Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

// SPDX-License-Identifier: MIT
pragma solidity >=0.8.0;

import "@openzeppelin/contracts/access/Ownable.sol";

import "../libraries/Percent.sol";
import "../timelock/OwnableTimelock.sol";

contract FeeMinter is Ownable, OwnableTimelock {
    /// Overall rate at which to mint new tokens
    uint256 public totalToMintPerBlock;

    /// Owner approved minters with assigned toMintPercents
    address[] public minters;

    /// Decimal points of precision to use with percents
    uint256 public decimals;

    // Version of the toMintPercent mapping
    uint32 private _version;
    
    // Map approved minter address to a percent of totalToMintPerBlock rate
    mapping(bytes32 => uint256) private _toMintPercent;

    // Emitted when a new totalToMintPerBlock is set
    event SetTotalToMintPerBlock(address indexed setter, uint256 indexed totalToMintPerBlock);

    // Emitted whan decimals is set
    event SetDecimals(address indexed sender, uint256 indexed decimals);

    // Emitted when new minters are assigned toMintPercents
    event SetToMintPercents(
        address indexed setter,
        address[] indexed minters,
        uint256[] indexed toMintPercents,
        uint32 version
    );

    constructor(uint256 _totalToMintPerBlock) {
        totalToMintPerBlock = _totalToMintPerBlock;
        decimals = 2;   // default to 2 decimals of precision, i.e. 100.00%
    }

    /// Set the _totalToMintPerBlock rate
    function setTotalToMintPerBlock(uint256 _totalToMintPerBlock) external onlyTimelock {
        totalToMintPerBlock = _totalToMintPerBlock;
        emit SetTotalToMintPerBlock(msg.sender, _totalToMintPerBlock);
    }

    /// Set the toMintPercent for each minter in _minters
    function setToMintPercents(address[] calldata _minters, uint256[] calldata _toMintPercents) 
        external 
        onlyTimelock 
    { 
        require(_minters.length == _toMintPercents.length, "FeeMinter: array length mismatch");

        // Increment the version and delete the previous mapping
        _version++;

        // Maintain a running tally of percents to enforce that they sum to 100
        uint256 percentSum;

        uint256 length = _minters.length;
        for (uint256 i = 0; i < length; i++) {
            address minter = _minters[i];
            require(minter != address(0), "FeeMinter: zero address");

            uint256 toMintPercent = _toMintPercents[i];
            percentSum += toMintPercent;
            require(percentSum <= _percent(), "FeeMinter: percent sum exceeds 100");

            _toMintPercent[_key(minter)] = toMintPercent;
        }
        require(percentSum == _percent(), "FeeMinter: percents do not total 100");

        minters = _minters;

        emit SetToMintPercents(
            msg.sender,
            _minters,
            _toMintPercents,
            _version
        );
    }

    // Set the number of _decimal points of precision used by percents
    function setDecimals(uint256 _decimals) external onlyOwner {
        decimals = _decimals;
        emit SetDecimals(msg.sender, _decimals);
    }
    
    /// Return the toMintBlock rate for _minter
    function getToMintPerBlock(address _minter) external view returns (uint256) {
        uint256 toMintPercent = getToMintPercent(_minter);
        return Percent.getPercentage(totalToMintPerBlock, toMintPercent, decimals);
    }

    /// Return the array of approved minter addresses
    function getMinters() external view returns (address[] memory) {
        return minters;
    }

    /// Return the toMintPercent for _minter
    function getToMintPercent(address _minter) public view returns (uint256) {
        return _toMintPercent[_key(_minter)];
    }

    // Return a key to the toMintPercent mapping based on _version and _minter
    function _key(address _minter) private view returns (bytes32) {
        return keccak256(abi.encodePacked(_version, _minter));
    }

    // Return the expected percent based on decimals being used
    function _percent() private view returns (uint256) {
        return 100 * (10 ** decimals);
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/Ownable.sol)

pragma solidity ^0.8.0;

import "../utils/Context.sol";

/**
 * @dev Contract module which provides a basic access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * By default, the owner account will be the one that deploys the contract. This
 * can later be changed with {transferOwnership}.
 *
 * This module is used through inheritance. It will make available the modifier
 * `onlyOwner`, which can be applied to your functions to restrict their use to
 * the owner.
 */
abstract contract Ownable is Context {
    address private _owner;

    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);

    /**
     * @dev Initializes the contract setting the deployer as the initial owner.
     */
    constructor() {
        _transferOwnership(_msgSender());
    }

    /**
     * @dev Returns the address of the current owner.
     */
    function owner() public view virtual returns (address) {
        return _owner;
    }

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        require(owner() == _msgSender(), "Ownable: caller is not the owner");
        _;
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions anymore. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby removing any functionality that is only available to the owner.
     */
    function renounceOwnership() public virtual onlyOwner {
        _transferOwnership(address(0));
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual onlyOwner {
        require(newOwner != address(0), "Ownable: new owner is the zero address");
        _transferOwnership(newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual {
        address oldOwner = _owner;
        _owner = newOwner;
        emit OwnershipTransferred(oldOwner, newOwner);
    }
}

// SPDX-License-Identifier: MIT
pragma solidity >= 0.8.0;

library Percent {
    uint256 public constant MAX_PERCENT = 100;

    modifier onlyValidPercent(uint256 _percent, uint256 _decimals) {
        require(_isValidPercent(_percent, _decimals), "Percent: invalid percent");
        _;
    }

    // Return true if the _percent is valid and false otherwise
    function isValidPercent(uint256 _percent)
        internal
        pure
        returns (bool)
    {
        return _isValidPercent(_percent, 0);
    }

    // Return true if the _percent with _decimals many decimals is valid and false otherwise
    function isValidPercent(uint256 _percent, uint256 _decimals)
        internal
        pure
        returns (bool)
    {
        return _isValidPercent(_percent, _decimals);
    }

    // Return true if the _percent with _decimals many decimals is valid and false otherwise
    function _isValidPercent(uint256 _percent, uint256 _decimals)
        private
        pure
        returns (bool)
    {
        return _percent <= MAX_PERCENT * 10 ** _decimals;
    }

    // Return _percent of _amount
    function getPercentage(uint256 _amount, uint256 _percent)
        internal 
        pure
        returns (uint256 percentage) 
    {
        percentage = _getPercentage(_amount, _percent, 0);
    }

    // Return _percent of _amount with _decimals many decimals
    function getPercentage(uint256 _amount, uint256 _percent, uint256 _decimals)
        internal 
        pure
        returns (uint256 percentage)
    {
        percentage =_getPercentage(_amount, _percent, _decimals);
    }

    // Return _percent of _amount with _decimals many decimals
    function _getPercentage(uint256 _amount, uint256 _percent, uint256 _decimals) 
        private
        pure
        onlyValidPercent(_percent, _decimals) 
        returns (uint256 percentage)
    {
        percentage = _amount * _percent / (MAX_PERCENT * 10 ** _decimals);
    }

    // Return _percent of _amount as the percentage and the remainder of _amount - percentage
    function splitByPercent(uint256 _amount, uint256 _percent) 
        internal 
        pure 
        returns (uint256 percentage, uint256 remainder) 
    {
        (percentage, remainder) = _splitByPercent(_amount, _percent, 0);
    }

    // Return _percent of _amount as the percentage and the remainder of _amount - percentage
    // with _decimals many decimals
    function splitByPercent(uint256 _amount, uint256 _percent, uint256 _decimals)
        internal 
        pure
        returns (uint256 percentage, uint256 remainder)
    {
        (percentage, remainder) = _splitByPercent(_amount, _percent, _decimals);
    }

    // Return _percent of _amount as the percentage and the remainder of _amount - percentage
    // with _decimals many decimals
    function _splitByPercent(uint256 _amount, uint256 _percent, uint256 _decimals)
        private
        pure
        onlyValidPercent(_percent, _decimals)
        returns (uint256 percentage, uint256 remainder)
    {
        percentage = _getPercentage(_amount, _percent, _decimals);
        remainder = _amount - percentage;
    }
}

// SPDX-License-Identifier: MIT
pragma solidity >=0.8.0;

abstract contract OwnableTimelock {
    error CallerIsNotTimelockOwner();
    error ZeroTimelockOwnerAddress();

    address private _timelockOwner;

    event TimelockOwnershipTransferred(address indexed previousOwner, address indexed newOwner);

    /**
     * @dev Initializes the contract setting the deployer as the initial owner.
     */
    constructor() {
        _transferTimelockOwnership(msg.sender);
    }

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyTimelock() {
        _checkTimelockOwner();
        _;
    }

    /**
     * @dev Returns the address of the current owner.
     */
    function timelockOwner() public view virtual returns (address) {
        return _timelockOwner;
    }

    /**
     * @dev Throws if the sender is not the owner.
     */
    function _checkTimelockOwner() internal view virtual {
        if (msg.sender != timelockOwner()) revert CallerIsNotTimelockOwner();
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions anymore. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby removing any functionality that is only available to the owner.
     */
    function renounceTimelockOwnership() public virtual onlyTimelock {
        _transferTimelockOwnership(address(0));
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferTimelockOwnership(address newOwner) public virtual onlyTimelock {
        if (newOwner == address(0)) revert ZeroTimelockOwnerAddress();
        _transferTimelockOwnership(newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Internal function without access restriction.
     */
    function _transferTimelockOwnership(address newOwner) internal virtual {
        address oldOwner = _timelockOwner;
        _timelockOwner = newOwner;
        emit TimelockOwnershipTransferred(oldOwner, newOwner);
    }
}

// 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;
    }
}

{
  "optimizer": {
    "enabled": true,
    "runs": 200
  },
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  },
  "libraries": {}
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"uint256","name":"_totalToMintPerBlock","type":"uint256"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"CallerIsNotTimelockOwner","type":"error"},{"inputs":[],"name":"ZeroTimelockOwnerAddress","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"uint256","name":"decimals","type":"uint256"}],"name":"SetDecimals","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"setter","type":"address"},{"indexed":true,"internalType":"address[]","name":"minters","type":"address[]"},{"indexed":true,"internalType":"uint256[]","name":"toMintPercents","type":"uint256[]"},{"indexed":false,"internalType":"uint32","name":"version","type":"uint32"}],"name":"SetToMintPercents","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"setter","type":"address"},{"indexed":true,"internalType":"uint256","name":"totalToMintPerBlock","type":"uint256"}],"name":"SetTotalToMintPerBlock","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"TimelockOwnershipTransferred","type":"event"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getMinters","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_minter","type":"address"}],"name":"getToMintPerBlock","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_minter","type":"address"}],"name":"getToMintPercent","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"minters","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceTimelockOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_decimals","type":"uint256"}],"name":"setDecimals","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"_minters","type":"address[]"},{"internalType":"uint256[]","name":"_toMintPercents","type":"uint256[]"}],"name":"setToMintPercents","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_totalToMintPerBlock","type":"uint256"}],"name":"setTotalToMintPerBlock","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"timelockOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalToMintPerBlock","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferTimelockOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"}]

0x608060405234801561001057600080fd5b50600436106100f55760003560e01c80638c8885c811610097578063d66da6d011610066578063d66da6d0146101dd578063f2fde38b146101e6578063f90f99a0146101f9578063fc5cdcf71461020c57600080fd5b80638c8885c8146101935780638da5cb5b146101a657806398d137e8146101b7578063a8a1e8f3146101ca57600080fd5b80636b32810b116100d35780636b32810b1461014e578063715018a6146101635780637cbcef341461016d5780638623ec7b1461018057600080fd5b8063313ce567146100fa578063425f457c146101165780635140da8a14610129575b600080fd5b61010360045481565b6040519081526020015b60405180910390f35b610103610124366004610a08565b610214565b6001546001600160a01b03165b6040516001600160a01b03909116815260200161010d565b610156610239565b60405161010d9190610a23565b61016b61029b565b005b61016b61017b366004610abc565b6102da565b61013661018e366004610b28565b61059a565b61016b6101a1366004610b28565b6105c4565b6000546001600160a01b0316610136565b6101036101c5366004610a08565b610623565b61016b6101d8366004610b28565b610647565b61010360025481565b61016b6101f4366004610a08565b610684565b61016b610207366004610a08565b61071f565b61016b610756565b60006006600061022384610768565b8152602001908152602001600020549050919050565b6060600380548060200260200160405190810160405280929190818152602001828054801561029157602002820191906000526020600020905b81546001600160a01b03168152600190910190602001808311610273575b5050505050905090565b6000546001600160a01b031633146102ce5760405162461bcd60e51b81526004016102c590610b41565b60405180910390fd5b6102d860006107bf565b565b6102e261080f565b8281146103315760405162461bcd60e51b815260206004820181905260248201527f4665654d696e7465723a206172726179206c656e677468206d69736d6174636860448201526064016102c5565b6005805463ffffffff1690600061034783610b8c565b825463ffffffff9182166101009390930a928302919092021990911617905550600083815b818110156104b657600087878381811061038857610388610bb0565b905060200201602081019061039d9190610a08565b90506001600160a01b0381166103f55760405162461bcd60e51b815260206004820152601760248201527f4665654d696e7465723a207a65726f206164647265737300000000000000000060448201526064016102c5565b600086868481811061040957610409610bb0565b905060200201359050808561041e9190610bc6565b945061042861083a565b8511156104825760405162461bcd60e51b815260206004820152602260248201527f4665654d696e7465723a2070657263656e742073756d20657863656564732031604482015261030360f41b60648201526084016102c5565b806006600061049085610768565b8152602081019190915260400160002055508190506104ae81610bde565b91505061036c565b506104bf61083a565b82146105195760405162461bcd60e51b8152602060048201526024808201527f4665654d696e7465723a2070657263656e747320646f206e6f7420746f74616c6044820152630203130360e41b60648201526084016102c5565b61052560038787610974565b508383604051610536929190610bf9565b6040518091039020868660405161054e929190610c25565b60405190819003812060055463ffffffff1682529033907f46effa0ec96a5b831a39a33107c81909d2f4e50cfa9a23412c184168003bfc469060200160405180910390a4505050505050565b600381815481106105aa57600080fd5b6000918252602090912001546001600160a01b0316905081565b6000546001600160a01b031633146105ee5760405162461bcd60e51b81526004016102c590610b41565b6004819055604051819033907f13e3f730c1219dab97437e98523b6880df0c5270cf8b251fbb922e6052df81bd90600090a350565b60008061062f83610214565b90506106406002548260045461085b565b9392505050565b61064f61080f565b6002819055604051819033907f6113455695a15fc0c178211bc8d94826a53cf407c79bb288528089ec2d690a9e90600090a350565b6000546001600160a01b031633146106ae5760405162461bcd60e51b81526004016102c590610b41565b6001600160a01b0381166107135760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016102c5565b61071c816107bf565b50565b61072761080f565b6001600160a01b03811661074d576040516212befd60e21b815260040160405180910390fd5b61071c81610870565b61075e61080f565b6102d86000610870565b60055460405160e09190911b6001600160e01b0319166020820152606082901b6bffffffffffffffffffffffff19166024820152600090603801604051602081830303815290604052805190602001209050919050565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6001546001600160a01b031633146102d85760405163504ec42f60e01b815260040160405180910390fd5b6000600454600a61084b9190610d49565b610856906064610d55565b905090565b60006108688484846108c2565b949350505050565b600180546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f435020463df9072c26fe186a7008f9fb875f94dacb336a0ac30291513d656e8e90600090a35050565b600082826108d08282610950565b61091c5760405162461bcd60e51b815260206004820152601860248201527f50657263656e743a20696e76616c69642070657263656e74000000000000000060448201526064016102c5565b61092784600a610d49565b610932906064610d55565b61093c8688610d55565b6109469190610d74565b9695505050505050565b600061095d82600a610d49565b610968906064610d55565b83111590505b92915050565b8280548282559060005260206000209081019282156109c7579160200282015b828111156109c75781546001600160a01b0319166001600160a01b03843516178255602090920191600190910190610994565b506109d39291506109d7565b5090565b5b808211156109d357600081556001016109d8565b80356001600160a01b0381168114610a0357600080fd5b919050565b600060208284031215610a1a57600080fd5b610640826109ec565b6020808252825182820181905260009190848201906040850190845b81811015610a645783516001600160a01b031683529284019291840191600101610a3f565b50909695505050505050565b60008083601f840112610a8257600080fd5b50813567ffffffffffffffff811115610a9a57600080fd5b6020830191508360208260051b8501011115610ab557600080fd5b9250929050565b60008060008060408587031215610ad257600080fd5b843567ffffffffffffffff80821115610aea57600080fd5b610af688838901610a70565b90965094506020870135915080821115610b0f57600080fd5b50610b1c87828801610a70565b95989497509550505050565b600060208284031215610b3a57600080fd5b5035919050565b6020808252818101527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604082015260600190565b634e487b7160e01b600052601160045260246000fd5b600063ffffffff80831681811415610ba657610ba6610b76565b6001019392505050565b634e487b7160e01b600052603260045260246000fd5b60008219821115610bd957610bd9610b76565b500190565b6000600019821415610bf257610bf2610b76565b5060010190565b60006001600160fb1b03831115610c0f57600080fd5b8260051b80858437600092019182525092915050565b60008184825b85811015610c5a576001600160a01b03610c44836109ec565b1683526020928301929190910190600101610c2b565b509095945050505050565b600181815b80851115610ca0578160001904821115610c8657610c86610b76565b80851615610c9357918102915b93841c9390800290610c6a565b509250929050565b600082610cb75750600161096e565b81610cc45750600061096e565b8160018114610cda5760028114610ce457610d00565b600191505061096e565b60ff841115610cf557610cf5610b76565b50506001821b61096e565b5060208310610133831016604e8410600b8410161715610d23575081810a61096e565b610d2d8383610c65565b8060001904821115610d4157610d41610b76565b029392505050565b60006106408383610ca8565b6000816000190483118215151615610d6f57610d6f610b76565b500290565b600082610d9157634e487b7160e01b600052601260045260246000fd5b50049056fea2646970667358221220f6892b5819d97d711aabf9d283799922c6d24cb068a33265f581b327f6f450d464736f6c634300080a0033