ETH Price: $2,524.54 (-0.52%)

Transaction Decoder

Block:
21249026 at Nov-23-2024 07:44:47 AM +UTC
Transaction Fee:
0.000846717570777408 ETH $2.14
Gas Used:
43,266 Gas / 19.570045088 Gwei

Emitted Events:

Account State Difference:

  Address   Before After State Difference Code
(Titan Builder)
13.669068028818274195 Eth13.669474922653334773 Eth0.000406893835060578
0x9f8F72aA...cC3A579A2
0xBE49Bd13...DD9887f40
10.400873500115987467 Eth
Nonce: 66135
10.400026782545210059 Eth
Nonce: 66136
0.000846717570777408

Execution Trace

0xbb26df665c594c723b746f68010d4dedbd441c8c.dca67d7b( )
  • ExchangeDeposit.gatherErc20( instance=0x9f8F72aA9304c8B593d555F12eF6589cC3A579A2 )
    • DSToken.balanceOf( src=0xBB26df665c594C723B746F68010D4dEDBd441c8C ) => ( 21065400000000000000 )
    • ExchangeDeposit.STATICCALL( )
    • DSToken.transfer( dst=0x3727cfCBD85390Bb11B3fF421878123AdB866be8, wad=21065400000000000000 ) => ( True )
      File 1 of 2: DSToken
      // MKR Token
      
      // hevm: flattened sources of src/mkr-499.sol
      pragma solidity ^0.4.15;
      
      ////// lib/ds-roles/lib/ds-auth/src/auth.sol
      // This program is free software: you can redistribute it and/or modify
      // it under the terms of the GNU General Public License as published by
      // the Free Software Foundation, either version 3 of the License, or
      // (at your option) any later version.
      
      // This program is distributed in the hope that it will be useful,
      // but WITHOUT ANY WARRANTY; without even the implied warranty of
      // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      // GNU General Public License for more details.
      
      // You should have received a copy of the GNU General Public License
      // along with this program.  If not, see <http://www.gnu.org/licenses/>.
      
      /* pragma solidity ^0.4.13; */
      
      contract DSAuthority {
          function canCall(
              address src, address dst, bytes4 sig
          ) public view returns (bool);
      }
      
      contract DSAuthEvents {
          event LogSetAuthority (address indexed authority);
          event LogSetOwner     (address indexed owner);
      }
      
      contract DSAuth is DSAuthEvents {
          DSAuthority  public  authority;
          address      public  owner;
      
          function DSAuth() public {
              owner = msg.sender;
              LogSetOwner(msg.sender);
          }
      
          function setOwner(address owner_)
              public
              auth
          {
              owner = owner_;
              LogSetOwner(owner);
          }
      
          function setAuthority(DSAuthority authority_)
              public
              auth
          {
              authority = authority_;
              LogSetAuthority(authority);
          }
      
          modifier auth {
              require(isAuthorized(msg.sender, msg.sig));
              _;
          }
      
          function isAuthorized(address src, bytes4 sig) internal view returns (bool) {
              if (src == address(this)) {
                  return true;
              } else if (src == owner) {
                  return true;
              } else if (authority == DSAuthority(0)) {
                  return false;
              } else {
                  return authority.canCall(src, this, sig);
              }
          }
      }
      
      ////// lib/ds-thing/lib/ds-math/src/math.sol
      /// math.sol -- mixin for inline numerical wizardry
      
      // This program is free software: you can redistribute it and/or modify
      // it under the terms of the GNU General Public License as published by
      // the Free Software Foundation, either version 3 of the License, or
      // (at your option) any later version.
      
      // This program is distributed in the hope that it will be useful,
      // but WITHOUT ANY WARRANTY; without even the implied warranty of
      // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      // GNU General Public License for more details.
      
      // You should have received a copy of the GNU General Public License
      // along with this program.  If not, see <http://www.gnu.org/licenses/>.
      
      /* pragma solidity ^0.4.13; */
      
      contract DSMath {
          function add(uint x, uint y) internal pure returns (uint z) {
              require((z = x + y) >= x);
          }
          function sub(uint x, uint y) internal pure returns (uint z) {
              require((z = x - y) <= x);
          }
          function mul(uint x, uint y) internal pure returns (uint z) {
              require(y == 0 || (z = x * y) / y == x);
          }
      
          function min(uint x, uint y) internal pure returns (uint z) {
              return x <= y ? x : y;
          }
          function max(uint x, uint y) internal pure returns (uint z) {
              return x >= y ? x : y;
          }
          function imin(int x, int y) internal pure returns (int z) {
              return x <= y ? x : y;
          }
          function imax(int x, int y) internal pure returns (int z) {
              return x >= y ? x : y;
          }
      
          uint constant WAD = 10 ** 18;
          uint constant RAY = 10 ** 27;
      
          function wmul(uint x, uint y) internal pure returns (uint z) {
              z = add(mul(x, y), WAD / 2) / WAD;
          }
          function rmul(uint x, uint y) internal pure returns (uint z) {
              z = add(mul(x, y), RAY / 2) / RAY;
          }
          function wdiv(uint x, uint y) internal pure returns (uint z) {
              z = add(mul(x, WAD), y / 2) / y;
          }
          function rdiv(uint x, uint y) internal pure returns (uint z) {
              z = add(mul(x, RAY), y / 2) / y;
          }
      
          // This famous algorithm is called "exponentiation by squaring"
          // and calculates x^n with x as fixed-point and n as regular unsigned.
          //
          // It's O(log n), instead of O(n) for naive repeated multiplication.
          //
          // These facts are why it works:
          //
          //  If n is even, then x^n = (x^2)^(n/2).
          //  If n is odd,  then x^n = x * x^(n-1),
          //   and applying the equation for even x gives
          //    x^n = x * (x^2)^((n-1) / 2).
          //
          //  Also, EVM division is flooring and
          //    floor[(n-1) / 2] = floor[n / 2].
          //
          function rpow(uint x, uint n) internal pure returns (uint z) {
              z = n % 2 != 0 ? x : RAY;
      
              for (n /= 2; n != 0; n /= 2) {
                  x = rmul(x, x);
      
                  if (n % 2 != 0) {
                      z = rmul(z, x);
                  }
              }
          }
      }
      
      ////// lib/ds-thing/lib/ds-note/src/note.sol
      /// note.sol -- the `note' modifier, for logging calls as events
      
      // This program is free software: you can redistribute it and/or modify
      // it under the terms of the GNU General Public License as published by
      // the Free Software Foundation, either version 3 of the License, or
      // (at your option) any later version.
      
      // This program is distributed in the hope that it will be useful,
      // but WITHOUT ANY WARRANTY; without even the implied warranty of
      // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      // GNU General Public License for more details.
      
      // You should have received a copy of the GNU General Public License
      // along with this program.  If not, see <http://www.gnu.org/licenses/>.
      
      /* pragma solidity ^0.4.13; */
      
      contract DSNote {
          event LogNote(
              bytes4   indexed  sig,
              address  indexed  guy,
              bytes32  indexed  foo,
              bytes32  indexed  bar,
              uint              wad,
              bytes             fax
          ) anonymous;
      
          modifier note {
              bytes32 foo;
              bytes32 bar;
      
              assembly {
                  foo := calldataload(4)
                  bar := calldataload(36)
              }
      
              LogNote(msg.sig, msg.sender, foo, bar, msg.value, msg.data);
      
              _;
          }
      }
      
      ////// lib/ds-thing/src/thing.sol
      // thing.sol - `auth` with handy mixins. your things should be DSThings
      
      // Copyright (C) 2017  DappHub, LLC
      
      // This program is free software: you can redistribute it and/or modify
      // it under the terms of the GNU General Public License as published by
      // the Free Software Foundation, either version 3 of the License, or
      // (at your option) any later version.
      
      // This program is distributed in the hope that it will be useful,
      // but WITHOUT ANY WARRANTY; without even the implied warranty of
      // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      // GNU General Public License for more details.
      
      // You should have received a copy of the GNU General Public License
      // along with this program.  If not, see <http://www.gnu.org/licenses/>.
      
      /* pragma solidity ^0.4.13; */
      
      /* import 'ds-auth/auth.sol'; */
      /* import 'ds-note/note.sol'; */
      /* import 'ds-math/math.sol'; */
      
      contract DSThing is DSAuth, DSNote, DSMath {
      }
      
      ////// lib/ds-token/lib/ds-stop/src/stop.sol
      /// stop.sol -- mixin for enable/disable functionality
      
      // Copyright (C) 2017  DappHub, LLC
      
      // This program is free software: you can redistribute it and/or modify
      // it under the terms of the GNU General Public License as published by
      // the Free Software Foundation, either version 3 of the License, or
      // (at your option) any later version.
      
      // This program is distributed in the hope that it will be useful,
      // but WITHOUT ANY WARRANTY; without even the implied warranty of
      // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      // GNU General Public License for more details.
      
      // You should have received a copy of the GNU General Public License
      // along with this program.  If not, see <http://www.gnu.org/licenses/>.
      
      /* pragma solidity ^0.4.13; */
      
      /* import "ds-auth/auth.sol"; */
      /* import "ds-note/note.sol"; */
      
      contract DSStop is DSNote, DSAuth {
      
          bool public stopped;
      
          modifier stoppable {
              require(!stopped);
              _;
          }
          function stop() public auth note {
              stopped = true;
          }
          function start() public auth note {
              stopped = false;
          }
      
      }
      
      ////// lib/ds-token/lib/erc20/src/erc20.sol
      // This program is free software: you can redistribute it and/or modify
      // it under the terms of the GNU General Public License as published by
      // the Free Software Foundation, either version 3 of the License, or
      // (at your option) any later version.
      
      // This program is distributed in the hope that it will be useful,
      // but WITHOUT ANY WARRANTY; without even the implied warranty of
      // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      // GNU General Public License for more details.
      
      // You should have received a copy of the GNU General Public License
      // along with this program.  If not, see <http://www.gnu.org/licenses/>.
      
      /* pragma solidity ^0.4.8; */
      
      // Token standard API
      // https://github.com/ethereum/EIPs/issues/20
      
      contract ERC20 {
          function totalSupply() public view returns (uint supply);
          function balanceOf( address who ) public view returns (uint value);
          function allowance( address owner, address spender ) public view returns (uint _allowance);
      
          function transfer( address to, uint value) public returns (bool ok);
          function transferFrom( address from, address to, uint value) public returns (bool ok);
          function approve( address spender, uint value ) public returns (bool ok);
      
          event Transfer( address indexed from, address indexed to, uint value);
          event Approval( address indexed owner, address indexed spender, uint value);
      }
      
      ////// lib/ds-token/src/base.sol
      /// base.sol -- basic ERC20 implementation
      
      // Copyright (C) 2015, 2016, 2017  DappHub, LLC
      
      // This program is free software: you can redistribute it and/or modify
      // it under the terms of the GNU General Public License as published by
      // the Free Software Foundation, either version 3 of the License, or
      // (at your option) any later version.
      
      // This program is distributed in the hope that it will be useful,
      // but WITHOUT ANY WARRANTY; without even the implied warranty of
      // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      // GNU General Public License for more details.
      
      // You should have received a copy of the GNU General Public License
      // along with this program.  If not, see <http://www.gnu.org/licenses/>.
      
      /* pragma solidity ^0.4.13; */
      
      /* import "erc20/erc20.sol"; */
      /* import "ds-math/math.sol"; */
      
      contract DSTokenBase is ERC20, DSMath {
          uint256                                            _supply;
          mapping (address => uint256)                       _balances;
          mapping (address => mapping (address => uint256))  _approvals;
      
          function DSTokenBase(uint supply) public {
              _balances[msg.sender] = supply;
              _supply = supply;
          }
      
          function totalSupply() public view returns (uint) {
              return _supply;
          }
          function balanceOf(address src) public view returns (uint) {
              return _balances[src];
          }
          function allowance(address src, address guy) public view returns (uint) {
              return _approvals[src][guy];
          }
      
          function transfer(address dst, uint wad) public returns (bool) {
              return transferFrom(msg.sender, dst, wad);
          }
      
          function transferFrom(address src, address dst, uint wad)
              public
              returns (bool)
          {
              if (src != msg.sender) {
                  _approvals[src][msg.sender] = sub(_approvals[src][msg.sender], wad);
              }
      
              _balances[src] = sub(_balances[src], wad);
              _balances[dst] = add(_balances[dst], wad);
      
              Transfer(src, dst, wad);
      
              return true;
          }
      
          function approve(address guy, uint wad) public returns (bool) {
              _approvals[msg.sender][guy] = wad;
      
              Approval(msg.sender, guy, wad);
      
              return true;
          }
      }
      
      ////// lib/ds-token/src/token.sol
      /// token.sol -- ERC20 implementation with minting and burning
      
      // Copyright (C) 2015, 2016, 2017  DappHub, LLC
      
      // This program is free software: you can redistribute it and/or modify
      // it under the terms of the GNU General Public License as published by
      // the Free Software Foundation, either version 3 of the License, or
      // (at your option) any later version.
      
      // This program is distributed in the hope that it will be useful,
      // but WITHOUT ANY WARRANTY; without even the implied warranty of
      // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      // GNU General Public License for more details.
      
      // You should have received a copy of the GNU General Public License
      // along with this program.  If not, see <http://www.gnu.org/licenses/>.
      
      /* pragma solidity ^0.4.13; */
      
      /* import "ds-stop/stop.sol"; */
      
      /* import "./base.sol"; */
      
      contract DSToken is DSTokenBase(0), DSStop {
      
          bytes32  public  symbol;
          uint256  public  decimals = 18; // standard token precision. override to customize
      
          function DSToken(bytes32 symbol_) public {
              symbol = symbol_;
          }
      
          event Mint(address indexed guy, uint wad);
          event Burn(address indexed guy, uint wad);
      
          function approve(address guy) public stoppable returns (bool) {
              return super.approve(guy, uint(-1));
          }
      
          function approve(address guy, uint wad) public stoppable returns (bool) {
              return super.approve(guy, wad);
          }
      
          function transferFrom(address src, address dst, uint wad)
              public
              stoppable
              returns (bool)
          {
              if (src != msg.sender && _approvals[src][msg.sender] != uint(-1)) {
                  _approvals[src][msg.sender] = sub(_approvals[src][msg.sender], wad);
              }
      
              _balances[src] = sub(_balances[src], wad);
              _balances[dst] = add(_balances[dst], wad);
      
              Transfer(src, dst, wad);
      
              return true;
          }
      
          function push(address dst, uint wad) public {
              transferFrom(msg.sender, dst, wad);
          }
          function pull(address src, uint wad) public {
              transferFrom(src, msg.sender, wad);
          }
          function move(address src, address dst, uint wad) public {
              transferFrom(src, dst, wad);
          }
      
          function mint(uint wad) public {
              mint(msg.sender, wad);
          }
          function burn(uint wad) public {
              burn(msg.sender, wad);
          }
          function mint(address guy, uint wad) public auth stoppable {
              _balances[guy] = add(_balances[guy], wad);
              _supply = add(_supply, wad);
              Mint(guy, wad);
          }
          function burn(address guy, uint wad) public auth stoppable {
              if (guy != msg.sender && _approvals[guy][msg.sender] != uint(-1)) {
                  _approvals[guy][msg.sender] = sub(_approvals[guy][msg.sender], wad);
              }
      
              _balances[guy] = sub(_balances[guy], wad);
              _supply = sub(_supply, wad);
              Burn(guy, wad);
          }
      
          // Optional token name
          bytes32   public  name = "";
      
          function setName(bytes32 name_) public auth {
              name = name_;
          }
      }

      File 2 of 2: ExchangeDeposit
      // SPDX-License-Identifier: MIT
      pragma solidity 0.6.11;
      import '@openzeppelin/contracts/token/ERC20/IERC20.sol';
      import '@openzeppelin/contracts/token/ERC20/SafeERC20.sol';
      import '@openzeppelin/contracts/utils/Address.sol';
      /**
       * @title ExchangeDeposit
       * @author Jonathan Underwood
       * @notice The main contract logic for centralized exchange deposit backend.
       * @dev This contract is the main contract that will generate the proxies, and
       * all proxies will go through this. There should only be one deployed.
       */
      contract ExchangeDeposit {
          using SafeERC20 for IERC20;
          using Address for address payable;
          /**
           * @notice Address to which any funds sent to this contract will be forwarded
           * @dev This is only set in ExchangeDeposit (this) contract's storage.
           * It should be cold.
           */
          address payable public coldAddress;
          /**
           * @notice The minimum wei amount of deposit to allow.
           * @dev This attribute is required for all future versions, as it is
           * accessed directly from ExchangeDeposit
           */
          uint256 public minimumInput = 1e16; // 0.01 ETH
          /**
           * @notice The address with the implementation of further upgradable logic.
           * @dev This is only set in ExchangeDeposit (this) contract's storage.
           * Also, forwarding logic to this address via DELEGATECALL is disabled when
           * this contract is killed (coldAddress == address(0)).
           * Note, it must also have the same storage structure.
           */
          address payable public implementation;
          /**
           * @notice The address that can manage the contract storage (and kill it).
           * @dev This is only set in ExchangeDeposit (this) contract's storage.
           * It has the ability to kill the contract and disable logic forwarding,
           * and change the coldAddress and implementation address storages.
           */
          address payable public immutable adminAddress;
          /**
           * @dev The address of this ExchangeDeposit instance. This is used
           * for discerning whether we are a Proxy or an ExchangeDepsosit.
           */
          address payable private immutable thisAddress;
          /**
           * @notice Create the contract, and sets the destination address.
           * @param coldAddr See storage coldAddress
           * @param adminAddr See storage adminAddress
           */
          constructor(address payable coldAddr, address payable adminAddr) public {
              require(coldAddr != address(0), '0x0 is an invalid address');
              require(adminAddr != address(0), '0x0 is an invalid address');
              coldAddress = coldAddr;
              adminAddress = adminAddr;
              thisAddress = address(this);
          }
          /**
           * @notice Deposit event, used to log deposits sent from the Forwarder contract
           * @dev We don't need to log coldAddress because the event logs and storage
           * are always the same context, so as long as we are checking the correct
           * account's event logs, no one should be able to set off events using
           * DELEGATECALL trickery.
           * @param receiver The proxy address from which funds were forwarded
           * @param amount The amount which was forwarded
           */
          event Deposit(address indexed receiver, uint256 amount);
          /**
           * @dev This internal function checks if the current context is the main
           * ExchangeDeposit contract or one of the proxies.
           * @return bool of whether or not this is ExchangeDeposit
           */
          function isExchangeDepositor() internal view returns (bool) {
              return thisAddress == address(this);
          }
          /**
           * @dev Get an instance of ExchangeDeposit for the main contract
           * @return ExchangeDeposit instance (main contract of the system)
           */
          function getExchangeDepositor() internal view returns (ExchangeDeposit) {
              // If this context is ExchangeDeposit, use `this`, else use exDepositorAddr
              return isExchangeDepositor() ? this : ExchangeDeposit(thisAddress);
          }
          /**
           * @dev Internal function for getting the implementation address.
           * This is needed because we don't know whether the current context is
           * the ExchangeDeposit contract or a proxy contract.
           * @return implementation address of the system
           */
          function getImplAddress() internal view returns (address payable) {
              return
                  isExchangeDepositor()
                      ? implementation
                      : ExchangeDeposit(thisAddress).implementation();
          }
          /**
           * @dev Internal function for getting the sendTo address for gathering ERC20/ETH.
           * If the contract is dead, they will be forwarded to the adminAddress.
           * @return address payable for sending ERC20/ETH
           */
          function getSendAddress() internal view returns (address payable) {
              ExchangeDeposit exDepositor = getExchangeDepositor();
              // Use exDepositor to perform logic for finding send address
              address payable coldAddr = exDepositor.coldAddress();
              // If ExchangeDeposit is killed, use adminAddress, else use coldAddress
              address payable toAddr =
                  coldAddr == address(0) ? exDepositor.adminAddress() : coldAddr;
              return toAddr;
          }
          /**
           * @dev Modifier that will execute internal code block only if the sender is the specified account
           */
          modifier onlyAdmin {
              require(msg.sender == adminAddress, 'Unauthorized caller');
              _;
          }
          /**
           * @dev Modifier that will execute internal code block only if not killed
           */
          modifier onlyAlive {
              require(
                  getExchangeDepositor().coldAddress() != address(0),
                  'I am dead :-('
              );
              _;
          }
          /**
           * @dev Modifier that will execute internal code block only if called directly
           * (Not via proxy delegatecall)
           */
          modifier onlyExchangeDepositor {
              require(isExchangeDepositor(), 'Calling Wrong Contract');
              _;
          }
          /**
           * @notice Execute a token transfer of the full balance from the proxy
           * to the designated recipient.
           * @dev Recipient is coldAddress if not killed, else adminAddress.
           * @param instance The address of the erc20 token contract
           */
          function gatherErc20(IERC20 instance) external {
              uint256 forwarderBalance = instance.balanceOf(address(this));
              if (forwarderBalance == 0) {
                  return;
              }
              instance.safeTransfer(getSendAddress(), forwarderBalance);
          }
          /**
           * @notice Gather any ETH that might have existed on the address prior to creation
           * @dev It is also possible our addresses receive funds from another contract's
           * selfdestruct.
           */
          function gatherEth() external {
              uint256 balance = address(this).balance;
              if (balance == 0) {
                  return;
              }
              (bool result, ) = getSendAddress().call{ value: balance }('');
              require(result, 'Could not gather ETH');
          }
          /**
           * @notice Change coldAddress to newAddress.
           * @param newAddress the new address for coldAddress
           */
          function changeColdAddress(address payable newAddress)
              external
              onlyExchangeDepositor
              onlyAlive
              onlyAdmin
          {
              require(newAddress != address(0), '0x0 is an invalid address');
              coldAddress = newAddress;
          }
          /**
           * @notice Change implementation to newAddress.
           * @dev newAddress can be address(0) (to disable extra implementations)
           * @param newAddress the new address for implementation
           */
          function changeImplAddress(address payable newAddress)
              external
              onlyExchangeDepositor
              onlyAlive
              onlyAdmin
          {
              require(
                  newAddress == address(0) || newAddress.isContract(),
                  'implementation must be contract'
              );
              implementation = newAddress;
          }
          /**
           * @notice Change minimumInput to newMinInput.
           * @param newMinInput the new minimumInput
           */
          function changeMinInput(uint256 newMinInput)
              external
              onlyExchangeDepositor
              onlyAlive
              onlyAdmin
          {
              minimumInput = newMinInput;
          }
          /**
           * @notice Sets coldAddress to 0, killing the forwarding and logging.
           */
          function kill() external onlyExchangeDepositor onlyAlive onlyAdmin {
              coldAddress = address(0);
          }
          /**
           * @notice Forward any ETH value to the coldAddress
           * @dev This receive() type fallback means msg.data will be empty.
           * We disable deposits when dead.
           * Security note: Every time you check the event log for deposits,
           * also check the coldAddress storage to make sure it's pointing to your
           * cold account.
           */
          receive() external payable {
              // Using a simplified version of onlyAlive
              // since we know that any call here has no calldata
              // this saves a large amount of gas due to the fact we know
              // that this can only be called from the ExchangeDeposit context
              require(coldAddress != address(0), 'I am dead :-(');
              require(msg.value >= minimumInput, 'Amount too small');
              (bool success, ) = coldAddress.call{ value: msg.value }('');
              require(success, 'Forwarding funds failed');
              emit Deposit(msg.sender, msg.value);
          }
          /**
           * @notice Forward commands to supplemental implementation address.
           * @dev This fallback() type fallback will be called when there is some
           * call data, and this contract is alive.
           * It forwards to the implementation contract via DELEGATECALL.
           */
          fallback() external payable onlyAlive {
              address payable toAddr = getImplAddress();
              require(toAddr != address(0), 'Fallback contract not set');
              (bool success, ) = toAddr.delegatecall(msg.data);
              require(success, 'Fallback contract failed');
          }
      }
      // 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);
                  }
              }
          }
      }
      // 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;
          }
      }