Overview
ETH Balance
0 ETH
Eth Value
$0.00More Info
Private Name Tags
ContractCreator
Latest 7 from a total of 7 transactions
Transaction Hash |
Method
|
Block
|
From
|
To
|
|||||
---|---|---|---|---|---|---|---|---|---|
Setup Governance | 19612158 | 149 days ago | IN | 0 ETH | 0.23170474 | ||||
Deploy R Token | 19612151 | 149 days ago | IN | 0 ETH | 0.38748329 | ||||
Setup Governance | 19577997 | 154 days ago | IN | 0 ETH | 0.18188596 | ||||
Deploy R Token | 19577960 | 154 days ago | IN | 0 ETH | 0.33023047 | ||||
Setup Governance | 19441566 | 173 days ago | IN | 0 ETH | 0.32848603 | ||||
Deploy R Token | 19441526 | 173 days ago | IN | 0 ETH | 0.35632952 | ||||
0x60a06040 | 18329920 | 329 days ago | IN | 0 ETH | 0.0339486 |
Latest 6 internal transactions
Advanced mode:
Parent Transaction Hash | Block | From | To | |||
---|---|---|---|---|---|---|
19612158 | 149 days ago | Contract Creation | 0 ETH | |||
19612158 | 149 days ago | Contract Creation | 0 ETH | |||
19577997 | 154 days ago | Contract Creation | 0 ETH | |||
19577997 | 154 days ago | Contract Creation | 0 ETH | |||
19441566 | 173 days ago | Contract Creation | 0 ETH | |||
19441566 | 173 days ago | Contract Creation | 0 ETH |
Loading...
Loading
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.
Contract Name:
FacadeWrite
Compiler Version
v0.8.19+commit.7dd6d404
Optimization Enabled:
Yes with 200 runs
Other Settings:
default evmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "../interfaces/IFacadeWrite.sol"; import "./lib/FacadeWriteLib.sol"; /** * @title FacadeWrite * @notice A UX-friendly layer to interact with the protocol * @dev Under the hood, uses two external libs to deal with blocksize limits. */ contract FacadeWrite is IFacadeWrite { using FacadeWriteLib for address; IDeployer public immutable deployer; constructor(IDeployer deployer_) { require(address(deployer_) != address(0), "invalid address"); deployer = deployer_; } /// Step 1 function deployRToken(ConfigurationParams calldata config, SetupParams calldata setup) external returns (address) { // Perform validations require(setup.primaryBasket.length > 0, "no collateral"); require(setup.primaryBasket.length == setup.weights.length, "invalid length"); // Validate backups for (uint256 i = 0; i < setup.backups.length; ++i) { require(setup.backups[i].backupCollateral.length > 0, "no backup collateral"); } // Validate beneficiaries for (uint256 i = 0; i < setup.beneficiaries.length; ++i) { require( setup.beneficiaries[i].beneficiary != address(0) && (setup.beneficiaries[i].revShare.rTokenDist > 0 || setup.beneficiaries[i].revShare.rsrDist > 0), "beneficiary revShare mismatch" ); } // Deploy contracts IRToken rToken = IRToken( deployer.deploy( config.name, config.symbol, config.mandate, address(this), // set as owner config.params ) ); // Get Main IMain main = rToken.main(); IAssetRegistry assetRegistry = main.assetRegistry(); IBasketHandler basketHandler = main.basketHandler(); // Register assets for (uint256 i = 0; i < setup.assets.length; ++i) { require(assetRegistry.register(setup.assets[i]), "duplicate asset"); } // Setup basket { IERC20[] memory basketERC20s = new IERC20[](setup.primaryBasket.length); // Register collateral for (uint256 i = 0; i < setup.primaryBasket.length; ++i) { require(assetRegistry.register(setup.primaryBasket[i]), "duplicate collateral"); IERC20 erc20 = setup.primaryBasket[i].erc20(); basketERC20s[i] = erc20; } // Set basket basketHandler.setPrimeBasket(basketERC20s, setup.weights); basketHandler.refreshBasket(); } // Setup backup config { for (uint256 i = 0; i < setup.backups.length; ++i) { IERC20[] memory backupERC20s = new IERC20[]( setup.backups[i].backupCollateral.length ); for (uint256 j = 0; j < setup.backups[i].backupCollateral.length; ++j) { ICollateral backupColl = setup.backups[i].backupCollateral[j]; assetRegistry.register(backupColl); // do not require the asset is new IERC20 erc20 = backupColl.erc20(); backupERC20s[j] = erc20; } basketHandler.setBackupConfig( setup.backups[i].backupUnit, setup.backups[i].diversityFactor, backupERC20s ); } } // Setup revshare beneficiaries for (uint256 i = 0; i < setup.beneficiaries.length; ++i) { main.distributor().setDistribution( setup.beneficiaries[i].beneficiary, setup.beneficiaries[i].revShare ); } // Pause until setupGovernance main.grantRole(PAUSER, address(this)); main.pauseTrading(); main.pauseIssuance(); main.revokeRole(PAUSER, address(this)); // Setup deployer as owner to complete next step - do not renounce roles yet main.grantRole(OWNER, msg.sender); // Return rToken address return address(rToken); } /// Step 2 /// @return newOwner The address of the new owner function setupGovernance( IRToken rToken, bool deployGovernance, bool unpause, GovernanceParams calldata govParams, GovernanceRoles calldata govRoles ) external returns (address newOwner) { // Get Main IMain main = rToken.main(); require(main.hasRole(OWNER, address(this)), "ownership already transferred"); require(main.hasRole(OWNER, msg.sender), "not initial deployer"); // Remove ownership to sender main.revokeRole(OWNER, msg.sender); if (deployGovernance) { require(govRoles.owner == address(0), "owner should be empty"); TimelockController timelock = new TimelockController( govParams.timelockDelay, new address[](0), new address[](0) ); // Deploy Governance contract address governance = FacadeWriteLib.deployGovernance( IStRSRVotes(address(main.stRSR())), timelock, govParams.votingDelay, govParams.votingPeriod, govParams.proposalThresholdAsMicroPercent, govParams.quorumPercent ); emit GovernanceCreated(rToken, governance, address(timelock)); // Setup Roles timelock.grantRole(timelock.PROPOSER_ROLE(), governance); // Gov only proposer // Set Guardian as canceller, if address(0) then no one can cancel timelock.grantRole(timelock.CANCELLER_ROLE(), govRoles.guardian); timelock.grantRole(timelock.EXECUTOR_ROLE(), governance); // Gov only executor timelock.revokeRole(timelock.TIMELOCK_ADMIN_ROLE(), address(this)); // Revoke admin role // Set new owner to timelock newOwner = address(timelock); } else { require(govRoles.owner != address(0), "owner not defined"); newOwner = govRoles.owner; } // Setup pausers for (uint256 i = 0; i < govRoles.pausers.length; ++i) { if (govRoles.pausers[i] != address(0)) { main.grantRole(PAUSER, govRoles.pausers[i]); } } // Setup short freezers for (uint256 i = 0; i < govRoles.shortFreezers.length; ++i) { if (govRoles.shortFreezers[i] != address(0)) { main.grantRole(SHORT_FREEZER, govRoles.shortFreezers[i]); } } // Setup long freezers for (uint256 i = 0; i < govRoles.longFreezers.length; ++i) { if (govRoles.longFreezers[i] != address(0)) { main.grantRole(LONG_FREEZER, govRoles.longFreezers[i]); } } // Unpause if required if (unpause) { main.grantRole(PAUSER, address(this)); main.unpauseTrading(); main.unpauseIssuance(); main.revokeRole(PAUSER, address(this)); } // Transfer Ownership and renounce owner role main.grantRole(OWNER, newOwner); main.renounceRole(OWNER, address(this)); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; interface AggregatorV3Interface { function decimals() external view returns (uint8); function description() external view returns (string memory); function version() external view returns (uint256); function getRoundData(uint80 _roundId) external view returns ( uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound ); function latestRoundData() external view returns ( uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound ); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol) pragma solidity ^0.8.0; /** * @dev External interface of AccessControl declared to support ERC165 detection. */ interface IAccessControlUpgradeable { /** * @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 // OpenZeppelin Contracts (last updated v4.5.0) (governance/utils/IVotes.sol) pragma solidity ^0.8.0; /** * @dev Common interface for {ERC20Votes}, {ERC721Votes}, and other {Votes}-enabled contracts. * * _Available since v4.5._ */ interface IVotesUpgradeable { /** * @dev Emitted when an account changes their delegate. */ event DelegateChanged(address indexed delegator, address indexed fromDelegate, address indexed toDelegate); /** * @dev Emitted when a token transfer or delegate change results in changes to a delegate's number of votes. */ event DelegateVotesChanged(address indexed delegate, uint256 previousBalance, uint256 newBalance); /** * @dev Returns the current amount of votes that `account` has. */ function getVotes(address account) external view returns (uint256); /** * @dev Returns the amount of votes that `account` had at the end of a past block (`blockNumber`). */ function getPastVotes(address account, uint256 blockNumber) external view returns (uint256); /** * @dev Returns the total supply of votes available at the end of a past block (`blockNumber`). * * NOTE: This value is the sum of all available votes, which is not necessarily the sum of all delegated votes. * Votes that have not been delegated are still part of total supply, even though they would not participate in a * vote. */ function getPastTotalSupply(uint256 blockNumber) external view returns (uint256); /** * @dev Returns the delegate that `account` has chosen. */ function delegates(address account) external view returns (address); /** * @dev Delegates votes from the sender to `delegatee`. */ function delegate(address delegatee) external; /** * @dev Delegates votes from signer to `delegatee`. */ function delegateBySig( address delegatee, uint256 nonce, uint256 expiry, uint8 v, bytes32 r, bytes32 s ) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/draft-IERC20Permit.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612]. * * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't * need to send a transaction, and thus is not required to hold Ether at all. */ interface IERC20PermitUpgradeable { /** * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens, * given ``owner``'s signed approval. * * IMPORTANT: The same issues {IERC20-approve} has related to transaction * ordering also apply here. * * Emits an {Approval} event. * * Requirements: * * - `spender` cannot be the zero address. * - `deadline` must be a timestamp in the future. * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner` * over the EIP712-formatted function arguments. * - the signature must use ``owner``'s current nonce (see {nonces}). * * For more information on the signature format, see the * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP * section]. */ function permit( address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s ) external; /** * @dev Returns the current nonce for `owner`. This value must be * included whenever a signature is generated for {permit}. * * Every successful call to {permit} increases ``owner``'s nonce by one. This * prevents a signature from being used multiple times. */ function nonces(address owner) external view returns (uint256); /** * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}. */ // solhint-disable-next-line func-name-mixedcase function DOMAIN_SEPARATOR() external view returns (bytes32); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol) pragma solidity ^0.8.0; import "../IERC20Upgradeable.sol"; /** * @dev Interface for the optional metadata functions from the ERC20 standard. * * _Available since v4.1._ */ interface IERC20MetadataUpgradeable is IERC20Upgradeable { /** * @dev Returns the name of the token. */ function name() external view returns (string memory); /** * @dev Returns the symbol of the token. */ function symbol() external view returns (string memory); /** * @dev Returns the decimals places of the token. */ function decimals() external view returns (uint8); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC20 standard as defined in the EIP. */ interface IERC20Upgradeable { /** * @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); /** * @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 `to`. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transfer(address to, 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 `from` to `to` 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 from, address to, uint256 amount ) external returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (access/AccessControl.sol) 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); _; } /** * @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 virtual override returns (bool) { return _roles[role].members[account]; } /** * @dev Revert with a standard message if `_msgSender()` is missing `role`. * Overriding this function changes the behavior of the {onlyRole} modifier. * * Format of the revert message is described in {_checkRole}. * * _Available since v4.6._ */ function _checkRole(bytes32 role) internal view virtual { _checkRole(role, _msgSender()); } /** * @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 virtual { 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 virtual 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. * * May emit a {RoleGranted} event. */ 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. * * May emit a {RoleRevoked} event. */ 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 revoked `role`, emits a {RoleRevoked} * event. * * Requirements: * * - the caller must be `account`. * * May emit a {RoleRevoked} event. */ 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. * * May emit a {RoleGranted} event. * * [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}. * ==== * * NOTE: This function is deprecated in favor of {_grantRole}. */ 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); } /** * @dev Grants `role` to `account`. * * Internal function without access restriction. * * May emit a {RoleGranted} event. */ function _grantRole(bytes32 role, address account) internal virtual { if (!hasRole(role, account)) { _roles[role].members[account] = true; emit RoleGranted(role, account, _msgSender()); } } /** * @dev Revokes `role` from `account`. * * Internal function without access restriction. * * May emit a {RoleRevoked} event. */ function _revokeRole(bytes32 role, address account) internal virtual { if (hasRole(role, account)) { _roles[role].members[account] = false; emit RoleRevoked(role, account, _msgSender()); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol) 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 // OpenZeppelin Contracts (last updated v4.6.0) (governance/extensions/GovernorCountingSimple.sol) pragma solidity ^0.8.0; import "../Governor.sol"; /** * @dev Extension of {Governor} for simple, 3 options, vote counting. * * _Available since v4.3._ */ abstract contract GovernorCountingSimple is Governor { /** * @dev Supported vote types. Matches Governor Bravo ordering. */ enum VoteType { Against, For, Abstain } struct ProposalVote { uint256 againstVotes; uint256 forVotes; uint256 abstainVotes; mapping(address => bool) hasVoted; } mapping(uint256 => ProposalVote) private _proposalVotes; /** * @dev See {IGovernor-COUNTING_MODE}. */ // solhint-disable-next-line func-name-mixedcase function COUNTING_MODE() public pure virtual override returns (string memory) { return "support=bravo&quorum=for,abstain"; } /** * @dev See {IGovernor-hasVoted}. */ function hasVoted(uint256 proposalId, address account) public view virtual override returns (bool) { return _proposalVotes[proposalId].hasVoted[account]; } /** * @dev Accessor to the internal vote counts. */ function proposalVotes(uint256 proposalId) public view virtual returns ( uint256 againstVotes, uint256 forVotes, uint256 abstainVotes ) { ProposalVote storage proposalvote = _proposalVotes[proposalId]; return (proposalvote.againstVotes, proposalvote.forVotes, proposalvote.abstainVotes); } /** * @dev See {Governor-_quorumReached}. */ function _quorumReached(uint256 proposalId) internal view virtual override returns (bool) { ProposalVote storage proposalvote = _proposalVotes[proposalId]; return quorum(proposalSnapshot(proposalId)) <= proposalvote.forVotes + proposalvote.abstainVotes; } /** * @dev See {Governor-_voteSucceeded}. In this module, the forVotes must be strictly over the againstVotes. */ function _voteSucceeded(uint256 proposalId) internal view virtual override returns (bool) { ProposalVote storage proposalvote = _proposalVotes[proposalId]; return proposalvote.forVotes > proposalvote.againstVotes; } /** * @dev See {Governor-_countVote}. In this module, the support follows the `VoteType` enum (from Governor Bravo). */ function _countVote( uint256 proposalId, address account, uint8 support, uint256 weight, bytes memory // params ) internal virtual override { ProposalVote storage proposalvote = _proposalVotes[proposalId]; require(!proposalvote.hasVoted[account], "GovernorVotingSimple: vote already cast"); proposalvote.hasVoted[account] = true; if (support == uint8(VoteType.Against)) { proposalvote.againstVotes += weight; } else if (support == uint8(VoteType.For)) { proposalvote.forVotes += weight; } else if (support == uint8(VoteType.Abstain)) { proposalvote.abstainVotes += weight; } else { revert("GovernorVotingSimple: invalid value for enum VoteType"); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (governance/extensions/GovernorSettings.sol) pragma solidity ^0.8.0; import "../Governor.sol"; /** * @dev Extension of {Governor} for settings updatable through governance. * * _Available since v4.4._ */ abstract contract GovernorSettings is Governor { uint256 private _votingDelay; uint256 private _votingPeriod; uint256 private _proposalThreshold; event VotingDelaySet(uint256 oldVotingDelay, uint256 newVotingDelay); event VotingPeriodSet(uint256 oldVotingPeriod, uint256 newVotingPeriod); event ProposalThresholdSet(uint256 oldProposalThreshold, uint256 newProposalThreshold); /** * @dev Initialize the governance parameters. */ constructor( uint256 initialVotingDelay, uint256 initialVotingPeriod, uint256 initialProposalThreshold ) { _setVotingDelay(initialVotingDelay); _setVotingPeriod(initialVotingPeriod); _setProposalThreshold(initialProposalThreshold); } /** * @dev See {IGovernor-votingDelay}. */ function votingDelay() public view virtual override returns (uint256) { return _votingDelay; } /** * @dev See {IGovernor-votingPeriod}. */ function votingPeriod() public view virtual override returns (uint256) { return _votingPeriod; } /** * @dev See {Governor-proposalThreshold}. */ function proposalThreshold() public view virtual override returns (uint256) { return _proposalThreshold; } /** * @dev Update the voting delay. This operation can only be performed through a governance proposal. * * Emits a {VotingDelaySet} event. */ function setVotingDelay(uint256 newVotingDelay) public virtual onlyGovernance { _setVotingDelay(newVotingDelay); } /** * @dev Update the voting period. This operation can only be performed through a governance proposal. * * Emits a {VotingPeriodSet} event. */ function setVotingPeriod(uint256 newVotingPeriod) public virtual onlyGovernance { _setVotingPeriod(newVotingPeriod); } /** * @dev Update the proposal threshold. This operation can only be performed through a governance proposal. * * Emits a {ProposalThresholdSet} event. */ function setProposalThreshold(uint256 newProposalThreshold) public virtual onlyGovernance { _setProposalThreshold(newProposalThreshold); } /** * @dev Internal setter for the voting delay. * * Emits a {VotingDelaySet} event. */ function _setVotingDelay(uint256 newVotingDelay) internal virtual { emit VotingDelaySet(_votingDelay, newVotingDelay); _votingDelay = newVotingDelay; } /** * @dev Internal setter for the voting period. * * Emits a {VotingPeriodSet} event. */ function _setVotingPeriod(uint256 newVotingPeriod) internal virtual { // voting period must be at least one block long require(newVotingPeriod > 0, "GovernorSettings: voting period too low"); emit VotingPeriodSet(_votingPeriod, newVotingPeriod); _votingPeriod = newVotingPeriod; } /** * @dev Internal setter for the proposal threshold. * * Emits a {ProposalThresholdSet} event. */ function _setProposalThreshold(uint256 newProposalThreshold) internal virtual { emit ProposalThresholdSet(_proposalThreshold, newProposalThreshold); _proposalThreshold = newProposalThreshold; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (governance/extensions/GovernorTimelockControl.sol) pragma solidity ^0.8.0; import "./IGovernorTimelock.sol"; import "../Governor.sol"; import "../TimelockController.sol"; /** * @dev Extension of {Governor} that binds the execution process to an instance of {TimelockController}. This adds a * delay, enforced by the {TimelockController} to all successful proposal (in addition to the voting duration). The * {Governor} needs the proposer (and ideally the executor) roles for the {Governor} to work properly. * * Using this model means the proposal will be operated by the {TimelockController} and not by the {Governor}. Thus, * the assets and permissions must be attached to the {TimelockController}. Any asset sent to the {Governor} will be * inaccessible. * * WARNING: Setting up the TimelockController to have additional proposers besides the governor is very risky, as it * grants them powers that they must be trusted or known not to use: 1) {onlyGovernance} functions like {relay} are * available to them through the timelock, and 2) approved governance proposals can be blocked by them, effectively * executing a Denial of Service attack. This risk will be mitigated in a future release. * * _Available since v4.3._ */ abstract contract GovernorTimelockControl is IGovernorTimelock, Governor { TimelockController private _timelock; mapping(uint256 => bytes32) private _timelockIds; /** * @dev Emitted when the timelock controller used for proposal execution is modified. */ event TimelockChange(address oldTimelock, address newTimelock); /** * @dev Set the timelock. */ constructor(TimelockController timelockAddress) { _updateTimelock(timelockAddress); } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, Governor) returns (bool) { return interfaceId == type(IGovernorTimelock).interfaceId || super.supportsInterface(interfaceId); } /** * @dev Overridden version of the {Governor-state} function with added support for the `Queued` status. */ function state(uint256 proposalId) public view virtual override(IGovernor, Governor) returns (ProposalState) { ProposalState status = super.state(proposalId); if (status != ProposalState.Succeeded) { return status; } // core tracks execution, so we just have to check if successful proposal have been queued. bytes32 queueid = _timelockIds[proposalId]; if (queueid == bytes32(0)) { return status; } else if (_timelock.isOperationDone(queueid)) { return ProposalState.Executed; } else if (_timelock.isOperationPending(queueid)) { return ProposalState.Queued; } else { return ProposalState.Canceled; } } /** * @dev Public accessor to check the address of the timelock */ function timelock() public view virtual override returns (address) { return address(_timelock); } /** * @dev Public accessor to check the eta of a queued proposal */ function proposalEta(uint256 proposalId) public view virtual override returns (uint256) { uint256 eta = _timelock.getTimestamp(_timelockIds[proposalId]); return eta == 1 ? 0 : eta; // _DONE_TIMESTAMP (1) should be replaced with a 0 value } /** * @dev Function to queue a proposal to the timelock. */ function queue( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) public virtual override returns (uint256) { uint256 proposalId = hashProposal(targets, values, calldatas, descriptionHash); require(state(proposalId) == ProposalState.Succeeded, "Governor: proposal not successful"); uint256 delay = _timelock.getMinDelay(); _timelockIds[proposalId] = _timelock.hashOperationBatch(targets, values, calldatas, 0, descriptionHash); _timelock.scheduleBatch(targets, values, calldatas, 0, descriptionHash, delay); emit ProposalQueued(proposalId, block.timestamp + delay); return proposalId; } /** * @dev Overridden execute function that run the already queued proposal through the timelock. */ function _execute( uint256, /* proposalId */ address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) internal virtual override { _timelock.executeBatch{value: msg.value}(targets, values, calldatas, 0, descriptionHash); } /** * @dev Overridden version of the {Governor-_cancel} function to cancel the timelocked proposal if it as already * been queued. */ // This function can reenter through the external call to the timelock, but we assume the timelock is trusted and // well behaved (according to TimelockController) and this will not happen. // slither-disable-next-line reentrancy-no-eth function _cancel( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) internal virtual override returns (uint256) { uint256 proposalId = super._cancel(targets, values, calldatas, descriptionHash); if (_timelockIds[proposalId] != 0) { _timelock.cancel(_timelockIds[proposalId]); delete _timelockIds[proposalId]; } return proposalId; } /** * @dev Address through which the governor executes action. In this case, the timelock. */ function _executor() internal view virtual override returns (address) { return address(_timelock); } /** * @dev Public endpoint to update the underlying timelock instance. Restricted to the timelock itself, so updates * must be proposed, scheduled, and executed through governance proposals. * * CAUTION: It is not recommended to change the timelock while there are other queued governance proposals. */ function updateTimelock(TimelockController newTimelock) external virtual onlyGovernance { _updateTimelock(newTimelock); } function _updateTimelock(TimelockController newTimelock) private { emit TimelockChange(address(_timelock), address(newTimelock)); _timelock = newTimelock; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (governance/extensions/GovernorVotes.sol) pragma solidity ^0.8.0; import "../Governor.sol"; import "../utils/IVotes.sol"; /** * @dev Extension of {Governor} for voting weight extraction from an {ERC20Votes} token, or since v4.5 an {ERC721Votes} token. * * _Available since v4.3._ */ abstract contract GovernorVotes is Governor { IVotes public immutable token; constructor(IVotes tokenAddress) { token = tokenAddress; } /** * Read the voting weight from the token's built in snapshot mechanism (see {Governor-_getVotes}). */ function _getVotes( address account, uint256 blockNumber, bytes memory /*params*/ ) internal view virtual override returns (uint256) { return token.getPastVotes(account, blockNumber); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.2) (governance/extensions/GovernorVotesQuorumFraction.sol) pragma solidity ^0.8.0; import "./GovernorVotes.sol"; import "../../utils/Checkpoints.sol"; import "../../utils/math/SafeCast.sol"; /** * @dev Extension of {Governor} for voting weight extraction from an {ERC20Votes} token and a quorum expressed as a * fraction of the total supply. * * _Available since v4.3._ */ abstract contract GovernorVotesQuorumFraction is GovernorVotes { using Checkpoints for Checkpoints.History; uint256 private _quorumNumerator; // DEPRECATED Checkpoints.History private _quorumNumeratorHistory; event QuorumNumeratorUpdated(uint256 oldQuorumNumerator, uint256 newQuorumNumerator); /** * @dev Initialize quorum as a fraction of the token's total supply. * * The fraction is specified as `numerator / denominator`. By default the denominator is 100, so quorum is * specified as a percent: a numerator of 10 corresponds to quorum being 10% of total supply. The denominator can be * customized by overriding {quorumDenominator}. */ constructor(uint256 quorumNumeratorValue) { _updateQuorumNumerator(quorumNumeratorValue); } /** * @dev Returns the current quorum numerator. See {quorumDenominator}. */ function quorumNumerator() public view virtual returns (uint256) { return _quorumNumeratorHistory._checkpoints.length == 0 ? _quorumNumerator : _quorumNumeratorHistory.latest(); } /** * @dev Returns the quorum numerator at a specific block number. See {quorumDenominator}. */ function quorumNumerator(uint256 blockNumber) public view virtual returns (uint256) { // If history is empty, fallback to old storage uint256 length = _quorumNumeratorHistory._checkpoints.length; if (length == 0) { return _quorumNumerator; } // Optimistic search, check the latest checkpoint Checkpoints.Checkpoint memory latest = _quorumNumeratorHistory._checkpoints[length - 1]; if (latest._blockNumber <= blockNumber) { return latest._value; } // Otherwize, do the binary search return _quorumNumeratorHistory.getAtBlock(blockNumber); } /** * @dev Returns the quorum denominator. Defaults to 100, but may be overridden. */ function quorumDenominator() public view virtual returns (uint256) { return 100; } /** * @dev Returns the quorum for a block number, in terms of number of votes: `supply * numerator / denominator`. */ function quorum(uint256 blockNumber) public view virtual override returns (uint256) { return (token.getPastTotalSupply(blockNumber) * quorumNumerator(blockNumber)) / quorumDenominator(); } /** * @dev Changes the quorum numerator. * * Emits a {QuorumNumeratorUpdated} event. * * Requirements: * * - Must be called through a governance proposal. * - New numerator must be smaller or equal to the denominator. */ function updateQuorumNumerator(uint256 newQuorumNumerator) external virtual onlyGovernance { _updateQuorumNumerator(newQuorumNumerator); } /** * @dev Changes the quorum numerator. * * Emits a {QuorumNumeratorUpdated} event. * * Requirements: * * - New numerator must be smaller or equal to the denominator. */ function _updateQuorumNumerator(uint256 newQuorumNumerator) internal virtual { require( newQuorumNumerator <= quorumDenominator(), "GovernorVotesQuorumFraction: quorumNumerator over quorumDenominator" ); uint256 oldQuorumNumerator = quorumNumerator(); // Make sure we keep track of the original numerator in contracts upgraded from a version without checkpoints. if (oldQuorumNumerator != 0 && _quorumNumeratorHistory._checkpoints.length == 0) { _quorumNumeratorHistory._checkpoints.push( Checkpoints.Checkpoint({_blockNumber: 0, _value: SafeCast.toUint224(oldQuorumNumerator)}) ); } // Set new quorum for future proposals _quorumNumeratorHistory.push(newQuorumNumerator); emit QuorumNumeratorUpdated(oldQuorumNumerator, newQuorumNumerator); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (governance/extensions/IGovernorTimelock.sol) pragma solidity ^0.8.0; import "../IGovernor.sol"; /** * @dev Extension of the {IGovernor} for timelock supporting modules. * * _Available since v4.3._ */ abstract contract IGovernorTimelock is IGovernor { event ProposalQueued(uint256 proposalId, uint256 eta); function timelock() public view virtual returns (address); function proposalEta(uint256 proposalId) public view virtual returns (uint256); function queue( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) public virtual returns (uint256 proposalId); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.2) (governance/Governor.sol) pragma solidity ^0.8.0; import "../token/ERC721/IERC721Receiver.sol"; import "../token/ERC1155/IERC1155Receiver.sol"; import "../utils/cryptography/ECDSA.sol"; import "../utils/cryptography/draft-EIP712.sol"; import "../utils/introspection/ERC165.sol"; import "../utils/math/SafeCast.sol"; import "../utils/structs/DoubleEndedQueue.sol"; import "../utils/Address.sol"; import "../utils/Context.sol"; import "../utils/Timers.sol"; import "./IGovernor.sol"; /** * @dev Core of the governance system, designed to be extended though various modules. * * This contract is abstract and requires several function to be implemented in various modules: * * - A counting module must implement {quorum}, {_quorumReached}, {_voteSucceeded} and {_countVote} * - A voting module must implement {_getVotes} * - Additionanly, the {votingPeriod} must also be implemented * * _Available since v4.3._ */ abstract contract Governor is Context, ERC165, EIP712, IGovernor, IERC721Receiver, IERC1155Receiver { using DoubleEndedQueue for DoubleEndedQueue.Bytes32Deque; using SafeCast for uint256; using Timers for Timers.BlockNumber; bytes32 public constant BALLOT_TYPEHASH = keccak256("Ballot(uint256 proposalId,uint8 support)"); bytes32 public constant EXTENDED_BALLOT_TYPEHASH = keccak256("ExtendedBallot(uint256 proposalId,uint8 support,string reason,bytes params)"); struct ProposalCore { Timers.BlockNumber voteStart; Timers.BlockNumber voteEnd; bool executed; bool canceled; } string private _name; mapping(uint256 => ProposalCore) private _proposals; // This queue keeps track of the governor operating on itself. Calls to functions protected by the // {onlyGovernance} modifier needs to be whitelisted in this queue. Whitelisting is set in {_beforeExecute}, // consumed by the {onlyGovernance} modifier and eventually reset in {_afterExecute}. This ensures that the // execution of {onlyGovernance} protected calls can only be achieved through successful proposals. DoubleEndedQueue.Bytes32Deque private _governanceCall; /** * @dev Restricts a function so it can only be executed through governance proposals. For example, governance * parameter setters in {GovernorSettings} are protected using this modifier. * * The governance executing address may be different from the Governor's own address, for example it could be a * timelock. This can be customized by modules by overriding {_executor}. The executor is only able to invoke these * functions during the execution of the governor's {execute} function, and not under any other circumstances. Thus, * for example, additional timelock proposers are not able to change governance parameters without going through the * governance protocol (since v4.6). */ modifier onlyGovernance() { require(_msgSender() == _executor(), "Governor: onlyGovernance"); if (_executor() != address(this)) { bytes32 msgDataHash = keccak256(_msgData()); // loop until popping the expected operation - throw if deque is empty (operation not authorized) while (_governanceCall.popFront() != msgDataHash) {} } _; } /** * @dev Sets the value for {name} and {version} */ constructor(string memory name_) EIP712(name_, version()) { _name = name_; } /** * @dev Function to receive ETH that will be handled by the governor (disabled if executor is a third party contract) */ receive() external payable virtual { require(_executor() == address(this)); } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) { // In addition to the current interfaceId, also support previous version of the interfaceId that did not // include the castVoteWithReasonAndParams() function as standard return interfaceId == (type(IGovernor).interfaceId ^ this.castVoteWithReasonAndParams.selector ^ this.castVoteWithReasonAndParamsBySig.selector ^ this.getVotesWithParams.selector) || interfaceId == type(IGovernor).interfaceId || interfaceId == type(IERC1155Receiver).interfaceId || super.supportsInterface(interfaceId); } /** * @dev See {IGovernor-name}. */ function name() public view virtual override returns (string memory) { return _name; } /** * @dev See {IGovernor-version}. */ function version() public view virtual override returns (string memory) { return "1"; } /** * @dev See {IGovernor-hashProposal}. * * The proposal id is produced by hashing the ABI encoded `targets` array, the `values` array, the `calldatas` array * and the descriptionHash (bytes32 which itself is the keccak256 hash of the description string). This proposal id * can be produced from the proposal data which is part of the {ProposalCreated} event. It can even be computed in * advance, before the proposal is submitted. * * Note that the chainId and the governor address are not part of the proposal id computation. Consequently, the * same proposal (with same operation and same description) will have the same id if submitted on multiple governors * across multiple networks. This also means that in order to execute the same operation twice (on the same * governor) the proposer will have to change the description in order to avoid proposal id conflicts. */ function hashProposal( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) public pure virtual override returns (uint256) { return uint256(keccak256(abi.encode(targets, values, calldatas, descriptionHash))); } /** * @dev See {IGovernor-state}. */ function state(uint256 proposalId) public view virtual override returns (ProposalState) { ProposalCore storage proposal = _proposals[proposalId]; if (proposal.executed) { return ProposalState.Executed; } if (proposal.canceled) { return ProposalState.Canceled; } uint256 snapshot = proposalSnapshot(proposalId); if (snapshot == 0) { revert("Governor: unknown proposal id"); } if (snapshot >= block.number) { return ProposalState.Pending; } uint256 deadline = proposalDeadline(proposalId); if (deadline >= block.number) { return ProposalState.Active; } if (_quorumReached(proposalId) && _voteSucceeded(proposalId)) { return ProposalState.Succeeded; } else { return ProposalState.Defeated; } } /** * @dev See {IGovernor-proposalSnapshot}. */ function proposalSnapshot(uint256 proposalId) public view virtual override returns (uint256) { return _proposals[proposalId].voteStart.getDeadline(); } /** * @dev See {IGovernor-proposalDeadline}. */ function proposalDeadline(uint256 proposalId) public view virtual override returns (uint256) { return _proposals[proposalId].voteEnd.getDeadline(); } /** * @dev Part of the Governor Bravo's interface: _"The number of votes required in order for a voter to become a proposer"_. */ function proposalThreshold() public view virtual returns (uint256) { return 0; } /** * @dev Amount of votes already cast passes the threshold limit. */ function _quorumReached(uint256 proposalId) internal view virtual returns (bool); /** * @dev Is the proposal successful or not. */ function _voteSucceeded(uint256 proposalId) internal view virtual returns (bool); /** * @dev Get the voting weight of `account` at a specific `blockNumber`, for a vote as described by `params`. */ function _getVotes( address account, uint256 blockNumber, bytes memory params ) internal view virtual returns (uint256); /** * @dev Register a vote for `proposalId` by `account` with a given `support`, voting `weight` and voting `params`. * * Note: Support is generic and can represent various things depending on the voting system used. */ function _countVote( uint256 proposalId, address account, uint8 support, uint256 weight, bytes memory params ) internal virtual; /** * @dev Default additional encoded parameters used by castVote methods that don't include them * * Note: Should be overridden by specific implementations to use an appropriate value, the * meaning of the additional params, in the context of that implementation */ function _defaultParams() internal view virtual returns (bytes memory) { return ""; } /** * @dev See {IGovernor-propose}. */ function propose( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, string memory description ) public virtual override returns (uint256) { require( getVotes(_msgSender(), block.number - 1) >= proposalThreshold(), "Governor: proposer votes below proposal threshold" ); uint256 proposalId = hashProposal(targets, values, calldatas, keccak256(bytes(description))); require(targets.length == values.length, "Governor: invalid proposal length"); require(targets.length == calldatas.length, "Governor: invalid proposal length"); require(targets.length > 0, "Governor: empty proposal"); ProposalCore storage proposal = _proposals[proposalId]; require(proposal.voteStart.isUnset(), "Governor: proposal already exists"); uint64 snapshot = block.number.toUint64() + votingDelay().toUint64(); uint64 deadline = snapshot + votingPeriod().toUint64(); proposal.voteStart.setDeadline(snapshot); proposal.voteEnd.setDeadline(deadline); emit ProposalCreated( proposalId, _msgSender(), targets, values, new string[](targets.length), calldatas, snapshot, deadline, description ); return proposalId; } /** * @dev See {IGovernor-execute}. */ function execute( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) public payable virtual override returns (uint256) { uint256 proposalId = hashProposal(targets, values, calldatas, descriptionHash); ProposalState status = state(proposalId); require( status == ProposalState.Succeeded || status == ProposalState.Queued, "Governor: proposal not successful" ); _proposals[proposalId].executed = true; emit ProposalExecuted(proposalId); _beforeExecute(proposalId, targets, values, calldatas, descriptionHash); _execute(proposalId, targets, values, calldatas, descriptionHash); _afterExecute(proposalId, targets, values, calldatas, descriptionHash); return proposalId; } /** * @dev Internal execution mechanism. Can be overridden to implement different execution mechanism */ function _execute( uint256, /* proposalId */ address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 /*descriptionHash*/ ) internal virtual { string memory errorMessage = "Governor: call reverted without message"; for (uint256 i = 0; i < targets.length; ++i) { (bool success, bytes memory returndata) = targets[i].call{value: values[i]}(calldatas[i]); Address.verifyCallResult(success, returndata, errorMessage); } } /** * @dev Hook before execution is triggered. */ function _beforeExecute( uint256, /* proposalId */ address[] memory targets, uint256[] memory, /* values */ bytes[] memory calldatas, bytes32 /*descriptionHash*/ ) internal virtual { if (_executor() != address(this)) { for (uint256 i = 0; i < targets.length; ++i) { if (targets[i] == address(this)) { _governanceCall.pushBack(keccak256(calldatas[i])); } } } } /** * @dev Hook after execution is triggered. */ function _afterExecute( uint256, /* proposalId */ address[] memory, /* targets */ uint256[] memory, /* values */ bytes[] memory, /* calldatas */ bytes32 /*descriptionHash*/ ) internal virtual { if (_executor() != address(this)) { if (!_governanceCall.empty()) { _governanceCall.clear(); } } } /** * @dev Internal cancel mechanism: locks up the proposal timer, preventing it from being re-submitted. Marks it as * canceled to allow distinguishing it from executed proposals. * * Emits a {IGovernor-ProposalCanceled} event. */ function _cancel( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) internal virtual returns (uint256) { uint256 proposalId = hashProposal(targets, values, calldatas, descriptionHash); ProposalState status = state(proposalId); require( status != ProposalState.Canceled && status != ProposalState.Expired && status != ProposalState.Executed, "Governor: proposal not active" ); _proposals[proposalId].canceled = true; emit ProposalCanceled(proposalId); return proposalId; } /** * @dev See {IGovernor-getVotes}. */ function getVotes(address account, uint256 blockNumber) public view virtual override returns (uint256) { return _getVotes(account, blockNumber, _defaultParams()); } /** * @dev See {IGovernor-getVotesWithParams}. */ function getVotesWithParams( address account, uint256 blockNumber, bytes memory params ) public view virtual override returns (uint256) { return _getVotes(account, blockNumber, params); } /** * @dev See {IGovernor-castVote}. */ function castVote(uint256 proposalId, uint8 support) public virtual override returns (uint256) { address voter = _msgSender(); return _castVote(proposalId, voter, support, ""); } /** * @dev See {IGovernor-castVoteWithReason}. */ function castVoteWithReason( uint256 proposalId, uint8 support, string calldata reason ) public virtual override returns (uint256) { address voter = _msgSender(); return _castVote(proposalId, voter, support, reason); } /** * @dev See {IGovernor-castVoteWithReasonAndParams}. */ function castVoteWithReasonAndParams( uint256 proposalId, uint8 support, string calldata reason, bytes memory params ) public virtual override returns (uint256) { address voter = _msgSender(); return _castVote(proposalId, voter, support, reason, params); } /** * @dev See {IGovernor-castVoteBySig}. */ function castVoteBySig( uint256 proposalId, uint8 support, uint8 v, bytes32 r, bytes32 s ) public virtual override returns (uint256) { address voter = ECDSA.recover( _hashTypedDataV4(keccak256(abi.encode(BALLOT_TYPEHASH, proposalId, support))), v, r, s ); return _castVote(proposalId, voter, support, ""); } /** * @dev See {IGovernor-castVoteWithReasonAndParamsBySig}. */ function castVoteWithReasonAndParamsBySig( uint256 proposalId, uint8 support, string calldata reason, bytes memory params, uint8 v, bytes32 r, bytes32 s ) public virtual override returns (uint256) { address voter = ECDSA.recover( _hashTypedDataV4( keccak256( abi.encode( EXTENDED_BALLOT_TYPEHASH, proposalId, support, keccak256(bytes(reason)), keccak256(params) ) ) ), v, r, s ); return _castVote(proposalId, voter, support, reason, params); } /** * @dev Internal vote casting mechanism: Check that the vote is pending, that it has not been cast yet, retrieve * voting weight using {IGovernor-getVotes} and call the {_countVote} internal function. Uses the _defaultParams(). * * Emits a {IGovernor-VoteCast} event. */ function _castVote( uint256 proposalId, address account, uint8 support, string memory reason ) internal virtual returns (uint256) { return _castVote(proposalId, account, support, reason, _defaultParams()); } /** * @dev Internal vote casting mechanism: Check that the vote is pending, that it has not been cast yet, retrieve * voting weight using {IGovernor-getVotes} and call the {_countVote} internal function. * * Emits a {IGovernor-VoteCast} event. */ function _castVote( uint256 proposalId, address account, uint8 support, string memory reason, bytes memory params ) internal virtual returns (uint256) { ProposalCore storage proposal = _proposals[proposalId]; require(state(proposalId) == ProposalState.Active, "Governor: vote not currently active"); uint256 weight = _getVotes(account, proposal.voteStart.getDeadline(), params); _countVote(proposalId, account, support, weight, params); if (params.length == 0) { emit VoteCast(account, proposalId, support, weight, reason); } else { emit VoteCastWithParams(account, proposalId, support, weight, reason, params); } return weight; } /** * @dev Relays a transaction or function call to an arbitrary target. In cases where the governance executor * is some contract other than the governor itself, like when using a timelock, this function can be invoked * in a governance proposal to recover tokens or Ether that was sent to the governor contract by mistake. * Note that if the executor is simply the governor itself, use of `relay` is redundant. */ function relay( address target, uint256 value, bytes calldata data ) external virtual onlyGovernance { Address.functionCallWithValue(target, data, value); } /** * @dev Address through which the governor executes action. Will be overloaded by module that execute actions * through another contract such as a timelock. */ function _executor() internal view virtual returns (address) { return address(this); } /** * @dev See {IERC721Receiver-onERC721Received}. */ function onERC721Received( address, address, uint256, bytes memory ) public virtual override returns (bytes4) { return this.onERC721Received.selector; } /** * @dev See {IERC1155Receiver-onERC1155Received}. */ function onERC1155Received( address, address, uint256, uint256, bytes memory ) public virtual override returns (bytes4) { return this.onERC1155Received.selector; } /** * @dev See {IERC1155Receiver-onERC1155BatchReceived}. */ function onERC1155BatchReceived( address, address, uint256[] memory, uint256[] memory, bytes memory ) public virtual override returns (bytes4) { return this.onERC1155BatchReceived.selector; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.2) (governance/IGovernor.sol) pragma solidity ^0.8.0; import "../utils/introspection/ERC165.sol"; /** * @dev Interface of the {Governor} core. * * _Available since v4.3._ */ abstract contract IGovernor is IERC165 { enum ProposalState { Pending, Active, Canceled, Defeated, Succeeded, Queued, Expired, Executed } /** * @dev Emitted when a proposal is created. */ event ProposalCreated( uint256 proposalId, address proposer, address[] targets, uint256[] values, string[] signatures, bytes[] calldatas, uint256 startBlock, uint256 endBlock, string description ); /** * @dev Emitted when a proposal is canceled. */ event ProposalCanceled(uint256 proposalId); /** * @dev Emitted when a proposal is executed. */ event ProposalExecuted(uint256 proposalId); /** * @dev Emitted when a vote is cast without params. * * Note: `support` values should be seen as buckets. Their interpretation depends on the voting module used. */ event VoteCast(address indexed voter, uint256 proposalId, uint8 support, uint256 weight, string reason); /** * @dev Emitted when a vote is cast with params. * * Note: `support` values should be seen as buckets. Their interpretation depends on the voting module used. * `params` are additional encoded parameters. Their intepepretation also depends on the voting module used. */ event VoteCastWithParams( address indexed voter, uint256 proposalId, uint8 support, uint256 weight, string reason, bytes params ); /** * @notice module:core * @dev Name of the governor instance (used in building the ERC712 domain separator). */ function name() public view virtual returns (string memory); /** * @notice module:core * @dev Version of the governor instance (used in building the ERC712 domain separator). Default: "1" */ function version() public view virtual returns (string memory); /** * @notice module:voting * @dev A description of the possible `support` values for {castVote} and the way these votes are counted, meant to * be consumed by UIs to show correct vote options and interpret the results. The string is a URL-encoded sequence of * key-value pairs that each describe one aspect, for example `support=bravo&quorum=for,abstain`. * * There are 2 standard keys: `support` and `quorum`. * * - `support=bravo` refers to the vote options 0 = Against, 1 = For, 2 = Abstain, as in `GovernorBravo`. * - `quorum=bravo` means that only For votes are counted towards quorum. * - `quorum=for,abstain` means that both For and Abstain votes are counted towards quorum. * * If a counting module makes use of encoded `params`, it should include this under a `params` key with a unique * name that describes the behavior. For example: * * - `params=fractional` might refer to a scheme where votes are divided fractionally between for/against/abstain. * - `params=erc721` might refer to a scheme where specific NFTs are delegated to vote. * * NOTE: The string can be decoded by the standard * https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams[`URLSearchParams`] * JavaScript class. */ // solhint-disable-next-line func-name-mixedcase function COUNTING_MODE() public pure virtual returns (string memory); /** * @notice module:core * @dev Hashing function used to (re)build the proposal id from the proposal details.. */ function hashProposal( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) public pure virtual returns (uint256); /** * @notice module:core * @dev Current state of a proposal, following Compound's convention */ function state(uint256 proposalId) public view virtual returns (ProposalState); /** * @notice module:core * @dev Block number used to retrieve user's votes and quorum. As per Compound's Comp and OpenZeppelin's * ERC20Votes, the snapshot is performed at the end of this block. Hence, voting for this proposal starts at the * beginning of the following block. */ function proposalSnapshot(uint256 proposalId) public view virtual returns (uint256); /** * @notice module:core * @dev Block number at which votes close. Votes close at the end of this block, so it is possible to cast a vote * during this block. */ function proposalDeadline(uint256 proposalId) public view virtual returns (uint256); /** * @notice module:user-config * @dev Delay, in number of block, between the proposal is created and the vote starts. This can be increassed to * leave time for users to buy voting power, or delegate it, before the voting of a proposal starts. */ function votingDelay() public view virtual returns (uint256); /** * @notice module:user-config * @dev Delay, in number of blocks, between the vote start and vote ends. * * NOTE: The {votingDelay} can delay the start of the vote. This must be considered when setting the voting * duration compared to the voting delay. */ function votingPeriod() public view virtual returns (uint256); /** * @notice module:user-config * @dev Minimum number of cast voted required for a proposal to be successful. * * Note: The `blockNumber` parameter corresponds to the snapshot used for counting vote. This allows to scale the * quorum depending on values such as the totalSupply of a token at this block (see {ERC20Votes}). */ function quorum(uint256 blockNumber) public view virtual returns (uint256); /** * @notice module:reputation * @dev Voting power of an `account` at a specific `blockNumber`. * * Note: this can be implemented in a number of ways, for example by reading the delegated balance from one (or * multiple), {ERC20Votes} tokens. */ function getVotes(address account, uint256 blockNumber) public view virtual returns (uint256); /** * @notice module:reputation * @dev Voting power of an `account` at a specific `blockNumber` given additional encoded parameters. */ function getVotesWithParams( address account, uint256 blockNumber, bytes memory params ) public view virtual returns (uint256); /** * @notice module:voting * @dev Returns weither `account` has cast a vote on `proposalId`. */ function hasVoted(uint256 proposalId, address account) public view virtual returns (bool); /** * @dev Create a new proposal. Vote start {IGovernor-votingDelay} blocks after the proposal is created and ends * {IGovernor-votingPeriod} blocks after the voting starts. * * Emits a {ProposalCreated} event. */ function propose( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, string memory description ) public virtual returns (uint256 proposalId); /** * @dev Execute a successful proposal. This requires the quorum to be reached, the vote to be successful, and the * deadline to be reached. * * Emits a {ProposalExecuted} event. * * Note: some module can modify the requirements for execution, for example by adding an additional timelock. */ function execute( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) public payable virtual returns (uint256 proposalId); /** * @dev Cast a vote * * Emits a {VoteCast} event. */ function castVote(uint256 proposalId, uint8 support) public virtual returns (uint256 balance); /** * @dev Cast a vote with a reason * * Emits a {VoteCast} event. */ function castVoteWithReason( uint256 proposalId, uint8 support, string calldata reason ) public virtual returns (uint256 balance); /** * @dev Cast a vote with a reason and additional encoded parameters * * Emits a {VoteCast} or {VoteCastWithParams} event depending on the length of params. */ function castVoteWithReasonAndParams( uint256 proposalId, uint8 support, string calldata reason, bytes memory params ) public virtual returns (uint256 balance); /** * @dev Cast a vote using the user's cryptographic signature. * * Emits a {VoteCast} event. */ function castVoteBySig( uint256 proposalId, uint8 support, uint8 v, bytes32 r, bytes32 s ) public virtual returns (uint256 balance); /** * @dev Cast a vote with a reason and additional encoded parameters using the user's cryptographic signature. * * Emits a {VoteCast} or {VoteCastWithParams} event depending on the length of params. */ function castVoteWithReasonAndParamsBySig( uint256 proposalId, uint8 support, string calldata reason, bytes memory params, uint8 v, bytes32 r, bytes32 s ) public virtual returns (uint256 balance); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (governance/TimelockController.sol) pragma solidity ^0.8.0; import "../access/AccessControl.sol"; import "../token/ERC721/IERC721Receiver.sol"; import "../token/ERC1155/IERC1155Receiver.sol"; import "../utils/Address.sol"; /** * @dev Contract module which acts as a timelocked controller. When set as the * owner of an `Ownable` smart contract, it enforces a timelock on all * `onlyOwner` maintenance operations. This gives time for users of the * controlled contract to exit before a potentially dangerous maintenance * operation is applied. * * By default, this contract is self administered, meaning administration tasks * have to go through the timelock process. The proposer (resp executor) role * is in charge of proposing (resp executing) operations. A common use case is * to position this {TimelockController} as the owner of a smart contract, with * a multisig or a DAO as the sole proposer. * * _Available since v3.3._ */ contract TimelockController is AccessControl, IERC721Receiver, IERC1155Receiver { bytes32 public constant TIMELOCK_ADMIN_ROLE = keccak256("TIMELOCK_ADMIN_ROLE"); bytes32 public constant PROPOSER_ROLE = keccak256("PROPOSER_ROLE"); bytes32 public constant EXECUTOR_ROLE = keccak256("EXECUTOR_ROLE"); bytes32 public constant CANCELLER_ROLE = keccak256("CANCELLER_ROLE"); uint256 internal constant _DONE_TIMESTAMP = uint256(1); mapping(bytes32 => uint256) private _timestamps; uint256 private _minDelay; /** * @dev Emitted when a call is scheduled as part of operation `id`. */ event CallScheduled( bytes32 indexed id, uint256 indexed index, address target, uint256 value, bytes data, bytes32 predecessor, uint256 delay ); /** * @dev Emitted when a call is performed as part of operation `id`. */ event CallExecuted(bytes32 indexed id, uint256 indexed index, address target, uint256 value, bytes data); /** * @dev Emitted when operation `id` is cancelled. */ event Cancelled(bytes32 indexed id); /** * @dev Emitted when the minimum delay for future operations is modified. */ event MinDelayChange(uint256 oldDuration, uint256 newDuration); /** * @dev Initializes the contract with a given `minDelay`, and a list of * initial proposers and executors. The proposers receive both the * proposer and the canceller role (for backward compatibility). The * executors receive the executor role. * * NOTE: At construction, both the deployer and the timelock itself are * administrators. This helps further configuration of the timelock by the * deployer. After configuration is done, it is recommended that the * deployer renounces its admin position and relies on timelocked * operations to perform future maintenance. */ constructor( uint256 minDelay, address[] memory proposers, address[] memory executors ) { _setRoleAdmin(TIMELOCK_ADMIN_ROLE, TIMELOCK_ADMIN_ROLE); _setRoleAdmin(PROPOSER_ROLE, TIMELOCK_ADMIN_ROLE); _setRoleAdmin(EXECUTOR_ROLE, TIMELOCK_ADMIN_ROLE); _setRoleAdmin(CANCELLER_ROLE, TIMELOCK_ADMIN_ROLE); // deployer + self administration _setupRole(TIMELOCK_ADMIN_ROLE, _msgSender()); _setupRole(TIMELOCK_ADMIN_ROLE, address(this)); // register proposers and cancellers for (uint256 i = 0; i < proposers.length; ++i) { _setupRole(PROPOSER_ROLE, proposers[i]); _setupRole(CANCELLER_ROLE, proposers[i]); } // register executors for (uint256 i = 0; i < executors.length; ++i) { _setupRole(EXECUTOR_ROLE, executors[i]); } _minDelay = minDelay; emit MinDelayChange(0, minDelay); } /** * @dev Modifier to make a function callable only by a certain role. In * addition to checking the sender's role, `address(0)` 's role is also * considered. Granting a role to `address(0)` is equivalent to enabling * this role for everyone. */ modifier onlyRoleOrOpenRole(bytes32 role) { if (!hasRole(role, address(0))) { _checkRole(role, _msgSender()); } _; } /** * @dev Contract might receive/hold ETH as part of the maintenance process. */ receive() external payable {} /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, AccessControl) returns (bool) { return interfaceId == type(IERC1155Receiver).interfaceId || super.supportsInterface(interfaceId); } /** * @dev Returns whether an id correspond to a registered operation. This * includes both Pending, Ready and Done operations. */ function isOperation(bytes32 id) public view virtual returns (bool registered) { return getTimestamp(id) > 0; } /** * @dev Returns whether an operation is pending or not. */ function isOperationPending(bytes32 id) public view virtual returns (bool pending) { return getTimestamp(id) > _DONE_TIMESTAMP; } /** * @dev Returns whether an operation is ready or not. */ function isOperationReady(bytes32 id) public view virtual returns (bool ready) { uint256 timestamp = getTimestamp(id); return timestamp > _DONE_TIMESTAMP && timestamp <= block.timestamp; } /** * @dev Returns whether an operation is done or not. */ function isOperationDone(bytes32 id) public view virtual returns (bool done) { return getTimestamp(id) == _DONE_TIMESTAMP; } /** * @dev Returns the timestamp at with an operation becomes ready (0 for * unset operations, 1 for done operations). */ function getTimestamp(bytes32 id) public view virtual returns (uint256 timestamp) { return _timestamps[id]; } /** * @dev Returns the minimum delay for an operation to become valid. * * This value can be changed by executing an operation that calls `updateDelay`. */ function getMinDelay() public view virtual returns (uint256 duration) { return _minDelay; } /** * @dev Returns the identifier of an operation containing a single * transaction. */ function hashOperation( address target, uint256 value, bytes calldata data, bytes32 predecessor, bytes32 salt ) public pure virtual returns (bytes32 hash) { return keccak256(abi.encode(target, value, data, predecessor, salt)); } /** * @dev Returns the identifier of an operation containing a batch of * transactions. */ function hashOperationBatch( address[] calldata targets, uint256[] calldata values, bytes[] calldata payloads, bytes32 predecessor, bytes32 salt ) public pure virtual returns (bytes32 hash) { return keccak256(abi.encode(targets, values, payloads, predecessor, salt)); } /** * @dev Schedule an operation containing a single transaction. * * Emits a {CallScheduled} event. * * Requirements: * * - the caller must have the 'proposer' role. */ function schedule( address target, uint256 value, bytes calldata data, bytes32 predecessor, bytes32 salt, uint256 delay ) public virtual onlyRole(PROPOSER_ROLE) { bytes32 id = hashOperation(target, value, data, predecessor, salt); _schedule(id, delay); emit CallScheduled(id, 0, target, value, data, predecessor, delay); } /** * @dev Schedule an operation containing a batch of transactions. * * Emits one {CallScheduled} event per transaction in the batch. * * Requirements: * * - the caller must have the 'proposer' role. */ function scheduleBatch( address[] calldata targets, uint256[] calldata values, bytes[] calldata payloads, bytes32 predecessor, bytes32 salt, uint256 delay ) public virtual onlyRole(PROPOSER_ROLE) { require(targets.length == values.length, "TimelockController: length mismatch"); require(targets.length == payloads.length, "TimelockController: length mismatch"); bytes32 id = hashOperationBatch(targets, values, payloads, predecessor, salt); _schedule(id, delay); for (uint256 i = 0; i < targets.length; ++i) { emit CallScheduled(id, i, targets[i], values[i], payloads[i], predecessor, delay); } } /** * @dev Schedule an operation that is to becomes valid after a given delay. */ function _schedule(bytes32 id, uint256 delay) private { require(!isOperation(id), "TimelockController: operation already scheduled"); require(delay >= getMinDelay(), "TimelockController: insufficient delay"); _timestamps[id] = block.timestamp + delay; } /** * @dev Cancel an operation. * * Requirements: * * - the caller must have the 'canceller' role. */ function cancel(bytes32 id) public virtual onlyRole(CANCELLER_ROLE) { require(isOperationPending(id), "TimelockController: operation cannot be cancelled"); delete _timestamps[id]; emit Cancelled(id); } /** * @dev Execute an (ready) operation containing a single transaction. * * Emits a {CallExecuted} event. * * Requirements: * * - the caller must have the 'executor' role. */ // This function can reenter, but it doesn't pose a risk because _afterCall checks that the proposal is pending, // thus any modifications to the operation during reentrancy should be caught. // slither-disable-next-line reentrancy-eth function execute( address target, uint256 value, bytes calldata payload, bytes32 predecessor, bytes32 salt ) public payable virtual onlyRoleOrOpenRole(EXECUTOR_ROLE) { bytes32 id = hashOperation(target, value, payload, predecessor, salt); _beforeCall(id, predecessor); _execute(target, value, payload); emit CallExecuted(id, 0, target, value, payload); _afterCall(id); } /** * @dev Execute an (ready) operation containing a batch of transactions. * * Emits one {CallExecuted} event per transaction in the batch. * * Requirements: * * - the caller must have the 'executor' role. */ function executeBatch( address[] calldata targets, uint256[] calldata values, bytes[] calldata payloads, bytes32 predecessor, bytes32 salt ) public payable virtual onlyRoleOrOpenRole(EXECUTOR_ROLE) { require(targets.length == values.length, "TimelockController: length mismatch"); require(targets.length == payloads.length, "TimelockController: length mismatch"); bytes32 id = hashOperationBatch(targets, values, payloads, predecessor, salt); _beforeCall(id, predecessor); for (uint256 i = 0; i < targets.length; ++i) { address target = targets[i]; uint256 value = values[i]; bytes calldata payload = payloads[i]; _execute(target, value, payload); emit CallExecuted(id, i, target, value, payload); } _afterCall(id); } /** * @dev Execute an operation's call. */ function _execute( address target, uint256 value, bytes calldata data ) internal virtual { (bool success, ) = target.call{value: value}(data); require(success, "TimelockController: underlying transaction reverted"); } /** * @dev Checks before execution of an operation's calls. */ function _beforeCall(bytes32 id, bytes32 predecessor) private view { require(isOperationReady(id), "TimelockController: operation is not ready"); require(predecessor == bytes32(0) || isOperationDone(predecessor), "TimelockController: missing dependency"); } /** * @dev Checks after execution of an operation's calls. */ function _afterCall(bytes32 id) private { require(isOperationReady(id), "TimelockController: operation is not ready"); _timestamps[id] = _DONE_TIMESTAMP; } /** * @dev Changes the minimum timelock duration for future operations. * * Emits a {MinDelayChange} event. * * Requirements: * * - the caller must be the timelock itself. This can only be achieved by scheduling and later executing * an operation where the timelock is the target and the data is the ABI-encoded call to this function. */ function updateDelay(uint256 newDelay) external virtual { require(msg.sender == address(this), "TimelockController: caller must be timelock"); emit MinDelayChange(_minDelay, newDelay); _minDelay = newDelay; } /** * @dev See {IERC721Receiver-onERC721Received}. */ function onERC721Received( address, address, uint256, bytes memory ) public virtual override returns (bytes4) { return this.onERC721Received.selector; } /** * @dev See {IERC1155Receiver-onERC1155Received}. */ function onERC1155Received( address, address, uint256, uint256, bytes memory ) public virtual override returns (bytes4) { return this.onERC1155Received.selector; } /** * @dev See {IERC1155Receiver-onERC1155BatchReceived}. */ function onERC1155BatchReceived( address, address, uint256[] memory, uint256[] memory, bytes memory ) public virtual override returns (bytes4) { return this.onERC1155BatchReceived.selector; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (governance/utils/IVotes.sol) pragma solidity ^0.8.0; /** * @dev Common interface for {ERC20Votes}, {ERC721Votes}, and other {Votes}-enabled contracts. * * _Available since v4.5._ */ interface IVotes { /** * @dev Emitted when an account changes their delegate. */ event DelegateChanged(address indexed delegator, address indexed fromDelegate, address indexed toDelegate); /** * @dev Emitted when a token transfer or delegate change results in changes to a delegate's number of votes. */ event DelegateVotesChanged(address indexed delegate, uint256 previousBalance, uint256 newBalance); /** * @dev Returns the current amount of votes that `account` has. */ function getVotes(address account) external view returns (uint256); /** * @dev Returns the amount of votes that `account` had at the end of a past block (`blockNumber`). */ function getPastVotes(address account, uint256 blockNumber) external view returns (uint256); /** * @dev Returns the total supply of votes available at the end of a past block (`blockNumber`). * * NOTE: This value is the sum of all available votes, which is not necessarily the sum of all delegated votes. * Votes that have not been delegated are still part of total supply, even though they would not participate in a * vote. */ function getPastTotalSupply(uint256 blockNumber) external view returns (uint256); /** * @dev Returns the delegate that `account` has chosen. */ function delegates(address account) external view returns (address); /** * @dev Delegates votes from the sender to `delegatee`. */ function delegate(address delegatee) external; /** * @dev Delegates votes from signer to `delegatee`. */ function delegateBySig( address delegatee, uint256 nonce, uint256 expiry, uint8 v, bytes32 r, bytes32 s ) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (token/ERC1155/IERC1155Receiver.sol) pragma solidity ^0.8.0; import "../../utils/introspection/IERC165.sol"; /** * @dev _Available since v3.1._ */ interface IERC1155Receiver is IERC165 { /** * @dev Handles the receipt of a single ERC1155 token type. This function is * called at the end of a `safeTransferFrom` after the balance has been updated. * * NOTE: To accept the transfer, this must return * `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` * (i.e. 0xf23a6e61, or its own function selector). * * @param operator The address which initiated the transfer (i.e. msg.sender) * @param from The address which previously owned the token * @param id The ID of the token being transferred * @param value The amount of tokens being transferred * @param data Additional data with no specified format * @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed */ function onERC1155Received( address operator, address from, uint256 id, uint256 value, bytes calldata data ) external returns (bytes4); /** * @dev Handles the receipt of a multiple ERC1155 token types. This function * is called at the end of a `safeBatchTransferFrom` after the balances have * been updated. * * NOTE: To accept the transfer(s), this must return * `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` * (i.e. 0xbc197c81, or its own function selector). * * @param operator The address which initiated the batch transfer (i.e. msg.sender) * @param from The address which previously owned the token * @param ids An array containing ids of each token being transferred (order and length must match values array) * @param values An array containing amounts of each token being transferred (order and length must match ids array) * @param data Additional data with no specified format * @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed */ function onERC1155BatchReceived( address operator, address from, uint256[] calldata ids, uint256[] calldata values, bytes calldata data ) external returns (bytes4); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol) pragma solidity ^0.8.0; import "../IERC20.sol"; /** * @dev Interface for the optional metadata functions from the ERC20 standard. * * _Available since v4.1._ */ interface IERC20Metadata is IERC20 { /** * @dev Returns the name of the token. */ function name() external view returns (string memory); /** * @dev Returns the symbol of the token. */ function symbol() external view returns (string memory); /** * @dev Returns the decimals places of the token. */ function decimals() external view returns (uint8); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC20 standard as defined in the EIP. */ interface IERC20 { /** * @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); /** * @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 `to`. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transfer(address to, 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 `from` to `to` 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 from, address to, uint256 amount ) external returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol) pragma solidity ^0.8.0; /** * @title ERC721 token receiver interface * @dev Interface for any contract that wants to support safeTransfers * from ERC721 asset contracts. */ interface IERC721Receiver { /** * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom} * by `operator` from `from`, this function is called. * * It must return its Solidity selector to confirm the token transfer. * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted. * * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`. */ function onERC721Received( address operator, address from, uint256 tokenId, bytes calldata data ) external returns (bytes4); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @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 * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 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 /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (utils/Checkpoints.sol) pragma solidity ^0.8.0; import "./math/Math.sol"; import "./math/SafeCast.sol"; /** * @dev This library defines the `History` struct, for checkpointing values as they change at different points in * time, and later looking up past values by block number. See {Votes} as an example. * * To create a history of checkpoints define a variable type `Checkpoints.History` in your contract, and store a new * checkpoint for the current transaction block using the {push} function. * * _Available since v4.5._ */ library Checkpoints { struct Checkpoint { uint32 _blockNumber; uint224 _value; } struct History { Checkpoint[] _checkpoints; } /** * @dev Returns the value in the latest checkpoint, or zero if there are no checkpoints. */ function latest(History storage self) internal view returns (uint256) { uint256 pos = self._checkpoints.length; return pos == 0 ? 0 : self._checkpoints[pos - 1]._value; } /** * @dev Returns the value at a given block number. If a checkpoint is not available at that block, the closest one * before it is returned, or zero otherwise. */ function getAtBlock(History storage self, uint256 blockNumber) internal view returns (uint256) { require(blockNumber < block.number, "Checkpoints: block not yet mined"); uint256 high = self._checkpoints.length; uint256 low = 0; while (low < high) { uint256 mid = Math.average(low, high); if (self._checkpoints[mid]._blockNumber > blockNumber) { high = mid; } else { low = mid + 1; } } return high == 0 ? 0 : self._checkpoints[high - 1]._value; } /** * @dev Pushes a value onto a History so that it is stored as the checkpoint for the current block. * * Returns previous value and new value. */ function push(History storage self, uint256 value) internal returns (uint256, uint256) { uint256 pos = self._checkpoints.length; uint256 old = latest(self); if (pos > 0 && self._checkpoints[pos - 1]._blockNumber == block.number) { self._checkpoints[pos - 1]._value = SafeCast.toUint224(value); } else { self._checkpoints.push( Checkpoint({_blockNumber: SafeCast.toUint32(block.number), _value: SafeCast.toUint224(value)}) ); } return (old, value); } /** * @dev Pushes a value onto a History, by updating the latest value using binary operation `op`. The new value will * be set to `op(latest, delta)`. * * Returns previous value and new value. */ function push( History storage self, function(uint256, uint256) view returns (uint256) op, uint256 delta ) internal returns (uint256, uint256) { return push(self, op(latest(self), delta)); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Context.sol) 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 // OpenZeppelin Contracts v4.4.1 (utils/cryptography/draft-EIP712.sol) 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; address private immutable _CACHED_THIS; 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); _CACHED_THIS = address(this); _TYPE_HASH = typeHash; } /** * @dev Returns the domain separator for the current chain. */ function _domainSeparatorV4() internal view returns (bytes32) { if (address(this) == _CACHED_THIS && 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); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.3) (utils/cryptography/ECDSA.sol) pragma solidity ^0.8.0; import "../Strings.sol"; /** * @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) { 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. /// @solidity memory-safe-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 { 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 = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff); uint8 v = uint8((uint256(vs) >> 255) + 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 Message, created from `s`. 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(bytes memory s) internal pure returns (bytes32) { return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", Strings.toString(s.length), s)); } /** * @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 // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol) 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 // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol) 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 // OpenZeppelin Contracts (last updated v4.7.0) (utils/math/Math.sol) pragma solidity ^0.8.0; /** * @dev Standard math utilities missing in the Solidity language. */ library Math { enum Rounding { Down, // Toward negative infinity Up, // Toward infinity Zero // Toward zero } /** * @dev Returns the largest of two numbers. */ function max(uint256 a, uint256 b) internal pure returns (uint256) { return a >= b ? a : b; } /** * @dev Returns the smallest of two numbers. */ function min(uint256 a, uint256 b) internal pure returns (uint256) { return a < b ? a : b; } /** * @dev Returns the average of two numbers. The result is rounded towards * zero. */ function average(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b) / 2 can overflow. return (a & b) + (a ^ b) / 2; } /** * @dev Returns the ceiling of the division of two numbers. * * This differs from standard division with `/` in that it rounds up instead * of rounding down. */ function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b - 1) / b can overflow on addition, so we distribute. return a == 0 ? 0 : (a - 1) / b + 1; } /** * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0 * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) * with further edits by Uniswap Labs also under MIT license. */ function mulDiv( uint256 x, uint256 y, uint256 denominator ) internal pure returns (uint256 result) { unchecked { // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256 // variables such that product = prod1 * 2^256 + prod0. uint256 prod0; // Least significant 256 bits of the product uint256 prod1; // Most significant 256 bits of the product assembly { let mm := mulmod(x, y, not(0)) prod0 := mul(x, y) prod1 := sub(sub(mm, prod0), lt(mm, prod0)) } // Handle non-overflow cases, 256 by 256 division. if (prod1 == 0) { return prod0 / denominator; } // Make sure the result is less than 2^256. Also prevents denominator == 0. require(denominator > prod1); /////////////////////////////////////////////// // 512 by 256 division. /////////////////////////////////////////////// // Make division exact by subtracting the remainder from [prod1 prod0]. uint256 remainder; assembly { // Compute remainder using mulmod. remainder := mulmod(x, y, denominator) // Subtract 256 bit number from 512 bit number. prod1 := sub(prod1, gt(remainder, prod0)) prod0 := sub(prod0, remainder) } // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1. // See https://cs.stackexchange.com/q/138556/92363. // Does not overflow because the denominator cannot be zero at this stage in the function. uint256 twos = denominator & (~denominator + 1); assembly { // Divide denominator by twos. denominator := div(denominator, twos) // Divide [prod1 prod0] by twos. prod0 := div(prod0, twos) // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one. twos := add(div(sub(0, twos), twos), 1) } // Shift in bits from prod1 into prod0. prod0 |= prod1 * twos; // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for // four bits. That is, denominator * inv = 1 mod 2^4. uint256 inverse = (3 * denominator) ^ 2; // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works // in modular arithmetic, doubling the correct bits in each step. inverse *= 2 - denominator * inverse; // inverse mod 2^8 inverse *= 2 - denominator * inverse; // inverse mod 2^16 inverse *= 2 - denominator * inverse; // inverse mod 2^32 inverse *= 2 - denominator * inverse; // inverse mod 2^64 inverse *= 2 - denominator * inverse; // inverse mod 2^128 inverse *= 2 - denominator * inverse; // inverse mod 2^256 // Because the division is now exact we can divide by multiplying with the modular inverse of denominator. // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1 // is no longer required. result = prod0 * inverse; return result; } } /** * @notice Calculates x * y / denominator with full precision, following the selected rounding direction. */ function mulDiv( uint256 x, uint256 y, uint256 denominator, Rounding rounding ) internal pure returns (uint256) { uint256 result = mulDiv(x, y, denominator); if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) { result += 1; } return result; } /** * @dev Returns the square root of a number. It the number is not a perfect square, the value is rounded down. * * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11). */ function sqrt(uint256 a) internal pure returns (uint256) { if (a == 0) { return 0; } // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target. // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have // `msb(a) <= a < 2*msb(a)`. // We also know that `k`, the position of the most significant bit, is such that `msb(a) = 2**k`. // This gives `2**k < a <= 2**(k+1)` → `2**(k/2) <= sqrt(a) < 2 ** (k/2+1)`. // Using an algorithm similar to the msb conmputation, we are able to compute `result = 2**(k/2)` which is a // good first aproximation of `sqrt(a)` with at least 1 correct bit. uint256 result = 1; uint256 x = a; if (x >> 128 > 0) { x >>= 128; result <<= 64; } if (x >> 64 > 0) { x >>= 64; result <<= 32; } if (x >> 32 > 0) { x >>= 32; result <<= 16; } if (x >> 16 > 0) { x >>= 16; result <<= 8; } if (x >> 8 > 0) { x >>= 8; result <<= 4; } if (x >> 4 > 0) { x >>= 4; result <<= 2; } if (x >> 2 > 0) { result <<= 1; } // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128, // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision // into the expected uint128 result. unchecked { result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; return min(result, a / result); } } /** * @notice Calculates sqrt(a), following the selected rounding direction. */ function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) { uint256 result = sqrt(a); if (rounding == Rounding.Up && result * result < a) { result += 1; } return result; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/math/SafeCast.sol) pragma solidity ^0.8.0; /** * @dev Wrappers over Solidity's uintXX/intXX casting operators with added overflow * checks. * * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can * easily result in undesired exploitation or bugs, since developers usually * assume that overflows raise errors. `SafeCast` restores this intuition by * reverting the transaction when such an operation overflows. * * Using this library instead of the unchecked operations eliminates an entire * class of bugs, so it's recommended to use it always. * * Can be combined with {SafeMath} and {SignedSafeMath} to extend it to smaller types, by performing * all math on `uint256` and `int256` and then downcasting. */ library SafeCast { /** * @dev Returns the downcasted uint248 from uint256, reverting on * overflow (when the input is greater than largest uint248). * * Counterpart to Solidity's `uint248` operator. * * Requirements: * * - input must fit into 248 bits * * _Available since v4.7._ */ function toUint248(uint256 value) internal pure returns (uint248) { require(value <= type(uint248).max, "SafeCast: value doesn't fit in 248 bits"); return uint248(value); } /** * @dev Returns the downcasted uint240 from uint256, reverting on * overflow (when the input is greater than largest uint240). * * Counterpart to Solidity's `uint240` operator. * * Requirements: * * - input must fit into 240 bits * * _Available since v4.7._ */ function toUint240(uint256 value) internal pure returns (uint240) { require(value <= type(uint240).max, "SafeCast: value doesn't fit in 240 bits"); return uint240(value); } /** * @dev Returns the downcasted uint232 from uint256, reverting on * overflow (when the input is greater than largest uint232). * * Counterpart to Solidity's `uint232` operator. * * Requirements: * * - input must fit into 232 bits * * _Available since v4.7._ */ function toUint232(uint256 value) internal pure returns (uint232) { require(value <= type(uint232).max, "SafeCast: value doesn't fit in 232 bits"); return uint232(value); } /** * @dev Returns the downcasted uint224 from uint256, reverting on * overflow (when the input is greater than largest uint224). * * Counterpart to Solidity's `uint224` operator. * * Requirements: * * - input must fit into 224 bits * * _Available since v4.2._ */ function toUint224(uint256 value) internal pure returns (uint224) { require(value <= type(uint224).max, "SafeCast: value doesn't fit in 224 bits"); return uint224(value); } /** * @dev Returns the downcasted uint216 from uint256, reverting on * overflow (when the input is greater than largest uint216). * * Counterpart to Solidity's `uint216` operator. * * Requirements: * * - input must fit into 216 bits * * _Available since v4.7._ */ function toUint216(uint256 value) internal pure returns (uint216) { require(value <= type(uint216).max, "SafeCast: value doesn't fit in 216 bits"); return uint216(value); } /** * @dev Returns the downcasted uint208 from uint256, reverting on * overflow (when the input is greater than largest uint208). * * Counterpart to Solidity's `uint208` operator. * * Requirements: * * - input must fit into 208 bits * * _Available since v4.7._ */ function toUint208(uint256 value) internal pure returns (uint208) { require(value <= type(uint208).max, "SafeCast: value doesn't fit in 208 bits"); return uint208(value); } /** * @dev Returns the downcasted uint200 from uint256, reverting on * overflow (when the input is greater than largest uint200). * * Counterpart to Solidity's `uint200` operator. * * Requirements: * * - input must fit into 200 bits * * _Available since v4.7._ */ function toUint200(uint256 value) internal pure returns (uint200) { require(value <= type(uint200).max, "SafeCast: value doesn't fit in 200 bits"); return uint200(value); } /** * @dev Returns the downcasted uint192 from uint256, reverting on * overflow (when the input is greater than largest uint192). * * Counterpart to Solidity's `uint192` operator. * * Requirements: * * - input must fit into 192 bits * * _Available since v4.7._ */ function toUint192(uint256 value) internal pure returns (uint192) { require(value <= type(uint192).max, "SafeCast: value doesn't fit in 192 bits"); return uint192(value); } /** * @dev Returns the downcasted uint184 from uint256, reverting on * overflow (when the input is greater than largest uint184). * * Counterpart to Solidity's `uint184` operator. * * Requirements: * * - input must fit into 184 bits * * _Available since v4.7._ */ function toUint184(uint256 value) internal pure returns (uint184) { require(value <= type(uint184).max, "SafeCast: value doesn't fit in 184 bits"); return uint184(value); } /** * @dev Returns the downcasted uint176 from uint256, reverting on * overflow (when the input is greater than largest uint176). * * Counterpart to Solidity's `uint176` operator. * * Requirements: * * - input must fit into 176 bits * * _Available since v4.7._ */ function toUint176(uint256 value) internal pure returns (uint176) { require(value <= type(uint176).max, "SafeCast: value doesn't fit in 176 bits"); return uint176(value); } /** * @dev Returns the downcasted uint168 from uint256, reverting on * overflow (when the input is greater than largest uint168). * * Counterpart to Solidity's `uint168` operator. * * Requirements: * * - input must fit into 168 bits * * _Available since v4.7._ */ function toUint168(uint256 value) internal pure returns (uint168) { require(value <= type(uint168).max, "SafeCast: value doesn't fit in 168 bits"); return uint168(value); } /** * @dev Returns the downcasted uint160 from uint256, reverting on * overflow (when the input is greater than largest uint160). * * Counterpart to Solidity's `uint160` operator. * * Requirements: * * - input must fit into 160 bits * * _Available since v4.7._ */ function toUint160(uint256 value) internal pure returns (uint160) { require(value <= type(uint160).max, "SafeCast: value doesn't fit in 160 bits"); return uint160(value); } /** * @dev Returns the downcasted uint152 from uint256, reverting on * overflow (when the input is greater than largest uint152). * * Counterpart to Solidity's `uint152` operator. * * Requirements: * * - input must fit into 152 bits * * _Available since v4.7._ */ function toUint152(uint256 value) internal pure returns (uint152) { require(value <= type(uint152).max, "SafeCast: value doesn't fit in 152 bits"); return uint152(value); } /** * @dev Returns the downcasted uint144 from uint256, reverting on * overflow (when the input is greater than largest uint144). * * Counterpart to Solidity's `uint144` operator. * * Requirements: * * - input must fit into 144 bits * * _Available since v4.7._ */ function toUint144(uint256 value) internal pure returns (uint144) { require(value <= type(uint144).max, "SafeCast: value doesn't fit in 144 bits"); return uint144(value); } /** * @dev Returns the downcasted uint136 from uint256, reverting on * overflow (when the input is greater than largest uint136). * * Counterpart to Solidity's `uint136` operator. * * Requirements: * * - input must fit into 136 bits * * _Available since v4.7._ */ function toUint136(uint256 value) internal pure returns (uint136) { require(value <= type(uint136).max, "SafeCast: value doesn't fit in 136 bits"); return uint136(value); } /** * @dev Returns the downcasted uint128 from uint256, reverting on * overflow (when the input is greater than largest uint128). * * Counterpart to Solidity's `uint128` operator. * * Requirements: * * - input must fit into 128 bits * * _Available since v2.5._ */ function toUint128(uint256 value) internal pure returns (uint128) { require(value <= type(uint128).max, "SafeCast: value doesn't fit in 128 bits"); return uint128(value); } /** * @dev Returns the downcasted uint120 from uint256, reverting on * overflow (when the input is greater than largest uint120). * * Counterpart to Solidity's `uint120` operator. * * Requirements: * * - input must fit into 120 bits * * _Available since v4.7._ */ function toUint120(uint256 value) internal pure returns (uint120) { require(value <= type(uint120).max, "SafeCast: value doesn't fit in 120 bits"); return uint120(value); } /** * @dev Returns the downcasted uint112 from uint256, reverting on * overflow (when the input is greater than largest uint112). * * Counterpart to Solidity's `uint112` operator. * * Requirements: * * - input must fit into 112 bits * * _Available since v4.7._ */ function toUint112(uint256 value) internal pure returns (uint112) { require(value <= type(uint112).max, "SafeCast: value doesn't fit in 112 bits"); return uint112(value); } /** * @dev Returns the downcasted uint104 from uint256, reverting on * overflow (when the input is greater than largest uint104). * * Counterpart to Solidity's `uint104` operator. * * Requirements: * * - input must fit into 104 bits * * _Available since v4.7._ */ function toUint104(uint256 value) internal pure returns (uint104) { require(value <= type(uint104).max, "SafeCast: value doesn't fit in 104 bits"); return uint104(value); } /** * @dev Returns the downcasted uint96 from uint256, reverting on * overflow (when the input is greater than largest uint96). * * Counterpart to Solidity's `uint96` operator. * * Requirements: * * - input must fit into 96 bits * * _Available since v4.2._ */ function toUint96(uint256 value) internal pure returns (uint96) { require(value <= type(uint96).max, "SafeCast: value doesn't fit in 96 bits"); return uint96(value); } /** * @dev Returns the downcasted uint88 from uint256, reverting on * overflow (when the input is greater than largest uint88). * * Counterpart to Solidity's `uint88` operator. * * Requirements: * * - input must fit into 88 bits * * _Available since v4.7._ */ function toUint88(uint256 value) internal pure returns (uint88) { require(value <= type(uint88).max, "SafeCast: value doesn't fit in 88 bits"); return uint88(value); } /** * @dev Returns the downcasted uint80 from uint256, reverting on * overflow (when the input is greater than largest uint80). * * Counterpart to Solidity's `uint80` operator. * * Requirements: * * - input must fit into 80 bits * * _Available since v4.7._ */ function toUint80(uint256 value) internal pure returns (uint80) { require(value <= type(uint80).max, "SafeCast: value doesn't fit in 80 bits"); return uint80(value); } /** * @dev Returns the downcasted uint72 from uint256, reverting on * overflow (when the input is greater than largest uint72). * * Counterpart to Solidity's `uint72` operator. * * Requirements: * * - input must fit into 72 bits * * _Available since v4.7._ */ function toUint72(uint256 value) internal pure returns (uint72) { require(value <= type(uint72).max, "SafeCast: value doesn't fit in 72 bits"); return uint72(value); } /** * @dev Returns the downcasted uint64 from uint256, reverting on * overflow (when the input is greater than largest uint64). * * Counterpart to Solidity's `uint64` operator. * * Requirements: * * - input must fit into 64 bits * * _Available since v2.5._ */ function toUint64(uint256 value) internal pure returns (uint64) { require(value <= type(uint64).max, "SafeCast: value doesn't fit in 64 bits"); return uint64(value); } /** * @dev Returns the downcasted uint56 from uint256, reverting on * overflow (when the input is greater than largest uint56). * * Counterpart to Solidity's `uint56` operator. * * Requirements: * * - input must fit into 56 bits * * _Available since v4.7._ */ function toUint56(uint256 value) internal pure returns (uint56) { require(value <= type(uint56).max, "SafeCast: value doesn't fit in 56 bits"); return uint56(value); } /** * @dev Returns the downcasted uint48 from uint256, reverting on * overflow (when the input is greater than largest uint48). * * Counterpart to Solidity's `uint48` operator. * * Requirements: * * - input must fit into 48 bits * * _Available since v4.7._ */ function toUint48(uint256 value) internal pure returns (uint48) { require(value <= type(uint48).max, "SafeCast: value doesn't fit in 48 bits"); return uint48(value); } /** * @dev Returns the downcasted uint40 from uint256, reverting on * overflow (when the input is greater than largest uint40). * * Counterpart to Solidity's `uint40` operator. * * Requirements: * * - input must fit into 40 bits * * _Available since v4.7._ */ function toUint40(uint256 value) internal pure returns (uint40) { require(value <= type(uint40).max, "SafeCast: value doesn't fit in 40 bits"); return uint40(value); } /** * @dev Returns the downcasted uint32 from uint256, reverting on * overflow (when the input is greater than largest uint32). * * Counterpart to Solidity's `uint32` operator. * * Requirements: * * - input must fit into 32 bits * * _Available since v2.5._ */ function toUint32(uint256 value) internal pure returns (uint32) { require(value <= type(uint32).max, "SafeCast: value doesn't fit in 32 bits"); return uint32(value); } /** * @dev Returns the downcasted uint24 from uint256, reverting on * overflow (when the input is greater than largest uint24). * * Counterpart to Solidity's `uint24` operator. * * Requirements: * * - input must fit into 24 bits * * _Available since v4.7._ */ function toUint24(uint256 value) internal pure returns (uint24) { require(value <= type(uint24).max, "SafeCast: value doesn't fit in 24 bits"); return uint24(value); } /** * @dev Returns the downcasted uint16 from uint256, reverting on * overflow (when the input is greater than largest uint16). * * Counterpart to Solidity's `uint16` operator. * * Requirements: * * - input must fit into 16 bits * * _Available since v2.5._ */ function toUint16(uint256 value) internal pure returns (uint16) { require(value <= type(uint16).max, "SafeCast: value doesn't fit in 16 bits"); return uint16(value); } /** * @dev Returns the downcasted uint8 from uint256, reverting on * overflow (when the input is greater than largest uint8). * * Counterpart to Solidity's `uint8` operator. * * Requirements: * * - input must fit into 8 bits * * _Available since v2.5._ */ function toUint8(uint256 value) internal pure returns (uint8) { require(value <= type(uint8).max, "SafeCast: value doesn't fit in 8 bits"); return uint8(value); } /** * @dev Converts a signed int256 into an unsigned uint256. * * Requirements: * * - input must be greater than or equal to 0. * * _Available since v3.0._ */ function toUint256(int256 value) internal pure returns (uint256) { require(value >= 0, "SafeCast: value must be positive"); return uint256(value); } /** * @dev Returns the downcasted int248 from int256, reverting on * overflow (when the input is less than smallest int248 or * greater than largest int248). * * Counterpart to Solidity's `int248` operator. * * Requirements: * * - input must fit into 248 bits * * _Available since v4.7._ */ function toInt248(int256 value) internal pure returns (int248) { require(value >= type(int248).min && value <= type(int248).max, "SafeCast: value doesn't fit in 248 bits"); return int248(value); } /** * @dev Returns the downcasted int240 from int256, reverting on * overflow (when the input is less than smallest int240 or * greater than largest int240). * * Counterpart to Solidity's `int240` operator. * * Requirements: * * - input must fit into 240 bits * * _Available since v4.7._ */ function toInt240(int256 value) internal pure returns (int240) { require(value >= type(int240).min && value <= type(int240).max, "SafeCast: value doesn't fit in 240 bits"); return int240(value); } /** * @dev Returns the downcasted int232 from int256, reverting on * overflow (when the input is less than smallest int232 or * greater than largest int232). * * Counterpart to Solidity's `int232` operator. * * Requirements: * * - input must fit into 232 bits * * _Available since v4.7._ */ function toInt232(int256 value) internal pure returns (int232) { require(value >= type(int232).min && value <= type(int232).max, "SafeCast: value doesn't fit in 232 bits"); return int232(value); } /** * @dev Returns the downcasted int224 from int256, reverting on * overflow (when the input is less than smallest int224 or * greater than largest int224). * * Counterpart to Solidity's `int224` operator. * * Requirements: * * - input must fit into 224 bits * * _Available since v4.7._ */ function toInt224(int256 value) internal pure returns (int224) { require(value >= type(int224).min && value <= type(int224).max, "SafeCast: value doesn't fit in 224 bits"); return int224(value); } /** * @dev Returns the downcasted int216 from int256, reverting on * overflow (when the input is less than smallest int216 or * greater than largest int216). * * Counterpart to Solidity's `int216` operator. * * Requirements: * * - input must fit into 216 bits * * _Available since v4.7._ */ function toInt216(int256 value) internal pure returns (int216) { require(value >= type(int216).min && value <= type(int216).max, "SafeCast: value doesn't fit in 216 bits"); return int216(value); } /** * @dev Returns the downcasted int208 from int256, reverting on * overflow (when the input is less than smallest int208 or * greater than largest int208). * * Counterpart to Solidity's `int208` operator. * * Requirements: * * - input must fit into 208 bits * * _Available since v4.7._ */ function toInt208(int256 value) internal pure returns (int208) { require(value >= type(int208).min && value <= type(int208).max, "SafeCast: value doesn't fit in 208 bits"); return int208(value); } /** * @dev Returns the downcasted int200 from int256, reverting on * overflow (when the input is less than smallest int200 or * greater than largest int200). * * Counterpart to Solidity's `int200` operator. * * Requirements: * * - input must fit into 200 bits * * _Available since v4.7._ */ function toInt200(int256 value) internal pure returns (int200) { require(value >= type(int200).min && value <= type(int200).max, "SafeCast: value doesn't fit in 200 bits"); return int200(value); } /** * @dev Returns the downcasted int192 from int256, reverting on * overflow (when the input is less than smallest int192 or * greater than largest int192). * * Counterpart to Solidity's `int192` operator. * * Requirements: * * - input must fit into 192 bits * * _Available since v4.7._ */ function toInt192(int256 value) internal pure returns (int192) { require(value >= type(int192).min && value <= type(int192).max, "SafeCast: value doesn't fit in 192 bits"); return int192(value); } /** * @dev Returns the downcasted int184 from int256, reverting on * overflow (when the input is less than smallest int184 or * greater than largest int184). * * Counterpart to Solidity's `int184` operator. * * Requirements: * * - input must fit into 184 bits * * _Available since v4.7._ */ function toInt184(int256 value) internal pure returns (int184) { require(value >= type(int184).min && value <= type(int184).max, "SafeCast: value doesn't fit in 184 bits"); return int184(value); } /** * @dev Returns the downcasted int176 from int256, reverting on * overflow (when the input is less than smallest int176 or * greater than largest int176). * * Counterpart to Solidity's `int176` operator. * * Requirements: * * - input must fit into 176 bits * * _Available since v4.7._ */ function toInt176(int256 value) internal pure returns (int176) { require(value >= type(int176).min && value <= type(int176).max, "SafeCast: value doesn't fit in 176 bits"); return int176(value); } /** * @dev Returns the downcasted int168 from int256, reverting on * overflow (when the input is less than smallest int168 or * greater than largest int168). * * Counterpart to Solidity's `int168` operator. * * Requirements: * * - input must fit into 168 bits * * _Available since v4.7._ */ function toInt168(int256 value) internal pure returns (int168) { require(value >= type(int168).min && value <= type(int168).max, "SafeCast: value doesn't fit in 168 bits"); return int168(value); } /** * @dev Returns the downcasted int160 from int256, reverting on * overflow (when the input is less than smallest int160 or * greater than largest int160). * * Counterpart to Solidity's `int160` operator. * * Requirements: * * - input must fit into 160 bits * * _Available since v4.7._ */ function toInt160(int256 value) internal pure returns (int160) { require(value >= type(int160).min && value <= type(int160).max, "SafeCast: value doesn't fit in 160 bits"); return int160(value); } /** * @dev Returns the downcasted int152 from int256, reverting on * overflow (when the input is less than smallest int152 or * greater than largest int152). * * Counterpart to Solidity's `int152` operator. * * Requirements: * * - input must fit into 152 bits * * _Available since v4.7._ */ function toInt152(int256 value) internal pure returns (int152) { require(value >= type(int152).min && value <= type(int152).max, "SafeCast: value doesn't fit in 152 bits"); return int152(value); } /** * @dev Returns the downcasted int144 from int256, reverting on * overflow (when the input is less than smallest int144 or * greater than largest int144). * * Counterpart to Solidity's `int144` operator. * * Requirements: * * - input must fit into 144 bits * * _Available since v4.7._ */ function toInt144(int256 value) internal pure returns (int144) { require(value >= type(int144).min && value <= type(int144).max, "SafeCast: value doesn't fit in 144 bits"); return int144(value); } /** * @dev Returns the downcasted int136 from int256, reverting on * overflow (when the input is less than smallest int136 or * greater than largest int136). * * Counterpart to Solidity's `int136` operator. * * Requirements: * * - input must fit into 136 bits * * _Available since v4.7._ */ function toInt136(int256 value) internal pure returns (int136) { require(value >= type(int136).min && value <= type(int136).max, "SafeCast: value doesn't fit in 136 bits"); return int136(value); } /** * @dev Returns the downcasted int128 from int256, reverting on * overflow (when the input is less than smallest int128 or * greater than largest int128). * * Counterpart to Solidity's `int128` operator. * * Requirements: * * - input must fit into 128 bits * * _Available since v3.1._ */ function toInt128(int256 value) internal pure returns (int128) { require(value >= type(int128).min && value <= type(int128).max, "SafeCast: value doesn't fit in 128 bits"); return int128(value); } /** * @dev Returns the downcasted int120 from int256, reverting on * overflow (when the input is less than smallest int120 or * greater than largest int120). * * Counterpart to Solidity's `int120` operator. * * Requirements: * * - input must fit into 120 bits * * _Available since v4.7._ */ function toInt120(int256 value) internal pure returns (int120) { require(value >= type(int120).min && value <= type(int120).max, "SafeCast: value doesn't fit in 120 bits"); return int120(value); } /** * @dev Returns the downcasted int112 from int256, reverting on * overflow (when the input is less than smallest int112 or * greater than largest int112). * * Counterpart to Solidity's `int112` operator. * * Requirements: * * - input must fit into 112 bits * * _Available since v4.7._ */ function toInt112(int256 value) internal pure returns (int112) { require(value >= type(int112).min && value <= type(int112).max, "SafeCast: value doesn't fit in 112 bits"); return int112(value); } /** * @dev Returns the downcasted int104 from int256, reverting on * overflow (when the input is less than smallest int104 or * greater than largest int104). * * Counterpart to Solidity's `int104` operator. * * Requirements: * * - input must fit into 104 bits * * _Available since v4.7._ */ function toInt104(int256 value) internal pure returns (int104) { require(value >= type(int104).min && value <= type(int104).max, "SafeCast: value doesn't fit in 104 bits"); return int104(value); } /** * @dev Returns the downcasted int96 from int256, reverting on * overflow (when the input is less than smallest int96 or * greater than largest int96). * * Counterpart to Solidity's `int96` operator. * * Requirements: * * - input must fit into 96 bits * * _Available since v4.7._ */ function toInt96(int256 value) internal pure returns (int96) { require(value >= type(int96).min && value <= type(int96).max, "SafeCast: value doesn't fit in 96 bits"); return int96(value); } /** * @dev Returns the downcasted int88 from int256, reverting on * overflow (when the input is less than smallest int88 or * greater than largest int88). * * Counterpart to Solidity's `int88` operator. * * Requirements: * * - input must fit into 88 bits * * _Available since v4.7._ */ function toInt88(int256 value) internal pure returns (int88) { require(value >= type(int88).min && value <= type(int88).max, "SafeCast: value doesn't fit in 88 bits"); return int88(value); } /** * @dev Returns the downcasted int80 from int256, reverting on * overflow (when the input is less than smallest int80 or * greater than largest int80). * * Counterpart to Solidity's `int80` operator. * * Requirements: * * - input must fit into 80 bits * * _Available since v4.7._ */ function toInt80(int256 value) internal pure returns (int80) { require(value >= type(int80).min && value <= type(int80).max, "SafeCast: value doesn't fit in 80 bits"); return int80(value); } /** * @dev Returns the downcasted int72 from int256, reverting on * overflow (when the input is less than smallest int72 or * greater than largest int72). * * Counterpart to Solidity's `int72` operator. * * Requirements: * * - input must fit into 72 bits * * _Available since v4.7._ */ function toInt72(int256 value) internal pure returns (int72) { require(value >= type(int72).min && value <= type(int72).max, "SafeCast: value doesn't fit in 72 bits"); return int72(value); } /** * @dev Returns the downcasted int64 from int256, reverting on * overflow (when the input is less than smallest int64 or * greater than largest int64). * * Counterpart to Solidity's `int64` operator. * * Requirements: * * - input must fit into 64 bits * * _Available since v3.1._ */ function toInt64(int256 value) internal pure returns (int64) { require(value >= type(int64).min && value <= type(int64).max, "SafeCast: value doesn't fit in 64 bits"); return int64(value); } /** * @dev Returns the downcasted int56 from int256, reverting on * overflow (when the input is less than smallest int56 or * greater than largest int56). * * Counterpart to Solidity's `int56` operator. * * Requirements: * * - input must fit into 56 bits * * _Available since v4.7._ */ function toInt56(int256 value) internal pure returns (int56) { require(value >= type(int56).min && value <= type(int56).max, "SafeCast: value doesn't fit in 56 bits"); return int56(value); } /** * @dev Returns the downcasted int48 from int256, reverting on * overflow (when the input is less than smallest int48 or * greater than largest int48). * * Counterpart to Solidity's `int48` operator. * * Requirements: * * - input must fit into 48 bits * * _Available since v4.7._ */ function toInt48(int256 value) internal pure returns (int48) { require(value >= type(int48).min && value <= type(int48).max, "SafeCast: value doesn't fit in 48 bits"); return int48(value); } /** * @dev Returns the downcasted int40 from int256, reverting on * overflow (when the input is less than smallest int40 or * greater than largest int40). * * Counterpart to Solidity's `int40` operator. * * Requirements: * * - input must fit into 40 bits * * _Available since v4.7._ */ function toInt40(int256 value) internal pure returns (int40) { require(value >= type(int40).min && value <= type(int40).max, "SafeCast: value doesn't fit in 40 bits"); return int40(value); } /** * @dev Returns the downcasted int32 from int256, reverting on * overflow (when the input is less than smallest int32 or * greater than largest int32). * * Counterpart to Solidity's `int32` operator. * * Requirements: * * - input must fit into 32 bits * * _Available since v3.1._ */ function toInt32(int256 value) internal pure returns (int32) { require(value >= type(int32).min && value <= type(int32).max, "SafeCast: value doesn't fit in 32 bits"); return int32(value); } /** * @dev Returns the downcasted int24 from int256, reverting on * overflow (when the input is less than smallest int24 or * greater than largest int24). * * Counterpart to Solidity's `int24` operator. * * Requirements: * * - input must fit into 24 bits * * _Available since v4.7._ */ function toInt24(int256 value) internal pure returns (int24) { require(value >= type(int24).min && value <= type(int24).max, "SafeCast: value doesn't fit in 24 bits"); return int24(value); } /** * @dev Returns the downcasted int16 from int256, reverting on * overflow (when the input is less than smallest int16 or * greater than largest int16). * * Counterpart to Solidity's `int16` operator. * * Requirements: * * - input must fit into 16 bits * * _Available since v3.1._ */ function toInt16(int256 value) internal pure returns (int16) { require(value >= type(int16).min && value <= type(int16).max, "SafeCast: value doesn't fit in 16 bits"); return int16(value); } /** * @dev Returns the downcasted int8 from int256, reverting on * overflow (when the input is less than smallest int8 or * greater than largest int8). * * Counterpart to Solidity's `int8` operator. * * Requirements: * * - input must fit into 8 bits * * _Available since v3.1._ */ function toInt8(int256 value) internal pure returns (int8) { require(value >= type(int8).min && value <= type(int8).max, "SafeCast: value doesn't fit in 8 bits"); return int8(value); } /** * @dev Converts an unsigned uint256 into a signed int256. * * Requirements: * * - input must be less than or equal to maxInt256. * * _Available since v3.0._ */ function toInt256(uint256 value) internal pure returns (int256) { // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive require(value <= uint256(type(int256).max), "SafeCast: value doesn't fit in an int256"); return int256(value); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol) pragma solidity ^0.8.0; /** * @dev String operations. */ library Strings { bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef"; uint8 private constant _ADDRESS_LENGTH = 20; /** * @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); } /** * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation. */ function toHexString(address addr) internal pure returns (string memory) { return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (utils/structs/DoubleEndedQueue.sol) pragma solidity ^0.8.4; import "../math/SafeCast.sol"; /** * @dev A sequence of items with the ability to efficiently push and pop items (i.e. insert and remove) on both ends of * the sequence (called front and back). Among other access patterns, it can be used to implement efficient LIFO and * FIFO queues. Storage use is optimized, and all operations are O(1) constant time. This includes {clear}, given that * the existing queue contents are left in storage. * * The struct is called `Bytes32Deque`. Other types can be cast to and from `bytes32`. This data structure can only be * used in storage, and not in memory. * ``` * DoubleEndedQueue.Bytes32Deque queue; * ``` * * _Available since v4.6._ */ library DoubleEndedQueue { /** * @dev An operation (e.g. {front}) couldn't be completed due to the queue being empty. */ error Empty(); /** * @dev An operation (e.g. {at}) couldn't be completed due to an index being out of bounds. */ error OutOfBounds(); /** * @dev Indices are signed integers because the queue can grow in any direction. They are 128 bits so begin and end * are packed in a single storage slot for efficient access. Since the items are added one at a time we can safely * assume that these 128-bit indices will not overflow, and use unchecked arithmetic. * * Struct members have an underscore prefix indicating that they are "private" and should not be read or written to * directly. Use the functions provided below instead. Modifying the struct manually may violate assumptions and * lead to unexpected behavior. * * Indices are in the range [begin, end) which means the first item is at data[begin] and the last item is at * data[end - 1]. */ struct Bytes32Deque { int128 _begin; int128 _end; mapping(int128 => bytes32) _data; } /** * @dev Inserts an item at the end of the queue. */ function pushBack(Bytes32Deque storage deque, bytes32 value) internal { int128 backIndex = deque._end; deque._data[backIndex] = value; unchecked { deque._end = backIndex + 1; } } /** * @dev Removes the item at the end of the queue and returns it. * * Reverts with `Empty` if the queue is empty. */ function popBack(Bytes32Deque storage deque) internal returns (bytes32 value) { if (empty(deque)) revert Empty(); int128 backIndex; unchecked { backIndex = deque._end - 1; } value = deque._data[backIndex]; delete deque._data[backIndex]; deque._end = backIndex; } /** * @dev Inserts an item at the beginning of the queue. */ function pushFront(Bytes32Deque storage deque, bytes32 value) internal { int128 frontIndex; unchecked { frontIndex = deque._begin - 1; } deque._data[frontIndex] = value; deque._begin = frontIndex; } /** * @dev Removes the item at the beginning of the queue and returns it. * * Reverts with `Empty` if the queue is empty. */ function popFront(Bytes32Deque storage deque) internal returns (bytes32 value) { if (empty(deque)) revert Empty(); int128 frontIndex = deque._begin; value = deque._data[frontIndex]; delete deque._data[frontIndex]; unchecked { deque._begin = frontIndex + 1; } } /** * @dev Returns the item at the beginning of the queue. * * Reverts with `Empty` if the queue is empty. */ function front(Bytes32Deque storage deque) internal view returns (bytes32 value) { if (empty(deque)) revert Empty(); int128 frontIndex = deque._begin; return deque._data[frontIndex]; } /** * @dev Returns the item at the end of the queue. * * Reverts with `Empty` if the queue is empty. */ function back(Bytes32Deque storage deque) internal view returns (bytes32 value) { if (empty(deque)) revert Empty(); int128 backIndex; unchecked { backIndex = deque._end - 1; } return deque._data[backIndex]; } /** * @dev Return the item at a position in the queue given by `index`, with the first item at 0 and last item at * `length(deque) - 1`. * * Reverts with `OutOfBounds` if the index is out of bounds. */ function at(Bytes32Deque storage deque, uint256 index) internal view returns (bytes32 value) { // int256(deque._begin) is a safe upcast int128 idx = SafeCast.toInt128(int256(deque._begin) + SafeCast.toInt256(index)); if (idx >= deque._end) revert OutOfBounds(); return deque._data[idx]; } /** * @dev Resets the queue back to being empty. * * NOTE: The current items are left behind in storage. This does not affect the functioning of the queue, but misses * out on potential gas refunds. */ function clear(Bytes32Deque storage deque) internal { deque._begin = 0; deque._end = 0; } /** * @dev Returns the number of items in the queue. */ function length(Bytes32Deque storage deque) internal view returns (uint256) { // The interface preserves the invariant that begin <= end so we assume this will not overflow. // We also assume there are at most int256.max items in the queue. unchecked { return uint256(int256(deque._end) - int256(deque._begin)); } } /** * @dev Returns true if the queue is empty. */ function empty(Bytes32Deque storage deque) internal view returns (bool) { return deque._end <= deque._begin; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Timers.sol) pragma solidity ^0.8.0; /** * @dev Tooling for timepoints, timers and delays */ library Timers { struct Timestamp { uint64 _deadline; } function getDeadline(Timestamp memory timer) internal pure returns (uint64) { return timer._deadline; } function setDeadline(Timestamp storage timer, uint64 timestamp) internal { timer._deadline = timestamp; } function reset(Timestamp storage timer) internal { timer._deadline = 0; } function isUnset(Timestamp memory timer) internal pure returns (bool) { return timer._deadline == 0; } function isStarted(Timestamp memory timer) internal pure returns (bool) { return timer._deadline > 0; } function isPending(Timestamp memory timer) internal view returns (bool) { return timer._deadline > block.timestamp; } function isExpired(Timestamp memory timer) internal view returns (bool) { return isStarted(timer) && timer._deadline <= block.timestamp; } struct BlockNumber { uint64 _deadline; } function getDeadline(BlockNumber memory timer) internal pure returns (uint64) { return timer._deadline; } function setDeadline(BlockNumber storage timer, uint64 timestamp) internal { timer._deadline = timestamp; } function reset(BlockNumber storage timer) internal { timer._deadline = 0; } function isUnset(BlockNumber memory timer) internal pure returns (bool) { return timer._deadline == 0; } function isStarted(BlockNumber memory timer) internal pure returns (bool) { return timer._deadline > 0; } function isPending(BlockNumber memory timer) internal view returns (bool) { return timer._deadline > block.number; } function isExpired(BlockNumber memory timer) internal view returns (bool) { return isStarted(timer) && timer._deadline <= block.number; } }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "../../plugins/governance/Governance.sol"; library FacadeWriteLib { /// @return The new Governance contract address function deployGovernance( IStRSRVotes stRSR, TimelockController timelock, uint256 votingDelay, uint256 votingPeriod, uint256 proposalThresholdAsMicroPercent, uint256 quorumPercent ) external returns (address) { return address( new Governance( stRSR, timelock, votingDelay, votingPeriod, proposalThresholdAsMicroPercent, quorumPercent ) ); } }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol"; import "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import "../libraries/Fixed.sol"; import "./IMain.sol"; import "./IRewardable.sol"; // Not used directly in the IAsset interface, but used by many consumers to save stack space struct Price { uint192 low; // {UoA/tok} uint192 high; // {UoA/tok} } /** * @title IAsset * @notice Supertype. Any token that interacts with our system must be wrapped in an asset, * whether it is used as RToken backing or not. Any token that can report a price in the UoA * is eligible to be an asset. */ interface IAsset is IRewardable { /// Refresh saved price /// The Reserve protocol calls this at least once per transaction, before relying on /// the Asset's other functions. /// @dev Called immediately after deployment, before use function refresh() external; /// Should not revert /// @return low {UoA/tok} The lower end of the price estimate /// @return high {UoA/tok} The upper end of the price estimate function price() external view returns (uint192 low, uint192 high); /// Should not revert /// lotLow should be nonzero when the asset might be worth selling /// @return lotLow {UoA/tok} The lower end of the lot price estimate /// @return lotHigh {UoA/tok} The upper end of the lot price estimate function lotPrice() external view returns (uint192 lotLow, uint192 lotHigh); /// @return {tok} The balance of the ERC20 in whole tokens function bal(address account) external view returns (uint192); /// @return The ERC20 contract of the token with decimals() available function erc20() external view returns (IERC20Metadata); /// @return The number of decimals in the ERC20; just for gas optimization function erc20Decimals() external view returns (uint8); /// @return If the asset is an instance of ICollateral or not function isCollateral() external view returns (bool); /// @return {UoA} The max trade volume, in UoA function maxTradeVolume() external view returns (uint192); /// @return {s} The timestamp of the last refresh() that saved prices function lastSave() external view returns (uint48); } // Used only in Testing. Strictly speaking an Asset does not need to adhere to this interface interface TestIAsset is IAsset { /// @return The address of the chainlink feed function chainlinkFeed() external view returns (AggregatorV3Interface); /// {1} The max % deviation allowed by the oracle function oracleError() external view returns (uint192); /// @return {s} Seconds that an oracle value is considered valid function oracleTimeout() external view returns (uint48); /// @return {s} Seconds that the lotPrice should decay over, after stale price function priceTimeout() external view returns (uint48); } /// CollateralStatus must obey a linear ordering. That is: /// - being DISABLED is worse than being IFFY, or SOUND /// - being IFFY is worse than being SOUND. enum CollateralStatus { SOUND, IFFY, // When a peg is not holding or a chainlink feed is stale DISABLED // When the collateral has completely defaulted } /// Upgrade-safe maximum operator for CollateralStatus library CollateralStatusComparator { /// @return Whether a is worse than b function worseThan(CollateralStatus a, CollateralStatus b) internal pure returns (bool) { return uint256(a) > uint256(b); } } /** * @title ICollateral * @notice A subtype of Asset that consists of the tokens eligible to back the RToken. */ interface ICollateral is IAsset { /// Emitted whenever the collateral status is changed /// @param newStatus The old CollateralStatus /// @param newStatus The updated CollateralStatus event CollateralStatusChanged( CollateralStatus indexed oldStatus, CollateralStatus indexed newStatus ); /// @dev refresh() /// Refresh exchange rates and update default status. /// VERY IMPORTANT: In any valid implemntation, status() MUST become DISABLED in refresh() if /// refPerTok() has ever decreased since last call. /// @return The canonical name of this collateral's target unit. function targetName() external view returns (bytes32); /// @return The status of this collateral asset. (Is it defaulting? Might it soon?) function status() external view returns (CollateralStatus); // ==== Exchange Rates ==== /// @return {ref/tok} Quantity of whole reference units per whole collateral tokens function refPerTok() external view returns (uint192); /// @return {target/ref} Quantity of whole target units per whole reference unit in the peg function targetPerRef() external view returns (uint192); } // Used only in Testing. Strictly speaking a Collateral does not need to adhere to this interface interface TestICollateral is TestIAsset, ICollateral { /// @return The epoch timestamp when the collateral will default from IFFY to DISABLED function whenDefault() external view returns (uint256); /// @return The amount of time a collateral must be in IFFY status until being DISABLED function delayUntilDefault() external view returns (uint48); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import "./IAsset.sol"; import "./IComponent.sol"; /// A serialization of the AssetRegistry to be passed around in the P1 impl for gas optimization struct Registry { IERC20[] erc20s; IAsset[] assets; } /** * @title IAssetRegistry * @notice The AssetRegistry is in charge of maintaining the ERC20 tokens eligible * to be handled by the rest of the system. If an asset is in the registry, this means: * 1. Its ERC20 contract has been vetted * 2. The asset is the only asset for that ERC20 * 3. The asset can be priced in the UoA, usually via an oracle */ interface IAssetRegistry is IComponent { /// Emitted when an asset is added to the registry /// @param erc20 The ERC20 contract for the asset /// @param asset The asset contract added to the registry event AssetRegistered(IERC20 indexed erc20, IAsset indexed asset); /// Emitted when an asset is removed from the registry /// @param erc20 The ERC20 contract for the asset /// @param asset The asset contract removed from the registry event AssetUnregistered(IERC20 indexed erc20, IAsset indexed asset); // Initialization function init(IMain main_, IAsset[] memory assets_) external; /// Fully refresh all asset state /// @custom:interaction function refresh() external; /// Register `asset` /// If either the erc20 address or the asset was already registered, fail /// @return true if the erc20 address was not already registered. /// @custom:governance function register(IAsset asset) external returns (bool); /// Register `asset` if and only if its erc20 address is already registered. /// If the erc20 address was not registered, revert. /// @return swapped If the asset was swapped for a previously-registered asset /// @custom:governance function swapRegistered(IAsset asset) external returns (bool swapped); /// Unregister an asset, requiring that it is already registered /// @custom:governance function unregister(IAsset asset) external; /// @return {s} The timestamp of the last refresh function lastRefresh() external view returns (uint48); /// @return The corresponding asset for ERC20, or reverts if not registered function toAsset(IERC20 erc20) external view returns (IAsset); /// @return The corresponding collateral, or reverts if unregistered or not collateral function toColl(IERC20 erc20) external view returns (ICollateral); /// @return If the ERC20 is registered function isRegistered(IERC20 erc20) external view returns (bool); /// @return A list of all registered ERC20s function erc20s() external view returns (IERC20[] memory); /// @return reg The list of registered ERC20s and Assets, in the same order function getRegistry() external view returns (Registry memory reg); /// @return The number of registered ERC20s function size() external view returns (uint256); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import "./IBroker.sol"; import "./IComponent.sol"; import "./ITrading.sol"; /** * @title IBackingManager * @notice The BackingManager handles changes in the ERC20 balances that back an RToken. * - It computes which trades to perform, if any, and initiates these trades with the Broker. * - rebalance() * - If already collateralized, excess assets are transferred to RevenueTraders. * - forwardRevenue(IERC20[] calldata erc20s) */ interface IBackingManager is IComponent, ITrading { /// Emitted when the trading delay is changed /// @param oldVal The old trading delay /// @param newVal The new trading delay event TradingDelaySet(uint48 oldVal, uint48 newVal); /// Emitted when the backing buffer is changed /// @param oldVal The old backing buffer /// @param newVal The new backing buffer event BackingBufferSet(uint192 oldVal, uint192 newVal); // Initialization function init( IMain main_, uint48 tradingDelay_, uint192 backingBuffer_, uint192 maxTradeSlippage_, uint192 minTradeVolume_ ) external; // Give RToken max allowance over a registered token /// @custom:refresher /// @custom:interaction function grantRTokenAllowance(IERC20) external; /// Apply the overall backing policy using the specified TradeKind, taking a haircut if unable /// @param kind TradeKind.DUTCH_AUCTION or TradeKind.BATCH_AUCTION /// @custom:interaction RCEI function rebalance(TradeKind kind) external; /// Forward revenue to RevenueTraders; reverts if not fully collateralized /// @param erc20s The tokens to forward /// @custom:interaction RCEI function forwardRevenue(IERC20[] calldata erc20s) external; } interface TestIBackingManager is IBackingManager, TestITrading { function tradingDelay() external view returns (uint48); function backingBuffer() external view returns (uint192); function setTradingDelay(uint48 val) external; function setBackingBuffer(uint192 val) external; }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import "../libraries/Fixed.sol"; import "./IAsset.sol"; import "./IComponent.sol"; struct BasketRange { uint192 bottom; // {BU} uint192 top; // {BU} } /** * @title IBasketHandler * @notice The BasketHandler aims to maintain a reference basket of constant target unit amounts. * When a collateral token defaults, a new reference basket of equal target units is set. * When _all_ collateral tokens default for a target unit, only then is the basket allowed to fall * in terms of target unit amounts. The basket is considered defaulted in this case. */ interface IBasketHandler is IComponent { /// Emitted when the prime basket is set /// @param erc20s The collateral tokens for the prime basket /// @param targetAmts {target/BU} A list of quantities of target unit per basket unit /// @param targetNames Each collateral token's targetName event PrimeBasketSet(IERC20[] erc20s, uint192[] targetAmts, bytes32[] targetNames); /// Emitted when the reference basket is set /// @param nonce {basketNonce} The basket nonce /// @param erc20s The list of collateral tokens in the reference basket /// @param refAmts {ref/BU} The reference amounts of the basket collateral tokens /// @param disabled True when the list of erc20s + refAmts may not be correct event BasketSet(uint256 indexed nonce, IERC20[] erc20s, uint192[] refAmts, bool disabled); /// Emitted when a backup config is set for a target unit /// @param targetName The name of the target unit as a bytes32 /// @param max The max number to use from `erc20s` /// @param erc20s The set of backup collateral tokens event BackupConfigSet(bytes32 indexed targetName, uint256 max, IERC20[] erc20s); /// Emitted when the warmup period is changed /// @param oldVal The old warmup period /// @param newVal The new warmup period event WarmupPeriodSet(uint48 oldVal, uint48 newVal); /// Emitted when the status of a basket has changed /// @param oldStatus The previous basket status /// @param newStatus The new basket status event BasketStatusChanged(CollateralStatus oldStatus, CollateralStatus newStatus); // Initialization function init(IMain main_, uint48 warmupPeriod_) external; /// Set the prime basket /// @param erc20s The collateral tokens for the new prime basket /// @param targetAmts The target amounts (in) {target/BU} for the new prime basket /// required range: 1e9 values; absolute range irrelevant. /// @custom:governance function setPrimeBasket(IERC20[] memory erc20s, uint192[] memory targetAmts) external; /// Set the backup configuration for a given target /// @param targetName The name of the target as a bytes32 /// @param max The maximum number of collateral tokens to use from this target /// Required range: 1-255 /// @param erc20s A list of ordered backup collateral tokens /// @custom:governance function setBackupConfig( bytes32 targetName, uint256 max, IERC20[] calldata erc20s ) external; /// Default the basket in order to schedule a basket refresh /// @custom:protected function disableBasket() external; /// Governance-controlled setter to cause a basket switch explicitly /// @custom:governance /// @custom:interaction function refreshBasket() external; /// Track the basket status changes /// @custom:refresher function trackStatus() external; /// @return If the BackingManager has sufficient collateral to redeem the entire RToken supply function fullyCollateralized() external view returns (bool); /// @return status The worst CollateralStatus of all collateral in the basket function status() external view returns (CollateralStatus status); /// @return If the basket is ready to issue and trade function isReady() external view returns (bool); /// @param erc20 The ERC20 token contract for the asset /// @return {tok/BU} The whole token quantity of token in the reference basket /// Returns 0 if erc20 is not registered or not in the basket /// Returns FIX_MAX (in lieu of +infinity) if Collateral.refPerTok() is 0. /// Otherwise, returns (token's basket.refAmts / token's Collateral.refPerTok()) function quantity(IERC20 erc20) external view returns (uint192); /// Like quantity(), but unsafe because it DOES NOT CONFIRM THAT THE ASSET IS CORRECT /// @param erc20 The ERC20 token contract for the asset /// @param asset The registered asset plugin contract for the erc20 /// @return {tok/BU} The whole token quantity of token in the reference basket /// Returns 0 if erc20 is not registered or not in the basket /// Returns FIX_MAX (in lieu of +infinity) if Collateral.refPerTok() is 0. /// Otherwise, returns (token's basket.refAmts / token's Collateral.refPerTok()) function quantityUnsafe(IERC20 erc20, IAsset asset) external view returns (uint192); /// @param amount {BU} /// @return erc20s The addresses of the ERC20 tokens in the reference basket /// @return quantities {qTok} The quantity of each ERC20 token to issue `amount` baskets function quote(uint192 amount, RoundingMode rounding) external view returns (address[] memory erc20s, uint256[] memory quantities); /// Return the redemption value of `amount` BUs for a linear combination of historical baskets /// @param basketNonces An array of basket nonces to do redemption from /// @param portions {1} An array of Fix quantities that must add up to FIX_ONE /// @param amount {BU} /// @return erc20s The backing collateral erc20s /// @return quantities {qTok} ERC20 token quantities equal to `amount` BUs function quoteCustomRedemption( uint48[] memory basketNonces, uint192[] memory portions, uint192 amount ) external view returns (address[] memory erc20s, uint256[] memory quantities); /// @return top {BU} The number of partial basket units: e.g max(coll.map((c) => c.balAsBUs()) /// bottom {BU} The number of whole basket units held by the account function basketsHeldBy(address account) external view returns (BasketRange memory); /// Should not revert /// @return low {UoA/BU} The lower end of the price estimate /// @return high {UoA/BU} The upper end of the price estimate function price() external view returns (uint192 low, uint192 high); /// Should not revert /// lotLow should be nonzero if a BU could be worth selling /// @return lotLow {UoA/tok} The lower end of the lot price estimate /// @return lotHigh {UoA/tok} The upper end of the lot price estimate function lotPrice() external view returns (uint192 lotLow, uint192 lotHigh); /// @return timestamp The timestamp at which the basket was last set function timestamp() external view returns (uint48); /// @return The current basket nonce, regardless of status function nonce() external view returns (uint48); } interface TestIBasketHandler is IBasketHandler { function warmupPeriod() external view returns (uint48); function setWarmupPeriod(uint48 val) external; }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "./IAsset.sol"; import "./IComponent.sol"; import "./IGnosis.sol"; import "./ITrade.sol"; enum TradeKind { DUTCH_AUCTION, BATCH_AUCTION } /// Cache of all (lot) prices for a pair to prevent re-lookup struct TradePrices { uint192 sellLow; // {UoA/sellTok} can be 0 uint192 sellHigh; // {UoA/sellTok} should not be 0 uint192 buyLow; // {UoA/buyTok} should not be 0 uint192 buyHigh; // {UoA/buyTok} should not be 0 or FIX_MAX } /// The data format that describes a request for trade with the Broker struct TradeRequest { IAsset sell; IAsset buy; uint256 sellAmount; // {qSellTok} uint256 minBuyAmount; // {qBuyTok} } /** * @title IBroker * @notice The Broker deploys oneshot Trade contracts for Traders and monitors * the continued proper functioning of trading platforms. */ interface IBroker is IComponent { event GnosisSet(IGnosis oldVal, IGnosis newVal); event BatchTradeImplementationSet(ITrade oldVal, ITrade newVal); event DutchTradeImplementationSet(ITrade oldVal, ITrade newVal); event BatchAuctionLengthSet(uint48 oldVal, uint48 newVal); event DutchAuctionLengthSet(uint48 oldVal, uint48 newVal); event BatchTradeDisabledSet(bool prevVal, bool newVal); event DutchTradeDisabledSet(IERC20Metadata indexed erc20, bool prevVal, bool newVal); // Initialization function init( IMain main_, IGnosis gnosis_, ITrade batchTradeImplemention_, uint48 batchAuctionLength_, ITrade dutchTradeImplemention_, uint48 dutchAuctionLength_ ) external; /// Request a trade from the broker /// @dev Requires setting an allowance in advance /// @custom:interaction function openTrade( TradeKind kind, TradeRequest memory req, TradePrices memory prices ) external returns (ITrade); /// Only callable by one of the trading contracts the broker deploys function reportViolation() external; function batchTradeDisabled() external view returns (bool); function dutchTradeDisabled(IERC20Metadata erc20) external view returns (bool); } interface TestIBroker is IBroker { function gnosis() external view returns (IGnosis); function batchTradeImplementation() external view returns (ITrade); function dutchTradeImplementation() external view returns (ITrade); function batchAuctionLength() external view returns (uint48); function dutchAuctionLength() external view returns (uint48); function setGnosis(IGnosis newGnosis) external; function setBatchTradeImplementation(ITrade newTradeImplementation) external; function setBatchAuctionLength(uint48 newAuctionLength) external; function setDutchTradeImplementation(ITrade newTradeImplementation) external; function setDutchAuctionLength(uint48 newAuctionLength) external; function enableBatchTrade() external; function enableDutchTrade(IERC20Metadata erc20) external; // only present on pre-3.0.0 Brokers; used by EasyAuction regression test function disabled() external view returns (bool); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "./IMain.sol"; import "./IVersioned.sol"; /** * @title IComponent * @notice A Component is the central building block of all our system contracts. Components * contain important state that must be migrated during upgrades, and they delegate * their ownership to Main's owner. */ interface IComponent is IVersioned { function main() external view returns (IMain); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import "../libraries/Throttle.sol"; import "./IAsset.sol"; import "./IDistributor.sol"; import "./IGnosis.sol"; import "./IMain.sol"; import "./IRToken.sol"; import "./IStRSR.sol"; import "./ITrade.sol"; import "./IVersioned.sol"; /** * @title DeploymentParams * @notice The set of protocol params needed to configure a new system deployment. * meaning that after deployment there is freedom to allow parametrizations to deviate. */ struct DeploymentParams { // === Revenue sharing === RevenueShare dist; // revenue sharing splits between RToken and RSR // // === Trade sizing === uint192 minTradeVolume; // {UoA} uint192 rTokenMaxTradeVolume; // {UoA} // // === Freezing === uint48 shortFreeze; // {s} how long an initial freeze lasts uint48 longFreeze; // {s} how long each freeze extension lasts // // === Rewards (Furnace + StRSR) === uint192 rewardRatio; // the fraction of available revenues that are paid out each block period // // === StRSR === uint48 unstakingDelay; // {s} the "thawing time" of staked RSR before withdrawal uint192 withdrawalLeak; // {1} fraction of RSR that can be withdrawn without refresh // // === BasketHandler === uint48 warmupPeriod; // {s} how long to wait until issuance/trading after regaining SOUND // // === BackingManager === uint48 tradingDelay; // {s} how long to wait until starting auctions after switching basket uint48 batchAuctionLength; // {s} the length of a Gnosis EasyAuction uint48 dutchAuctionLength; // {s} the length of a falling-price dutch auction uint192 backingBuffer; // {1} how much extra backing collateral to keep uint192 maxTradeSlippage; // {1} max slippage acceptable in a trade // // === RToken Supply Throttles === ThrottleLib.Params issuanceThrottle; // see ThrottleLib ThrottleLib.Params redemptionThrottle; } /** * @title Implementations * @notice The set of implementation contracts to be used for proxies in the Deployer */ struct Implementations { IMain main; Components components; TradePlugins trading; } struct TradePlugins { ITrade gnosisTrade; ITrade dutchTrade; } /** * @title IDeployer * @notice Factory contract for an RToken system instance */ interface IDeployer is IVersioned { /// Emitted when a new RToken and accompanying system is deployed /// @param main The address of `Main` /// @param rToken The address of the RToken ERC20 /// @param stRSR The address of the StRSR ERC20 staking pool/token /// @param owner The owner of the newly deployed system /// @param version The semantic versioning version string (see: https://semver.org) event RTokenCreated( IMain indexed main, IRToken indexed rToken, IStRSR stRSR, address indexed owner, string version ); /// Emitted when a new RTokenAsset is deployed during `deployRTokenAsset` /// @param rToken The address of the RToken ERC20 /// @param rTokenAsset The address of the RTokenAsset event RTokenAssetCreated(IRToken indexed rToken, IAsset rTokenAsset); // /// Deploys an instance of the entire system /// @param name The name of the RToken to deploy /// @param symbol The symbol of the RToken to deploy /// @param mandate An IPFS link or direct string; describes what the RToken _should be_ /// @param owner The address that should own the entire system, hopefully a governance contract /// @param params Deployment params /// @return The address of the newly deployed Main instance. function deploy( string calldata name, string calldata symbol, string calldata mandate, address owner, DeploymentParams calldata params ) external returns (address); /// Deploys a new RTokenAsset instance. Not needed during normal deployment flow /// @param maxTradeVolume {UoA} The maximum trade volume for the RTokenAsset function deployRTokenAsset(IRToken rToken, uint192 maxTradeVolume) external returns (IAsset); } interface TestIDeployer is IDeployer { /// A top-level ENS domain that should always point to the latest Deployer instance // solhint-disable-next-line func-name-mixedcase function ENS() external view returns (string memory); function rsr() external view returns (IERC20Metadata); function gnosis() external view returns (IGnosis); function rsrAsset() external view returns (IAsset); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import "./IComponent.sol"; uint256 constant MAX_DISTRIBUTION = 1e4; // 10,000 uint8 constant MAX_DESTINATIONS = 100; // maximum number of RevenueShare destinations struct RevenueShare { uint16 rTokenDist; // {revShare} A value between [0, 10,000] uint16 rsrDist; // {revShare} A value between [0, 10,000] } /// Assumes no more than 100 independent distributions. struct RevenueTotals { uint24 rTokenTotal; // {revShare} uint24 rsrTotal; // {revShare} } /** * @title IDistributor * @notice The Distributor Component maintains a revenue distribution table that dictates * how to divide revenue across the Furnace, StRSR, and any other destinations. */ interface IDistributor is IComponent { /// Emitted when a distribution is set /// @param dest The address set to receive the distribution /// @param rTokenDist The distribution of RToken that should go to `dest` /// @param rsrDist The distribution of RSR that should go to `dest` event DistributionSet(address indexed dest, uint16 rTokenDist, uint16 rsrDist); /// Emitted when revenue is distributed /// @param erc20 The token being distributed, either RSR or the RToken itself /// @param source The address providing the revenue /// @param amount The amount of the revenue event RevenueDistributed(IERC20 indexed erc20, address indexed source, uint256 amount); // Initialization function init(IMain main_, RevenueShare memory dist) external; /// @custom:governance function setDistribution(address dest, RevenueShare memory share) external; /// Distribute the `erc20` token across all revenue destinations /// Only callable by RevenueTraders /// @custom:protected function distribute(IERC20 erc20, uint256 amount) external; /// @return revTotals The total of all destinations function totals() external view returns (RevenueTotals memory revTotals); } interface TestIDistributor is IDistributor { // solhint-disable-next-line func-name-mixedcase function FURNACE() external view returns (address); // solhint-disable-next-line func-name-mixedcase function ST_RSR() external view returns (address); /// @return rTokenDist The RToken distribution for the address /// @return rsrDist The RSR distribution for the address function distribution(address) external view returns (uint16 rTokenDist, uint16 rsrDist); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "./IDeployer.sol"; /** * @title ConfigurationParams * @notice The set of protocol params needed to deploy an RToken */ struct ConfigurationParams { // === RToken info === string name; string symbol; string mandate; // === Deployer params === DeploymentParams params; } /** * @title SetupParams * @notice The set of protocol params needed to setup a full instance of an RToken */ struct SetupParams { // === Assets === IAsset[] assets; // === Basket === ICollateral[] primaryBasket; uint192[] weights; // === Basket Backup === BackupInfo[] backups; // === Beneficiaries - Revenue Sharing === BeneficiaryInfo[] beneficiaries; } /** * @title BackupInfo * @notice The set of params to define a basket backup */ struct BackupInfo { bytes32 backupUnit; uint256 diversityFactor; ICollateral[] backupCollateral; } /** * @title BeneficiaryInfo * @notice The set of params to define a beneficiary */ struct BeneficiaryInfo { address beneficiary; RevenueShare revShare; } /** * @title GovernanceParams * @notice The set of params required to setup decentralized governance */ struct GovernanceParams { uint256 votingDelay; // in blocks uint256 votingPeriod; // in blocks uint256 proposalThresholdAsMicroPercent; // e.g. 1e4 for 0.01% uint256 quorumPercent; // e.g 4 for 4% uint256 timelockDelay; // in seconds (used for timelock) } /** * @title GovernanceRoles * @notice The set of roles required (owner, guardian, pausers, and freezers) */ struct GovernanceRoles { address owner; address guardian; address[] pausers; address[] shortFreezers; address[] longFreezers; } /** * @title IFacadeWrite * @notice A UX-friendly layer for interactin with the protocol */ interface IFacadeWrite { /// Emitted when a new Governance is deployed /// @param rToken The address of the RToken /// @param governance The address of the new governance /// @param timelock The address of the timelock event GovernanceCreated( IRToken indexed rToken, address indexed governance, address indexed timelock ); /// Deploys an instance of an RToken function deployRToken(ConfigurationParams calldata config, SetupParams calldata setup) external returns (address); /// Sets up governance for an RToken function setupGovernance( IRToken rToken, bool deployGovernance, bool unfreeze, GovernanceParams calldata govParams, GovernanceRoles calldata govRoles ) external returns (address); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "../libraries/Fixed.sol"; import "./IComponent.sol"; /** * @title IFurnace * @notice A helper contract to burn RTokens slowly and permisionlessly. */ interface IFurnace is IComponent { // Initialization function init(IMain main_, uint192 ratio_) external; /// Emitted when the melting ratio is changed /// @param oldRatio The old ratio /// @param newRatio The new ratio event RatioSet(uint192 oldRatio, uint192 newRatio); function ratio() external view returns (uint192); /// Needed value range: [0, 1], granularity 1e-9 /// @custom:governance function setRatio(uint192) external; /// Performs any RToken melting that has vested since the last payout. /// @custom:refresher function melt() external; } interface TestIFurnace is IFurnace { function lastPayout() external view returns (uint256); function lastPayoutBal() external view returns (uint256); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; struct GnosisAuctionData { IERC20 auctioningToken; IERC20 biddingToken; uint256 orderCancellationEndDate; uint256 auctionEndDate; bytes32 initialAuctionOrder; uint256 minimumBiddingAmountPerOrder; uint256 interimSumBidAmount; bytes32 interimOrder; bytes32 clearingPriceOrder; uint96 volumeClearingPriceOrder; bool minFundingThresholdNotReached; bool isAtomicClosureAllowed; uint256 feeNumerator; uint256 minFundingThreshold; } /// The relevant portion of the interface of the live Gnosis EasyAuction contract /// https://github.com/gnosis/ido-contracts/blob/main/contracts/EasyAuction.sol interface IGnosis { function initiateAuction( IERC20 auctioningToken, IERC20 biddingToken, uint256 orderCancellationEndDate, uint256 auctionEndDate, uint96 auctionedSellAmount, uint96 minBuyAmount, uint256 minimumBiddingAmountPerOrder, uint256 minFundingThreshold, bool isAtomicClosureAllowed, address accessManagerContract, bytes memory accessManagerContractData ) external returns (uint256 auctionId); function auctionData(uint256 auctionId) external view returns (GnosisAuctionData memory); /// @param auctionId The external auction id /// @dev See here for decoding: https://git.io/JMang /// @return encodedOrder The order, encoded in a bytes 32 function settleAuction(uint256 auctionId) external returns (bytes32 encodedOrder); /// @return The numerator over a 1000-valued denominator function feeNumerator() external returns (uint256); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts-upgradeable/access/IAccessControlUpgradeable.sol"; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import "./IAssetRegistry.sol"; import "./IBasketHandler.sol"; import "./IBackingManager.sol"; import "./IBroker.sol"; import "./IGnosis.sol"; import "./IFurnace.sol"; import "./IDistributor.sol"; import "./IRToken.sol"; import "./IRevenueTrader.sol"; import "./IStRSR.sol"; import "./ITrading.sol"; import "./IVersioned.sol"; // === Auth roles === bytes32 constant OWNER = bytes32(bytes("OWNER")); bytes32 constant SHORT_FREEZER = bytes32(bytes("SHORT_FREEZER")); bytes32 constant LONG_FREEZER = bytes32(bytes("LONG_FREEZER")); bytes32 constant PAUSER = bytes32(bytes("PAUSER")); /** * Main is a central hub that maintains a list of Component contracts. * * Components: * - perform a specific function * - defer auth to Main * - usually (but not always) contain sizeable state that require a proxy */ struct Components { // Definitely need proxy IRToken rToken; IStRSR stRSR; IAssetRegistry assetRegistry; IBasketHandler basketHandler; IBackingManager backingManager; IDistributor distributor; IFurnace furnace; IBroker broker; IRevenueTrader rsrTrader; IRevenueTrader rTokenTrader; } interface IAuth is IAccessControlUpgradeable { /// Emitted when `unfreezeAt` is changed /// @param oldVal The old value of `unfreezeAt` /// @param newVal The new value of `unfreezeAt` event UnfreezeAtSet(uint48 oldVal, uint48 newVal); /// Emitted when the short freeze duration governance param is changed /// @param oldDuration The old short freeze duration /// @param newDuration The new short freeze duration event ShortFreezeDurationSet(uint48 oldDuration, uint48 newDuration); /// Emitted when the long freeze duration governance param is changed /// @param oldDuration The old long freeze duration /// @param newDuration The new long freeze duration event LongFreezeDurationSet(uint48 oldDuration, uint48 newDuration); /// Emitted when the system is paused or unpaused for trading /// @param oldVal The old value of `tradingPaused` /// @param newVal The new value of `tradingPaused` event TradingPausedSet(bool oldVal, bool newVal); /// Emitted when the system is paused or unpaused for issuance /// @param oldVal The old value of `issuancePaused` /// @param newVal The new value of `issuancePaused` event IssuancePausedSet(bool oldVal, bool newVal); /** * Trading Paused: Disable everything except for OWNER actions, RToken.issue, RToken.redeem, * StRSR.stake, and StRSR.payoutRewards * Issuance Paused: Disable RToken.issue * Frozen: Disable everything except for OWNER actions + StRSR.stake (for governance) */ function tradingPausedOrFrozen() external view returns (bool); function issuancePausedOrFrozen() external view returns (bool); function frozen() external view returns (bool); function shortFreeze() external view returns (uint48); function longFreeze() external view returns (uint48); // ==== // onlyRole(OWNER) function freezeForever() external; // onlyRole(SHORT_FREEZER) function freezeShort() external; // onlyRole(LONG_FREEZER) function freezeLong() external; // onlyRole(OWNER) function unfreeze() external; function pauseTrading() external; function unpauseTrading() external; function pauseIssuance() external; function unpauseIssuance() external; } interface IComponentRegistry { // === Component setters/getters === event RTokenSet(IRToken indexed oldVal, IRToken indexed newVal); function rToken() external view returns (IRToken); event StRSRSet(IStRSR oldVal, IStRSR newVal); function stRSR() external view returns (IStRSR); event AssetRegistrySet(IAssetRegistry oldVal, IAssetRegistry newVal); function assetRegistry() external view returns (IAssetRegistry); event BasketHandlerSet(IBasketHandler oldVal, IBasketHandler newVal); function basketHandler() external view returns (IBasketHandler); event BackingManagerSet(IBackingManager oldVal, IBackingManager newVal); function backingManager() external view returns (IBackingManager); event DistributorSet(IDistributor oldVal, IDistributor newVal); function distributor() external view returns (IDistributor); event RSRTraderSet(IRevenueTrader oldVal, IRevenueTrader newVal); function rsrTrader() external view returns (IRevenueTrader); event RTokenTraderSet(IRevenueTrader oldVal, IRevenueTrader newVal); function rTokenTrader() external view returns (IRevenueTrader); event FurnaceSet(IFurnace oldVal, IFurnace newVal); function furnace() external view returns (IFurnace); event BrokerSet(IBroker oldVal, IBroker newVal); function broker() external view returns (IBroker); } /** * @title IMain * @notice The central hub for the entire system. Maintains components and an owner singleton role */ interface IMain is IVersioned, IAuth, IComponentRegistry { function poke() external; // not used in p1 // === Initialization === event MainInitialized(); function init( Components memory components, IERC20 rsr_, uint48 shortFreeze_, uint48 longFreeze_ ) external; function rsr() external view returns (IERC20); } interface TestIMain is IMain { /// @custom:governance function setShortFreeze(uint48) external; /// @custom:governance function setLongFreeze(uint48) external; function shortFreeze() external view returns (uint48); function longFreeze() external view returns (uint48); function longFreezes(address account) external view returns (uint256); function tradingPaused() external view returns (bool); function issuancePaused() external view returns (bool); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "./IBroker.sol"; import "./IComponent.sol"; import "./ITrading.sol"; /** * @title IRevenueTrader * @notice The RevenueTrader is an extension of the trading mixin that trades all * assets at its address for a single target asset. There are two runtime instances * of the RevenueTrader, 1 for RToken and 1 for RSR. */ interface IRevenueTrader is IComponent, ITrading { // Initialization function init( IMain main_, IERC20 tokenToBuy_, uint192 maxTradeSlippage_, uint192 minTradeVolume_ ) external; /// Distribute tokenToBuy to its destinations /// @dev Special-case of manageTokens() /// @custom:interaction function distributeTokenToBuy() external; /// Return registered ERC20s to the BackingManager if distribution for tokenToBuy is 0 /// @custom:interaction function returnTokens(IERC20[] memory erc20s) external; /// Process some number of tokens /// If the tokenToBuy is included in erc20s, RevenueTrader will distribute it at end of the tx /// @param erc20s The ERC20s to manage; can be tokenToBuy or anything registered /// @param kinds The kinds of auctions to launch: DUTCH_AUCTION | BATCH_AUCTION /// @custom:interaction function manageTokens(IERC20[] memory erc20s, TradeKind[] memory kinds) external; function tokenToBuy() external view returns (IERC20); } // solhint-disable-next-line no-empty-blocks interface TestIRevenueTrader is IRevenueTrader, TestITrading { }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import "./IComponent.sol"; import "./IMain.sol"; /** * @title IRewardable * @notice A simple interface mixin to support claiming of rewards. */ interface IRewardable { /// Emitted whenever a reward token balance is claimed event RewardsClaimed(IERC20 indexed erc20, uint256 amount); /// Claim rewards earned by holding a balance of the ERC20 token /// Must emit `RewardsClaimed` for each token rewards are claimed for /// @custom:interaction function claimRewards() external; } /** * @title IRewardableComponent * @notice A simple interface mixin to support claiming of rewards. */ interface IRewardableComponent is IRewardable { /// Claim rewards for a single ERC20 /// Must emit `RewardsClaimed` for each token rewards are claimed for /// @custom:interaction function claimRewardsSingle(IERC20 erc20) external; }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20MetadataUpgradeable.sol"; // solhint-disable-next-line max-line-length import "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/draft-IERC20PermitUpgradeable.sol"; import "../libraries/Fixed.sol"; import "../libraries/Throttle.sol"; import "./IAsset.sol"; import "./IComponent.sol"; import "./IMain.sol"; import "./IRewardable.sol"; /** * @title IRToken * @notice An RToken is an ERC20 that is permissionlessly issuable/redeemable and tracks an * exchange rate against a single unit: baskets, or {BU} in our type notation. */ interface IRToken is IComponent, IERC20MetadataUpgradeable, IERC20PermitUpgradeable { /// Emitted when an issuance of RToken occurs, whether it occurs via slow minting or not /// @param issuer The address holding collateral tokens /// @param recipient The address of the recipient of the RTokens /// @param amount The quantity of RToken being issued /// @param baskets The corresponding number of baskets event Issuance( address indexed issuer, address indexed recipient, uint256 amount, uint192 baskets ); /// Emitted when a redemption of RToken occurs /// @param redeemer The address holding RToken /// @param recipient The address of the account receiving the backing collateral tokens /// @param amount The quantity of RToken being redeemed /// @param baskets The corresponding number of baskets /// @param amount {qRTok} The amount of RTokens canceled event Redemption( address indexed redeemer, address indexed recipient, uint256 amount, uint192 baskets ); /// Emitted when the number of baskets needed changes /// @param oldBasketsNeeded Previous number of baskets units needed /// @param newBasketsNeeded New number of basket units needed event BasketsNeededChanged(uint192 oldBasketsNeeded, uint192 newBasketsNeeded); /// Emitted when RToken is melted, i.e the RToken supply is decreased but basketsNeeded is not /// @param amount {qRTok} event Melted(uint256 amount); /// Emitted when issuance SupplyThrottle params are set event IssuanceThrottleSet(ThrottleLib.Params oldVal, ThrottleLib.Params newVal); /// Emitted when redemption SupplyThrottle params are set event RedemptionThrottleSet(ThrottleLib.Params oldVal, ThrottleLib.Params newVal); // Initialization function init( IMain main_, string memory name_, string memory symbol_, string memory mandate_, ThrottleLib.Params calldata issuanceThrottleParams, ThrottleLib.Params calldata redemptionThrottleParams ) external; /// Issue an RToken with basket collateral /// @param amount {qRTok} The quantity of RToken to issue /// @custom:interaction function issue(uint256 amount) external; /// Issue an RToken with basket collateral, to a particular recipient /// @param recipient The address to receive the issued RTokens /// @param amount {qRTok} The quantity of RToken to issue /// @custom:interaction function issueTo(address recipient, uint256 amount) external; /// Redeem RToken for basket collateral /// @dev Use redeemCustom for non-current baskets /// @param amount {qRTok} The quantity {qRToken} of RToken to redeem /// @custom:interaction function redeem(uint256 amount) external; /// Redeem RToken for basket collateral to a particular recipient /// @dev Use redeemCustom for non-current baskets /// @param recipient The address to receive the backing collateral tokens /// @param amount {qRTok} The quantity {qRToken} of RToken to redeem /// @custom:interaction function redeemTo(address recipient, uint256 amount) external; /// Redeem RToken for a linear combination of historical baskets, to a particular recipient /// @dev Allows partial redemptions up to the minAmounts /// @param recipient The address to receive the backing collateral tokens /// @param amount {qRTok} The quantity {qRToken} of RToken to redeem /// @param basketNonces An array of basket nonces to do redemption from /// @param portions {1} An array of Fix quantities that must add up to FIX_ONE /// @param expectedERC20sOut An array of ERC20s expected out /// @param minAmounts {qTok} The minimum ERC20 quantities the caller should receive /// @custom:interaction function redeemCustom( address recipient, uint256 amount, uint48[] memory basketNonces, uint192[] memory portions, address[] memory expectedERC20sOut, uint256[] memory minAmounts ) external; /// Mint an amount of RToken equivalent to baskets BUs, scaling basketsNeeded up /// Callable only by BackingManager /// @param baskets {BU} The number of baskets to mint RToken for /// @custom:protected function mint(uint192 baskets) external; /// Melt a quantity of RToken from the caller's account /// @param amount {qRTok} The amount to be melted /// @custom:protected function melt(uint256 amount) external; /// Burn an amount of RToken from caller's account and scale basketsNeeded down /// Callable only by BackingManager /// @custom:protected function dissolve(uint256 amount) external; /// Set the number of baskets needed directly, callable only by the BackingManager /// @param basketsNeeded {BU} The number of baskets to target /// needed range: pretty interesting /// @custom:protected function setBasketsNeeded(uint192 basketsNeeded) external; /// @return {BU} How many baskets are being targeted function basketsNeeded() external view returns (uint192); /// @return {qRTok} The maximum issuance that can be performed in the current block function issuanceAvailable() external view returns (uint256); /// @return {qRTok} The maximum redemption that can be performed in the current block function redemptionAvailable() external view returns (uint256); } interface TestIRToken is IRToken { function setIssuanceThrottleParams(ThrottleLib.Params calldata) external; function setRedemptionThrottleParams(ThrottleLib.Params calldata) external; function issuanceThrottleParams() external view returns (ThrottleLib.Params memory); function redemptionThrottleParams() external view returns (ThrottleLib.Params memory); function increaseAllowance(address, uint256) external returns (bool); function decreaseAllowance(address, uint256) external returns (bool); function monetizeDonations(IERC20) external; }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20MetadataUpgradeable.sol"; // solhint-disable-next-line max-line-length import "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/draft-IERC20PermitUpgradeable.sol"; import "../libraries/Fixed.sol"; import "./IComponent.sol"; import "./IMain.sol"; /** * @title IStRSR * @notice An ERC20 token representing shares of the RSR over-collateralization pool. * * StRSR permits the BackingManager to take RSR in times of need. In return, the BackingManager * benefits the StRSR pool with RSR rewards purchased with a portion of its revenue. * * In the absence of collateral default or losses due to slippage, StRSR should have a * monotonically increasing exchange rate with respect to RSR, meaning that over time * StRSR is redeemable for more RSR. It is non-rebasing. */ interface IStRSR is IERC20MetadataUpgradeable, IERC20PermitUpgradeable, IComponent { /// Emitted when RSR is staked /// @param era The era at time of staking /// @param staker The address of the staker /// @param rsrAmount {qRSR} How much RSR was staked /// @param stRSRAmount {qStRSR} How much stRSR was minted by this staking event Staked( uint256 indexed era, address indexed staker, uint256 rsrAmount, uint256 stRSRAmount ); /// Emitted when an unstaking is started /// @param draftId The id of the draft. /// @param draftEra The era of the draft. /// @param staker The address of the unstaker /// The triple (staker, draftEra, draftId) is a unique ID /// @param rsrAmount {qRSR} How much RSR this unstaking will be worth, absent seizures /// @param stRSRAmount {qStRSR} How much stRSR was burned by this unstaking event UnstakingStarted( uint256 indexed draftId, uint256 indexed draftEra, address indexed staker, uint256 rsrAmount, uint256 stRSRAmount, uint256 availableAt ); /// Emitted when RSR is unstaked /// @param firstId The beginning of the range of draft IDs withdrawn in this transaction /// @param endId The end of range of draft IDs withdrawn in this transaction /// (ID i was withdrawn if firstId <= i < endId) /// @param draftEra The era of the draft. /// The triple (staker, draftEra, id) is a unique ID among drafts /// @param staker The address of the unstaker /// @param rsrAmount {qRSR} How much RSR this unstaking was worth event UnstakingCompleted( uint256 indexed firstId, uint256 indexed endId, uint256 draftEra, address indexed staker, uint256 rsrAmount ); /// Emitted when RSR unstaking is cancelled /// @param firstId The beginning of the range of draft IDs withdrawn in this transaction /// @param endId The end of range of draft IDs withdrawn in this transaction /// (ID i was withdrawn if firstId <= i < endId) /// @param draftEra The era of the draft. /// The triple (staker, draftEra, id) is a unique ID among drafts /// @param staker The address of the unstaker /// @param rsrAmount {qRSR} How much RSR this unstaking was worth event UnstakingCancelled( uint256 indexed firstId, uint256 indexed endId, uint256 draftEra, address indexed staker, uint256 rsrAmount ); /// Emitted whenever the exchange rate changes event ExchangeRateSet(uint192 oldVal, uint192 newVal); /// Emitted whenever RSR are paids out event RewardsPaid(uint256 rsrAmt); /// Emitted if all the RSR in the staking pool is seized and all balances are reset to zero. event AllBalancesReset(uint256 indexed newEra); /// Emitted if all the RSR in the unstakin pool is seized, and all ongoing unstaking is voided. event AllUnstakingReset(uint256 indexed newEra); event UnstakingDelaySet(uint48 oldVal, uint48 newVal); event RewardRatioSet(uint192 oldVal, uint192 newVal); event WithdrawalLeakSet(uint192 oldVal, uint192 newVal); // Initialization function init( IMain main_, string memory name_, string memory symbol_, uint48 unstakingDelay_, uint192 rewardRatio_, uint192 withdrawalLeak_ ) external; /// Gather and payout rewards from rsrTrader /// @custom:interaction function payoutRewards() external; /// Stakes an RSR `amount` on the corresponding RToken to earn yield and over-collateralized /// the system /// @param amount {qRSR} /// @custom:interaction function stake(uint256 amount) external; /// Begins a delayed unstaking for `amount` stRSR /// @param amount {qStRSR} /// @custom:interaction function unstake(uint256 amount) external; /// Complete delayed unstaking for the account, up to (but not including!) `endId` /// @custom:interaction function withdraw(address account, uint256 endId) external; /// Cancel unstaking for the account, up to (but not including!) `endId` /// @custom:interaction function cancelUnstake(uint256 endId) external; /// Seize RSR, only callable by main.backingManager() /// @custom:protected function seizeRSR(uint256 amount) external; /// Reset all stakes and advance era /// @custom:governance function resetStakes() external; /// Return the maximum valid value of endId such that withdraw(endId) should immediately work function endIdForWithdraw(address account) external view returns (uint256 endId); /// @return {qRSR/qStRSR} The exchange rate between RSR and StRSR function exchangeRate() external view returns (uint192); } interface TestIStRSR is IStRSR { function rewardRatio() external view returns (uint192); function setRewardRatio(uint192) external; function unstakingDelay() external view returns (uint48); function setUnstakingDelay(uint48) external; function withdrawalLeak() external view returns (uint192); function setWithdrawalLeak(uint192) external; function increaseAllowance(address, uint256) external returns (bool); function decreaseAllowance(address, uint256) external returns (bool); /// @return {qStRSR/qRSR} The exchange rate between StRSR and RSR function exchangeRate() external view returns (uint192); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts-upgradeable/governance/utils/IVotesUpgradeable.sol"; interface IStRSRVotes is IVotesUpgradeable { /// @return The current era function currentEra() external view returns (uint256); /// @return The era at a past block number function getPastEra(uint256 blockNumber) external view returns (uint256); /// Stakes an RSR `amount` on the corresponding RToken and allows to delegate /// votes from the sender to `delegatee` or self function stakeAndDelegate(uint256 amount, address delegatee) external; }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import "./IBroker.sol"; enum TradeStatus { NOT_STARTED, // before init() OPEN, // after init() and before settle() CLOSED, // after settle() // === Intermediate-tx state === PENDING // during init() or settle() (reentrancy protection) } /** * Simple generalized trading interface for all Trade contracts to obey * * Usage: if (canSettle()) settle() */ interface ITrade { /// Complete the trade and transfer tokens back to the origin trader /// @return soldAmt {qSellTok} The quantity of tokens sold /// @return boughtAmt {qBuyTok} The quantity of tokens bought function settle() external returns (uint256 soldAmt, uint256 boughtAmt); function sell() external view returns (IERC20Metadata); function buy() external view returns (IERC20Metadata); /// @return The timestamp at which the trade is projected to become settle-able function endTime() external view returns (uint48); /// @return True if the trade can be settled /// @dev Should be guaranteed to be true eventually as an invariant function canSettle() external view returns (bool); /// @return TradeKind.DUTCH_AUCTION or TradeKind.BATCH_AUCTION // solhint-disable-next-line func-name-mixedcase function KIND() external view returns (TradeKind); }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import "../libraries/Fixed.sol"; import "./IAsset.sol"; import "./IComponent.sol"; import "./ITrade.sol"; import "./IRewardable.sol"; /** * @title ITrading * @notice Common events and refresher function for all Trading contracts */ interface ITrading is IComponent, IRewardableComponent { event MaxTradeSlippageSet(uint192 oldVal, uint192 newVal); event MinTradeVolumeSet(uint192 oldVal, uint192 newVal); /// Emitted when a trade is started /// @param trade The one-time-use trade contract that was just deployed /// @param sell The token to sell /// @param buy The token to buy /// @param sellAmount {qSellTok} The quantity of the selling token /// @param minBuyAmount {qBuyTok} The minimum quantity of the buying token to accept event TradeStarted( ITrade indexed trade, IERC20 indexed sell, IERC20 indexed buy, uint256 sellAmount, uint256 minBuyAmount ); /// Emitted after a trade ends /// @param trade The one-time-use trade contract /// @param sell The token to sell /// @param buy The token to buy /// @param sellAmount {qSellTok} The quantity of the token sold /// @param buyAmount {qBuyTok} The quantity of the token bought event TradeSettled( ITrade indexed trade, IERC20 indexed sell, IERC20 indexed buy, uint256 sellAmount, uint256 buyAmount ); /// Settle a single trade, expected to be used with multicall for efficient mass settlement /// @param sell The sell token in the trade /// @return The trade settled /// @custom:refresher function settleTrade(IERC20 sell) external returns (ITrade); /// @return {%} The maximum trade slippage acceptable function maxTradeSlippage() external view returns (uint192); /// @return {UoA} The minimum trade volume in UoA, applies to all assets function minTradeVolume() external view returns (uint192); /// @return The ongoing trade for a sell token, or the zero address function trades(IERC20 sell) external view returns (ITrade); /// @return The number of ongoing trades open function tradesOpen() external view returns (uint48); /// @return The number of total trades ever opened function tradesNonce() external view returns (uint256); } interface TestITrading is ITrading { /// @custom:governance function setMaxTradeSlippage(uint192 val) external; /// @custom:governance function setMinTradeVolume(uint192 val) external; }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; interface IVersioned { function version() external view returns (string memory); }
// SPDX-License-Identifier: BlueOak-1.0.0 // solhint-disable func-name-mixedcase func-visibility pragma solidity ^0.8.19; /// @title FixedPoint, a fixed-point arithmetic library defining the custom type uint192 /// @author Matt Elder <[email protected]> and the Reserve Team <https://reserve.org> /** The logical type `uint192 ` is a 192 bit value, representing an 18-decimal Fixed-point fractional value. This is what's described in the Solidity documentation as "fixed192x18" -- a value represented by 192 bits, that makes 18 digits available to the right of the decimal point. The range of values that uint192 can represent is about [-1.7e20, 1.7e20]. Unless a function explicitly says otherwise, it will fail on overflow. To be clear, the following should hold: toFix(0) == 0 toFix(1) == 1e18 */ // Analysis notes: // Every function should revert iff its result is out of bounds. // Unless otherwise noted, when a rounding mode is given, that mode is applied to // a single division that may happen as the last step in the computation. // Unless otherwise noted, when a rounding mode is *not* given but is needed, it's FLOOR. // For each, we comment: // - @return is the value expressed in "value space", where uint192(1e18) "is" 1.0 // - as-ints: is the value expressed in "implementation space", where uint192(1e18) "is" 1e18 // The "@return" expression is suitable for actually using the library // The "as-ints" expression is suitable for testing // A uint value passed to this library was out of bounds for uint192 operations error UIntOutOfBounds(); bytes32 constant UIntOutofBoundsHash = keccak256(abi.encodeWithSignature("UIntOutOfBounds()")); // Used by P1 implementation for easier casting uint256 constant FIX_ONE_256 = 1e18; uint8 constant FIX_DECIMALS = 18; // If a particular uint192 is represented by the uint192 n, then the uint192 represents the // value n/FIX_SCALE. uint64 constant FIX_SCALE = 1e18; // FIX_SCALE Squared: uint128 constant FIX_SCALE_SQ = 1e36; // The largest integer that can be converted to uint192 . // This is a bit bigger than 3.1e39 uint192 constant FIX_MAX_INT = type(uint192).max / FIX_SCALE; uint192 constant FIX_ZERO = 0; // The uint192 representation of zero. uint192 constant FIX_ONE = FIX_SCALE; // The uint192 representation of one. uint192 constant FIX_MAX = type(uint192).max; // The largest uint192. (Not an integer!) uint192 constant FIX_MIN = 0; // The smallest uint192. /// An enum that describes a rounding approach for converting to ints enum RoundingMode { FLOOR, // Round towards zero ROUND, // Round to the nearest int CEIL // Round away from zero } RoundingMode constant FLOOR = RoundingMode.FLOOR; RoundingMode constant ROUND = RoundingMode.ROUND; RoundingMode constant CEIL = RoundingMode.CEIL; /* @dev Solidity 0.8.x only allows you to change one of type or size per type conversion. Thus, all the tedious-looking double conversions like uint256(uint256 (foo)) See: https://docs.soliditylang.org/en/v0.8.17/080-breaking-changes.html#new-restrictions */ /// Explicitly convert a uint256 to a uint192. Revert if the input is out of bounds. function _safeWrap(uint256 x) pure returns (uint192) { if (FIX_MAX < x) revert UIntOutOfBounds(); return uint192(x); } /// Convert a uint to its Fix representation. /// @return x // as-ints: x * 1e18 function toFix(uint256 x) pure returns (uint192) { return _safeWrap(x * FIX_SCALE); } /// Convert a uint to its fixed-point representation, and left-shift its value `shiftLeft` /// decimal digits. /// @return x * 10**shiftLeft // as-ints: x * 10**(shiftLeft + 18) function shiftl_toFix(uint256 x, int8 shiftLeft) pure returns (uint192) { return shiftl_toFix(x, shiftLeft, FLOOR); } /// @return x * 10**shiftLeft // as-ints: x * 10**(shiftLeft + 18) function shiftl_toFix( uint256 x, int8 shiftLeft, RoundingMode rounding ) pure returns (uint192) { // conditions for avoiding overflow if (x == 0) return 0; if (shiftLeft <= -96) return (rounding == CEIL ? 1 : 0); // 0 < uint.max / 10**77 < 0.5 if (40 <= shiftLeft) revert UIntOutOfBounds(); // 10**56 < FIX_MAX < 10**57 shiftLeft += 18; uint256 coeff = 10**abs(shiftLeft); uint256 shifted = (shiftLeft >= 0) ? x * coeff : _divrnd(x, coeff, rounding); return _safeWrap(shifted); } /// Divide a uint by a uint192, yielding a uint192 /// This may also fail if the result is MIN_uint192! not fixing this for optimization's sake. /// @return x / y // as-ints: x * 1e36 / y function divFix(uint256 x, uint192 y) pure returns (uint192) { // If we didn't have to worry about overflow, we'd just do `return x * 1e36 / _y` // If it's safe to do this operation the easy way, do it: if (x < uint256(type(uint256).max / FIX_SCALE_SQ)) { return _safeWrap(uint256(x * FIX_SCALE_SQ) / y); } else { return _safeWrap(mulDiv256(x, FIX_SCALE_SQ, y)); } } /// Divide a uint by a uint, yielding a uint192 /// @return x / y // as-ints: x * 1e18 / y function divuu(uint256 x, uint256 y) pure returns (uint192) { return _safeWrap(mulDiv256(FIX_SCALE, x, y)); } /// @return min(x,y) // as-ints: min(x,y) function fixMin(uint192 x, uint192 y) pure returns (uint192) { return x < y ? x : y; } /// @return max(x,y) // as-ints: max(x,y) function fixMax(uint192 x, uint192 y) pure returns (uint192) { return x > y ? x : y; } /// @return absoluteValue(x,y) // as-ints: absoluteValue(x,y) function abs(int256 x) pure returns (uint256) { return x < 0 ? uint256(-x) : uint256(x); } /// Divide two uints, returning a uint, using rounding mode `rounding`. /// @return numerator / divisor // as-ints: numerator / divisor function _divrnd( uint256 numerator, uint256 divisor, RoundingMode rounding ) pure returns (uint256) { uint256 result = numerator / divisor; if (rounding == FLOOR) return result; if (rounding == ROUND) { if (numerator % divisor > (divisor - 1) / 2) { result++; } } else { if (numerator % divisor > 0) { result++; } } return result; } library FixLib { /// Again, all arithmetic functions fail if and only if the result is out of bounds. /// Convert this fixed-point value to a uint. Round towards zero if needed. /// @return x // as-ints: x / 1e18 function toUint(uint192 x) internal pure returns (uint136) { return toUint(x, FLOOR); } /// Convert this uint192 to a uint /// @return x // as-ints: x / 1e18 with rounding function toUint(uint192 x, RoundingMode rounding) internal pure returns (uint136) { return uint136(_divrnd(uint256(x), FIX_SCALE, rounding)); } /// Return the uint192 shifted to the left by `decimal` digits /// (Similar to a bitshift but in base 10) /// @return x * 10**decimals // as-ints: x * 10**decimals function shiftl(uint192 x, int8 decimals) internal pure returns (uint192) { return shiftl(x, decimals, FLOOR); } /// Return the uint192 shifted to the left by `decimal` digits /// (Similar to a bitshift but in base 10) /// @return x * 10**decimals // as-ints: x * 10**decimals function shiftl( uint192 x, int8 decimals, RoundingMode rounding ) internal pure returns (uint192) { // Handle overflow cases if (x == 0) return 0; if (decimals <= -59) return (rounding == CEIL ? 1 : 0); // 59, because 1e58 > 2**192 if (58 <= decimals) revert UIntOutOfBounds(); // 58, because x * 1e58 > 2 ** 192 if x != 0 uint256 coeff = uint256(10**abs(decimals)); return _safeWrap(decimals >= 0 ? x * coeff : _divrnd(x, coeff, rounding)); } /// Add a uint192 to this uint192 /// @return x + y // as-ints: x + y function plus(uint192 x, uint192 y) internal pure returns (uint192) { return x + y; } /// Add a uint to this uint192 /// @return x + y // as-ints: x + y*1e18 function plusu(uint192 x, uint256 y) internal pure returns (uint192) { return _safeWrap(x + y * FIX_SCALE); } /// Subtract a uint192 from this uint192 /// @return x - y // as-ints: x - y function minus(uint192 x, uint192 y) internal pure returns (uint192) { return x - y; } /// Subtract a uint from this uint192 /// @return x - y // as-ints: x - y*1e18 function minusu(uint192 x, uint256 y) internal pure returns (uint192) { return _safeWrap(uint256(x) - uint256(y * FIX_SCALE)); } /// Multiply this uint192 by a uint192 /// Round truncated values to the nearest available value. 5e-19 rounds away from zero. /// @return x * y // as-ints: x * y/1e18 [division using ROUND, not FLOOR] function mul(uint192 x, uint192 y) internal pure returns (uint192) { return mul(x, y, ROUND); } /// Multiply this uint192 by a uint192 /// @return x * y // as-ints: x * y/1e18 function mul( uint192 x, uint192 y, RoundingMode rounding ) internal pure returns (uint192) { return _safeWrap(_divrnd(uint256(x) * uint256(y), FIX_SCALE, rounding)); } /// Multiply this uint192 by a uint /// @return x * y // as-ints: x * y function mulu(uint192 x, uint256 y) internal pure returns (uint192) { return _safeWrap(x * y); } /// Divide this uint192 by a uint192 /// @return x / y // as-ints: x * 1e18 / y function div(uint192 x, uint192 y) internal pure returns (uint192) { return div(x, y, FLOOR); } /// Divide this uint192 by a uint192 /// @return x / y // as-ints: x * 1e18 / y function div( uint192 x, uint192 y, RoundingMode rounding ) internal pure returns (uint192) { // Multiply-in FIX_SCALE before dividing by y to preserve precision. return _safeWrap(_divrnd(uint256(x) * FIX_SCALE, y, rounding)); } /// Divide this uint192 by a uint /// @return x / y // as-ints: x / y function divu(uint192 x, uint256 y) internal pure returns (uint192) { return divu(x, y, FLOOR); } /// Divide this uint192 by a uint /// @return x / y // as-ints: x / y function divu( uint192 x, uint256 y, RoundingMode rounding ) internal pure returns (uint192) { return _safeWrap(_divrnd(x, y, rounding)); } uint64 constant FIX_HALF = uint64(FIX_SCALE) / 2; /// Raise this uint192 to a nonnegative integer power. Requires that x_ <= FIX_ONE /// Gas cost is O(lg(y)), precision is +- 1e-18. /// @return x_ ** y // as-ints: x_ ** y / 1e18**(y-1) <- technically correct for y = 0. :D function powu(uint192 x_, uint48 y) internal pure returns (uint192) { require(x_ <= FIX_ONE); if (y == 1) return x_; if (x_ == FIX_ONE || y == 0) return FIX_ONE; uint256 x = uint256(x_) * FIX_SCALE; // x is D36 uint256 result = FIX_SCALE_SQ; // result is D36 while (true) { if (y & 1 == 1) result = (result * x + FIX_SCALE_SQ / 2) / FIX_SCALE_SQ; if (y <= 1) break; y = (y >> 1); x = (x * x + FIX_SCALE_SQ / 2) / FIX_SCALE_SQ; } return _safeWrap(result / FIX_SCALE); } /// Comparison operators... function lt(uint192 x, uint192 y) internal pure returns (bool) { return x < y; } function lte(uint192 x, uint192 y) internal pure returns (bool) { return x <= y; } function gt(uint192 x, uint192 y) internal pure returns (bool) { return x > y; } function gte(uint192 x, uint192 y) internal pure returns (bool) { return x >= y; } function eq(uint192 x, uint192 y) internal pure returns (bool) { return x == y; } function neq(uint192 x, uint192 y) internal pure returns (bool) { return x != y; } /// Return whether or not this uint192 is less than epsilon away from y. /// @return |x - y| < epsilon // as-ints: |x - y| < epsilon function near( uint192 x, uint192 y, uint192 epsilon ) internal pure returns (bool) { uint192 diff = x <= y ? y - x : x - y; return diff < epsilon; } // ================ Chained Operations ================ // The operation foo_bar() always means: // Do foo() followed by bar(), and overflow only if the _end_ result doesn't fit in an uint192 /// Shift this uint192 left by `decimals` digits, and convert to a uint /// @return x * 10**decimals // as-ints: x * 10**(decimals - 18) function shiftl_toUint(uint192 x, int8 decimals) internal pure returns (uint256) { return shiftl_toUint(x, decimals, FLOOR); } /// Shift this uint192 left by `decimals` digits, and convert to a uint. /// @return x * 10**decimals // as-ints: x * 10**(decimals - 18) function shiftl_toUint( uint192 x, int8 decimals, RoundingMode rounding ) internal pure returns (uint256) { // Handle overflow cases if (x == 0) return 0; // always computable, no matter what decimals is if (decimals <= -42) return (rounding == CEIL ? 1 : 0); if (96 <= decimals) revert UIntOutOfBounds(); decimals -= 18; // shift so that toUint happens at the same time. uint256 coeff = uint256(10**abs(decimals)); return decimals >= 0 ? uint256(x * coeff) : uint256(_divrnd(x, coeff, rounding)); } /// Multiply this uint192 by a uint, and output the result as a uint /// @return x * y // as-ints: x * y / 1e18 function mulu_toUint(uint192 x, uint256 y) internal pure returns (uint256) { return mulDiv256(uint256(x), y, FIX_SCALE); } /// Multiply this uint192 by a uint, and output the result as a uint /// @return x * y // as-ints: x * y / 1e18 function mulu_toUint( uint192 x, uint256 y, RoundingMode rounding ) internal pure returns (uint256) { return mulDiv256(uint256(x), y, FIX_SCALE, rounding); } /// Multiply this uint192 by a uint192 and output the result as a uint /// @return x * y // as-ints: x * y / 1e36 function mul_toUint(uint192 x, uint192 y) internal pure returns (uint256) { return mulDiv256(uint256(x), uint256(y), FIX_SCALE_SQ); } /// Multiply this uint192 by a uint192 and output the result as a uint /// @return x * y // as-ints: x * y / 1e36 function mul_toUint( uint192 x, uint192 y, RoundingMode rounding ) internal pure returns (uint256) { return mulDiv256(uint256(x), uint256(y), FIX_SCALE_SQ, rounding); } /// Compute x * y / z avoiding intermediate overflow /// @dev Only use if you need to avoid overflow; costlier than x * y / z /// @return x * y / z // as-ints: x * y / z function muluDivu( uint192 x, uint256 y, uint256 z ) internal pure returns (uint192) { return muluDivu(x, y, z, FLOOR); } /// Compute x * y / z, avoiding intermediate overflow /// @dev Only use if you need to avoid overflow; costlier than x * y / z /// @return x * y / z // as-ints: x * y / z function muluDivu( uint192 x, uint256 y, uint256 z, RoundingMode rounding ) internal pure returns (uint192) { return _safeWrap(mulDiv256(x, y, z, rounding)); } /// Compute x * y / z on Fixes, avoiding intermediate overflow /// @dev Only use if you need to avoid overflow; costlier than x * y / z /// @return x * y / z // as-ints: x * y / z function mulDiv( uint192 x, uint192 y, uint192 z ) internal pure returns (uint192) { return mulDiv(x, y, z, FLOOR); } /// Compute x * y / z on Fixes, avoiding intermediate overflow /// @dev Only use if you need to avoid overflow; costlier than x * y / z /// @return x * y / z // as-ints: x * y / z function mulDiv( uint192 x, uint192 y, uint192 z, RoundingMode rounding ) internal pure returns (uint192) { return _safeWrap(mulDiv256(x, y, z, rounding)); } // === safe*() === /// Multiply two fixes, rounding up to FIX_MAX and down to 0 /// @param a First param to multiply /// @param b Second param to multiply function safeMul( uint192 a, uint192 b, RoundingMode rounding ) internal pure returns (uint192) { // untestable: // a will never = 0 here because of the check in _price() if (a == 0 || b == 0) return 0; // untestable: // a = FIX_MAX iff b = 0 if (a == FIX_MAX || b == FIX_MAX) return FIX_MAX; // return FIX_MAX instead of throwing overflow errors. unchecked { // p and mul *are* Fix values, so have 18 decimals (D18) uint256 rawDelta = uint256(b) * a; // {D36} = {D18} * {D18} // if we overflowed, then return FIX_MAX if (rawDelta / b != a) return FIX_MAX; uint256 shiftDelta = rawDelta; // add in rounding if (rounding == RoundingMode.ROUND) shiftDelta += (FIX_ONE / 2); else if (rounding == RoundingMode.CEIL) shiftDelta += FIX_ONE - 1; // untestable (here there be dragons): // (below explanation is for the ROUND case, but it extends to the FLOOR/CEIL too) // A) shiftDelta = rawDelta + (FIX_ONE / 2) // shiftDelta overflows if: // B) shiftDelta = MAX_UINT256 - FIX_ONE/2 + 1 // rawDelta + (FIX_ONE/2) = MAX_UINT256 - FIX_ONE/2 + 1 // b * a = MAX_UINT256 - FIX_ONE + 1 // therefore shiftDelta overflows if: // C) b = (MAX_UINT256 - FIX_ONE + 1) / a // MAX_UINT256 ~= 1e77 , FIX_MAX ~= 6e57 (6e20 difference in magnitude) // a <= 1e21 (MAX_TARGET_AMT) // a must be between 1e19 & 1e20 in order for b in (C) to be uint192, // but a would have to be < 1e18 in order for (A) to overflow if (shiftDelta < rawDelta) return FIX_MAX; // return FIX_MAX if return result would truncate if (shiftDelta / FIX_ONE > FIX_MAX) return FIX_MAX; // return _div(rawDelta, FIX_ONE, rounding) return uint192(shiftDelta / FIX_ONE); // {D18} = {D36} / {D18} } } /// Divide two fixes, rounding up to FIX_MAX and down to 0 /// @param a Numerator /// @param b Denominator function safeDiv( uint192 a, uint192 b, RoundingMode rounding ) internal pure returns (uint192) { if (a == 0) return 0; if (b == 0) return FIX_MAX; uint256 raw = _divrnd(FIX_ONE_256 * a, uint256(b), rounding); if (raw >= FIX_MAX) return FIX_MAX; return uint192(raw); // don't need _safeWrap } /// Multiplies two fixes and divide by a third /// @param a First to multiply /// @param b Second to multiply /// @param c Denominator function safeMulDiv( uint192 a, uint192 b, uint192 c, RoundingMode rounding ) internal pure returns (uint192 result) { if (a == 0 || b == 0) return 0; if (a == FIX_MAX || b == FIX_MAX || c == 0) return FIX_MAX; uint256 result_256; unchecked { (uint256 hi, uint256 lo) = fullMul(a, b); if (hi >= c) return FIX_MAX; uint256 mm = mulmod(a, b, c); if (mm > lo) hi -= 1; lo -= mm; uint256 pow2 = c & (0 - c); uint256 c_256 = uint256(c); // Warning: Should not access c below this line c_256 /= pow2; lo /= pow2; lo += hi * ((0 - pow2) / pow2 + 1); uint256 r = 1; r *= 2 - c_256 * r; r *= 2 - c_256 * r; r *= 2 - c_256 * r; r *= 2 - c_256 * r; r *= 2 - c_256 * r; r *= 2 - c_256 * r; r *= 2 - c_256 * r; r *= 2 - c_256 * r; result_256 = lo * r; // Apply rounding if (rounding == CEIL) { if (mm > 0) result_256 += 1; } else if (rounding == ROUND) { if (mm > ((c_256 - 1) / 2)) result_256 += 1; } } if (result_256 >= FIX_MAX) return FIX_MAX; return uint192(result_256); } } // ================ a couple pure-uint helpers================ // as-ints comments are omitted here, because they're the same as @return statements, because // these are all pure uint functions /// Return (x*y/z), avoiding intermediate overflow. // Adapted from sources: // https://medium.com/coinmonks/4db014e080b1, https://medium.com/wicketh/afa55870a65 // and quite a few of the other excellent "Mathemagic" posts from https://medium.com/wicketh /// @dev Only use if you need to avoid overflow; costlier than x * y / z /// @return result x * y / z function mulDiv256( uint256 x, uint256 y, uint256 z ) pure returns (uint256 result) { unchecked { (uint256 hi, uint256 lo) = fullMul(x, y); if (hi >= z) revert UIntOutOfBounds(); uint256 mm = mulmod(x, y, z); if (mm > lo) hi -= 1; lo -= mm; uint256 pow2 = z & (0 - z); z /= pow2; lo /= pow2; lo += hi * ((0 - pow2) / pow2 + 1); uint256 r = 1; r *= 2 - z * r; r *= 2 - z * r; r *= 2 - z * r; r *= 2 - z * r; r *= 2 - z * r; r *= 2 - z * r; r *= 2 - z * r; r *= 2 - z * r; result = lo * r; } } /// Return (x*y/z), avoiding intermediate overflow. /// @dev Only use if you need to avoid overflow; costlier than x * y / z /// @return x * y / z function mulDiv256( uint256 x, uint256 y, uint256 z, RoundingMode rounding ) pure returns (uint256) { uint256 result = mulDiv256(x, y, z); if (rounding == FLOOR) return result; uint256 mm = mulmod(x, y, z); if (rounding == CEIL) { if (mm > 0) result += 1; } else { if (mm > ((z - 1) / 2)) result += 1; // z should be z-1 } return result; } /// Return (x*y) as a "virtual uint512" (lo, hi), representing (hi*2**256 + lo) /// Adapted from sources: /// https://medium.com/wicketh/27650fec525d, https://medium.com/coinmonks/4db014e080b1 /// @dev Intended to be internal to this library /// @return hi (hi, lo) satisfies hi*(2**256) + lo == x * y /// @return lo (paired with `hi`) function fullMul(uint256 x, uint256 y) pure returns (uint256 hi, uint256 lo) { unchecked { uint256 mm = mulmod(x, y, uint256(0) - uint256(1)); lo = x * y; hi = mm - lo; if (mm < lo) hi -= 1; } }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "./Fixed.sol"; uint48 constant ONE_HOUR = 3600; // {seconds/hour} /** * @title ThrottleLib * A library that implements a usage throttle that can be used to ensure net issuance * or net redemption for an RToken never exceeds some bounds per unit time (hour). * * It is expected for the RToken to use this library with two instances, one for issuance * and one for redemption. Issuance causes the available redemption amount to increase, and * visa versa. */ library ThrottleLib { using FixLib for uint192; struct Params { uint256 amtRate; // {qRTok/hour} a quantity of RToken hourly; cannot be 0 uint192 pctRate; // {1/hour} a fraction of RToken hourly; can be 0 } struct Throttle { // === Gov params === Params params; // === Cache === uint48 lastTimestamp; // {seconds} uint256 lastAvailable; // {qRTok} } /// Reverts if usage amount exceeds available amount /// @param supply {qRTok} Total RToken supply beforehand /// @param amount {qRTok} Amount of RToken to use. Should be negative for the issuance /// throttle during redemption and for the redemption throttle during issuance. function useAvailable( Throttle storage throttle, uint256 supply, int256 amount ) internal { // untestable: amtRate will always be greater > 0 due to previous validations if (throttle.params.amtRate == 0 && throttle.params.pctRate == 0) return; // Calculate hourly limit uint256 limit = hourlyLimit(throttle, supply); // {qRTok} // Calculate available amount before supply change uint256 available = currentlyAvailable(throttle, limit); // Update throttle.timestamp if available amount changed or at limit if (available != throttle.lastAvailable || available == limit) { throttle.lastTimestamp = uint48(block.timestamp); } // Update throttle.lastAvailable if (amount > 0) { require(uint256(amount) <= available, "supply change throttled"); available -= uint256(amount); // untestable: the final else statement, amount will never be 0 } else if (amount < 0) { available += uint256(-amount); } throttle.lastAvailable = available; } /// @param limit {qRTok/hour} The hourly limit /// @return available {qRTok} Amount currently available for consumption function currentlyAvailable(Throttle storage throttle, uint256 limit) internal view returns (uint256 available) { uint48 delta = uint48(block.timestamp) - throttle.lastTimestamp; // {seconds} available = throttle.lastAvailable + (limit * delta) / ONE_HOUR; if (available > limit) available = limit; } /// @return limit {qRTok} The hourly limit function hourlyLimit(Throttle storage throttle, uint256 supply) internal view returns (uint256 limit) { Params storage params = throttle.params; // Calculate hourly limit as: max(params.amtRate, supply.mul(params.pctRate)) limit = (supply * params.pctRate) / FIX_ONE_256; // {qRTok} if (params.amtRate > limit) limit = params.amtRate; } }
// SPDX-License-Identifier: BlueOak-1.0.0 pragma solidity 0.8.19; import "@openzeppelin/contracts/governance/Governor.sol"; import "@openzeppelin/contracts/governance/extensions/GovernorCountingSimple.sol"; import "@openzeppelin/contracts/governance/extensions/GovernorSettings.sol"; import "@openzeppelin/contracts/governance/extensions/GovernorTimelockControl.sol"; import "@openzeppelin/contracts/governance/extensions/GovernorVotes.sol"; import "@openzeppelin/contracts/governance/extensions/GovernorVotesQuorumFraction.sol"; import "../../interfaces/IStRSRVotes.sol"; /* * @title Governance * @dev Decentralized Governance for the Reserve Protocol. * * Note that due to the elastic supply of StRSR, proposalThreshold is handled * very differently than the typical approach. It is in terms of micro %, * as is _getVotes(). * * 1 {micro %} = 1e8 */ contract Governance is Governor, GovernorSettings, GovernorCountingSimple, GovernorVotes, GovernorVotesQuorumFraction, GovernorTimelockControl { // 100% uint256 public constant ONE_HUNDRED_PERCENT = 1e8; // {micro %} // solhint-disable no-empty-blocks constructor( IStRSRVotes token_, TimelockController timelock_, uint256 votingDelay_, // in blocks uint256 votingPeriod_, // in blocks uint256 proposalThresholdAsMicroPercent_, // e.g. 1e4 for 0.01% uint256 quorumPercent // e.g 4 for 4% ) Governor("Governor Alexios") GovernorSettings(votingDelay_, votingPeriod_, proposalThresholdAsMicroPercent_) GovernorVotes(IVotes(address(token_))) GovernorVotesQuorumFraction(quorumPercent) GovernorTimelockControl(timelock_) {} // solhint-enable no-empty-blocks function votingDelay() public view override(IGovernor, GovernorSettings) returns (uint256) { return super.votingDelay(); } function votingPeriod() public view override(IGovernor, GovernorSettings) returns (uint256) { return super.votingPeriod(); } /// @return {qStRSR} The number of votes required in order for a voter to become a proposer function proposalThreshold() public view override(Governor, GovernorSettings) returns (uint256) { uint256 asMicroPercent = super.proposalThreshold(); // {micro %} uint256 pastSupply = token.getPastTotalSupply(block.number - 1); // {qStRSR} // max StRSR supply is 1e38 // CEIL to make sure thresholds near 0% don't get rounded down to 0 tokens return (asMicroPercent * pastSupply + (ONE_HUNDRED_PERCENT - 1)) / ONE_HUNDRED_PERCENT; } function quorum(uint256 blockNumber) public view virtual override(IGovernor, GovernorVotesQuorumFraction) returns (uint256) { return super.quorum(blockNumber); } function state(uint256 proposalId) public view override(Governor, GovernorTimelockControl) returns (ProposalState) { return GovernorTimelockControl.state(proposalId); } function propose( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, string memory description ) public override(Governor, IGovernor) returns (uint256 proposalId) { // The super call checks that getVotes() >= proposalThreshold() return super.propose(targets, values, calldatas, description); } function queue( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) public override returns (uint256 proposalId) { proposalId = super.queue(targets, values, calldatas, descriptionHash); require(startedInSameEra(proposalId), "new era"); } function cancel( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) external { uint256 proposalId = _cancel(targets, values, calldatas, descriptionHash); require(!startedInSameEra(proposalId), "same era"); } function _execute( uint256 proposalId, address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) internal override(Governor, GovernorTimelockControl) { super._execute(proposalId, targets, values, calldatas, descriptionHash); require(startedInSameEra(proposalId), "new era"); } function _cancel( address[] memory targets, uint256[] memory values, bytes[] memory calldatas, bytes32 descriptionHash ) internal override(Governor, GovernorTimelockControl) returns (uint256) { return super._cancel(targets, values, calldatas, descriptionHash); } function _executor() internal view override(Governor, GovernorTimelockControl) returns (address) { return super._executor(); } /// @return {qStRSR} The voting weight the account had at a previous block number function _getVotes( address account, uint256 blockNumber, bytes memory /*params*/ ) internal view override(Governor, GovernorVotes) returns (uint256) { return token.getPastVotes(account, blockNumber); // {qStRSR} } function supportsInterface(bytes4 interfaceId) public view override(Governor, GovernorTimelockControl) returns (bool) { return super.supportsInterface(interfaceId); } // === Private === function startedInSameEra(uint256 proposalId) private view returns (bool) { uint256 startBlock = proposalSnapshot(proposalId); uint256 pastEra = IStRSRVotes(address(token)).getPastEra(startBlock); uint256 currentEra = IStRSRVotes(address(token)).currentEra(); return currentEra == pastEra; } }
{ "optimizer": { "enabled": true, "runs": 200 }, "outputSelection": { "*": { "*": [ "evm.bytecode", "evm.deployedBytecode", "devdoc", "userdoc", "metadata", "abi" ] } }, "libraries": { "contracts/facade/lib/FacadeWriteLib.sol": { "FacadeWriteLib": "0x908cd3b4b4b6c60d5eb7d1ca7ecda0e7cecd6db1" } } }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[{"internalType":"contract IDeployer","name":"deployer_","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"contract IRToken","name":"rToken","type":"address"},{"indexed":true,"internalType":"address","name":"governance","type":"address"},{"indexed":true,"internalType":"address","name":"timelock","type":"address"}],"name":"GovernanceCreated","type":"event"},{"inputs":[{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"string","name":"mandate","type":"string"},{"components":[{"components":[{"internalType":"uint16","name":"rTokenDist","type":"uint16"},{"internalType":"uint16","name":"rsrDist","type":"uint16"}],"internalType":"struct RevenueShare","name":"dist","type":"tuple"},{"internalType":"uint192","name":"minTradeVolume","type":"uint192"},{"internalType":"uint192","name":"rTokenMaxTradeVolume","type":"uint192"},{"internalType":"uint48","name":"shortFreeze","type":"uint48"},{"internalType":"uint48","name":"longFreeze","type":"uint48"},{"internalType":"uint192","name":"rewardRatio","type":"uint192"},{"internalType":"uint48","name":"unstakingDelay","type":"uint48"},{"internalType":"uint192","name":"withdrawalLeak","type":"uint192"},{"internalType":"uint48","name":"warmupPeriod","type":"uint48"},{"internalType":"uint48","name":"tradingDelay","type":"uint48"},{"internalType":"uint48","name":"batchAuctionLength","type":"uint48"},{"internalType":"uint48","name":"dutchAuctionLength","type":"uint48"},{"internalType":"uint192","name":"backingBuffer","type":"uint192"},{"internalType":"uint192","name":"maxTradeSlippage","type":"uint192"},{"components":[{"internalType":"uint256","name":"amtRate","type":"uint256"},{"internalType":"uint192","name":"pctRate","type":"uint192"}],"internalType":"struct ThrottleLib.Params","name":"issuanceThrottle","type":"tuple"},{"components":[{"internalType":"uint256","name":"amtRate","type":"uint256"},{"internalType":"uint192","name":"pctRate","type":"uint192"}],"internalType":"struct ThrottleLib.Params","name":"redemptionThrottle","type":"tuple"}],"internalType":"struct DeploymentParams","name":"params","type":"tuple"}],"internalType":"struct ConfigurationParams","name":"config","type":"tuple"},{"components":[{"internalType":"contract IAsset[]","name":"assets","type":"address[]"},{"internalType":"contract ICollateral[]","name":"primaryBasket","type":"address[]"},{"internalType":"uint192[]","name":"weights","type":"uint192[]"},{"components":[{"internalType":"bytes32","name":"backupUnit","type":"bytes32"},{"internalType":"uint256","name":"diversityFactor","type":"uint256"},{"internalType":"contract ICollateral[]","name":"backupCollateral","type":"address[]"}],"internalType":"struct BackupInfo[]","name":"backups","type":"tuple[]"},{"components":[{"internalType":"address","name":"beneficiary","type":"address"},{"components":[{"internalType":"uint16","name":"rTokenDist","type":"uint16"},{"internalType":"uint16","name":"rsrDist","type":"uint16"}],"internalType":"struct RevenueShare","name":"revShare","type":"tuple"}],"internalType":"struct BeneficiaryInfo[]","name":"beneficiaries","type":"tuple[]"}],"internalType":"struct SetupParams","name":"setup","type":"tuple"}],"name":"deployRToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"deployer","outputs":[{"internalType":"contract IDeployer","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IRToken","name":"rToken","type":"address"},{"internalType":"bool","name":"deployGovernance","type":"bool"},{"internalType":"bool","name":"unpause","type":"bool"},{"components":[{"internalType":"uint256","name":"votingDelay","type":"uint256"},{"internalType":"uint256","name":"votingPeriod","type":"uint256"},{"internalType":"uint256","name":"proposalThresholdAsMicroPercent","type":"uint256"},{"internalType":"uint256","name":"quorumPercent","type":"uint256"},{"internalType":"uint256","name":"timelockDelay","type":"uint256"}],"internalType":"struct GovernanceParams","name":"govParams","type":"tuple"},{"components":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"guardian","type":"address"},{"internalType":"address[]","name":"pausers","type":"address[]"},{"internalType":"address[]","name":"shortFreezers","type":"address[]"},{"internalType":"address[]","name":"longFreezers","type":"address[]"}],"internalType":"struct GovernanceRoles","name":"govRoles","type":"tuple"}],"name":"setupGovernance","outputs":[{"internalType":"address","name":"newOwner","type":"address"}],"stateMutability":"nonpayable","type":"function"}]
Contract Creation Code
60a06040523480156200001157600080fd5b5060405162004cc638038062004cc6833981016040819052620000349162000093565b6001600160a01b038116620000815760405162461bcd60e51b815260206004820152600f60248201526e696e76616c6964206164647265737360881b604482015260640160405180910390fd5b6001600160a01b0316608052620000c5565b600060208284031215620000a657600080fd5b81516001600160a01b0381168114620000be57600080fd5b9392505050565b608051614bdf620000e760003960008181609b015261039d0152614bdf6000f3fe60806040523480156200001157600080fd5b5060043610620000465760003560e01c8063a8150a38146200004b578063c8d87723146200007e578063d5f394881462000095575b600080fd5b620000626200005c3660046200211c565b620000bd565b6040516001600160a01b03909116815260200160405180910390f35b620000626200008f366004620021b7565b62001123565b620000627f000000000000000000000000000000000000000000000000000000000000000081565b600080620000cf60208401846200224c565b905011620001145760405162461bcd60e51b815260206004820152600d60248201526c1b9bc818dbdb1b185d195c985b609a1b60448201526064015b60405180910390fd5b6200012360408301836200224c565b90506200013460208401846200224c565b905014620001765760405162461bcd60e51b815260206004820152600e60248201526d0d2dcecc2d8d2c840d8cadccee8d60931b60448201526064016200010b565b60005b6200018860608401846200224c565b905081101562000235576000620001a360608501856200224c565b83818110620001b657620001b6620022a0565b9050602002810190620001ca9190620022b6565b620001da9060408101906200224c565b905011620002225760405162461bcd60e51b81526020600482015260146024820152731b9bc8189858dadd5c0818dbdb1b185d195c985b60621b60448201526064016200010b565b6200022d81620022d7565b905062000179565b5060005b620002486080840184620022ff565b905081101562000390576000620002636080850185620022ff565b83818110620002765762000276620022a0565b6200028e92602060609092020190810191506200234b565b6001600160a01b0316141580156200032f57506000620002b26080850185620022ff565b83818110620002c557620002c5620022a0565b620002e092604060609092020190810191506020016200238a565b61ffff1611806200032f57506000620002fd6080850185620022ff565b83818110620003105762000310620022a0565b620003299260609182020190810191506040016200238a565b61ffff16115b6200037d5760405162461bcd60e51b815260206004820152601d60248201527f62656e6566696369617279207265765368617265206d69736d6174636800000060448201526064016200010b565b6200038881620022d7565b905062000239565b5060006001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000166204b647620003cd8680620023a8565b620003dc6020890189620023a8565b620003eb60408b018b620023a8565b308c6060016040518963ffffffff1660e01b8152600401620004159897969594939291906200249a565b6020604051808303816000875af115801562000435573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200045b919062002710565b90506000816001600160a01b031663dffeadd06040518163ffffffff1660e01b8152600401602060405180830381865afa1580156200049e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620004c4919062002710565b90506000816001600160a01b031663979d7e866040518163ffffffff1660e01b8152600401602060405180830381865afa15801562000507573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200052d919062002710565b90506000826001600160a01b0316632f2439b16040518163ffffffff1660e01b8152600401602060405180830381865afa15801562000570573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000596919062002710565b905060005b620005a787806200224c565b9050811015620006b6576001600160a01b038316634420e486620005cc89806200224c565b84818110620005df57620005df620022a0565b9050602002016020810190620005f691906200234b565b6040516001600160e01b031960e084901b1681526001600160a01b0390911660048201526024016020604051808303816000875af11580156200063d573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000663919062002730565b620006a35760405162461bcd60e51b815260206004820152600f60248201526e191d5c1b1a58d85d1948185cdcd95d608a1b60448201526064016200010b565b620006ae81620022d7565b90506200059b565b506000620006c860208801886200224c565b905067ffffffffffffffff811115620006e557620006e562002750565b6040519080825280602002602001820160405280156200070f578160200160208202803683370190505b50905060005b6200072460208901896200224c565b90508110156200090b576001600160a01b038416634420e4866200074c60208b018b6200224c565b848181106200075f576200075f620022a0565b90506020020160208101906200077691906200234b565b6040516001600160e01b031960e084901b1681526001600160a01b0390911660048201526024016020604051808303816000875af1158015620007bd573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620007e3919062002730565b620008285760405162461bcd60e51b8152602060048201526014602482015273191d5c1b1a58d85d194818dbdb1b185d195c985b60621b60448201526064016200010b565b60006200083960208a018a6200224c565b838181106200084c576200084c620022a0565b90506020020160208101906200086391906200234b565b6001600160a01b031663785e9e866040518163ffffffff1660e01b8152600401602060405180830381865afa158015620008a1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620008c7919062002710565b905080838381518110620008df57620008df620022a0565b6001600160a01b0390921660209283029190910190910152506200090381620022d7565b905062000715565b506001600160a01b03821663ef2b9337826200092b60408b018b6200224c565b6040518463ffffffff1660e01b81526004016200094b93929190620027ac565b600060405180830381600087803b1580156200096657600080fd5b505af11580156200097b573d6000803e3d6000fd5b50505050816001600160a01b0316638a55015b6040518163ffffffff1660e01b8152600401600060405180830381600087803b158015620009bb57600080fd5b505af1158015620009d0573d6000803e3d6000fd5b505050505060005b620009e760608801886200224c565b905081101562000d5c57600062000a0260608901896200224c565b8381811062000a155762000a15620022a0565b905060200281019062000a299190620022b6565b62000a399060408101906200224c565b905067ffffffffffffffff81111562000a565762000a5662002750565b60405190808252806020026020018201604052801562000a80578160200160208202803683370190505b50905060005b62000a9560608a018a6200224c565b8481811062000aa85762000aa8620022a0565b905060200281019062000abc9190620022b6565b62000acc9060408101906200224c565b905081101562000c7157600062000ae760608b018b6200224c565b8581811062000afa5762000afa620022a0565b905060200281019062000b0e9190620022b6565b62000b1e9060408101906200224c565b8381811062000b315762000b31620022a0565b905060200201602081019062000b4891906200234b565b604051632210724360e11b81526001600160a01b03808316600483015291925090871690634420e486906024016020604051808303816000875af115801562000b95573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000bbb919062002730565b506000816001600160a01b031663785e9e866040518163ffffffff1660e01b8152600401602060405180830381865afa15801562000bfd573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000c23919062002710565b90508084848151811062000c3b5762000c3b620022a0565b60200260200101906001600160a01b031690816001600160a01b03168152505050508062000c6990620022d7565b905062000a86565b506001600160a01b03831663f11d464862000c9060608b018b6200224c565b8581811062000ca35762000ca3620022a0565b905060200281019062000cb79190620022b6565b3562000cc760608c018c6200224c565b8681811062000cda5762000cda620022a0565b905060200281019062000cee9190620022b6565b60200135846040518463ffffffff1660e01b815260040162000d139392919062002813565b600060405180830381600087803b15801562000d2e57600080fd5b505af115801562000d43573d6000803e3d6000fd5b50505050508062000d5490620022d7565b9050620009d8565b5060005b62000d6f6080880188620022ff565b905081101562000eb857836001600160a01b031663bfe109286040518163ffffffff1660e01b8152600401602060405180830381865afa15801562000db8573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000dde919062002710565b6001600160a01b0316638859443762000dfb60808a018a620022ff565b8481811062000e0e5762000e0e620022a0565b62000e2692602060609092020190810191506200234b565b62000e3560808b018b620022ff565b8581811062000e485762000e48620022a0565b9050606002016020016040518363ffffffff1660e01b815260040162000e709291906200283d565b600060405180830381600087803b15801562000e8b57600080fd5b505af115801562000ea0573d6000803e3d6000fd5b505050508062000eb090620022d7565b905062000d60565b50826001600160a01b0316632f2ff15d604051806040016040528060068152602001652820aaa9a2a960d11b81525062000ef2906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b15801562000f3257600080fd5b505af115801562000f47573d6000803e3d6000fd5b50505050826001600160a01b0316631031e36e6040518163ffffffff1660e01b8152600401600060405180830381600087803b15801562000f8757600080fd5b505af115801562000f9c573d6000803e3d6000fd5b50505050826001600160a01b031663df23cbb16040518163ffffffff1660e01b8152600401600060405180830381600087803b15801562000fdc57600080fd5b505af115801562000ff1573d6000803e3d6000fd5b50505050826001600160a01b031663d547741f604051806040016040528060068152602001652820aaa9a2a960d11b8152506200102e906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b1580156200106e57600080fd5b505af115801562001083573d6000803e3d6000fd5b50505050826001600160a01b0316632f2ff15d6040518060400160405280600581526020016427aba722a960d91b815250620010bf906200285c565b6040516001600160e01b031960e084901b1681526004810191909152336024820152604401600060405180830381600087803b158015620010ff57600080fd5b505af115801562001114573d6000803e3d6000fd5b50959998505050505050505050565b600080866001600160a01b031663dffeadd06040518163ffffffff1660e01b8152600401602060405180830381865afa15801562001165573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200118b919062002710565b9050806001600160a01b03166391d148546040518060400160405280600581526020016427aba722a960d91b815250620011c5906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401602060405180830381865afa15801562001208573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200122e919062002730565b6200127c5760405162461bcd60e51b815260206004820152601d60248201527f6f776e65727368697020616c7265616479207472616e7366657272656400000060448201526064016200010b565b806001600160a01b03166391d148546040518060400160405280600581526020016427aba722a960d91b815250620012b4906200285c565b6040516001600160e01b031960e084901b1681526004810191909152336024820152604401602060405180830381865afa158015620012f7573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200131d919062002730565b620013625760405162461bcd60e51b81526020600482015260146024820152733737ba1034b734ba34b0b6103232b83637bcb2b960611b60448201526064016200010b565b806001600160a01b031663d547741f6040518060400160405280600581526020016427aba722a960d91b8152506200139a906200285c565b6040516001600160e01b031960e084901b1681526004810191909152336024820152604401600060405180830381600087803b158015620013da57600080fd5b505af1158015620013ef573d6000803e3d6000fd5b505050508515620019845760006200140b60208501856200234b565b6001600160a01b0316146200145b5760405162461bcd60e51b81526020600482015260156024820152746f776e65722073686f756c6420626520656d70747960581b60448201526064016200010b565b6040805160008082526020820181815282840193849052909260808801359291906200148790620020f5565b620014959392919062002881565b604051809103906000f080158015620014b2573d6000803e3d6000fd5b509050600073908cd3b4b4b6c60d5eb7d1ca7ecda0e7cecd6db1630c48221d846001600160a01b0316634780a5e56040518163ffffffff1660e01b8152600401602060405180830381865afa15801562001510573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001536919062002710565b604080516001600160e01b031960e085901b1681526001600160a01b03928316600482015291861660248301528935604483015260208a013560648301528901356084820152606089013560a482015260c401602060405180830381865af4158015620015a7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620015cd919062002710565b9050816001600160a01b0316816001600160a01b03168a6001600160a01b03167f777419e2e4c706c5ea8f18b5292cc23249798ba28513b11080b97f44ca87fbd060405160405180910390a4816001600160a01b0316632f2ff15d836001600160a01b0316638f61f4f56040518163ffffffff1660e01b8152600401602060405180830381865afa15801562001667573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200168d9190620028ba565b6040516001600160e01b031960e084901b16815260048101919091526001600160a01b0384166024820152604401600060405180830381600087803b158015620016d657600080fd5b505af1158015620016eb573d6000803e3d6000fd5b50505050816001600160a01b0316632f2ff15d836001600160a01b031663b08e51c06040518163ffffffff1660e01b8152600401602060405180830381865afa1580156200173d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620017639190620028ba565b620017756040890160208a016200234b565b6040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401600060405180830381600087803b158015620017bd57600080fd5b505af1158015620017d2573d6000803e3d6000fd5b50505050816001600160a01b0316632f2ff15d836001600160a01b03166307bd02656040518163ffffffff1660e01b8152600401602060405180830381865afa15801562001824573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200184a9190620028ba565b6040516001600160e01b031960e084901b16815260048101919091526001600160a01b0384166024820152604401600060405180830381600087803b1580156200189357600080fd5b505af1158015620018a8573d6000803e3d6000fd5b50505050816001600160a01b031663d547741f836001600160a01b0316630d3cf6fc6040518163ffffffff1660e01b8152600401602060405180830381865afa158015620018fa573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620019209190620028ba565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b1580156200196057600080fd5b505af115801562001975573d6000803e3d6000fd5b505050508193505050620019f3565b60006200199560208501856200234b565b6001600160a01b031603620019e15760405162461bcd60e51b81526020600482015260116024820152701bdddb995c881b9bdd081919599a5b9959607a1b60448201526064016200010b565b620019f060208401846200234b565b91505b60005b62001a0560408501856200224c565b905081101562001b4057600062001a2060408601866200224c565b8381811062001a335762001a33620022a0565b905060200201602081019062001a4a91906200234b565b6001600160a01b03161462001b2d57816001600160a01b0316632f2ff15d604051806040016040528060068152602001652820aaa9a2a960d11b81525062001a92906200285c565b62001aa160408801886200224c565b8581811062001ab45762001ab4620022a0565b905060200201602081019062001acb91906200234b565b6040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401600060405180830381600087803b15801562001b1357600080fd5b505af115801562001b28573d6000803e3d6000fd5b505050505b62001b3881620022d7565b9050620019f6565b5060005b62001b5360608501856200224c565b905081101562001c9557600062001b6e60608601866200224c565b8381811062001b815762001b81620022a0565b905060200201602081019062001b9891906200234b565b6001600160a01b03161462001c8257816001600160a01b0316632f2ff15d6040518060400160405280600d81526020016c29a427a92a2fa32922a2ad22a960991b81525062001be7906200285c565b62001bf660608801886200224c565b8581811062001c095762001c09620022a0565b905060200201602081019062001c2091906200234b565b6040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401600060405180830381600087803b15801562001c6857600080fd5b505af115801562001c7d573d6000803e3d6000fd5b505050505b62001c8d81620022d7565b905062001b44565b5060005b62001ca860808501856200224c565b905081101562001de957600062001cc360808601866200224c565b8381811062001cd65762001cd6620022a0565b905060200201602081019062001ced91906200234b565b6001600160a01b03161462001dd657816001600160a01b0316632f2ff15d6040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b81525062001d3b906200285c565b62001d4a60808801886200224c565b8581811062001d5d5762001d5d620022a0565b905060200201602081019062001d7491906200234b565b6040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401600060405180830381600087803b15801562001dbc57600080fd5b505af115801562001dd1573d6000803e3d6000fd5b505050505b62001de181620022d7565b905062001c99565b50841562001fc057806001600160a01b0316632f2ff15d604051806040016040528060068152602001652820aaa9a2a960d11b81525062001e2a906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b15801562001e6a57600080fd5b505af115801562001e7f573d6000803e3d6000fd5b50505050806001600160a01b031663456068d26040518163ffffffff1660e01b8152600401600060405180830381600087803b15801562001ebf57600080fd5b505af115801562001ed4573d6000803e3d6000fd5b50505050806001600160a01b0316632585a2706040518163ffffffff1660e01b8152600401600060405180830381600087803b15801562001f1457600080fd5b505af115801562001f29573d6000803e3d6000fd5b50505050806001600160a01b031663d547741f604051806040016040528060068152602001652820aaa9a2a960d11b81525062001f66906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b15801562001fa657600080fd5b505af115801562001fbb573d6000803e3d6000fd5b505050505b806001600160a01b0316632f2ff15d6040518060400160405280600581526020016427aba722a960d91b81525062001ff8906200285c565b6040516001600160e01b031960e084901b16815260048101919091526001600160a01b0385166024820152604401600060405180830381600087803b1580156200204157600080fd5b505af115801562002056573d6000803e3d6000fd5b50505050806001600160a01b03166336568abe6040518060400160405280600581526020016427aba722a960d91b81525062002092906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b158015620020d257600080fd5b505af1158015620020e7573d6000803e3d6000fd5b505050505095945050505050565b6122d580620028d583390190565b600060a082840312156200211657600080fd5b50919050565b600080604083850312156200213057600080fd5b823567ffffffffffffffff808211156200214957600080fd5b908401906102c082870312156200215f57600080fd5b909250602084013590808211156200217657600080fd5b50620021858582860162002103565b9150509250929050565b6001600160a01b0381168114620021a557600080fd5b50565b8015158114620021a557600080fd5b60008060008060006101208688031215620021d157600080fd5b8535620021de816200218f565b94506020860135620021f081620021a8565b935060408601356200220281620021a8565b925062002213876060880162002103565b915061010086013567ffffffffffffffff8111156200223157600080fd5b6200223f8882890162002103565b9150509295509295909350565b6000808335601e198436030181126200226457600080fd5b83018035915067ffffffffffffffff8211156200228057600080fd5b6020019150600581901b36038213156200229957600080fd5b9250929050565b634e487b7160e01b600052603260045260246000fd5b60008235605e19833603018112620022cd57600080fd5b9190910192915050565b600060018201620022f857634e487b7160e01b600052601160045260246000fd5b5060010190565b6000808335601e198436030181126200231757600080fd5b83018035915067ffffffffffffffff8211156200233357600080fd5b60200191506060810236038213156200229957600080fd5b6000602082840312156200235e57600080fd5b81356200236b816200218f565b9392505050565b803561ffff811681146200238557600080fd5b919050565b6000602082840312156200239d57600080fd5b6200236b8262002372565b6000808335601e19843603018112620023c057600080fd5b83018035915067ffffffffffffffff821115620023dc57600080fd5b6020019150368190038213156200229957600080fd5b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff806200242a8362002372565b168352806200243c6020840162002372565b166020840152505050565b80356001600160c01b03811681146200238557600080fd5b803565ffffffffffff811681146200238557600080fd5b803582526001600160c01b03620024906020830162002447565b1660208301525050565b60006102e0808352620024b18184018b8d620023f2565b90508281036020840152620024c881898b620023f2565b90508281036040840152620024df818789620023f2565b6001600160a01b0386166060850152915062002501905060808301846200241b565b6200250f6040840162002447565b6001600160c01b031660c08301526200252b6060840162002447565b6001600160c01b031660e083015262002547608084016200245f565b6101006200255e8185018365ffffffffffff169052565b6200256c60a086016200245f565b9150610120620025858186018465ffffffffffff169052565b6200259360c0870162002447565b9250610140620025ad818701856001600160c01b03169052565b620025bb60e088016200245f565b9350610160620025d48188018665ffffffffffff169052565b620025e184890162002447565b94506101809350620025fd848801866001600160c01b03169052565b6200260a8389016200245f565b94506101a09250620026258388018665ffffffffffff169052565b620026328289016200245f565b94506101c091506200264d8288018665ffffffffffff169052565b6200265a8189016200245f565b9450506101e0620026748188018665ffffffffffff169052565b620026818489016200245f565b65ffffffffffff811661020089015294506200269f83890162002447565b94506102209350620026bb848801866001600160c01b03169052565b620026c882890162002447565b6001600160c01b0381166102408901529450620026ec6102608801828a0162002476565b505050620027016102a0850182870162002476565b50509998505050505050505050565b6000602082840312156200272357600080fd5b81516200236b816200218f565b6000602082840312156200274357600080fd5b81516200236b81620021a8565b634e487b7160e01b600052604160045260246000fd5b600081518084526020808501945080840160005b83811015620027a15781516001600160a01b0316875295820195908201906001016200277a565b509495945050505050565b604081526000620027c1604083018662002766565b8281036020848101919091528482528591810160005b8681101562002807576001600160c01b03620027f38562002447565b1682529282019290820190600101620027d7565b50979650505050505050565b83815282602082015260606040820152600062002834606083018462002766565b95945050505050565b6001600160a01b0383168152606081016200236b60208301846200241b565b80516020808301519190811015620021165760001960209190910360031b1b16919050565b8381526060602082015260006200289c606083018562002766565b8281036040840152620028b0818562002766565b9695505050505050565b600060208284031215620028cd57600080fd5b505191905056fe60806040523480156200001157600080fd5b50604051620022d5380380620022d58339810160408190526200003491620003f7565b6200004f60008051602062002255833981519152806200021c565b6200007960008051602062002275833981519152600080516020620022558339815191526200021c565b620000a360008051602062002295833981519152600080516020620022558339815191526200021c565b620000cd600080516020620022b5833981519152600080516020620022558339815191526200021c565b620000e8600080516020620022558339815191523362000267565b62000103600080516020620022558339815191523062000267565b60005b825181101562000189576200014d600080516020620022758339815191528483815181106200013957620001396200046b565b60200260200101516200026760201b60201c565b62000176600080516020620022b58339815191528483815181106200013957620001396200046b565b620001818162000481565b905062000106565b5060005b8151811015620001d357620001c0600080516020620022958339815191528383815181106200013957620001396200046b565b620001cb8162000481565b90506200018d565b5060028390556040805160008152602081018590527f11c24f4ead16507c69ac467fbd5e4eed5fb5c699626d2cc6d66421df253886d5910160405180910390a1505050620004a9565b600082815260208190526040808220600101805490849055905190918391839186917fbd79b86ffe0ab8e8776151514217cd7cacd52c909f66475c3af44e129f0b00ff9190a4505050565b62000273828262000277565b5050565b6000828152602081815260408083206001600160a01b038516845290915290205460ff1662000273576000828152602081815260408083206001600160a01b03851684529091529020805460ff19166001179055620002d33390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b634e487b7160e01b600052604160045260246000fd5b80516001600160a01b03811681146200034557600080fd5b919050565b600082601f8301126200035c57600080fd5b815160206001600160401b03808311156200037b576200037b62000317565b8260051b604051601f19603f83011681018181108482111715620003a357620003a362000317565b604052938452858101830193838101925087851115620003c257600080fd5b83870191505b84821015620003ec57620003dc826200032d565b83529183019190830190620003c8565b979650505050505050565b6000806000606084860312156200040d57600080fd5b835160208501519093506001600160401b03808211156200042d57600080fd5b6200043b878388016200034a565b935060408601519150808211156200045257600080fd5b5062000461868287016200034a565b9150509250925092565b634e487b7160e01b600052603260045260246000fd5b600060018201620004a257634e487b7160e01b600052601160045260246000fd5b5060010190565b611d9c80620004b96000396000f3fe6080604052600436106101bb5760003560e01c80638065657f116100ec578063bc197c811161008a578063d547741f11610064578063d547741f14610582578063e38335e5146105a2578063f23a6e61146105b5578063f27a0c92146105e157600080fd5b8063bc197c8114610509578063c4d252f514610535578063d45c44351461055557600080fd5b806391d14854116100c657806391d1485414610480578063a217fddf146104a0578063b08e51c0146104b5578063b1c5f427146104e957600080fd5b80638065657f1461040c5780638f2a0bb01461042c5780638f61f4f51461044c57600080fd5b8063248a9ca31161015957806331d507501161013357806331d507501461038c57806336568abe146103ac578063584b153e146103cc57806364d62353146103ec57600080fd5b8063248a9ca31461030b5780632ab0f5291461033b5780632f2ff15d1461036c57600080fd5b80630d3cf6fc116101955780630d3cf6fc14610260578063134008d31461029457806313bc9f20146102a7578063150b7a02146102c757600080fd5b806301d5062a146101c757806301ffc9a7146101e957806307bd02651461021e57600080fd5b366101c257005b600080fd5b3480156101d357600080fd5b506101e76101e23660046113b9565b6105f6565b005b3480156101f557600080fd5b5061020961020436600461142d565b61068b565b60405190151581526020015b60405180910390f35b34801561022a57600080fd5b506102527fd8aa0f3194971a2a116679f7c2090f6939c8d4e01a2a8d7e41d55e5351469e6381565b604051908152602001610215565b34801561026c57600080fd5b506102527f5f58e3a2316349923ce3780f8d587db2d72378aed66a8261c916544fa6846ca581565b6101e76102a2366004611457565b6106b6565b3480156102b357600080fd5b506102096102c23660046114c2565b61076b565b3480156102d357600080fd5b506102f26102e2366004611590565b630a85bd0160e11b949350505050565b6040516001600160e01b03199091168152602001610215565b34801561031757600080fd5b506102526103263660046114c2565b60009081526020819052604090206001015490565b34801561034757600080fd5b506102096103563660046114c2565b6000908152600160208190526040909120541490565b34801561037857600080fd5b506101e76103873660046115f7565b610791565b34801561039857600080fd5b506102096103a73660046114c2565b6107bb565b3480156103b857600080fd5b506101e76103c73660046115f7565b6107d4565b3480156103d857600080fd5b506102096103e73660046114c2565b610857565b3480156103f857600080fd5b506101e76104073660046114c2565b61086d565b34801561041857600080fd5b50610252610427366004611457565b610911565b34801561043857600080fd5b506101e7610447366004611667565b610950565b34801561045857600080fd5b506102527fb09aa5aeb3702cfd50b6b62bc4532604938f21248a27a1d5ca736082b6819cc181565b34801561048c57600080fd5b5061020961049b3660046115f7565b610aa2565b3480156104ac57600080fd5b50610252600081565b3480156104c157600080fd5b506102527ffd643c72710c63c0180259aba6b2d05451e3591a24e58b62239378085726f78381565b3480156104f557600080fd5b50610252610504366004611718565b610acb565b34801561051557600080fd5b506102f261052436600461183f565b63bc197c8160e01b95945050505050565b34801561054157600080fd5b506101e76105503660046114c2565b610b10565b34801561056157600080fd5b506102526105703660046114c2565b60009081526001602052604090205490565b34801561058e57600080fd5b506101e761059d3660046115f7565b610be5565b6101e76105b0366004611718565b610c0a565b3480156105c157600080fd5b506102f26105d03660046118e8565b63f23a6e6160e01b95945050505050565b3480156105ed57600080fd5b50600254610252565b7fb09aa5aeb3702cfd50b6b62bc4532604938f21248a27a1d5ca736082b6819cc161062081610d94565b6000610630898989898989610911565b905061063c8184610da1565b6000817f4cf4410cc57040e44862ef0f45f3dd5a5e02db8eb8add648d4b0e236f1d07dca8b8b8b8b8b8a60405161067896959493929190611975565b60405180910390a3505050505050505050565b60006001600160e01b03198216630271189760e51b14806106b057506106b082610e90565b92915050565b7fd8aa0f3194971a2a116679f7c2090f6939c8d4e01a2a8d7e41d55e5351469e636106e2816000610aa2565b6106f0576106f08133610ec5565b6000610700888888888888610911565b905061070c8185610f29565b61071888888888610fc5565b6000817fc2617efa69bab66782fa219543714338489c4e9e178271560a91b82c3f612b588a8a8a8a60405161075094939291906119b2565b60405180910390a361076181611098565b5050505050505050565b60008181526001602052604081205460018111801561078a5750428111155b9392505050565b6000828152602081905260409020600101546107ac81610d94565b6107b683836110d1565b505050565b60008181526001602052604081205481905b1192915050565b6001600160a01b03811633146108495760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084015b60405180910390fd5b6108538282611155565b5050565b60008181526001602081905260408220546107cd565b3330146108d05760405162461bcd60e51b815260206004820152602b60248201527f54696d656c6f636b436f6e74726f6c6c65723a2063616c6c6572206d7573742060448201526a62652074696d656c6f636b60a81b6064820152608401610840565b60025460408051918252602082018390527f11c24f4ead16507c69ac467fbd5e4eed5fb5c699626d2cc6d66421df253886d5910160405180910390a1600255565b600086868686868660405160200161092e96959493929190611975565b6040516020818303038152906040528051906020012090509695505050505050565b7fb09aa5aeb3702cfd50b6b62bc4532604938f21248a27a1d5ca736082b6819cc161097a81610d94565b8887146109995760405162461bcd60e51b8152600401610840906119e4565b8885146109b85760405162461bcd60e51b8152600401610840906119e4565b60006109ca8b8b8b8b8b8b8b8b610acb565b90506109d68184610da1565b60005b8a811015610a945780827f4cf4410cc57040e44862ef0f45f3dd5a5e02db8eb8add648d4b0e236f1d07dca8e8e85818110610a1657610a16611a27565b9050602002016020810190610a2b9190611a3d565b8d8d86818110610a3d57610a3d611a27565b905060200201358c8c87818110610a5657610a56611a27565b9050602002810190610a689190611a58565b8c8b604051610a7c96959493929190611975565b60405180910390a3610a8d81611ab4565b90506109d9565b505050505050505050505050565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b60008888888888888888604051602001610aec989796959493929190611b5e565b60405160208183030381529060405280519060200120905098975050505050505050565b7ffd643c72710c63c0180259aba6b2d05451e3591a24e58b62239378085726f783610b3a81610d94565b610b4382610857565b610ba95760405162461bcd60e51b815260206004820152603160248201527f54696d656c6f636b436f6e74726f6c6c65723a206f7065726174696f6e2063616044820152701b9b9bdd0818994818d85b98d95b1b1959607a1b6064820152608401610840565b6000828152600160205260408082208290555183917fbaa1eb22f2a492ba1a5fea61b8df4d27c6c8b5f3971e63bb58fa14ff72eedb7091a25050565b600082815260208190526040902060010154610c0081610d94565b6107b68383611155565b7fd8aa0f3194971a2a116679f7c2090f6939c8d4e01a2a8d7e41d55e5351469e63610c36816000610aa2565b610c4457610c448133610ec5565b878614610c635760405162461bcd60e51b8152600401610840906119e4565b878414610c825760405162461bcd60e51b8152600401610840906119e4565b6000610c948a8a8a8a8a8a8a8a610acb565b9050610ca08185610f29565b60005b89811015610d7e5760008b8b83818110610cbf57610cbf611a27565b9050602002016020810190610cd49190611a3d565b905060008a8a84818110610cea57610cea611a27565b9050602002013590503660008a8a86818110610d0857610d08611a27565b9050602002810190610d1a9190611a58565b91509150610d2a84848484610fc5565b84867fc2617efa69bab66782fa219543714338489c4e9e178271560a91b82c3f612b5886868686604051610d6194939291906119b2565b60405180910390a35050505080610d7790611ab4565b9050610ca3565b50610d8881611098565b50505050505050505050565b610d9e8133610ec5565b50565b610daa826107bb565b15610e0f5760405162461bcd60e51b815260206004820152602f60248201527f54696d656c6f636b436f6e74726f6c6c65723a206f7065726174696f6e20616c60448201526e1c9958591e481cd8da19591d5b1959608a1b6064820152608401610840565b600254811015610e705760405162461bcd60e51b815260206004820152602660248201527f54696d656c6f636b436f6e74726f6c6c65723a20696e73756666696369656e746044820152652064656c617960d01b6064820152608401610840565b610e7a8142611bff565b6000928352600160205260409092209190915550565b60006001600160e01b03198216637965db0b60e01b14806106b057506301ffc9a760e01b6001600160e01b03198316146106b0565b610ecf8282610aa2565b61085357610ee7816001600160a01b031660146111ba565b610ef28360206111ba565b604051602001610f03929190611c36565b60408051601f198184030181529082905262461bcd60e51b825261084091600401611cab565b610f328261076b565b610f4e5760405162461bcd60e51b815260040161084090611cde565b801580610f6a5750600081815260016020819052604090912054145b6108535760405162461bcd60e51b815260206004820152602660248201527f54696d656c6f636b436f6e74726f6c6c65723a206d697373696e6720646570656044820152656e64656e637960d01b6064820152608401610840565b6000846001600160a01b0316848484604051610fe2929190611d28565b60006040518083038185875af1925050503d806000811461101f576040519150601f19603f3d011682016040523d82523d6000602084013e611024565b606091505b50509050806110915760405162461bcd60e51b815260206004820152603360248201527f54696d656c6f636b436f6e74726f6c6c65723a20756e6465726c79696e6720746044820152721c985b9cd858dd1a5bdb881c995d995c9d1959606a1b6064820152608401610840565b5050505050565b6110a18161076b565b6110bd5760405162461bcd60e51b815260040161084090611cde565b600090815260016020819052604090912055565b6110db8282610aa2565b610853576000828152602081815260408083206001600160a01b03851684529091529020805460ff191660011790556111113390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b61115f8282610aa2565b15610853576000828152602081815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b606060006111c9836002611d38565b6111d4906002611bff565b6001600160401b038111156111eb576111eb6114db565b6040519080825280601f01601f191660200182016040528015611215576020820181803683370190505b509050600360fc1b8160008151811061123057611230611a27565b60200101906001600160f81b031916908160001a905350600f60fb1b8160018151811061125f5761125f611a27565b60200101906001600160f81b031916908160001a9053506000611283846002611d38565b61128e906001611bff565b90505b6001811115611306576f181899199a1a9b1b9c1cb0b131b232b360811b85600f16601081106112c2576112c2611a27565b1a60f81b8282815181106112d8576112d8611a27565b60200101906001600160f81b031916908160001a90535060049490941c936112ff81611d4f565b9050611291565b50831561078a5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610840565b80356001600160a01b038116811461136c57600080fd5b919050565b60008083601f84011261138357600080fd5b5081356001600160401b0381111561139a57600080fd5b6020830191508360208285010111156113b257600080fd5b9250929050565b600080600080600080600060c0888a0312156113d457600080fd5b6113dd88611355565b96506020880135955060408801356001600160401b038111156113ff57600080fd5b61140b8a828b01611371565b989b979a50986060810135976080820135975060a09091013595509350505050565b60006020828403121561143f57600080fd5b81356001600160e01b03198116811461078a57600080fd5b60008060008060008060a0878903121561147057600080fd5b61147987611355565b95506020870135945060408701356001600160401b0381111561149b57600080fd5b6114a789828a01611371565b979a9699509760608101359660809091013595509350505050565b6000602082840312156114d457600080fd5b5035919050565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611519576115196114db565b604052919050565b600082601f83011261153257600080fd5b81356001600160401b0381111561154b5761154b6114db565b61155e601f8201601f19166020016114f1565b81815284602083860101111561157357600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080608085870312156115a657600080fd5b6115af85611355565b93506115bd60208601611355565b92506040850135915060608501356001600160401b038111156115df57600080fd5b6115eb87828801611521565b91505092959194509250565b6000806040838503121561160a57600080fd5b8235915061161a60208401611355565b90509250929050565b60008083601f84011261163557600080fd5b5081356001600160401b0381111561164c57600080fd5b6020830191508360208260051b85010111156113b257600080fd5b600080600080600080600080600060c08a8c03121561168557600080fd5b89356001600160401b038082111561169c57600080fd5b6116a88d838e01611623565b909b50995060208c01359150808211156116c157600080fd5b6116cd8d838e01611623565b909950975060408c01359150808211156116e657600080fd5b506116f38c828d01611623565b9a9d999c50979a969997986060880135976080810135975060a0013595509350505050565b60008060008060008060008060a0898b03121561173457600080fd5b88356001600160401b038082111561174b57600080fd5b6117578c838d01611623565b909a50985060208b013591508082111561177057600080fd5b61177c8c838d01611623565b909850965060408b013591508082111561179557600080fd5b506117a28b828c01611623565b999c989b509699959896976060870135966080013595509350505050565b600082601f8301126117d157600080fd5b813560206001600160401b038211156117ec576117ec6114db565b8160051b6117fb8282016114f1565b928352848101820192828101908785111561181557600080fd5b83870192505b848310156118345782358252918301919083019061181b565b979650505050505050565b600080600080600060a0868803121561185757600080fd5b61186086611355565b945061186e60208701611355565b935060408601356001600160401b038082111561188a57600080fd5b61189689838a016117c0565b945060608801359150808211156118ac57600080fd5b6118b889838a016117c0565b935060808801359150808211156118ce57600080fd5b506118db88828901611521565b9150509295509295909350565b600080600080600060a0868803121561190057600080fd5b61190986611355565b945061191760208701611355565b9350604086013592506060860135915060808601356001600160401b0381111561194057600080fd5b6118db88828901611521565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60018060a01b038716815285602082015260a06040820152600061199d60a08301868861194c565b60608301949094525060800152949350505050565b60018060a01b03851681528360208201526060604082015260006119da60608301848661194c565b9695505050505050565b60208082526023908201527f54696d656c6f636b436f6e74726f6c6c65723a206c656e677468206d69736d616040820152620e8c6d60eb1b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b600060208284031215611a4f57600080fd5b61078a82611355565b6000808335601e19843603018112611a6f57600080fd5b8301803591506001600160401b03821115611a8957600080fd5b6020019150368190038213156113b257600080fd5b634e487b7160e01b600052601160045260246000fd5b600060018201611ac657611ac6611a9e565b5060010190565b81835260006020808501808196508560051b810191508460005b87811015611b515782840389528135601e19883603018112611b0857600080fd5b870185810190356001600160401b03811115611b2357600080fd5b803603821315611b3257600080fd5b611b3d86828461194c565b9a87019a9550505090840190600101611ae7565b5091979650505050505050565b60a0808252810188905260008960c08301825b8b811015611b9f576001600160a01b03611b8a84611355565b16825260209283019290910190600101611b71565b5083810360208501528881526001600160fb1b03891115611bbf57600080fd5b8860051b9150818a60208301370182810360209081016040850152611be79082018789611acd565b60608401959095525050608001529695505050505050565b808201808211156106b0576106b0611a9e565b60005b83811015611c2d578181015183820152602001611c15565b50506000910152565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351611c6e816017850160208801611c12565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351611c9f816028840160208801611c12565b01602801949350505050565b6020815260008251806020840152611cca816040850160208701611c12565b601f01601f19169190910160400192915050565b6020808252602a908201527f54696d656c6f636b436f6e74726f6c6c65723a206f7065726174696f6e206973604082015269206e6f7420726561647960b01b606082015260800190565b8183823760009101908152919050565b80820281158282048414176106b0576106b0611a9e565b600081611d5e57611d5e611a9e565b50600019019056fea26469706673582212205852bfd074c25eca0dec6c591a58e2b56d7c574c40e8eb6375dea9c2c537191464736f6c634300081300335f58e3a2316349923ce3780f8d587db2d72378aed66a8261c916544fa6846ca5b09aa5aeb3702cfd50b6b62bc4532604938f21248a27a1d5ca736082b6819cc1d8aa0f3194971a2a116679f7c2090f6939c8d4e01a2a8d7e41d55e5351469e63fd643c72710c63c0180259aba6b2d05451e3591a24e58b62239378085726f783a264697066735822122024b58fcd271927ab399468aaa575f66af4a83facb5548c925a036a122538b0d764736f6c6343000813003300000000000000000000000043587caa7de69c3c2ad0fb73d4c9da67a8e35b0b
Deployed Bytecode
0x60806040523480156200001157600080fd5b5060043610620000465760003560e01c8063a8150a38146200004b578063c8d87723146200007e578063d5f394881462000095575b600080fd5b620000626200005c3660046200211c565b620000bd565b6040516001600160a01b03909116815260200160405180910390f35b620000626200008f366004620021b7565b62001123565b620000627f00000000000000000000000043587caa7de69c3c2ad0fb73d4c9da67a8e35b0b81565b600080620000cf60208401846200224c565b905011620001145760405162461bcd60e51b815260206004820152600d60248201526c1b9bc818dbdb1b185d195c985b609a1b60448201526064015b60405180910390fd5b6200012360408301836200224c565b90506200013460208401846200224c565b905014620001765760405162461bcd60e51b815260206004820152600e60248201526d0d2dcecc2d8d2c840d8cadccee8d60931b60448201526064016200010b565b60005b6200018860608401846200224c565b905081101562000235576000620001a360608501856200224c565b83818110620001b657620001b6620022a0565b9050602002810190620001ca9190620022b6565b620001da9060408101906200224c565b905011620002225760405162461bcd60e51b81526020600482015260146024820152731b9bc8189858dadd5c0818dbdb1b185d195c985b60621b60448201526064016200010b565b6200022d81620022d7565b905062000179565b5060005b620002486080840184620022ff565b905081101562000390576000620002636080850185620022ff565b83818110620002765762000276620022a0565b6200028e92602060609092020190810191506200234b565b6001600160a01b0316141580156200032f57506000620002b26080850185620022ff565b83818110620002c557620002c5620022a0565b620002e092604060609092020190810191506020016200238a565b61ffff1611806200032f57506000620002fd6080850185620022ff565b83818110620003105762000310620022a0565b620003299260609182020190810191506040016200238a565b61ffff16115b6200037d5760405162461bcd60e51b815260206004820152601d60248201527f62656e6566696369617279207265765368617265206d69736d6174636800000060448201526064016200010b565b6200038881620022d7565b905062000239565b5060006001600160a01b037f00000000000000000000000043587caa7de69c3c2ad0fb73d4c9da67a8e35b0b166204b647620003cd8680620023a8565b620003dc6020890189620023a8565b620003eb60408b018b620023a8565b308c6060016040518963ffffffff1660e01b8152600401620004159897969594939291906200249a565b6020604051808303816000875af115801562000435573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200045b919062002710565b90506000816001600160a01b031663dffeadd06040518163ffffffff1660e01b8152600401602060405180830381865afa1580156200049e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620004c4919062002710565b90506000816001600160a01b031663979d7e866040518163ffffffff1660e01b8152600401602060405180830381865afa15801562000507573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200052d919062002710565b90506000826001600160a01b0316632f2439b16040518163ffffffff1660e01b8152600401602060405180830381865afa15801562000570573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000596919062002710565b905060005b620005a787806200224c565b9050811015620006b6576001600160a01b038316634420e486620005cc89806200224c565b84818110620005df57620005df620022a0565b9050602002016020810190620005f691906200234b565b6040516001600160e01b031960e084901b1681526001600160a01b0390911660048201526024016020604051808303816000875af11580156200063d573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000663919062002730565b620006a35760405162461bcd60e51b815260206004820152600f60248201526e191d5c1b1a58d85d1948185cdcd95d608a1b60448201526064016200010b565b620006ae81620022d7565b90506200059b565b506000620006c860208801886200224c565b905067ffffffffffffffff811115620006e557620006e562002750565b6040519080825280602002602001820160405280156200070f578160200160208202803683370190505b50905060005b6200072460208901896200224c565b90508110156200090b576001600160a01b038416634420e4866200074c60208b018b6200224c565b848181106200075f576200075f620022a0565b90506020020160208101906200077691906200234b565b6040516001600160e01b031960e084901b1681526001600160a01b0390911660048201526024016020604051808303816000875af1158015620007bd573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620007e3919062002730565b620008285760405162461bcd60e51b8152602060048201526014602482015273191d5c1b1a58d85d194818dbdb1b185d195c985b60621b60448201526064016200010b565b60006200083960208a018a6200224c565b838181106200084c576200084c620022a0565b90506020020160208101906200086391906200234b565b6001600160a01b031663785e9e866040518163ffffffff1660e01b8152600401602060405180830381865afa158015620008a1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620008c7919062002710565b905080838381518110620008df57620008df620022a0565b6001600160a01b0390921660209283029190910190910152506200090381620022d7565b905062000715565b506001600160a01b03821663ef2b9337826200092b60408b018b6200224c565b6040518463ffffffff1660e01b81526004016200094b93929190620027ac565b600060405180830381600087803b1580156200096657600080fd5b505af11580156200097b573d6000803e3d6000fd5b50505050816001600160a01b0316638a55015b6040518163ffffffff1660e01b8152600401600060405180830381600087803b158015620009bb57600080fd5b505af1158015620009d0573d6000803e3d6000fd5b505050505060005b620009e760608801886200224c565b905081101562000d5c57600062000a0260608901896200224c565b8381811062000a155762000a15620022a0565b905060200281019062000a299190620022b6565b62000a399060408101906200224c565b905067ffffffffffffffff81111562000a565762000a5662002750565b60405190808252806020026020018201604052801562000a80578160200160208202803683370190505b50905060005b62000a9560608a018a6200224c565b8481811062000aa85762000aa8620022a0565b905060200281019062000abc9190620022b6565b62000acc9060408101906200224c565b905081101562000c7157600062000ae760608b018b6200224c565b8581811062000afa5762000afa620022a0565b905060200281019062000b0e9190620022b6565b62000b1e9060408101906200224c565b8381811062000b315762000b31620022a0565b905060200201602081019062000b4891906200234b565b604051632210724360e11b81526001600160a01b03808316600483015291925090871690634420e486906024016020604051808303816000875af115801562000b95573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000bbb919062002730565b506000816001600160a01b031663785e9e866040518163ffffffff1660e01b8152600401602060405180830381865afa15801562000bfd573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000c23919062002710565b90508084848151811062000c3b5762000c3b620022a0565b60200260200101906001600160a01b031690816001600160a01b03168152505050508062000c6990620022d7565b905062000a86565b506001600160a01b03831663f11d464862000c9060608b018b6200224c565b8581811062000ca35762000ca3620022a0565b905060200281019062000cb79190620022b6565b3562000cc760608c018c6200224c565b8681811062000cda5762000cda620022a0565b905060200281019062000cee9190620022b6565b60200135846040518463ffffffff1660e01b815260040162000d139392919062002813565b600060405180830381600087803b15801562000d2e57600080fd5b505af115801562000d43573d6000803e3d6000fd5b50505050508062000d5490620022d7565b9050620009d8565b5060005b62000d6f6080880188620022ff565b905081101562000eb857836001600160a01b031663bfe109286040518163ffffffff1660e01b8152600401602060405180830381865afa15801562000db8573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000dde919062002710565b6001600160a01b0316638859443762000dfb60808a018a620022ff565b8481811062000e0e5762000e0e620022a0565b62000e2692602060609092020190810191506200234b565b62000e3560808b018b620022ff565b8581811062000e485762000e48620022a0565b9050606002016020016040518363ffffffff1660e01b815260040162000e709291906200283d565b600060405180830381600087803b15801562000e8b57600080fd5b505af115801562000ea0573d6000803e3d6000fd5b505050508062000eb090620022d7565b905062000d60565b50826001600160a01b0316632f2ff15d604051806040016040528060068152602001652820aaa9a2a960d11b81525062000ef2906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b15801562000f3257600080fd5b505af115801562000f47573d6000803e3d6000fd5b50505050826001600160a01b0316631031e36e6040518163ffffffff1660e01b8152600401600060405180830381600087803b15801562000f8757600080fd5b505af115801562000f9c573d6000803e3d6000fd5b50505050826001600160a01b031663df23cbb16040518163ffffffff1660e01b8152600401600060405180830381600087803b15801562000fdc57600080fd5b505af115801562000ff1573d6000803e3d6000fd5b50505050826001600160a01b031663d547741f604051806040016040528060068152602001652820aaa9a2a960d11b8152506200102e906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b1580156200106e57600080fd5b505af115801562001083573d6000803e3d6000fd5b50505050826001600160a01b0316632f2ff15d6040518060400160405280600581526020016427aba722a960d91b815250620010bf906200285c565b6040516001600160e01b031960e084901b1681526004810191909152336024820152604401600060405180830381600087803b158015620010ff57600080fd5b505af115801562001114573d6000803e3d6000fd5b50959998505050505050505050565b600080866001600160a01b031663dffeadd06040518163ffffffff1660e01b8152600401602060405180830381865afa15801562001165573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200118b919062002710565b9050806001600160a01b03166391d148546040518060400160405280600581526020016427aba722a960d91b815250620011c5906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401602060405180830381865afa15801562001208573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200122e919062002730565b6200127c5760405162461bcd60e51b815260206004820152601d60248201527f6f776e65727368697020616c7265616479207472616e7366657272656400000060448201526064016200010b565b806001600160a01b03166391d148546040518060400160405280600581526020016427aba722a960d91b815250620012b4906200285c565b6040516001600160e01b031960e084901b1681526004810191909152336024820152604401602060405180830381865afa158015620012f7573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200131d919062002730565b620013625760405162461bcd60e51b81526020600482015260146024820152733737ba1034b734ba34b0b6103232b83637bcb2b960611b60448201526064016200010b565b806001600160a01b031663d547741f6040518060400160405280600581526020016427aba722a960d91b8152506200139a906200285c565b6040516001600160e01b031960e084901b1681526004810191909152336024820152604401600060405180830381600087803b158015620013da57600080fd5b505af1158015620013ef573d6000803e3d6000fd5b505050508515620019845760006200140b60208501856200234b565b6001600160a01b0316146200145b5760405162461bcd60e51b81526020600482015260156024820152746f776e65722073686f756c6420626520656d70747960581b60448201526064016200010b565b6040805160008082526020820181815282840193849052909260808801359291906200148790620020f5565b620014959392919062002881565b604051809103906000f080158015620014b2573d6000803e3d6000fd5b509050600073908cd3b4b4b6c60d5eb7d1ca7ecda0e7cecd6db1630c48221d846001600160a01b0316634780a5e56040518163ffffffff1660e01b8152600401602060405180830381865afa15801562001510573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001536919062002710565b604080516001600160e01b031960e085901b1681526001600160a01b03928316600482015291861660248301528935604483015260208a013560648301528901356084820152606089013560a482015260c401602060405180830381865af4158015620015a7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620015cd919062002710565b9050816001600160a01b0316816001600160a01b03168a6001600160a01b03167f777419e2e4c706c5ea8f18b5292cc23249798ba28513b11080b97f44ca87fbd060405160405180910390a4816001600160a01b0316632f2ff15d836001600160a01b0316638f61f4f56040518163ffffffff1660e01b8152600401602060405180830381865afa15801562001667573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200168d9190620028ba565b6040516001600160e01b031960e084901b16815260048101919091526001600160a01b0384166024820152604401600060405180830381600087803b158015620016d657600080fd5b505af1158015620016eb573d6000803e3d6000fd5b50505050816001600160a01b0316632f2ff15d836001600160a01b031663b08e51c06040518163ffffffff1660e01b8152600401602060405180830381865afa1580156200173d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620017639190620028ba565b620017756040890160208a016200234b565b6040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401600060405180830381600087803b158015620017bd57600080fd5b505af1158015620017d2573d6000803e3d6000fd5b50505050816001600160a01b0316632f2ff15d836001600160a01b03166307bd02656040518163ffffffff1660e01b8152600401602060405180830381865afa15801562001824573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200184a9190620028ba565b6040516001600160e01b031960e084901b16815260048101919091526001600160a01b0384166024820152604401600060405180830381600087803b1580156200189357600080fd5b505af1158015620018a8573d6000803e3d6000fd5b50505050816001600160a01b031663d547741f836001600160a01b0316630d3cf6fc6040518163ffffffff1660e01b8152600401602060405180830381865afa158015620018fa573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620019209190620028ba565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b1580156200196057600080fd5b505af115801562001975573d6000803e3d6000fd5b505050508193505050620019f3565b60006200199560208501856200234b565b6001600160a01b031603620019e15760405162461bcd60e51b81526020600482015260116024820152701bdddb995c881b9bdd081919599a5b9959607a1b60448201526064016200010b565b620019f060208401846200234b565b91505b60005b62001a0560408501856200224c565b905081101562001b4057600062001a2060408601866200224c565b8381811062001a335762001a33620022a0565b905060200201602081019062001a4a91906200234b565b6001600160a01b03161462001b2d57816001600160a01b0316632f2ff15d604051806040016040528060068152602001652820aaa9a2a960d11b81525062001a92906200285c565b62001aa160408801886200224c565b8581811062001ab45762001ab4620022a0565b905060200201602081019062001acb91906200234b565b6040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401600060405180830381600087803b15801562001b1357600080fd5b505af115801562001b28573d6000803e3d6000fd5b505050505b62001b3881620022d7565b9050620019f6565b5060005b62001b5360608501856200224c565b905081101562001c9557600062001b6e60608601866200224c565b8381811062001b815762001b81620022a0565b905060200201602081019062001b9891906200234b565b6001600160a01b03161462001c8257816001600160a01b0316632f2ff15d6040518060400160405280600d81526020016c29a427a92a2fa32922a2ad22a960991b81525062001be7906200285c565b62001bf660608801886200224c565b8581811062001c095762001c09620022a0565b905060200201602081019062001c2091906200234b565b6040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401600060405180830381600087803b15801562001c6857600080fd5b505af115801562001c7d573d6000803e3d6000fd5b505050505b62001c8d81620022d7565b905062001b44565b5060005b62001ca860808501856200224c565b905081101562001de957600062001cc360808601866200224c565b8381811062001cd65762001cd6620022a0565b905060200201602081019062001ced91906200234b565b6001600160a01b03161462001dd657816001600160a01b0316632f2ff15d6040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b81525062001d3b906200285c565b62001d4a60808801886200224c565b8581811062001d5d5762001d5d620022a0565b905060200201602081019062001d7491906200234b565b6040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401600060405180830381600087803b15801562001dbc57600080fd5b505af115801562001dd1573d6000803e3d6000fd5b505050505b62001de181620022d7565b905062001c99565b50841562001fc057806001600160a01b0316632f2ff15d604051806040016040528060068152602001652820aaa9a2a960d11b81525062001e2a906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b15801562001e6a57600080fd5b505af115801562001e7f573d6000803e3d6000fd5b50505050806001600160a01b031663456068d26040518163ffffffff1660e01b8152600401600060405180830381600087803b15801562001ebf57600080fd5b505af115801562001ed4573d6000803e3d6000fd5b50505050806001600160a01b0316632585a2706040518163ffffffff1660e01b8152600401600060405180830381600087803b15801562001f1457600080fd5b505af115801562001f29573d6000803e3d6000fd5b50505050806001600160a01b031663d547741f604051806040016040528060068152602001652820aaa9a2a960d11b81525062001f66906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b15801562001fa657600080fd5b505af115801562001fbb573d6000803e3d6000fd5b505050505b806001600160a01b0316632f2ff15d6040518060400160405280600581526020016427aba722a960d91b81525062001ff8906200285c565b6040516001600160e01b031960e084901b16815260048101919091526001600160a01b0385166024820152604401600060405180830381600087803b1580156200204157600080fd5b505af115801562002056573d6000803e3d6000fd5b50505050806001600160a01b03166336568abe6040518060400160405280600581526020016427aba722a960d91b81525062002092906200285c565b6040516001600160e01b031960e084901b1681526004810191909152306024820152604401600060405180830381600087803b158015620020d257600080fd5b505af1158015620020e7573d6000803e3d6000fd5b505050505095945050505050565b6122d580620028d583390190565b600060a082840312156200211657600080fd5b50919050565b600080604083850312156200213057600080fd5b823567ffffffffffffffff808211156200214957600080fd5b908401906102c082870312156200215f57600080fd5b909250602084013590808211156200217657600080fd5b50620021858582860162002103565b9150509250929050565b6001600160a01b0381168114620021a557600080fd5b50565b8015158114620021a557600080fd5b60008060008060006101208688031215620021d157600080fd5b8535620021de816200218f565b94506020860135620021f081620021a8565b935060408601356200220281620021a8565b925062002213876060880162002103565b915061010086013567ffffffffffffffff8111156200223157600080fd5b6200223f8882890162002103565b9150509295509295909350565b6000808335601e198436030181126200226457600080fd5b83018035915067ffffffffffffffff8211156200228057600080fd5b6020019150600581901b36038213156200229957600080fd5b9250929050565b634e487b7160e01b600052603260045260246000fd5b60008235605e19833603018112620022cd57600080fd5b9190910192915050565b600060018201620022f857634e487b7160e01b600052601160045260246000fd5b5060010190565b6000808335601e198436030181126200231757600080fd5b83018035915067ffffffffffffffff8211156200233357600080fd5b60200191506060810236038213156200229957600080fd5b6000602082840312156200235e57600080fd5b81356200236b816200218f565b9392505050565b803561ffff811681146200238557600080fd5b919050565b6000602082840312156200239d57600080fd5b6200236b8262002372565b6000808335601e19843603018112620023c057600080fd5b83018035915067ffffffffffffffff821115620023dc57600080fd5b6020019150368190038213156200229957600080fd5b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff806200242a8362002372565b168352806200243c6020840162002372565b166020840152505050565b80356001600160c01b03811681146200238557600080fd5b803565ffffffffffff811681146200238557600080fd5b803582526001600160c01b03620024906020830162002447565b1660208301525050565b60006102e0808352620024b18184018b8d620023f2565b90508281036020840152620024c881898b620023f2565b90508281036040840152620024df818789620023f2565b6001600160a01b0386166060850152915062002501905060808301846200241b565b6200250f6040840162002447565b6001600160c01b031660c08301526200252b6060840162002447565b6001600160c01b031660e083015262002547608084016200245f565b6101006200255e8185018365ffffffffffff169052565b6200256c60a086016200245f565b9150610120620025858186018465ffffffffffff169052565b6200259360c0870162002447565b9250610140620025ad818701856001600160c01b03169052565b620025bb60e088016200245f565b9350610160620025d48188018665ffffffffffff169052565b620025e184890162002447565b94506101809350620025fd848801866001600160c01b03169052565b6200260a8389016200245f565b94506101a09250620026258388018665ffffffffffff169052565b620026328289016200245f565b94506101c091506200264d8288018665ffffffffffff169052565b6200265a8189016200245f565b9450506101e0620026748188018665ffffffffffff169052565b620026818489016200245f565b65ffffffffffff811661020089015294506200269f83890162002447565b94506102209350620026bb848801866001600160c01b03169052565b620026c882890162002447565b6001600160c01b0381166102408901529450620026ec6102608801828a0162002476565b505050620027016102a0850182870162002476565b50509998505050505050505050565b6000602082840312156200272357600080fd5b81516200236b816200218f565b6000602082840312156200274357600080fd5b81516200236b81620021a8565b634e487b7160e01b600052604160045260246000fd5b600081518084526020808501945080840160005b83811015620027a15781516001600160a01b0316875295820195908201906001016200277a565b509495945050505050565b604081526000620027c1604083018662002766565b8281036020848101919091528482528591810160005b8681101562002807576001600160c01b03620027f38562002447565b1682529282019290820190600101620027d7565b50979650505050505050565b83815282602082015260606040820152600062002834606083018462002766565b95945050505050565b6001600160a01b0383168152606081016200236b60208301846200241b565b80516020808301519190811015620021165760001960209190910360031b1b16919050565b8381526060602082015260006200289c606083018562002766565b8281036040840152620028b0818562002766565b9695505050505050565b600060208284031215620028cd57600080fd5b505191905056fe60806040523480156200001157600080fd5b50604051620022d5380380620022d58339810160408190526200003491620003f7565b6200004f60008051602062002255833981519152806200021c565b6200007960008051602062002275833981519152600080516020620022558339815191526200021c565b620000a360008051602062002295833981519152600080516020620022558339815191526200021c565b620000cd600080516020620022b5833981519152600080516020620022558339815191526200021c565b620000e8600080516020620022558339815191523362000267565b62000103600080516020620022558339815191523062000267565b60005b825181101562000189576200014d600080516020620022758339815191528483815181106200013957620001396200046b565b60200260200101516200026760201b60201c565b62000176600080516020620022b58339815191528483815181106200013957620001396200046b565b620001818162000481565b905062000106565b5060005b8151811015620001d357620001c0600080516020620022958339815191528383815181106200013957620001396200046b565b620001cb8162000481565b90506200018d565b5060028390556040805160008152602081018590527f11c24f4ead16507c69ac467fbd5e4eed5fb5c699626d2cc6d66421df253886d5910160405180910390a1505050620004a9565b600082815260208190526040808220600101805490849055905190918391839186917fbd79b86ffe0ab8e8776151514217cd7cacd52c909f66475c3af44e129f0b00ff9190a4505050565b62000273828262000277565b5050565b6000828152602081815260408083206001600160a01b038516845290915290205460ff1662000273576000828152602081815260408083206001600160a01b03851684529091529020805460ff19166001179055620002d33390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b634e487b7160e01b600052604160045260246000fd5b80516001600160a01b03811681146200034557600080fd5b919050565b600082601f8301126200035c57600080fd5b815160206001600160401b03808311156200037b576200037b62000317565b8260051b604051601f19603f83011681018181108482111715620003a357620003a362000317565b604052938452858101830193838101925087851115620003c257600080fd5b83870191505b84821015620003ec57620003dc826200032d565b83529183019190830190620003c8565b979650505050505050565b6000806000606084860312156200040d57600080fd5b835160208501519093506001600160401b03808211156200042d57600080fd5b6200043b878388016200034a565b935060408601519150808211156200045257600080fd5b5062000461868287016200034a565b9150509250925092565b634e487b7160e01b600052603260045260246000fd5b600060018201620004a257634e487b7160e01b600052601160045260246000fd5b5060010190565b611d9c80620004b96000396000f3fe6080604052600436106101bb5760003560e01c80638065657f116100ec578063bc197c811161008a578063d547741f11610064578063d547741f14610582578063e38335e5146105a2578063f23a6e61146105b5578063f27a0c92146105e157600080fd5b8063bc197c8114610509578063c4d252f514610535578063d45c44351461055557600080fd5b806391d14854116100c657806391d1485414610480578063a217fddf146104a0578063b08e51c0146104b5578063b1c5f427146104e957600080fd5b80638065657f1461040c5780638f2a0bb01461042c5780638f61f4f51461044c57600080fd5b8063248a9ca31161015957806331d507501161013357806331d507501461038c57806336568abe146103ac578063584b153e146103cc57806364d62353146103ec57600080fd5b8063248a9ca31461030b5780632ab0f5291461033b5780632f2ff15d1461036c57600080fd5b80630d3cf6fc116101955780630d3cf6fc14610260578063134008d31461029457806313bc9f20146102a7578063150b7a02146102c757600080fd5b806301d5062a146101c757806301ffc9a7146101e957806307bd02651461021e57600080fd5b366101c257005b600080fd5b3480156101d357600080fd5b506101e76101e23660046113b9565b6105f6565b005b3480156101f557600080fd5b5061020961020436600461142d565b61068b565b60405190151581526020015b60405180910390f35b34801561022a57600080fd5b506102527fd8aa0f3194971a2a116679f7c2090f6939c8d4e01a2a8d7e41d55e5351469e6381565b604051908152602001610215565b34801561026c57600080fd5b506102527f5f58e3a2316349923ce3780f8d587db2d72378aed66a8261c916544fa6846ca581565b6101e76102a2366004611457565b6106b6565b3480156102b357600080fd5b506102096102c23660046114c2565b61076b565b3480156102d357600080fd5b506102f26102e2366004611590565b630a85bd0160e11b949350505050565b6040516001600160e01b03199091168152602001610215565b34801561031757600080fd5b506102526103263660046114c2565b60009081526020819052604090206001015490565b34801561034757600080fd5b506102096103563660046114c2565b6000908152600160208190526040909120541490565b34801561037857600080fd5b506101e76103873660046115f7565b610791565b34801561039857600080fd5b506102096103a73660046114c2565b6107bb565b3480156103b857600080fd5b506101e76103c73660046115f7565b6107d4565b3480156103d857600080fd5b506102096103e73660046114c2565b610857565b3480156103f857600080fd5b506101e76104073660046114c2565b61086d565b34801561041857600080fd5b50610252610427366004611457565b610911565b34801561043857600080fd5b506101e7610447366004611667565b610950565b34801561045857600080fd5b506102527fb09aa5aeb3702cfd50b6b62bc4532604938f21248a27a1d5ca736082b6819cc181565b34801561048c57600080fd5b5061020961049b3660046115f7565b610aa2565b3480156104ac57600080fd5b50610252600081565b3480156104c157600080fd5b506102527ffd643c72710c63c0180259aba6b2d05451e3591a24e58b62239378085726f78381565b3480156104f557600080fd5b50610252610504366004611718565b610acb565b34801561051557600080fd5b506102f261052436600461183f565b63bc197c8160e01b95945050505050565b34801561054157600080fd5b506101e76105503660046114c2565b610b10565b34801561056157600080fd5b506102526105703660046114c2565b60009081526001602052604090205490565b34801561058e57600080fd5b506101e761059d3660046115f7565b610be5565b6101e76105b0366004611718565b610c0a565b3480156105c157600080fd5b506102f26105d03660046118e8565b63f23a6e6160e01b95945050505050565b3480156105ed57600080fd5b50600254610252565b7fb09aa5aeb3702cfd50b6b62bc4532604938f21248a27a1d5ca736082b6819cc161062081610d94565b6000610630898989898989610911565b905061063c8184610da1565b6000817f4cf4410cc57040e44862ef0f45f3dd5a5e02db8eb8add648d4b0e236f1d07dca8b8b8b8b8b8a60405161067896959493929190611975565b60405180910390a3505050505050505050565b60006001600160e01b03198216630271189760e51b14806106b057506106b082610e90565b92915050565b7fd8aa0f3194971a2a116679f7c2090f6939c8d4e01a2a8d7e41d55e5351469e636106e2816000610aa2565b6106f0576106f08133610ec5565b6000610700888888888888610911565b905061070c8185610f29565b61071888888888610fc5565b6000817fc2617efa69bab66782fa219543714338489c4e9e178271560a91b82c3f612b588a8a8a8a60405161075094939291906119b2565b60405180910390a361076181611098565b5050505050505050565b60008181526001602052604081205460018111801561078a5750428111155b9392505050565b6000828152602081905260409020600101546107ac81610d94565b6107b683836110d1565b505050565b60008181526001602052604081205481905b1192915050565b6001600160a01b03811633146108495760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084015b60405180910390fd5b6108538282611155565b5050565b60008181526001602081905260408220546107cd565b3330146108d05760405162461bcd60e51b815260206004820152602b60248201527f54696d656c6f636b436f6e74726f6c6c65723a2063616c6c6572206d7573742060448201526a62652074696d656c6f636b60a81b6064820152608401610840565b60025460408051918252602082018390527f11c24f4ead16507c69ac467fbd5e4eed5fb5c699626d2cc6d66421df253886d5910160405180910390a1600255565b600086868686868660405160200161092e96959493929190611975565b6040516020818303038152906040528051906020012090509695505050505050565b7fb09aa5aeb3702cfd50b6b62bc4532604938f21248a27a1d5ca736082b6819cc161097a81610d94565b8887146109995760405162461bcd60e51b8152600401610840906119e4565b8885146109b85760405162461bcd60e51b8152600401610840906119e4565b60006109ca8b8b8b8b8b8b8b8b610acb565b90506109d68184610da1565b60005b8a811015610a945780827f4cf4410cc57040e44862ef0f45f3dd5a5e02db8eb8add648d4b0e236f1d07dca8e8e85818110610a1657610a16611a27565b9050602002016020810190610a2b9190611a3d565b8d8d86818110610a3d57610a3d611a27565b905060200201358c8c87818110610a5657610a56611a27565b9050602002810190610a689190611a58565b8c8b604051610a7c96959493929190611975565b60405180910390a3610a8d81611ab4565b90506109d9565b505050505050505050505050565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b60008888888888888888604051602001610aec989796959493929190611b5e565b60405160208183030381529060405280519060200120905098975050505050505050565b7ffd643c72710c63c0180259aba6b2d05451e3591a24e58b62239378085726f783610b3a81610d94565b610b4382610857565b610ba95760405162461bcd60e51b815260206004820152603160248201527f54696d656c6f636b436f6e74726f6c6c65723a206f7065726174696f6e2063616044820152701b9b9bdd0818994818d85b98d95b1b1959607a1b6064820152608401610840565b6000828152600160205260408082208290555183917fbaa1eb22f2a492ba1a5fea61b8df4d27c6c8b5f3971e63bb58fa14ff72eedb7091a25050565b600082815260208190526040902060010154610c0081610d94565b6107b68383611155565b7fd8aa0f3194971a2a116679f7c2090f6939c8d4e01a2a8d7e41d55e5351469e63610c36816000610aa2565b610c4457610c448133610ec5565b878614610c635760405162461bcd60e51b8152600401610840906119e4565b878414610c825760405162461bcd60e51b8152600401610840906119e4565b6000610c948a8a8a8a8a8a8a8a610acb565b9050610ca08185610f29565b60005b89811015610d7e5760008b8b83818110610cbf57610cbf611a27565b9050602002016020810190610cd49190611a3d565b905060008a8a84818110610cea57610cea611a27565b9050602002013590503660008a8a86818110610d0857610d08611a27565b9050602002810190610d1a9190611a58565b91509150610d2a84848484610fc5565b84867fc2617efa69bab66782fa219543714338489c4e9e178271560a91b82c3f612b5886868686604051610d6194939291906119b2565b60405180910390a35050505080610d7790611ab4565b9050610ca3565b50610d8881611098565b50505050505050505050565b610d9e8133610ec5565b50565b610daa826107bb565b15610e0f5760405162461bcd60e51b815260206004820152602f60248201527f54696d656c6f636b436f6e74726f6c6c65723a206f7065726174696f6e20616c60448201526e1c9958591e481cd8da19591d5b1959608a1b6064820152608401610840565b600254811015610e705760405162461bcd60e51b815260206004820152602660248201527f54696d656c6f636b436f6e74726f6c6c65723a20696e73756666696369656e746044820152652064656c617960d01b6064820152608401610840565b610e7a8142611bff565b6000928352600160205260409092209190915550565b60006001600160e01b03198216637965db0b60e01b14806106b057506301ffc9a760e01b6001600160e01b03198316146106b0565b610ecf8282610aa2565b61085357610ee7816001600160a01b031660146111ba565b610ef28360206111ba565b604051602001610f03929190611c36565b60408051601f198184030181529082905262461bcd60e51b825261084091600401611cab565b610f328261076b565b610f4e5760405162461bcd60e51b815260040161084090611cde565b801580610f6a5750600081815260016020819052604090912054145b6108535760405162461bcd60e51b815260206004820152602660248201527f54696d656c6f636b436f6e74726f6c6c65723a206d697373696e6720646570656044820152656e64656e637960d01b6064820152608401610840565b6000846001600160a01b0316848484604051610fe2929190611d28565b60006040518083038185875af1925050503d806000811461101f576040519150601f19603f3d011682016040523d82523d6000602084013e611024565b606091505b50509050806110915760405162461bcd60e51b815260206004820152603360248201527f54696d656c6f636b436f6e74726f6c6c65723a20756e6465726c79696e6720746044820152721c985b9cd858dd1a5bdb881c995d995c9d1959606a1b6064820152608401610840565b5050505050565b6110a18161076b565b6110bd5760405162461bcd60e51b815260040161084090611cde565b600090815260016020819052604090912055565b6110db8282610aa2565b610853576000828152602081815260408083206001600160a01b03851684529091529020805460ff191660011790556111113390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b61115f8282610aa2565b15610853576000828152602081815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b606060006111c9836002611d38565b6111d4906002611bff565b6001600160401b038111156111eb576111eb6114db565b6040519080825280601f01601f191660200182016040528015611215576020820181803683370190505b509050600360fc1b8160008151811061123057611230611a27565b60200101906001600160f81b031916908160001a905350600f60fb1b8160018151811061125f5761125f611a27565b60200101906001600160f81b031916908160001a9053506000611283846002611d38565b61128e906001611bff565b90505b6001811115611306576f181899199a1a9b1b9c1cb0b131b232b360811b85600f16601081106112c2576112c2611a27565b1a60f81b8282815181106112d8576112d8611a27565b60200101906001600160f81b031916908160001a90535060049490941c936112ff81611d4f565b9050611291565b50831561078a5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610840565b80356001600160a01b038116811461136c57600080fd5b919050565b60008083601f84011261138357600080fd5b5081356001600160401b0381111561139a57600080fd5b6020830191508360208285010111156113b257600080fd5b9250929050565b600080600080600080600060c0888a0312156113d457600080fd5b6113dd88611355565b96506020880135955060408801356001600160401b038111156113ff57600080fd5b61140b8a828b01611371565b989b979a50986060810135976080820135975060a09091013595509350505050565b60006020828403121561143f57600080fd5b81356001600160e01b03198116811461078a57600080fd5b60008060008060008060a0878903121561147057600080fd5b61147987611355565b95506020870135945060408701356001600160401b0381111561149b57600080fd5b6114a789828a01611371565b979a9699509760608101359660809091013595509350505050565b6000602082840312156114d457600080fd5b5035919050565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611519576115196114db565b604052919050565b600082601f83011261153257600080fd5b81356001600160401b0381111561154b5761154b6114db565b61155e601f8201601f19166020016114f1565b81815284602083860101111561157357600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080608085870312156115a657600080fd5b6115af85611355565b93506115bd60208601611355565b92506040850135915060608501356001600160401b038111156115df57600080fd5b6115eb87828801611521565b91505092959194509250565b6000806040838503121561160a57600080fd5b8235915061161a60208401611355565b90509250929050565b60008083601f84011261163557600080fd5b5081356001600160401b0381111561164c57600080fd5b6020830191508360208260051b85010111156113b257600080fd5b600080600080600080600080600060c08a8c03121561168557600080fd5b89356001600160401b038082111561169c57600080fd5b6116a88d838e01611623565b909b50995060208c01359150808211156116c157600080fd5b6116cd8d838e01611623565b909950975060408c01359150808211156116e657600080fd5b506116f38c828d01611623565b9a9d999c50979a969997986060880135976080810135975060a0013595509350505050565b60008060008060008060008060a0898b03121561173457600080fd5b88356001600160401b038082111561174b57600080fd5b6117578c838d01611623565b909a50985060208b013591508082111561177057600080fd5b61177c8c838d01611623565b909850965060408b013591508082111561179557600080fd5b506117a28b828c01611623565b999c989b509699959896976060870135966080013595509350505050565b600082601f8301126117d157600080fd5b813560206001600160401b038211156117ec576117ec6114db565b8160051b6117fb8282016114f1565b928352848101820192828101908785111561181557600080fd5b83870192505b848310156118345782358252918301919083019061181b565b979650505050505050565b600080600080600060a0868803121561185757600080fd5b61186086611355565b945061186e60208701611355565b935060408601356001600160401b038082111561188a57600080fd5b61189689838a016117c0565b945060608801359150808211156118ac57600080fd5b6118b889838a016117c0565b935060808801359150808211156118ce57600080fd5b506118db88828901611521565b9150509295509295909350565b600080600080600060a0868803121561190057600080fd5b61190986611355565b945061191760208701611355565b9350604086013592506060860135915060808601356001600160401b0381111561194057600080fd5b6118db88828901611521565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60018060a01b038716815285602082015260a06040820152600061199d60a08301868861194c565b60608301949094525060800152949350505050565b60018060a01b03851681528360208201526060604082015260006119da60608301848661194c565b9695505050505050565b60208082526023908201527f54696d656c6f636b436f6e74726f6c6c65723a206c656e677468206d69736d616040820152620e8c6d60eb1b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b600060208284031215611a4f57600080fd5b61078a82611355565b6000808335601e19843603018112611a6f57600080fd5b8301803591506001600160401b03821115611a8957600080fd5b6020019150368190038213156113b257600080fd5b634e487b7160e01b600052601160045260246000fd5b600060018201611ac657611ac6611a9e565b5060010190565b81835260006020808501808196508560051b810191508460005b87811015611b515782840389528135601e19883603018112611b0857600080fd5b870185810190356001600160401b03811115611b2357600080fd5b803603821315611b3257600080fd5b611b3d86828461194c565b9a87019a9550505090840190600101611ae7565b5091979650505050505050565b60a0808252810188905260008960c08301825b8b811015611b9f576001600160a01b03611b8a84611355565b16825260209283019290910190600101611b71565b5083810360208501528881526001600160fb1b03891115611bbf57600080fd5b8860051b9150818a60208301370182810360209081016040850152611be79082018789611acd565b60608401959095525050608001529695505050505050565b808201808211156106b0576106b0611a9e565b60005b83811015611c2d578181015183820152602001611c15565b50506000910152565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351611c6e816017850160208801611c12565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351611c9f816028840160208801611c12565b01602801949350505050565b6020815260008251806020840152611cca816040850160208701611c12565b601f01601f19169190910160400192915050565b6020808252602a908201527f54696d656c6f636b436f6e74726f6c6c65723a206f7065726174696f6e206973604082015269206e6f7420726561647960b01b606082015260800190565b8183823760009101908152919050565b80820281158282048414176106b0576106b0611a9e565b600081611d5e57611d5e611a9e565b50600019019056fea26469706673582212205852bfd074c25eca0dec6c591a58e2b56d7c574c40e8eb6375dea9c2c537191464736f6c634300081300335f58e3a2316349923ce3780f8d587db2d72378aed66a8261c916544fa6846ca5b09aa5aeb3702cfd50b6b62bc4532604938f21248a27a1d5ca736082b6819cc1d8aa0f3194971a2a116679f7c2090f6939c8d4e01a2a8d7e41d55e5351469e63fd643c72710c63c0180259aba6b2d05451e3591a24e58b62239378085726f783a264697066735822122024b58fcd271927ab399468aaa575f66af4a83facb5548c925a036a122538b0d764736f6c63430008130033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
00000000000000000000000043587caa7de69c3c2ad0fb73d4c9da67a8e35b0b
-----Decoded View---------------
Arg [0] : deployer_ (address): 0x43587CAA7dE69C3c2aD0fb73D4C9da67A8E35b0b
-----Encoded View---------------
1 Constructor Arguments found :
Arg [0] : 00000000000000000000000043587caa7de69c3c2ad0fb73d4c9da67a8e35b0b
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 26 Chains
Chain | Token | Portfolio % | Price | Amount | Value |
---|
Loading...
Loading
[ Download: CSV Export ]
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.