ETH Price: $2,550.93 (+1.47%)

Transaction Decoder

Block:
11665683 at Jan-16-2021 10:22:14 AM +UTC
Transaction Fee:
0.006058572 ETH $15.45
Gas Used:
116,511 Gas / 52 Gwei

Emitted Events:

97 Dollar.Transfer( from=[Sender] 0x43803b21e7d8a78a0c8487b6e9c1ad159c721bb4, to=[Receiver] BCCESDPool, value=50000000000000000000 )
98 BCCESDPool.Staked( user=[Sender] 0x43803b21e7d8a78a0c8487b6e9c1ad159c721bb4, amount=50000000000000000000 )

Account State Difference:

  Address   Before After State Difference Code
0x024D43aC...1e4edA9c3
(Mining Express)
64.187836284573598147 Eth64.193894856573598147 Eth0.006058572
0x36F3FD68...A0689d723
0x43803B21...59c721Bb4
0.503132991436945061 Eth
Nonce: 507
0.497074419436945061 Eth
Nonce: 508
0.006058572

Execution Trace

BCCESDPool.stake( amount=50000000000000000000 )
  • Dollar.transferFrom( sender=0x43803B21E7D8a78a0c8487b6E9C1AD159c721Bb4, recipient=0x024D43aC1dAC185a888daA567b78B241e4edA9c3, amount=50000000000000000000 ) => ( True )
    File 1 of 2: BCCESDPool
    pragma solidity ^0.6.0;
    /**
     *Submitted for verification at Etherscan.io on 2020-07-17
     */
    /*
       ____            __   __        __   _
      / __/__ __ ___  / /_ / /  ___  / /_ (_)__ __
     _\\ \\ / // // _ \\/ __// _ \\/ -_)/ __// / \\ \\ /
    /___/ \\_, //_//_/\\__//_//_/\\__/ \\__//_/ /_\\_\\
         /___/
    * Synthetix: BASISCASHRewards.sol
    *
    * Docs: https://docs.synthetix.io/
    *
    *
    * MIT License
    * ===========
    *
    * Copyright (c) 2020 Synthetix
    *
    * Permission is hereby granted, free of charge, to any person obtaining a copy
    * of this software and associated documentation files (the "Software"), to deal
    * in the Software without restriction, including without limitation the rights
    * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
    * copies of the Software, and to permit persons to whom the Software is
    * furnished to do so, subject to the following conditions:
    *
    * The above copyright notice and this permission notice shall be included in all
    * copies or substantial portions of the Software.
    *
    * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
    * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
    */
    // File: @openzeppelin/contracts/math/Math.sol
    import '@openzeppelin/contracts/math/Math.sol';
    // File: @openzeppelin/contracts/math/SafeMath.sol
    import '@openzeppelin/contracts/math/SafeMath.sol';
    // File: @openzeppelin/contracts/token/ERC20/IERC20.sol
    import '@openzeppelin/contracts/token/ERC20/IERC20.sol';
    // File: @openzeppelin/contracts/utils/Address.sol
    import '@openzeppelin/contracts/utils/Address.sol';
    // File: @openzeppelin/contracts/token/ERC20/SafeERC20.sol
    import '@openzeppelin/contracts/token/ERC20/SafeERC20.sol';
    // File: contracts/IRewardDistributionRecipient.sol
    import '../interfaces/IRewardDistributionRecipient.sol';
    contract ESDWrapper {
        using SafeMath for uint256;
        using SafeERC20 for IERC20;
        IERC20 public esd;
        uint256 private _totalSupply;
        mapping(address => uint256) private _balances;
        function totalSupply() public virtual view returns (uint256) {
            return _totalSupply;
        }
        function balanceOf(address account) public virtual view returns (uint256) {
            return _balances[account];
        }
        function stake(uint256 amount) public virtual {
            _totalSupply = _totalSupply.add(amount);
            _balances[msg.sender] = _balances[msg.sender].add(amount);
            esd.safeTransferFrom(msg.sender, address(this), amount);
        }
        function withdraw(uint256 amount) public virtual {
            _totalSupply = _totalSupply.sub(amount);
            _balances[msg.sender] = _balances[msg.sender].sub(amount);
            esd.safeTransfer(msg.sender, amount);
        }
    }
    contract BCCESDPool is ESDWrapper, IRewardDistributionRecipient {
        IERC20 public basisCash;
        uint256 public DURATION = 5 days;
        uint256 public starttime;
        uint256 public periodFinish = 0;
        uint256 public rewardRate = 0;
        uint256 public lastUpdateTime;
        uint256 public rewardPerTokenStored;
        mapping(address => uint256) public userRewardPerTokenPaid;
        mapping(address => uint256) public rewards;
        mapping(address => uint256) public deposits;
        event RewardAdded(uint256 reward);
        event Staked(address indexed user, uint256 amount);
        event Withdrawn(address indexed user, uint256 amount);
        event RewardPaid(address indexed user, uint256 reward);
        constructor(
            address basisCash_,
            address esd_,
            uint256 starttime_
        ) public {
            basisCash = IERC20(basisCash_);
            esd = IERC20(esd_);
            starttime = starttime_;
        }
        modifier checkStart() {
            require(block.timestamp >= starttime, 'BCCESDPool: not start');
            _;
        }
        modifier updateReward(address account) {
            rewardPerTokenStored = rewardPerToken();
            lastUpdateTime = lastTimeRewardApplicable();
            if (account != address(0)) {
                rewards[account] = earned(account);
                userRewardPerTokenPaid[account] = rewardPerTokenStored;
            }
            _;
        }
        function lastTimeRewardApplicable() public view returns (uint256) {
            return Math.min(block.timestamp, periodFinish);
        }
        function rewardPerToken() public view returns (uint256) {
            if (totalSupply() == 0) {
                return rewardPerTokenStored;
            }
            return
                rewardPerTokenStored.add(
                    lastTimeRewardApplicable()
                        .sub(lastUpdateTime)
                        .mul(rewardRate)
                        .mul(1e18)
                        .div(totalSupply())
                );
        }
        function earned(address account) public view returns (uint256) {
            return
                balanceOf(account)
                    .mul(rewardPerToken().sub(userRewardPerTokenPaid[account]))
                    .div(1e18)
                    .add(rewards[account]);
        }
        // stake visibility is public as overriding LPTokenWrapper's stake() function
        function stake(uint256 amount)
            public
            override
            updateReward(msg.sender)
            checkStart
        {
            require(amount > 0, 'BCCESDPool: Cannot stake 0');
            uint256 newDeposit = deposits[msg.sender].add(amount);
            require(
                newDeposit <= 20000e18,
                'BCCESDPool: deposit amount exceeds maximum 20000'
            );
            deposits[msg.sender] = newDeposit;
            super.stake(amount);
            emit Staked(msg.sender, amount);
        }
        function withdraw(uint256 amount)
            public
            override
            updateReward(msg.sender)
            checkStart
        {
            require(amount > 0, 'BCCESDPool: Cannot withdraw 0');
            deposits[msg.sender] = deposits[msg.sender].sub(amount);
            super.withdraw(amount);
            emit Withdrawn(msg.sender, amount);
        }
        function exit() external {
            withdraw(balanceOf(msg.sender));
            getReward();
        }
        function getReward() public updateReward(msg.sender) checkStart {
            uint256 reward = earned(msg.sender);
            if (reward > 0) {
                rewards[msg.sender] = 0;
                basisCash.safeTransfer(msg.sender, reward);
                emit RewardPaid(msg.sender, reward);
            }
        }
        function notifyRewardAmount(uint256 reward)
            external
            override
            onlyRewardDistribution
            updateReward(address(0))
        {
            if (block.timestamp > starttime) {
                if (block.timestamp >= periodFinish) {
                    rewardRate = reward.div(DURATION);
                } else {
                    uint256 remaining = periodFinish.sub(block.timestamp);
                    uint256 leftover = remaining.mul(rewardRate);
                    rewardRate = reward.add(leftover).div(DURATION);
                }
                lastUpdateTime = block.timestamp;
                periodFinish = block.timestamp.add(DURATION);
                emit RewardAdded(reward);
            } else {
                rewardRate = reward.div(DURATION);
                lastUpdateTime = starttime;
                periodFinish = starttime.add(DURATION);
                emit RewardAdded(reward);
            }
        }
    }
    pragma solidity ^0.6.0;
    import '@openzeppelin/contracts/access/Ownable.sol';
    abstract contract IRewardDistributionRecipient is Ownable {
        address public rewardDistribution;
        function notifyRewardAmount(uint256 reward) external virtual;
        modifier onlyRewardDistribution() {
            require(
                _msgSender() == rewardDistribution,
                'Caller is not reward distribution'
            );
            _;
        }
        function setRewardDistribution(address _rewardDistribution)
            external
            virtual
            onlyOwner
        {
            rewardDistribution = _rewardDistribution;
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.6.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 GSN 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 payable) {
            return msg.sender;
        }
        function _msgData() internal view virtual returns (bytes memory) {
            this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
            return msg.data;
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.6.0;
    import "../GSN/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.
     */
    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 () internal {
            address msgSender = _msgSender();
            _owner = msgSender;
            emit OwnershipTransferred(address(0), msgSender);
        }
        /**
         * @dev Returns the address of the current owner.
         */
        function owner() public view 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 {
            emit OwnershipTransferred(_owner, address(0));
            _owner = 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");
            emit OwnershipTransferred(_owner, newOwner);
            _owner = newOwner;
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.6.0;
    /**
     * @dev Standard math utilities missing in the Solidity language.
     */
    library Math {
        /**
         * @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, so we distribute
            return (a / 2) + (b / 2) + ((a % 2 + b % 2) / 2);
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.6.0;
    /**
     * @dev Wrappers over Solidity's arithmetic operations with added overflow
     * checks.
     *
     * Arithmetic operations in Solidity wrap on overflow. This can easily result
     * in bugs, because programmers usually assume that an overflow raises an
     * error, which is the standard behavior in high level programming languages.
     * `SafeMath` restores this intuition by reverting the transaction when 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.
     */
    library SafeMath {
        /**
         * @dev Returns the addition of two unsigned integers, reverting on
         * overflow.
         *
         * Counterpart to Solidity's `+` operator.
         *
         * Requirements:
         *
         * - Addition cannot overflow.
         */
        function add(uint256 a, uint256 b) internal pure returns (uint256) {
            uint256 c = a + b;
            require(c >= a, "SafeMath: addition overflow");
            return c;
        }
        /**
         * @dev Returns the subtraction of two unsigned integers, reverting on
         * overflow (when the result is negative).
         *
         * Counterpart to Solidity's `-` operator.
         *
         * Requirements:
         *
         * - Subtraction cannot overflow.
         */
        function sub(uint256 a, uint256 b) internal pure returns (uint256) {
            return sub(a, b, "SafeMath: subtraction overflow");
        }
        /**
         * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
         * overflow (when the result is negative).
         *
         * Counterpart to Solidity's `-` operator.
         *
         * Requirements:
         *
         * - Subtraction cannot overflow.
         */
        function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            require(b <= a, errorMessage);
            uint256 c = a - b;
            return c;
        }
        /**
         * @dev Returns the multiplication of two unsigned integers, reverting on
         * overflow.
         *
         * Counterpart to Solidity's `*` operator.
         *
         * Requirements:
         *
         * - Multiplication cannot overflow.
         */
        function mul(uint256 a, uint256 b) internal pure returns (uint256) {
            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
            // benefit is lost if 'b' is also tested.
            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
            if (a == 0) {
                return 0;
            }
            uint256 c = a * b;
            require(c / a == b, "SafeMath: multiplication overflow");
            return c;
        }
        /**
         * @dev Returns the integer division of two unsigned integers. Reverts on
         * division by zero. The result is rounded towards zero.
         *
         * Counterpart to Solidity's `/` operator. Note: this function uses a
         * `revert` opcode (which leaves remaining gas untouched) while Solidity
         * uses an invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function div(uint256 a, uint256 b) internal pure returns (uint256) {
            return div(a, b, "SafeMath: division by zero");
        }
        /**
         * @dev Returns the integer division of two unsigned integers. Reverts with custom message on
         * division by zero. The result is rounded towards zero.
         *
         * Counterpart to Solidity's `/` operator. Note: this function uses a
         * `revert` opcode (which leaves remaining gas untouched) while Solidity
         * uses an invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            require(b > 0, errorMessage);
            uint256 c = a / b;
            // assert(a == b * c + a % b); // There is no case in which this doesn't hold
            return c;
        }
        /**
         * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
         * Reverts when dividing by zero.
         *
         * Counterpart to Solidity's `%` operator. This function uses a `revert`
         * opcode (which leaves remaining gas untouched) while Solidity uses an
         * invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function mod(uint256 a, uint256 b) internal pure returns (uint256) {
            return mod(a, b, "SafeMath: modulo by zero");
        }
        /**
         * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
         * Reverts with custom message when dividing by zero.
         *
         * Counterpart to Solidity's `%` operator. This function uses a `revert`
         * opcode (which leaves remaining gas untouched) while Solidity uses an
         * invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            require(b != 0, errorMessage);
            return a % b;
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.6.0;
    /**
     * @dev Interface of the ERC20 standard as defined in the EIP.
     */
    interface IERC20 {
        /**
         * @dev Returns the amount of tokens in existence.
         */
        function totalSupply() external view returns (uint256);
        /**
         * @dev Returns the amount of tokens owned by `account`.
         */
        function balanceOf(address account) external view returns (uint256);
        /**
         * @dev Moves `amount` tokens from the caller's account to `recipient`.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transfer(address recipient, uint256 amount) external returns (bool);
        /**
         * @dev Returns the remaining number of tokens that `spender` will be
         * allowed to spend on behalf of `owner` through {transferFrom}. This is
         * zero by default.
         *
         * This value changes when {approve} or {transferFrom} are called.
         */
        function allowance(address owner, address spender) external view returns (uint256);
        /**
         * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * IMPORTANT: Beware that changing an allowance with this method brings the risk
         * that someone may use both the old and the new allowance by unfortunate
         * transaction ordering. One possible solution to mitigate this race
         * condition is to first reduce the spender's allowance to 0 and set the
         * desired value afterwards:
         * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
         *
         * Emits an {Approval} event.
         */
        function approve(address spender, uint256 amount) external returns (bool);
        /**
         * @dev Moves `amount` tokens from `sender` to `recipient` using the
         * allowance mechanism. `amount` is then deducted from the caller's
         * allowance.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
        /**
         * @dev Emitted when `value` tokens are moved from one account (`from`) to
         * another (`to`).
         *
         * Note that `value` may be zero.
         */
        event Transfer(address indexed from, address indexed to, uint256 value);
        /**
         * @dev Emitted when the allowance of a `spender` for an `owner` is set by
         * a call to {approve}. `value` is the new allowance.
         */
        event Approval(address indexed owner, address indexed spender, uint256 value);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.6.0;
    import "./IERC20.sol";
    import "../../math/SafeMath.sol";
    import "../../utils/Address.sol";
    /**
     * @title SafeERC20
     * @dev Wrappers around ERC20 operations that throw on failure (when the token
     * contract returns false). Tokens that return no value (and instead revert or
     * throw on failure) are also supported, non-reverting calls are assumed to be
     * successful.
     * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
     * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
     */
    library SafeERC20 {
        using SafeMath for uint256;
        using Address for address;
        function safeTransfer(IERC20 token, address to, uint256 value) internal {
            _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
        }
        function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
            _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
        }
        /**
         * @dev Deprecated. This function has issues similar to the ones found in
         * {IERC20-approve}, and its usage is discouraged.
         *
         * Whenever possible, use {safeIncreaseAllowance} and
         * {safeDecreaseAllowance} instead.
         */
        function safeApprove(IERC20 token, address spender, uint256 value) internal {
            // safeApprove should only be called when setting an initial allowance,
            // or when resetting it to zero. To increase and decrease it, use
            // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
            // solhint-disable-next-line max-line-length
            require((value == 0) || (token.allowance(address(this), spender) == 0),
                "SafeERC20: approve from non-zero to non-zero allowance"
            );
            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
        }
        function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
            uint256 newAllowance = token.allowance(address(this), spender).add(value);
            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
        }
        function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
            uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
        }
        /**
         * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
         * on the return value: the return value is optional (but if data is returned, it must not be false).
         * @param token The token targeted by the call.
         * @param data The call data (encoded using abi.encode or one of its variants).
         */
        function _callOptionalReturn(IERC20 token, bytes memory data) private {
            // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
            // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
            // the target address contains contract code and also asserts for success in the low-level call.
            bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
            if (returndata.length > 0) { // Return data is optional
                // solhint-disable-next-line max-line-length
                require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
            }
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.6.2;
    /**
     * @dev Collection of functions related to the address type
     */
    library Address {
        /**
         * @dev Returns true if `account` is a contract.
         *
         * [IMPORTANT]
         * ====
         * It is unsafe to assume that an address for which this function returns
         * false is an externally-owned account (EOA) and not a contract.
         *
         * Among others, `isContract` will return false for the following
         * types of addresses:
         *
         *  - an externally-owned account
         *  - a contract in construction
         *  - an address where a contract will be created
         *  - an address where a contract lived, but was destroyed
         * ====
         */
        function isContract(address account) internal view returns (bool) {
            // This method relies in extcodesize, which returns 0 for contracts in
            // construction, since the code is only stored at the end of the
            // constructor execution.
            uint256 size;
            // solhint-disable-next-line no-inline-assembly
            assembly { size := extcodesize(account) }
            return size > 0;
        }
        /**
         * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
         * `recipient`, forwarding all available gas and reverting on errors.
         *
         * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
         * of certain opcodes, possibly making contracts go over the 2300 gas limit
         * imposed by `transfer`, making them unable to receive funds via
         * `transfer`. {sendValue} removes this limitation.
         *
         * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
         *
         * IMPORTANT: because control is transferred to `recipient`, care must be
         * taken to not create reentrancy vulnerabilities. Consider using
         * {ReentrancyGuard} or the
         * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
         */
        function sendValue(address payable recipient, uint256 amount) internal {
            require(address(this).balance >= amount, "Address: insufficient balance");
            // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
            (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");
            return _functionCallWithValue(target, data, value, errorMessage);
        }
        function _functionCallWithValue(address target, bytes memory data, uint256 weiValue, string memory errorMessage) private returns (bytes memory) {
            require(isContract(target), "Address: call to non-contract");
            // solhint-disable-next-line avoid-low-level-calls
            (bool success, bytes memory returndata) = target.call{ value: weiValue }(data);
            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
                    // solhint-disable-next-line no-inline-assembly
                    assembly {
                        let returndata_size := mload(returndata)
                        revert(add(32, returndata), returndata_size)
                    }
                } else {
                    revert(errorMessage);
                }
            }
        }
    }
    

    File 2 of 2: Dollar
    pragma solidity ^0.5.17;
    pragma experimental ABIEncoderV2;
    
    
    /*
     * @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 GSN 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.
     */
    contract Context {
        // Empty internal constructor, to prevent people from mistakenly deploying
        // an instance of this contract, which should be used via inheritance.
        constructor () internal { }
        // solhint-disable-previous-line no-empty-blocks
    
        function _msgSender() internal view returns (address payable) {
            return msg.sender;
        }
    
        function _msgData() internal view returns (bytes memory) {
            this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
            return msg.data;
        }
    }
    
    /**
     * @dev Interface of the ERC20 standard as defined in the EIP. Does not include
     * the optional functions; to access them see {ERC20Detailed}.
     */
    interface IERC20 {
        /**
         * @dev Returns the amount of tokens in existence.
         */
        function totalSupply() external view returns (uint256);
    
        /**
         * @dev Returns the amount of tokens owned by `account`.
         */
        function balanceOf(address account) external view returns (uint256);
    
        /**
         * @dev Moves `amount` tokens from the caller's account to `recipient`.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transfer(address recipient, uint256 amount) external returns (bool);
    
        /**
         * @dev Returns the remaining number of tokens that `spender` will be
         * allowed to spend on behalf of `owner` through {transferFrom}. This is
         * zero by default.
         *
         * This value changes when {approve} or {transferFrom} are called.
         */
        function allowance(address owner, address spender) external view returns (uint256);
    
        /**
         * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * IMPORTANT: Beware that changing an allowance with this method brings the risk
         * that someone may use both the old and the new allowance by unfortunate
         * transaction ordering. One possible solution to mitigate this race
         * condition is to first reduce the spender's allowance to 0 and set the
         * desired value afterwards:
         * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
         *
         * Emits an {Approval} event.
         */
        function approve(address spender, uint256 amount) external returns (bool);
    
        /**
         * @dev Moves `amount` tokens from `sender` to `recipient` using the
         * allowance mechanism. `amount` is then deducted from the caller's
         * allowance.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
    
        /**
         * @dev Emitted when `value` tokens are moved from one account (`from`) to
         * another (`to`).
         *
         * Note that `value` may be zero.
         */
        event Transfer(address indexed from, address indexed to, uint256 value);
    
        /**
         * @dev Emitted when the allowance of a `spender` for an `owner` is set by
         * a call to {approve}. `value` is the new allowance.
         */
        event Approval(address indexed owner, address indexed spender, uint256 value);
    }
    
    /**
     * @dev Wrappers over Solidity's arithmetic operations with added overflow
     * checks.
     *
     * Arithmetic operations in Solidity wrap on overflow. This can easily result
     * in bugs, because programmers usually assume that an overflow raises an
     * error, which is the standard behavior in high level programming languages.
     * `SafeMath` restores this intuition by reverting the transaction when 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.
     */
    library SafeMath {
        /**
         * @dev Returns the addition of two unsigned integers, reverting on
         * overflow.
         *
         * Counterpart to Solidity's `+` operator.
         *
         * Requirements:
         * - Addition cannot overflow.
         */
        function add(uint256 a, uint256 b) internal pure returns (uint256) {
            uint256 c = a + b;
            require(c >= a, "SafeMath: addition overflow");
    
            return c;
        }
    
        /**
         * @dev Returns the subtraction of two unsigned integers, reverting on
         * overflow (when the result is negative).
         *
         * Counterpart to Solidity's `-` operator.
         *
         * Requirements:
         * - Subtraction cannot overflow.
         */
        function sub(uint256 a, uint256 b) internal pure returns (uint256) {
            return sub(a, b, "SafeMath: subtraction overflow");
        }
    
        /**
         * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
         * overflow (when the result is negative).
         *
         * Counterpart to Solidity's `-` operator.
         *
         * Requirements:
         * - Subtraction cannot overflow.
         *
         * _Available since v2.4.0._
         */
        function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            require(b <= a, errorMessage);
            uint256 c = a - b;
    
            return c;
        }
    
        /**
         * @dev Returns the multiplication of two unsigned integers, reverting on
         * overflow.
         *
         * Counterpart to Solidity's `*` operator.
         *
         * Requirements:
         * - Multiplication cannot overflow.
         */
        function mul(uint256 a, uint256 b) internal pure returns (uint256) {
            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
            // benefit is lost if 'b' is also tested.
            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
            if (a == 0) {
                return 0;
            }
    
            uint256 c = a * b;
            require(c / a == b, "SafeMath: multiplication overflow");
    
            return c;
        }
    
        /**
         * @dev Returns the integer division of two unsigned integers. Reverts on
         * division by zero. The result is rounded towards zero.
         *
         * Counterpart to Solidity's `/` operator. Note: this function uses a
         * `revert` opcode (which leaves remaining gas untouched) while Solidity
         * uses an invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         * - The divisor cannot be zero.
         */
        function div(uint256 a, uint256 b) internal pure returns (uint256) {
            return div(a, b, "SafeMath: division by zero");
        }
    
        /**
         * @dev Returns the integer division of two unsigned integers. Reverts with custom message on
         * division by zero. The result is rounded towards zero.
         *
         * Counterpart to Solidity's `/` operator. Note: this function uses a
         * `revert` opcode (which leaves remaining gas untouched) while Solidity
         * uses an invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         * - The divisor cannot be zero.
         *
         * _Available since v2.4.0._
         */
        function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            // Solidity only automatically asserts when dividing by 0
            require(b > 0, errorMessage);
            uint256 c = a / b;
            // assert(a == b * c + a % b); // There is no case in which this doesn't hold
    
            return c;
        }
    
        /**
         * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
         * Reverts when dividing by zero.
         *
         * Counterpart to Solidity's `%` operator. This function uses a `revert`
         * opcode (which leaves remaining gas untouched) while Solidity uses an
         * invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         * - The divisor cannot be zero.
         */
        function mod(uint256 a, uint256 b) internal pure returns (uint256) {
            return mod(a, b, "SafeMath: modulo by zero");
        }
    
        /**
         * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
         * Reverts with custom message when dividing by zero.
         *
         * Counterpart to Solidity's `%` operator. This function uses a `revert`
         * opcode (which leaves remaining gas untouched) while Solidity uses an
         * invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         * - The divisor cannot be zero.
         *
         * _Available since v2.4.0._
         */
        function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            require(b != 0, errorMessage);
            return a % b;
        }
    }
    
    /**
     * @dev Implementation of the {IERC20} interface.
     *
     * This implementation is agnostic to the way tokens are created. This means
     * that a supply mechanism has to be added in a derived contract using {_mint}.
     * For a generic mechanism see {ERC20Mintable}.
     *
     * TIP: For a detailed writeup see our guide
     * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How
     * to implement supply mechanisms].
     *
     * We have followed general OpenZeppelin guidelines: functions revert instead
     * of returning `false` on failure. This behavior is nonetheless conventional
     * and does not conflict with the expectations of ERC20 applications.
     *
     * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
     * This allows applications to reconstruct the allowance for all accounts just
     * by listening to said events. Other implementations of the EIP may not emit
     * these events, as it isn't required by the specification.
     *
     * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
     * functions have been added to mitigate the well-known issues around setting
     * allowances. See {IERC20-approve}.
     */
    contract ERC20 is Context, IERC20 {
        using SafeMath for uint256;
    
        mapping (address => uint256) private _balances;
    
        mapping (address => mapping (address => uint256)) private _allowances;
    
        uint256 private _totalSupply;
    
        /**
         * @dev See {IERC20-totalSupply}.
         */
        function totalSupply() public view returns (uint256) {
            return _totalSupply;
        }
    
        /**
         * @dev See {IERC20-balanceOf}.
         */
        function balanceOf(address account) public view returns (uint256) {
            return _balances[account];
        }
    
        /**
         * @dev See {IERC20-transfer}.
         *
         * Requirements:
         *
         * - `recipient` cannot be the zero address.
         * - the caller must have a balance of at least `amount`.
         */
        function transfer(address recipient, uint256 amount) public returns (bool) {
            _transfer(_msgSender(), recipient, amount);
            return true;
        }
    
        /**
         * @dev See {IERC20-allowance}.
         */
        function allowance(address owner, address spender) public view returns (uint256) {
            return _allowances[owner][spender];
        }
    
        /**
         * @dev See {IERC20-approve}.
         *
         * Requirements:
         *
         * - `spender` cannot be the zero address.
         */
        function approve(address spender, uint256 amount) public returns (bool) {
            _approve(_msgSender(), spender, amount);
            return true;
        }
    
        /**
         * @dev See {IERC20-transferFrom}.
         *
         * Emits an {Approval} event indicating the updated allowance. This is not
         * required by the EIP. See the note at the beginning of {ERC20};
         *
         * Requirements:
         * - `sender` and `recipient` cannot be the zero address.
         * - `sender` must have a balance of at least `amount`.
         * - the caller must have allowance for `sender`'s tokens of at least
         * `amount`.
         */
        function transferFrom(address sender, address recipient, uint256 amount) public returns (bool) {
            _transfer(sender, recipient, amount);
            _approve(sender, _msgSender(), _allowances[sender][_msgSender()].sub(amount, "ERC20: transfer amount exceeds allowance"));
            return true;
        }
    
        /**
         * @dev Atomically increases the allowance granted to `spender` by the caller.
         *
         * This is an alternative to {approve} that can be used as a mitigation for
         * problems described in {IERC20-approve}.
         *
         * Emits an {Approval} event indicating the updated allowance.
         *
         * Requirements:
         *
         * - `spender` cannot be the zero address.
         */
        function increaseAllowance(address spender, uint256 addedValue) public returns (bool) {
            _approve(_msgSender(), spender, _allowances[_msgSender()][spender].add(addedValue));
            return true;
        }
    
        /**
         * @dev Atomically decreases the allowance granted to `spender` by the caller.
         *
         * This is an alternative to {approve} that can be used as a mitigation for
         * problems described in {IERC20-approve}.
         *
         * Emits an {Approval} event indicating the updated allowance.
         *
         * Requirements:
         *
         * - `spender` cannot be the zero address.
         * - `spender` must have allowance for the caller of at least
         * `subtractedValue`.
         */
        function decreaseAllowance(address spender, uint256 subtractedValue) public returns (bool) {
            _approve(_msgSender(), spender, _allowances[_msgSender()][spender].sub(subtractedValue, "ERC20: decreased allowance below zero"));
            return true;
        }
    
        /**
         * @dev Moves tokens `amount` from `sender` to `recipient`.
         *
         * This is internal function is equivalent to {transfer}, and can be used to
         * e.g. implement automatic token fees, slashing mechanisms, etc.
         *
         * Emits a {Transfer} event.
         *
         * Requirements:
         *
         * - `sender` cannot be the zero address.
         * - `recipient` cannot be the zero address.
         * - `sender` must have a balance of at least `amount`.
         */
        function _transfer(address sender, address recipient, uint256 amount) internal {
            require(sender != address(0), "ERC20: transfer from the zero address");
            require(recipient != address(0), "ERC20: transfer to the zero address");
    
            _balances[sender] = _balances[sender].sub(amount, "ERC20: transfer amount exceeds balance");
            _balances[recipient] = _balances[recipient].add(amount);
            emit Transfer(sender, recipient, amount);
        }
    
        /** @dev Creates `amount` tokens and assigns them to `account`, increasing
         * the total supply.
         *
         * Emits a {Transfer} event with `from` set to the zero address.
         *
         * Requirements
         *
         * - `to` cannot be the zero address.
         */
        function _mint(address account, uint256 amount) internal {
            require(account != address(0), "ERC20: mint to the zero address");
    
            _totalSupply = _totalSupply.add(amount);
            _balances[account] = _balances[account].add(amount);
            emit Transfer(address(0), account, amount);
        }
    
        /**
         * @dev Destroys `amount` tokens from `account`, reducing the
         * total supply.
         *
         * Emits a {Transfer} event with `to` set to the zero address.
         *
         * Requirements
         *
         * - `account` cannot be the zero address.
         * - `account` must have at least `amount` tokens.
         */
        function _burn(address account, uint256 amount) internal {
            require(account != address(0), "ERC20: burn from the zero address");
    
            _balances[account] = _balances[account].sub(amount, "ERC20: burn amount exceeds balance");
            _totalSupply = _totalSupply.sub(amount);
            emit Transfer(account, address(0), amount);
        }
    
        /**
         * @dev Sets `amount` as the allowance of `spender` over the `owner`s tokens.
         *
         * This is internal function is equivalent to `approve`, and can be used to
         * e.g. set automatic allowances for certain subsystems, etc.
         *
         * Emits an {Approval} event.
         *
         * Requirements:
         *
         * - `owner` cannot be the zero address.
         * - `spender` cannot be the zero address.
         */
        function _approve(address owner, address spender, uint256 amount) internal {
            require(owner != address(0), "ERC20: approve from the zero address");
            require(spender != address(0), "ERC20: approve to the zero address");
    
            _allowances[owner][spender] = amount;
            emit Approval(owner, spender, amount);
        }
    
        /**
         * @dev Destroys `amount` tokens from `account`.`amount` is then deducted
         * from the caller's allowance.
         *
         * See {_burn} and {_approve}.
         */
        function _burnFrom(address account, uint256 amount) internal {
            _burn(account, amount);
            _approve(account, _msgSender(), _allowances[account][_msgSender()].sub(amount, "ERC20: burn amount exceeds allowance"));
        }
    }
    
    /**
     * @dev Extension of {ERC20} that allows token holders to destroy both their own
     * tokens and those that they have an allowance for, in a way that can be
     * recognized off-chain (via event analysis).
     */
    contract ERC20Burnable is Context, ERC20 {
        /**
         * @dev Destroys `amount` tokens from the caller.
         *
         * See {ERC20-_burn}.
         */
        function burn(uint256 amount) public {
            _burn(_msgSender(), amount);
        }
    
        /**
         * @dev See {ERC20-_burnFrom}.
         */
        function burnFrom(address account, uint256 amount) public {
            _burnFrom(account, amount);
        }
    }
    
    /**
     * @dev Optional functions from the ERC20 standard.
     */
    contract ERC20Detailed is IERC20 {
        string private _name;
        string private _symbol;
        uint8 private _decimals;
    
        /**
         * @dev Sets the values for `name`, `symbol`, and `decimals`. All three of
         * these values are immutable: they can only be set once during
         * construction.
         */
        constructor (string memory name, string memory symbol, uint8 decimals) public {
            _name = name;
            _symbol = symbol;
            _decimals = decimals;
        }
    
        /**
         * @dev Returns the name of the token.
         */
        function name() public view returns (string memory) {
            return _name;
        }
    
        /**
         * @dev Returns the symbol of the token, usually a shorter version of the
         * name.
         */
        function symbol() public view returns (string memory) {
            return _symbol;
        }
    
        /**
         * @dev Returns the number of decimals used to get its user representation.
         * For example, if `decimals` equals `2`, a balance of `505` tokens should
         * be displayed to a user as `5,05` (`505 / 10 ** 2`).
         *
         * Tokens usually opt for a value of 18, imitating the relationship between
         * Ether and Wei.
         *
         * NOTE: This information is only used for _display_ purposes: it in
         * no way affects any of the arithmetic of the contract, including
         * {IERC20-balanceOf} and {IERC20-transfer}.
         */
        function decimals() public view returns (uint8) {
            return _decimals;
        }
    }
    
    /**
     * @title Roles
     * @dev Library for managing addresses assigned to a Role.
     */
    library Roles {
        struct Role {
            mapping (address => bool) bearer;
        }
    
        /**
         * @dev Give an account access to this role.
         */
        function add(Role storage role, address account) internal {
            require(!has(role, account), "Roles: account already has role");
            role.bearer[account] = true;
        }
    
        /**
         * @dev Remove an account's access to this role.
         */
        function remove(Role storage role, address account) internal {
            require(has(role, account), "Roles: account does not have role");
            role.bearer[account] = false;
        }
    
        /**
         * @dev Check if an account has this role.
         * @return bool
         */
        function has(Role storage role, address account) internal view returns (bool) {
            require(account != address(0), "Roles: account is the zero address");
            return role.bearer[account];
        }
    }
    
    contract MinterRole is Context {
        using Roles for Roles.Role;
    
        event MinterAdded(address indexed account);
        event MinterRemoved(address indexed account);
    
        Roles.Role private _minters;
    
        constructor () internal {
            _addMinter(_msgSender());
        }
    
        modifier onlyMinter() {
            require(isMinter(_msgSender()), "MinterRole: caller does not have the Minter role");
            _;
        }
    
        function isMinter(address account) public view returns (bool) {
            return _minters.has(account);
        }
    
        function addMinter(address account) public onlyMinter {
            _addMinter(account);
        }
    
        function renounceMinter() public {
            _removeMinter(_msgSender());
        }
    
        function _addMinter(address account) internal {
            _minters.add(account);
            emit MinterAdded(account);
        }
    
        function _removeMinter(address account) internal {
            _minters.remove(account);
            emit MinterRemoved(account);
        }
    }
    
    /*
        Copyright 2019 dYdX Trading Inc.
    
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
    
        http://www.apache.org/licenses/LICENSE-2.0
    
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
    */
    /**
     * @title Require
     * @author dYdX
     *
     * Stringifies parameters to pretty-print revert messages. Costs more gas than regular require()
     */
    library Require {
    
        // ============ Constants ============
    
        uint256 constant ASCII_ZERO = 48; // '0'
        uint256 constant ASCII_RELATIVE_ZERO = 87; // 'a' - 10
        uint256 constant ASCII_LOWER_EX = 120; // 'x'
        bytes2 constant COLON = 0x3a20; // ': '
        bytes2 constant COMMA = 0x2c20; // ', '
        bytes2 constant LPAREN = 0x203c; // ' <'
        byte constant RPAREN = 0x3e; // '>'
        uint256 constant FOUR_BIT_MASK = 0xf;
    
        // ============ Library Functions ============
    
        function that(
            bool must,
            bytes32 file,
            bytes32 reason
        )
        internal
        pure
        {
            if (!must) {
                revert(
                    string(
                        abi.encodePacked(
                            stringifyTruncated(file),
                            COLON,
                            stringifyTruncated(reason)
                        )
                    )
                );
            }
        }
    
        function that(
            bool must,
            bytes32 file,
            bytes32 reason,
            uint256 payloadA
        )
        internal
        pure
        {
            if (!must) {
                revert(
                    string(
                        abi.encodePacked(
                            stringifyTruncated(file),
                            COLON,
                            stringifyTruncated(reason),
                            LPAREN,
                            stringify(payloadA),
                            RPAREN
                        )
                    )
                );
            }
        }
    
        function that(
            bool must,
            bytes32 file,
            bytes32 reason,
            uint256 payloadA,
            uint256 payloadB
        )
        internal
        pure
        {
            if (!must) {
                revert(
                    string(
                        abi.encodePacked(
                            stringifyTruncated(file),
                            COLON,
                            stringifyTruncated(reason),
                            LPAREN,
                            stringify(payloadA),
                            COMMA,
                            stringify(payloadB),
                            RPAREN
                        )
                    )
                );
            }
        }
    
        function that(
            bool must,
            bytes32 file,
            bytes32 reason,
            address payloadA
        )
        internal
        pure
        {
            if (!must) {
                revert(
                    string(
                        abi.encodePacked(
                            stringifyTruncated(file),
                            COLON,
                            stringifyTruncated(reason),
                            LPAREN,
                            stringify(payloadA),
                            RPAREN
                        )
                    )
                );
            }
        }
    
        function that(
            bool must,
            bytes32 file,
            bytes32 reason,
            address payloadA,
            uint256 payloadB
        )
        internal
        pure
        {
            if (!must) {
                revert(
                    string(
                        abi.encodePacked(
                            stringifyTruncated(file),
                            COLON,
                            stringifyTruncated(reason),
                            LPAREN,
                            stringify(payloadA),
                            COMMA,
                            stringify(payloadB),
                            RPAREN
                        )
                    )
                );
            }
        }
    
        function that(
            bool must,
            bytes32 file,
            bytes32 reason,
            address payloadA,
            uint256 payloadB,
            uint256 payloadC
        )
        internal
        pure
        {
            if (!must) {
                revert(
                    string(
                        abi.encodePacked(
                            stringifyTruncated(file),
                            COLON,
                            stringifyTruncated(reason),
                            LPAREN,
                            stringify(payloadA),
                            COMMA,
                            stringify(payloadB),
                            COMMA,
                            stringify(payloadC),
                            RPAREN
                        )
                    )
                );
            }
        }
    
        function that(
            bool must,
            bytes32 file,
            bytes32 reason,
            bytes32 payloadA
        )
        internal
        pure
        {
            if (!must) {
                revert(
                    string(
                        abi.encodePacked(
                            stringifyTruncated(file),
                            COLON,
                            stringifyTruncated(reason),
                            LPAREN,
                            stringify(payloadA),
                            RPAREN
                        )
                    )
                );
            }
        }
    
        function that(
            bool must,
            bytes32 file,
            bytes32 reason,
            bytes32 payloadA,
            uint256 payloadB,
            uint256 payloadC
        )
        internal
        pure
        {
            if (!must) {
                revert(
                    string(
                        abi.encodePacked(
                            stringifyTruncated(file),
                            COLON,
                            stringifyTruncated(reason),
                            LPAREN,
                            stringify(payloadA),
                            COMMA,
                            stringify(payloadB),
                            COMMA,
                            stringify(payloadC),
                            RPAREN
                        )
                    )
                );
            }
        }
    
        // ============ Private Functions ============
    
        function stringifyTruncated(
            bytes32 input
        )
        private
        pure
        returns (bytes memory)
        {
            // put the input bytes into the result
            bytes memory result = abi.encodePacked(input);
    
            // determine the length of the input by finding the location of the last non-zero byte
            for (uint256 i = 32; i > 0; ) {
                // reverse-for-loops with unsigned integer
                /* solium-disable-next-line security/no-modify-for-iter-var */
                i--;
    
                // find the last non-zero byte in order to determine the length
                if (result[i] != 0) {
                    uint256 length = i + 1;
    
                    /* solium-disable-next-line security/no-inline-assembly */
                    assembly {
                        mstore(result, length) // r.length = length;
                    }
    
                    return result;
                }
            }
    
            // all bytes are zero
            return new bytes(0);
        }
    
        function stringify(
            uint256 input
        )
        private
        pure
        returns (bytes memory)
        {
            if (input == 0) {
                return "0";
            }
    
            // get the final string length
            uint256 j = input;
            uint256 length;
            while (j != 0) {
                length++;
                j /= 10;
            }
    
            // allocate the string
            bytes memory bstr = new bytes(length);
    
            // populate the string starting with the least-significant character
            j = input;
            for (uint256 i = length; i > 0; ) {
                // reverse-for-loops with unsigned integer
                /* solium-disable-next-line security/no-modify-for-iter-var */
                i--;
    
                // take last decimal digit
                bstr[i] = byte(uint8(ASCII_ZERO + (j % 10)));
    
                // remove the last decimal digit
                j /= 10;
            }
    
            return bstr;
        }
    
        function stringify(
            address input
        )
        private
        pure
        returns (bytes memory)
        {
            uint256 z = uint256(input);
    
            // addresses are "0x" followed by 20 bytes of data which take up 2 characters each
            bytes memory result = new bytes(42);
    
            // populate the result with "0x"
            result[0] = byte(uint8(ASCII_ZERO));
            result[1] = byte(uint8(ASCII_LOWER_EX));
    
            // for each byte (starting from the lowest byte), populate the result with two characters
            for (uint256 i = 0; i < 20; i++) {
                // each byte takes two characters
                uint256 shift = i * 2;
    
                // populate the least-significant character
                result[41 - shift] = char(z & FOUR_BIT_MASK);
                z = z >> 4;
    
                // populate the most-significant character
                result[40 - shift] = char(z & FOUR_BIT_MASK);
                z = z >> 4;
            }
    
            return result;
        }
    
        function stringify(
            bytes32 input
        )
        private
        pure
        returns (bytes memory)
        {
            uint256 z = uint256(input);
    
            // bytes32 are "0x" followed by 32 bytes of data which take up 2 characters each
            bytes memory result = new bytes(66);
    
            // populate the result with "0x"
            result[0] = byte(uint8(ASCII_ZERO));
            result[1] = byte(uint8(ASCII_LOWER_EX));
    
            // for each byte (starting from the lowest byte), populate the result with two characters
            for (uint256 i = 0; i < 32; i++) {
                // each byte takes two characters
                uint256 shift = i * 2;
    
                // populate the least-significant character
                result[65 - shift] = char(z & FOUR_BIT_MASK);
                z = z >> 4;
    
                // populate the most-significant character
                result[64 - shift] = char(z & FOUR_BIT_MASK);
                z = z >> 4;
            }
    
            return result;
        }
    
        function char(
            uint256 input
        )
        private
        pure
        returns (byte)
        {
            // return ASCII digit (0-9)
            if (input < 10) {
                return byte(uint8(input + ASCII_ZERO));
            }
    
            // return ASCII letter (a-f)
            return byte(uint8(input + ASCII_RELATIVE_ZERO));
        }
    }
    
    /*
        Copyright 2019 ZeroEx Intl.
    
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
    
        http://www.apache.org/licenses/LICENSE-2.0
    
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
    */
    library LibEIP712 {
    
        // Hash of the EIP712 Domain Separator Schema
        // keccak256(abi.encodePacked(
        //     "EIP712Domain(",
        //     "string name,",
        //     "string version,",
        //     "uint256 chainId,",
        //     "address verifyingContract",
        //     ")"
        // ))
        bytes32 constant internal _EIP712_DOMAIN_SEPARATOR_SCHEMA_HASH = 0x8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f;
    
        /// @dev Calculates a EIP712 domain separator.
        /// @param name The EIP712 domain name.
        /// @param version The EIP712 domain version.
        /// @param verifyingContract The EIP712 verifying contract.
        /// @return EIP712 domain separator.
        function hashEIP712Domain(
            string memory name,
            string memory version,
            uint256 chainId,
            address verifyingContract
        )
        internal
        pure
        returns (bytes32 result)
        {
            bytes32 schemaHash = _EIP712_DOMAIN_SEPARATOR_SCHEMA_HASH;
    
            // Assembly for more efficient computing:
            // keccak256(abi.encodePacked(
            //     _EIP712_DOMAIN_SEPARATOR_SCHEMA_HASH,
            //     keccak256(bytes(name)),
            //     keccak256(bytes(version)),
            //     chainId,
            //     uint256(verifyingContract)
            // ))
    
            assembly {
            // Calculate hashes of dynamic data
                let nameHash := keccak256(add(name, 32), mload(name))
                let versionHash := keccak256(add(version, 32), mload(version))
    
            // Load free memory pointer
                let memPtr := mload(64)
    
            // Store params in memory
                mstore(memPtr, schemaHash)
                mstore(add(memPtr, 32), nameHash)
                mstore(add(memPtr, 64), versionHash)
                mstore(add(memPtr, 96), chainId)
                mstore(add(memPtr, 128), verifyingContract)
    
            // Compute hash
                result := keccak256(memPtr, 160)
            }
            return result;
        }
    
        /// @dev Calculates EIP712 encoding for a hash struct with a given domain hash.
        /// @param eip712DomainHash Hash of the domain domain separator data, computed
        ///                         with getDomainHash().
        /// @param hashStruct The EIP712 hash struct.
        /// @return EIP712 hash applied to the given EIP712 Domain.
        function hashEIP712Message(bytes32 eip712DomainHash, bytes32 hashStruct)
        internal
        pure
        returns (bytes32 result)
        {
            // Assembly for more efficient computing:
            // keccak256(abi.encodePacked(
            //     EIP191_HEADER,
            //     EIP712_DOMAIN_HASH,
            //     hashStruct
            // ));
    
            assembly {
            // Load free memory pointer
                let memPtr := mload(64)
    
                mstore(memPtr, 0x1901000000000000000000000000000000000000000000000000000000000000)  // EIP191 header
                mstore(add(memPtr, 2), eip712DomainHash)                                            // EIP712 domain hash
                mstore(add(memPtr, 34), hashStruct)                                                 // Hash of struct
    
            // Compute hash
                result := keccak256(memPtr, 66)
            }
            return result;
        }
    }
    
    /*
        Copyright 2019 dYdX Trading Inc.
        Copyright 2020 Empty Set Squad <[email protected]>
    
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
    
        http://www.apache.org/licenses/LICENSE-2.0
    
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
    */
    /**
     * @title Decimal
     * @author dYdX
     *
     * Library that defines a fixed-point number with 18 decimal places.
     */
    library Decimal {
        using SafeMath for uint256;
    
        // ============ Constants ============
    
        uint256 constant BASE = 10**18;
    
        // ============ Structs ============
    
    
        struct D256 {
            uint256 value;
        }
    
        // ============ Static Functions ============
    
        function zero()
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: 0 });
        }
    
        function one()
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: BASE });
        }
    
        function from(
            uint256 a
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: a.mul(BASE) });
        }
    
        function ratio(
            uint256 a,
            uint256 b
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: getPartial(a, BASE, b) });
        }
    
        // ============ Self Functions ============
    
        function add(
            D256 memory self,
            uint256 b
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: self.value.add(b.mul(BASE)) });
        }
    
        function sub(
            D256 memory self,
            uint256 b
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: self.value.sub(b.mul(BASE)) });
        }
    
        function sub(
            D256 memory self,
            uint256 b,
            string memory reason
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: self.value.sub(b.mul(BASE), reason) });
        }
    
        function mul(
            D256 memory self,
            uint256 b
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: self.value.mul(b) });
        }
    
        function div(
            D256 memory self,
            uint256 b
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: self.value.div(b) });
        }
    
        function pow(
            D256 memory self,
            uint256 b
        )
        internal
        pure
        returns (D256 memory)
        {
            if (b == 0) {
                return from(1);
            }
    
            D256 memory temp = D256({ value: self.value });
            for (uint256 i = 1; i < b; i++) {
                temp = mul(temp, self);
            }
    
            return temp;
        }
    
        function add(
            D256 memory self,
            D256 memory b
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: self.value.add(b.value) });
        }
    
        function sub(
            D256 memory self,
            D256 memory b
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: self.value.sub(b.value) });
        }
    
        function sub(
            D256 memory self,
            D256 memory b,
            string memory reason
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: self.value.sub(b.value, reason) });
        }
    
        function mul(
            D256 memory self,
            D256 memory b
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: getPartial(self.value, b.value, BASE) });
        }
    
        function div(
            D256 memory self,
            D256 memory b
        )
        internal
        pure
        returns (D256 memory)
        {
            return D256({ value: getPartial(self.value, BASE, b.value) });
        }
    
        function equals(D256 memory self, D256 memory b) internal pure returns (bool) {
            return self.value == b.value;
        }
    
        function greaterThan(D256 memory self, D256 memory b) internal pure returns (bool) {
            return compareTo(self, b) == 2;
        }
    
        function lessThan(D256 memory self, D256 memory b) internal pure returns (bool) {
            return compareTo(self, b) == 0;
        }
    
        function greaterThanOrEqualTo(D256 memory self, D256 memory b) internal pure returns (bool) {
            return compareTo(self, b) > 0;
        }
    
        function lessThanOrEqualTo(D256 memory self, D256 memory b) internal pure returns (bool) {
            return compareTo(self, b) < 2;
        }
    
        function isZero(D256 memory self) internal pure returns (bool) {
            return self.value == 0;
        }
    
        function asUint256(D256 memory self) internal pure returns (uint256) {
            return self.value.div(BASE);
        }
    
        // ============ Core Methods ============
    
        function getPartial(
            uint256 target,
            uint256 numerator,
            uint256 denominator
        )
        private
        pure
        returns (uint256)
        {
            return target.mul(numerator).div(denominator);
        }
    
        function compareTo(
            D256 memory a,
            D256 memory b
        )
        private
        pure
        returns (uint256)
        {
            if (a.value == b.value) {
                return 1;
            }
            return a.value > b.value ? 2 : 0;
        }
    }
    
    /*
        Copyright 2020 Empty Set Squad <[email protected]>
    
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
    
        http://www.apache.org/licenses/LICENSE-2.0
    
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
    */
    library Constants {
        /* Chain */
        uint256 private constant CHAIN_ID = 1; // Mainnet
    
        /* Bootstrapping */
        uint256 private constant BOOTSTRAPPING_PERIOD = 90;
        uint256 private constant BOOTSTRAPPING_PRICE = 11e17; // 1.10 USDC
        uint256 private constant BOOTSTRAPPING_SPEEDUP_FACTOR = 3; // 30 days @ 8 hours
    
        /* Oracle */
        address private constant USDC = address(0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48);
        uint256 private constant ORACLE_RESERVE_MINIMUM = 1e10; // 10,000 USDC
    
        /* Bonding */
        uint256 private constant INITIAL_STAKE_MULTIPLE = 1e6; // 100 ESD -> 100M ESDS
    
        /* Epoch */
        uint256 private constant EPOCH_PERIOD = 86400; // 1 day
    
        /* Governance */
        uint256 private constant GOVERNANCE_PERIOD = 7;
        uint256 private constant GOVERNANCE_QUORUM = 33e16; // 33%
    
        /* DAO */
        uint256 private constant ADVANCE_INCENTIVE = 1e20; // 100 ESD
    
        /* Market */
        uint256 private constant COUPON_EXPIRATION = 90;
    
        /* Regulator */
        uint256 private constant SUPPLY_CHANGE_LIMIT = 1e17; // 10%
        uint256 private constant ORACLE_POOL_RATIO = 5; // 5%
    
    
        /**
         * Getters
         */
    
        function getUsdc() internal pure returns (address) {
            return USDC;
        }
    
        function getOracleReserveMinimum() internal pure returns (uint256) {
            return ORACLE_RESERVE_MINIMUM;
        }
    
        function getEpochPeriod() internal pure returns (uint256) {
            return EPOCH_PERIOD;
        }
    
        function getInitialStakeMultiple() internal pure returns (uint256) {
            return INITIAL_STAKE_MULTIPLE;
        }
    
        function getBootstrappingPeriod() internal pure returns (uint256) {
            return BOOTSTRAPPING_PERIOD;
        }
    
        function getBootstrappingPrice() internal pure returns (Decimal.D256 memory) {
            return Decimal.D256({value: BOOTSTRAPPING_PRICE});
        }
    
        function getBootstrappingSpeedupFactor() internal pure returns (uint256) {
            return BOOTSTRAPPING_SPEEDUP_FACTOR;
        }
    
        function getGovernancePeriod() internal pure returns (uint256) {
            return GOVERNANCE_PERIOD;
        }
    
        function getGovernanceQuorum() internal pure returns (Decimal.D256 memory) {
            return Decimal.D256({value: GOVERNANCE_QUORUM});
        }
    
        function getAdvanceIncentive() internal pure returns (uint256) {
            return ADVANCE_INCENTIVE;
        }
    
        function getCouponExpiration() internal pure returns (uint256) {
            return COUPON_EXPIRATION;
        }
    
        function getSupplyChangeLimit() internal pure returns (Decimal.D256 memory) {
            return Decimal.D256({value: SUPPLY_CHANGE_LIMIT});
        }
    
        function getOraclePoolRatio() internal pure returns (uint256) {
            return ORACLE_POOL_RATIO;
        }
    
        function getChainId() internal pure returns (uint256) {
            return CHAIN_ID;
        }
    }
    
    /*
        Copyright 2020 Empty Set Squad <[email protected]>
    
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
    
        http://www.apache.org/licenses/LICENSE-2.0
    
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
    */
    contract Permittable is ERC20Detailed, ERC20 {
        bytes32 constant FILE = "Permittable";
    
        // keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)");
        bytes32 public constant EIP712_PERMIT_TYPEHASH = 0x6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9;
        string private constant EIP712_VERSION = "1";
    
        bytes32 public EIP712_DOMAIN_SEPARATOR;
    
        mapping(address => uint256) nonces;
    
        constructor() public {
            EIP712_DOMAIN_SEPARATOR = LibEIP712.hashEIP712Domain(name(), EIP712_VERSION, Constants.getChainId(), address(this));
        }
    
        function permit(
            address owner,
            address spender,
            uint256 value,
            uint256 deadline,
            uint8 v,
            bytes32 r,
            bytes32 s
        ) external {
            bytes32 digest = LibEIP712.hashEIP712Message(
                EIP712_DOMAIN_SEPARATOR,
                keccak256(abi.encode(
                    EIP712_PERMIT_TYPEHASH,
                    owner,
                    spender,
                    value,
                    nonces[owner]++,
                    deadline
                ))
            );
    
            address recovered = ecrecover(digest, v, r, s);
            Require.that(
                recovered == owner,
                FILE,
                "Invalid signature"
            );
    
            Require.that(
                recovered != address(0),
                FILE,
                "Zero address"
            );
    
            Require.that(
                now <= deadline,
                FILE,
                "Expired"
            );
    
            _approve(owner, spender, value);
        }
    }
    
    /*
        Copyright 2020 Empty Set Squad <[email protected]>
    
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
    
        http://www.apache.org/licenses/LICENSE-2.0
    
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
    */
    contract IDollar is IERC20 {
        function burn(uint256 amount) public;
        function burnFrom(address account, uint256 amount) public;
        function mint(address account, uint256 amount) public returns (bool);
    }
    
    /*
        Copyright 2020 Empty Set Squad <[email protected]>
    
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
    
        http://www.apache.org/licenses/LICENSE-2.0
    
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
    */
    contract Dollar is IDollar, MinterRole, ERC20Detailed, Permittable, ERC20Burnable {
    
        constructor()
        ERC20Detailed("Empty Set Dollar", "ESD", 18)
        Permittable()
        public
        { }
    
        function mint(address account, uint256 amount) public onlyMinter returns (bool) {
            _mint(account, amount);
            return true;
        }
    
        function transferFrom(address sender, address recipient, uint256 amount) public returns (bool) {
            _transfer(sender, recipient, amount);
            if (allowance(sender, _msgSender()) != uint256(-1)) {
                _approve(
                    sender,
                    _msgSender(),
                    allowance(sender, _msgSender()).sub(amount, "Dollar: transfer amount exceeds allowance"));
            }
            return true;
        }
    }