ETH Price: $2,312.51 (+2.17%)

Transaction Decoder

Block:
15495272 at Sep-08-2022 07:22:15 AM +UTC
Transaction Fee:
0.003040562621710321 ETH $7.03
Gas Used:
204,851 Gas / 14.842800971 Gwei

Emitted Events:

521 MaticToken.Transfer( from=DeFiPlaza, to=0xF2F400C138F9fb900576263af0BC7fCde2B1b8a8, value=270698416670151222679 )
522 DeFiPlaza.Swapped( sender=0xF2F400C138F9fb900576263af0BC7fCde2B1b8a8, inputToken=0x00000000...000000000, outputToken=MaticToken, inputAmount=138775000000000000, outputAmount=270698416670151222679 )
523 MaticToken.Transfer( from=0xF2F400C138F9fb900576263af0BC7fCde2B1b8a8, to=AggregationRouterV4, value=270698416670151222679 )
524 MaticToken.Transfer( from=AggregationRouterV4, to=0x74de5d4FCbf63E00296fd95d33236B9794016631, value=270698416670151222679 )
525 MaticToken.Transfer( from=0x74de5d4FCbf63E00296fd95d33236B9794016631, to=[Sender] 0x6bc78bd9a7f8c17098e2ce61327e67af66f9a9de, value=270698416670151222679 )
526 0x881d40237659c251811cec9c364ef91dc08d300c.0xbeee1e6e7fe307ddcf84b0a16137a4430ad5e2480fc4f4a8e250ab56ccd7630d( 0xbeee1e6e7fe307ddcf84b0a16137a4430ad5e2480fc4f4a8e250ab56ccd7630d, 0xbd5c436f8c83379009c1962310b8347e561d1900906d3fe4075b1596f8955f88, 0x0000000000000000000000006bc78bd9a7f8c17098e2ce61327e67af66f9a9de )

Account State Difference:

  Address   Before After State Difference Code
(BTC.com Pool 2)
2,113.812419703876933825 Eth2,113.812829405876933825 Eth0.000409702
0x6bc78bD9...f66F9a9DE
0.376024613617297386 Eth
Nonce: 59
0.232984050995587065 Eth
Nonce: 60
0.143040562621710321
0x7D1AfA7B...8AaCfeBB0
0xE68c1d72...bc7514110 34.201519024540844664 Eth34.340294024540844664 Eth0.138775
0xF326e4dE...3c79f1915
(MetaMask: DS Proxy)
20,529.925061467035595018 Eth20,529.926286467035595018 Eth0.001225

Execution Trace

ETH 0.14 Metamask: Swap Router.5f575529( )
  • ETH 0.14 MetaMask: Swaps Spender.e3547335( )
    • ETH 0.14 0xdfa7bd39ded0051b2ecc48f7e17f63ecd165cae1.92f5f037( )
      • ETH 0.138775 AggregationRouterV4.swap( caller=0xF2F400C138F9fb900576263af0BC7fCde2B1b8a8, desc=[{name:srcToken, type:address, order:1, indexed:false, value:0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE, valueString:0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE}, {name:dstToken, type:address, order:2, indexed:false, value:0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0, valueString:0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0}, {name:srcReceiver, type:address, order:3, indexed:false, value:0xF2F400C138F9fb900576263af0BC7fCde2B1b8a8, valueString:0xF2F400C138F9fb900576263af0BC7fCde2B1b8a8}, {name:dstReceiver, type:address, order:4, indexed:false, value:0x74de5d4FCbf63E00296fd95d33236B9794016631, valueString:0x74de5d4FCbf63E00296fd95d33236B9794016631}, {name:amount, type:uint256, order:5, indexed:false, value:138775000000000000, valueString:138775000000000000}, {name:minReturnAmount, type:uint256, order:6, indexed:false, value:265284448336748198225, valueString:265284448336748198225}, {name:flags, type:uint256, order:7, indexed:false, value:0, valueString:0}, {name:permit, type:bytes, order:8, indexed:false, value:0x, valueString:0x}], data=0x0000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000160800000000000000000000000E68C1D72340AEEFE5BE76EDA63AE2F4BC751411000000000000000000000000000000000000000000000000001ED072092B4700000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000084FE02915600000000000000000000000000000000000000000000000000000000000000000000000000000000000000007D1AFA7B718FB893DB30A3ABC0CFC608AACFEBB000000000000000000000000000000000000000000000000001ED072092B47000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000016414284AAB000000000000000000000000000000000000000000000000000000000000008080000000000000000000000000000000000000000000000000000000000000240000000000000000000000007D1AFA7B718FB893DB30A3ABC0CFC608AACFEBB000000000000000000000000000000001000000000000000000000000000000010000000000000000000000007D1AFA7B718FB893DB30A3ABC0CFC608AACFEBB0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000044A9059CBB0000000000000000000000001111111254FB6C44BAC0BED2854E76F90643097D00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 ) => ( returnAmount=270698416670151222679, spentAmount=138775000000000000, gasLeft=55592 )
        • ETH 0.138775 1inch: Aggregation Executor 2.2636f7f8( )
          • ETH 0.138775 DeFiPlaza.swap( inputToken=0x0000000000000000000000000000000000000000, outputToken=0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0, inputAmount=138775000000000000, minOutputAmount=0 ) => ( outputAmount=270698416670151222679 )
            • MaticToken.balanceOf( owner=0xE68c1d72340aEeFe5Be76eDa63AE2f4bc7514110 ) => ( 67051924230177851521558 )
            • MaticToken.transfer( to=0xF2F400C138F9fb900576263af0BC7fCde2B1b8a8, value=270698416670151222679 ) => ( True )
            • 1inch: Aggregation Executor 2.14284aab( )
              • MaticToken.balanceOf( owner=0xF2F400C138F9fb900576263af0BC7fCde2B1b8a8 ) => ( 270698416670151222679 )
              • MaticToken.transfer( to=0x1111111254fb6c44bAC0beD2854e76F90643097d, value=270698416670151222679 ) => ( True )
              • MaticToken.balanceOf( owner=0x1111111254fb6c44bAC0beD2854e76F90643097d ) => ( 270698416670151222679 )
              • MaticToken.transfer( to=0x74de5d4FCbf63E00296fd95d33236B9794016631, value=270698416670151222679 ) => ( True )
              • ETH 0.001225 Proxy.CALL( )
              • MaticToken.balanceOf( owner=0x74de5d4FCbf63E00296fd95d33236B9794016631 ) => ( 270698416670151222679 )
              • MaticToken.transfer( to=0x6bc78bD9A7F8C17098E2cE61327e67af66F9a9DE, value=270698416670151222679 ) => ( True )
                File 1 of 5: DeFiPlaza
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.6;
                import "../interfaces/IDeFiPlaza.sol";
                import "@openzeppelin/contracts/access/Ownable.sol";
                import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
                import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
                import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
                /**
                 * @title DeFi Plaza exchange controct, multi token DEX.
                 * @author Jazzer 9F
                 * @notice Trades between two tokens follow the local bonding curve x*y=k
                 * The number of tokens used is hard coded to 16 for efficiency reasons.
                 */
                contract DeFiPlaza is IDeFiPlaza, Ownable, ERC20 {
                  using SafeERC20 for IERC20;
                  // States that each token can be in
                  enum State {Unlisted, PreListing, Delisting, Listed}
                  // Configuration per token. Still some bits available if needed
                  struct TokenSettings {
                    State state;                      // What state the token is currently in
                    uint112 listingTarget;            // Amount of tokens needed to activate listing
                  }
                  // Exchange configuration
                  struct Config {
                    bool unlocked;                    // Locked for trading to prevent re-entrancy misery
                    uint64 oneMinusTradingFee;        // One minus the swap fee (0.64 fixed point integer)
                    uint64 delistingBonus;            // Amount of additional tokens to encourage immediate delisting (0.64 fixed point)
                  }
                  // Keeps track of whether there is a listing change underway and if so between which tokens
                  struct ListingUpdate {
                    address tokenToDelist;            // Token to be removed
                    address tokenToList;              // Token to be listed
                  }
                  // Mapping to keep track of the listed tokens
                  mapping(address => TokenSettings) public listedTokens;
                  Config public DFPconfig;
                  ListingUpdate public listingUpdate;
                  address public admin;
                  /**
                  * Sets up default configuration
                  * Initialize with ordered list of 15 token addresses (ETH is always listed)
                  * Doesn't do any checks. Make sure you ONLY add well behaved ERC20s!!
                  */
                  constructor(address[] memory tokensToList, uint256 mintAmount, string memory name_, string memory symbol_) ERC20(name_, symbol_) {
                    // Basic exchange configuration
                    Config memory config;
                    config.unlocked = false;
                    config.oneMinusTradingFee = 0xffbe76c8b4395800;   // approximately 0.999
                    config.delistingBonus = 0;
                    DFPconfig = config;
                    // Configure the listed tokens as such
                    TokenSettings memory listed;
                    listed.state = State.Listed;
                    require(tokensToList.length == 15, "Incorrect number of tokens");
                    address previous = address(0);
                    address current = address(0);
                    for (uint256 i = 0; i < 15; i++) {
                      current = tokensToList[i];
                      require(current > previous, "Require ordered list");
                      listedTokens[current] = listed;
                      previous = current;
                    }
                    // Generate the LP tokens reflecting the initial liquidity (to be loaded externally)
                    _mint(msg.sender, mintAmount);
                  }
                  // For bootstrapping ETH liquidity
                  receive() external payable {}
                  // To safeguard some functionality is only applied to listed tokens
                  modifier onlyListedToken(address token) {
                    require(
                      token == address(0) || listedTokens[token].state > State.Delisting,
                      "DFP: Token not listed"
                    );
                    _;
                  }
                  modifier onlyAdmin() {
                    require(
                      msg.sender == admin || msg.sender == owner(),
                      "DFP: admin rights required"
                    );
                    _;
                  }
                  /**
                  * Allows users to swap between any two tokens listed on the DEX.
                  * Follows the x*y=k swap invariant hyperbole
                  * For ETH trades, send the ETH with the transaction and use the NULL address as inputToken.
                  */
                  function swap(
                    address inputToken,
                    address outputToken,
                    uint256 inputAmount,
                    uint256 minOutputAmount
                  )
                    external
                    payable
                    onlyListedToken(inputToken)
                    onlyListedToken(outputToken)
                    override
                    returns (uint256 outputAmount)
                  {
                    // Check that the exchange is unlocked and thus open for business
                    Config memory _config = DFPconfig;
                    require(_config.unlocked, "DFP: Locked");
                    // Pull in input token and check the exchange balance for that token
                    uint256 initialInputBalance;
                    if (inputToken == address(0)) {
                      require(msg.value == inputAmount, "DFP: bad ETH amount");
                      initialInputBalance = address(this).balance - inputAmount;
                    } else {
                      initialInputBalance = IERC20(inputToken).balanceOf(address(this));
                      IERC20(inputToken).safeTransferFrom(msg.sender, address(this), inputAmount);
                    }
                    // Check dex balance of the output token
                    uint256 initialOutputBalance;
                    if (outputToken == address(0)) {
                      initialOutputBalance = address(this).balance;
                    } else {
                      initialOutputBalance = IERC20(outputToken).balanceOf(address(this));
                    }
                    // Calculate the output amount through the x*y=k invariant
                    // Can skip overflow/underflow checks on this calculation as they will always work against an attacker anyway.
                    uint256 netInputAmount = inputAmount * _config.oneMinusTradingFee;
                    outputAmount = netInputAmount * initialOutputBalance / ((initialInputBalance << 64) + netInputAmount);
                    require(outputAmount > minOutputAmount, "DFP: No deal");
                    // Send output tokens to whoever invoked the swap function
                    if (outputToken == address(0)) {
                      address payable sender = payable(msg.sender);
                      sender.transfer(outputAmount);
                    } else {
                      IERC20(outputToken).safeTransfer(msg.sender, outputAmount);
                    }
                    // Emit swap event to enable better governance decision making
                    emit Swapped(msg.sender, inputToken, outputToken, inputAmount, outputAmount);
                  }
                  /**
                  * Single sided liquidity add. More economic at low/moderate liquidity amounts.
                  * Mathematically works as adding all tokens and swapping back to 1 token at no fee.
                  *
                  *         R = (1 + X_supplied/X_initial)^(1/N) - 1
                  *         LP_minted = R * LP_total
                  *
                  * When adding ETH, the inputToken address to be used is the NULL address.
                  * A fee is applied to prevent zero fee swapping through liquidity add/remove.
                  *
                  * Note that this method suffers from two forms of slippage.
                  *   1. Slippage from single sided add which is modeled with 15 internal swaps
                  *   2. Slippage from the numerical approximation required for calculation.
                  *
                  * When adding a large amount of liquidity when compared with the existing
                  * liquidity for the selected token, the slippage can become quite significant.
                  * The smart contract limits the maximum input amount at 100% of the existing
                  * liquidity, at which point the slippage is 29.2% (due to 1) + 9.3% (due to 2)
                  */
                  function addLiquidity(address inputToken, uint256 inputAmount, uint256 minLP)
                    external
                    payable
                    onlyListedToken(inputToken)
                    override
                    returns (uint256 actualLP)
                  {
                    // Check that the exchange is unlocked and thus open for business
                    Config memory _config = DFPconfig;
                    require(_config.unlocked, "DFP: Locked");
                    // Pull in input token and check the exchange balance for that token
                    uint256 initialBalance;
                    if (inputToken == address(0)) {
                      require(msg.value == inputAmount, "DFP: Incorrect amount of ETH");
                      initialBalance = address(this).balance - inputAmount;
                    } else {
                      initialBalance = IERC20(inputToken).balanceOf(address(this));
                      IERC20(inputToken).safeTransferFrom(msg.sender, address(this), inputAmount);
                    }
                    // Prevent excessive liquidity add which runs of the approximation curve
                    require(inputAmount < initialBalance, "DFP: Too much at once");
                    // See https://en.wikipedia.org/wiki/Binomial_approximation for the below
                    // Compute the 6th power binomial series approximation of R.
                    //
                    //                   X   15 X^2   155 X^3   7285 X^4   91791 X^5   2417163 X^6
                    // (1+X)^1/16 - 1 ≈ -- - ------ + ------- - -------- + --------- - -----------
                    //                  16    512      8192      524288     8388608     268435456
                    //
                    // Note that we need to terminate at an even order to guarantee an underestimate
                    // for safety. The underestimation leads to slippage for higher amounts, but
                    // protects funds of those that are already invested.
                    uint256 X = (inputAmount * _config.oneMinusTradingFee) / initialBalance;  // 0.64 bits
                    uint256 X_ = X * X;                                // X^2   0.128 bits
                    uint256 R_ = (X >> 4) - (X_ * 15 >> 73);           // R2    0.64 bits
                    X_ = X_ * X;                                       // X^3   0.192 bits
                    R_ = R_ + (X_ * 155 >> 141);                       // R3    0.64 bits
                    X_ = X_ * X >> 192;                                // X^4   0.64 bits
                    R_ = R_ - (X_ * 7285 >> 19);                       // R4    0.64 bits
                    X_ = X_ * X;                                       // X^5   0.128 bits
                    R_ = R_ + (X_ * 91791 >> 87);                      // R5    0.64 bits
                    X_ = X_ * X;                                       // X^6   0.192 bits
                    R_ = R_ - (X_ * 2417163 >> 156);                   // R6    0.64 bits
                    // Calculate and mint LPs to be awarded
                    actualLP = R_ * totalSupply() >> 64;
                    require(actualLP > minLP, "DFP: No deal");
                    _mint(msg.sender, actualLP);
                    // Emitting liquidity add event to enable better governance decisions
                    emit LiquidityAdded(msg.sender, inputToken, inputAmount, actualLP);
                  }
                  /**
                  * Multi-token liquidity add. More economic for large amounts of liquidity.
                  * Simply takes in all 16 listed tokens in ratio and mints the LPs accordingly.
                  * For ETH, the inputToken address to be used is the NULL address.
                  * A fee is applied to prevent zero fee swapping through liquidity add/remove.
                  */
                  function addMultiple(address[] calldata tokens, uint256[] calldata maxAmounts)
                    external
                    payable
                    override
                    returns (uint256 actualLP)
                  {
                    // Perform basic checks
                    Config memory _config = DFPconfig;
                    require(_config.unlocked, "DFP: Locked");
                    require(tokens.length == 16, "DFP: Bad tokens array length");
                    require(maxAmounts.length == 16, "DFP: Bad maxAmount array length");
                    // Check ETH amount/ratio first
                    require(tokens[0] == address(0), "DFP: No ETH found");
                    require(maxAmounts[0] == msg.value, "DFP: Incorrect ETH amount");
                    uint256 dexBalance = address(this).balance - msg.value;
                    uint256 actualRatio = msg.value * (1<<128) / dexBalance;
                    // Check ERC20 amounts/ratios
                    uint256 currentRatio;
                    address previous;
                    address token;
                    for (uint256 i = 1; i < 16; i++) {
                      token = tokens[i];
                      require(token > previous, "DFP: Require ordered list");
                      require(
                        listedTokens[token].state > State.Delisting,
                        "DFP: Token not listed"
                      );
                      dexBalance = IERC20(token).balanceOf(address(this));
                      currentRatio = maxAmounts[i] * (1 << 128) / dexBalance;
                      if (currentRatio < actualRatio) {
                        actualRatio = currentRatio;
                      }
                      previous = token;
                    }
                    // Calculate how many LP will be generated
                    actualLP = (actualRatio * totalSupply() >> 64) * DFPconfig.oneMinusTradingFee >> 128;
                    // Collect ERC20 tokens
                    for (uint256 i = 1; i < 16; i++) {
                      token = tokens[i];
                      dexBalance = IERC20(token).balanceOf(address(this));
                      IERC20(token).safeTransferFrom(msg.sender, address(this), dexBalance * actualRatio >> 128);
                    }
                    // Mint the LP tokens
                    _mint(msg.sender, actualLP);
                    emit MultiLiquidityAdded(msg.sender, actualLP, totalSupply());
                    // Refund ETH change
                    dexBalance = address(this).balance - msg.value;
                    address payable sender = payable(msg.sender);
                    sender.transfer(msg.value - (dexBalance * actualRatio >> 128));
                  }
                  /**
                  * Single sided liquidity withdrawal. More efficient at lower liquidity amounts.
                  * Mathematically withdraws 16 tokens in ratio and then swaps 15 back in at no fees.
                  * Calculates the following:
                  *
                  *        R = LP_burnt / LP_initial
                  *        X_out = X_initial * (1 - (1 - R)^N)
                  *
                  * No fee is applied for withdrawals. For ETH output, use the NULL address as outputToken.
                  */
                  function removeLiquidity(uint256 LPamount, address outputToken, uint256 minOutputAmount)
                    external
                    onlyListedToken(outputToken)
                    override
                    returns (uint256 actualOutput)
                  {
                    // Checks the initial balance of the token desired as output token
                    uint256 initialBalance;
                    if (outputToken == address(0)) {
                      initialBalance = address(this).balance;
                    } else {
                      initialBalance = IERC20(outputToken).balanceOf(address(this));
                    }
                    // Calculates intermediate variable F = (1-R)^16 and then the resulting output amount.
                    uint256 F_;
                    F_ = (1 << 64) - (LPamount << 64) / totalSupply();   // (1-R)      (0.64 bits)
                    F_ = F_ * F_;                                       // (1-R)^2    (0.128 bits)
                    F_ = F_ * F_ >> 192;                                // (1-R)^4    (0.64 bits)
                    F_ = F_ * F_;                                       // (1-R)^8    (0.128 bits)
                    F_ = F_ * F_ >> 192;                                // (1-R)^16   (0.64 bits)
                    actualOutput = initialBalance * ((1 << 64) - F_) >> 64;
                    require(actualOutput > minOutputAmount, "DFP: No deal");
                    // Burns the LP tokens and sends the output tokens
                    _burn(msg.sender, LPamount);
                    if (outputToken == address(0)) {
                      address payable sender = payable(msg.sender);
                      sender.transfer(actualOutput);
                    } else {
                      IERC20(outputToken).safeTransfer(msg.sender, actualOutput);
                    }
                    // Emitting liquidity removal event to enable better governance decisions
                    emit LiquidityRemoved(msg.sender, outputToken, actualOutput, LPamount);
                  }
                  /**
                  * Multi-token liquidity removal. More economic for large amounts of liquidity.
                  * Returns all 16 listed tokens in ratio and burns the LPs accordingly.
                  */
                  function removeMultiple(uint256 LPamount, address[] calldata tokens)
                    external
                    override
                    returns (bool success)
                  {
                    // Perform basic validation (no lock check here on purpose)
                    require(tokens.length == 16, "DFP: Bad tokens array length");
                    // Calculate fraction of total liquidity to be returned
                    uint256 fraction = (LPamount << 128) / totalSupply();
                    // Send the ETH first (use transfer to prevent reentrancy)
                    uint256 dexBalance = address(this).balance;
                    address payable sender = payable(msg.sender);
                    sender.transfer(fraction * dexBalance >> 128);
                    // Send the ERC20 tokens
                    address previous;
                    for (uint256 i = 1; i < 16; i++) {
                      address token = tokens[i];
                      require(token > previous, "DFP: Require ordered list");
                      require(
                        listedTokens[token].state > State.Delisting,
                        "DFP: Token not listed"
                      );
                      dexBalance = IERC20(token).balanceOf(address(this));
                      IERC20(token).safeTransfer(msg.sender, fraction * dexBalance >> 128);
                      previous = token;
                    }
                    // Burn the LPs
                    _burn(msg.sender, LPamount);
                    emit MultiLiquidityRemoved(msg.sender, LPamount, totalSupply());
                    // That's all folks
                    return true;
                  }
                  /**
                  * When a token is delisted and another one gets listed in its place, the users can
                  * call this function to provide liquidity for the new token in exchange for the old
                  * token. The ratio should be set such that the users have a financial incentive to
                  * perform this transaction.
                  */
                  function bootstrapNewToken(
                    address inputToken,
                    uint256 maxInputAmount,
                    address outputToken
                  ) public override returns (uint64 fractionBootstrapped) {
                    // Check whether the valid token is being bootstrapped
                    TokenSettings memory tokenToList = listedTokens[inputToken];
                    require(
                      tokenToList.state == State.PreListing,
                      "DFP: Wrong token"
                    );
                    // Calculate how many tokens to actually take in (clamp at max available)
                    uint256 initialInputBalance = IERC20(inputToken).balanceOf(address(this));
                    uint256 availableAmount;
                    // Intentionally underflow (zero clamping) is the cheapest way to gracefully prevent failing when target is already met
                    unchecked { availableAmount = tokenToList.listingTarget - initialInputBalance; }
                    if (initialInputBalance >= tokenToList.listingTarget) { availableAmount = 1; }
                    uint256 actualInputAmount = maxInputAmount > availableAmount ? availableAmount : maxInputAmount;
                    // Actually pull the tokens in
                    IERC20(inputToken).safeTransferFrom(msg.sender, address(this), actualInputAmount);
                    // Check whether the output token requested is indeed being delisted
                    TokenSettings memory tokenToDelist = listedTokens[outputToken];
                    require(
                      tokenToDelist.state == State.Delisting,
                      "DFP: Wrong token"
                    );
                    // Check how many of the output tokens should be given out and transfer those
                    uint256 initialOutputBalance = IERC20(outputToken).balanceOf(address(this));
                    uint256 outputAmount = actualInputAmount * initialOutputBalance / availableAmount;
                    IERC20(outputToken).safeTransfer(msg.sender, outputAmount);
                    fractionBootstrapped = uint64((actualInputAmount << 64) / tokenToList.listingTarget);
                    // Emit event for better governance decisions
                    emit Bootstrapped(
                      msg.sender,
                      inputToken,
                      actualInputAmount,
                      outputToken,
                      outputAmount
                    );
                    // If the input token liquidity is now at the target we complete the (de)listing
                    if (actualInputAmount == availableAmount) {
                      tokenToList.state = State.Listed;
                      listedTokens[inputToken] = tokenToList;
                      delete listedTokens[outputToken];
                      delete listingUpdate;
                      DFPconfig.delistingBonus = 0;
                      emit BootstrapCompleted(outputToken, inputToken);
                    }
                  }
                  /**
                   * Emergency bonus withdrawal when bootstrapping is expected to remain incomplete
                   * A fraction is specified (for example 5%) that is then rewarded in bonus tokens
                   * on top of the regular bootstrapping output tokens.
                   */
                  function bootstrapNewTokenWithBonus(
                    address inputToken,
                    uint256 maxInputAmount,
                    address outputToken,
                    address bonusToken
                  ) external onlyListedToken(bonusToken) override returns (uint256 bonusAmount) {
                    // Check whether the output token requested is indeed being delisted
                    TokenSettings memory tokenToDelist = listedTokens[outputToken];
                    require(
                      tokenToDelist.state == State.Delisting,
                      "DFP: Wrong token"
                    );
                    // Collect parameters required to calculate bonus
                    uint256 bonusFactor = uint256(DFPconfig.delistingBonus);
                    uint64 fractionBootstrapped = bootstrapNewToken(inputToken, maxInputAmount, outputToken);
                    // Balance of selected bonus token
                    uint256 bonusBalance;
                    if (bonusToken == address(0)) {
                      bonusBalance = address(this).balance;
                    } else {
                      bonusBalance = IERC20(bonusToken).balanceOf(address(this));
                    }
                    // Calculate bonus amount
                    bonusAmount = uint256(fractionBootstrapped) * bonusFactor * bonusBalance >> 128;
                    // Payout bonus tokens
                    if (bonusToken == address(0)) {
                      address payable sender = payable(msg.sender);
                      sender.transfer(bonusAmount);
                    } else {
                      IERC20(bonusToken).safeTransfer(msg.sender, bonusAmount);
                    }
                    // Emit event to enable data driven governance
                    emit BootstrapBonus(
                      msg.sender,
                      bonusToken,
                      bonusAmount
                    );
                  }
                  /**
                   * Initiates process to delist one token and list another.
                   */
                  function changeListing(
                    address tokenToDelist,              // Address of token to be delisted
                    address tokenToList,                // Address of token to be listed
                    uint112 listingTarget               // Amount of tokens needed to activate listing
                  ) external onlyListedToken(tokenToDelist) onlyOwner() {
                    // Basic validity checks. ETH cannot be delisted, only one delisting at a time.
                    require(tokenToDelist != address(0), "DFP: Cannot delist ETH");
                    ListingUpdate memory update = listingUpdate;
                    require(update.tokenToDelist == address(0), "DFP: Previous update incomplete");
                    // Can't list an already listed token
                    TokenSettings memory _token = listedTokens[tokenToList];
                    require(_token.state == State.Unlisted, "DFP: Token already listed");
                    // Set the delisting/listing struct.
                    update.tokenToDelist = tokenToDelist;
                    update.tokenToList = tokenToList;
                    listingUpdate = update;
                    // Configure the token states for incoming/outgoing tokens
                    _token.state = State.PreListing;
                    _token.listingTarget = listingTarget;
                    listedTokens[tokenToList] = _token;
                    listedTokens[tokenToDelist].state = State.Delisting;
                  }
                  /**
                  * Sets trading fee (actually calculates using 1-fee) as a 0.64 fixed point number.
                  */
                  function setTradingFee(uint64 oneMinusFee) external onlyOwner() {
                    DFPconfig.oneMinusTradingFee = oneMinusFee;
                  }
                  /**
                  * Sets delisting bonus as emergency measure to complete a (de)listing when it gets stuck.
                  */
                  function setDeListingBonus(uint64 delistingBonus) external onlyOwner() {
                    ListingUpdate memory update = listingUpdate;
                    require(update.tokenToDelist != address(0), "DFP: No active delisting");
                    DFPconfig.delistingBonus = delistingBonus;
                  }
                  /**
                  * Sets admin address for emergency exchange locking
                  */
                  function setAdmin(address adminAddress) external onlyOwner() {
                    admin = adminAddress;
                  }
                  /**
                  * Sets exchange lock, under which swap and liquidity add (but not remove) are disabled
                  */
                  function lockExchange() external onlyAdmin() {
                    DFPconfig.unlocked = false;
                  }
                  /**
                  * Resets exchange lock.
                  */
                  function unlockExchange() external onlyAdmin() {
                    DFPconfig.unlocked = true;
                  }
                }
                // SPDX-License-Identifier: Unlicensed
                pragma solidity ^0.8.6;
                interface IDeFiPlaza {
                  function swap(
                    address inputToken,
                    address outputToken,
                    uint256 inputAmount,
                    uint256 minOutputAmount
                  ) external payable returns (uint256 outputAmount);
                  function addLiquidity(
                    address inputToken,
                    uint256 inputAmount,
                    uint256 minLP
                  ) external payable returns (uint256 deltaLP);
                  function addMultiple(
                    address[] calldata tokens,
                    uint256[] calldata maxAmounts
                  ) external payable returns (uint256 actualLP);
                  function removeLiquidity(
                    uint256 LPamount,
                    address outputToken,
                    uint256 minOutputAmount
                  ) external returns (uint256 actualOutput);
                  function removeMultiple(
                    uint256 LPamount,
                    address[] calldata tokens
                  ) external returns (bool success);
                  function bootstrapNewToken(
                    address inputToken,
                    uint256 maxInputAmount,
                    address outputToken
                  ) external returns (uint64 fractionBootstrapped);
                  function bootstrapNewTokenWithBonus(
                    address inputToken,
                    uint256 maxInputAmount,
                    address outputToken,
                    address bonusToken
                  ) external returns (uint256 bonusAmount);
                  event Swapped(
                    address sender,
                    address inputToken,
                    address outputToken,
                    uint256 inputAmount,
                    uint256 outputAmount
                  );
                  event LiquidityAdded(
                    address sender,
                    address token,
                    uint256 tokenAmount,
                    uint256 LPs
                  );
                  event MultiLiquidityAdded(
                    address sender,
                    uint256 LPs,
                    uint256 totalLPafter
                  );
                  event LiquidityRemoved(
                    address recipient,
                    address token,
                    uint256 tokenAmount,
                    uint256 LPs
                  );
                  event MultiLiquidityRemoved(
                    address sender,
                    uint256 LPs,
                    uint256 totalLPafter
                  );
                  event Bootstrapped(
                    address sender,
                    address inputToken,
                    uint256 inputAmount,
                    address outputToken,
                    uint256 outputAmount
                  );
                  event BootstrapBonus(
                    address sender,
                    address bonusToken,
                    uint256 bonusAmount
                  );
                  event BootstrapCompleted(
                    address delistedToken,
                    address listedToken
                  );
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "../utils/Context.sol";
                /**
                 * @dev Contract module which provides a basic access control mechanism, where
                 * there is an account (an owner) that can be granted exclusive access to
                 * specific functions.
                 *
                 * By default, the owner account will be the one that deploys the contract. This
                 * can later be changed with {transferOwnership}.
                 *
                 * This module is used through inheritance. It will make available the modifier
                 * `onlyOwner`, which can be applied to your functions to restrict their use to
                 * the owner.
                 */
                abstract contract Ownable is Context {
                    address private _owner;
                    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                    /**
                     * @dev Initializes the contract setting the deployer as the initial owner.
                     */
                    constructor() {
                        _setOwner(_msgSender());
                    }
                    /**
                     * @dev Returns the address of the current owner.
                     */
                    function owner() public view virtual returns (address) {
                        return _owner;
                    }
                    /**
                     * @dev Throws if called by any account other than the owner.
                     */
                    modifier onlyOwner() {
                        require(owner() == _msgSender(), "Ownable: caller is not the owner");
                        _;
                    }
                    /**
                     * @dev Leaves the contract without owner. It will not be possible to call
                     * `onlyOwner` functions anymore. Can only be called by the current owner.
                     *
                     * NOTE: Renouncing ownership will leave the contract without an owner,
                     * thereby removing any functionality that is only available to the owner.
                     */
                    function renounceOwnership() public virtual onlyOwner {
                        _setOwner(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");
                        _setOwner(newOwner);
                    }
                    function _setOwner(address newOwner) private {
                        address oldOwner = _owner;
                        _owner = newOwner;
                        emit OwnershipTransferred(oldOwner, newOwner);
                    }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "./IERC20.sol";
                import "./extensions/IERC20Metadata.sol";
                import "../../utils/Context.sol";
                /**
                 * @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 {ERC20PresetMinterPauser}.
                 *
                 * 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, IERC20Metadata {
                    mapping(address => uint256) private _balances;
                    mapping(address => mapping(address => uint256)) private _allowances;
                    uint256 private _totalSupply;
                    string private _name;
                    string private _symbol;
                    /**
                     * @dev Sets the values for {name} and {symbol}.
                     *
                     * The default value of {decimals} is 18. To select a different value for
                     * {decimals} you should overload it.
                     *
                     * All two of these values are immutable: they can only be set once during
                     * construction.
                     */
                    constructor(string memory name_, string memory symbol_) {
                        _name = name_;
                        _symbol = symbol_;
                    }
                    /**
                     * @dev Returns the name of the token.
                     */
                    function name() public view virtual override returns (string memory) {
                        return _name;
                    }
                    /**
                     * @dev Returns the symbol of the token, usually a shorter version of the
                     * name.
                     */
                    function symbol() public view virtual override 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. This is the value {ERC20} uses, unless this function is
                     * overridden;
                     *
                     * 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 virtual override returns (uint8) {
                        return 18;
                    }
                    /**
                     * @dev See {IERC20-totalSupply}.
                     */
                    function totalSupply() public view virtual override returns (uint256) {
                        return _totalSupply;
                    }
                    /**
                     * @dev See {IERC20-balanceOf}.
                     */
                    function balanceOf(address account) public view virtual override 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 virtual override returns (bool) {
                        _transfer(_msgSender(), recipient, amount);
                        return true;
                    }
                    /**
                     * @dev See {IERC20-allowance}.
                     */
                    function allowance(address owner, address spender) public view virtual override returns (uint256) {
                        return _allowances[owner][spender];
                    }
                    /**
                     * @dev See {IERC20-approve}.
                     *
                     * Requirements:
                     *
                     * - `spender` cannot be the zero address.
                     */
                    function approve(address spender, uint256 amount) public virtual override 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 virtual override returns (bool) {
                        _transfer(sender, recipient, amount);
                        uint256 currentAllowance = _allowances[sender][_msgSender()];
                        require(currentAllowance >= amount, "ERC20: transfer amount exceeds allowance");
                        unchecked {
                            _approve(sender, _msgSender(), currentAllowance - amount);
                        }
                        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 virtual returns (bool) {
                        _approve(_msgSender(), spender, _allowances[_msgSender()][spender] + 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 virtual returns (bool) {
                        uint256 currentAllowance = _allowances[_msgSender()][spender];
                        require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
                        unchecked {
                            _approve(_msgSender(), spender, currentAllowance - subtractedValue);
                        }
                        return true;
                    }
                    /**
                     * @dev Moves `amount` of tokens from `sender` to `recipient`.
                     *
                     * This 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 virtual {
                        require(sender != address(0), "ERC20: transfer from the zero address");
                        require(recipient != address(0), "ERC20: transfer to the zero address");
                        _beforeTokenTransfer(sender, recipient, amount);
                        uint256 senderBalance = _balances[sender];
                        require(senderBalance >= amount, "ERC20: transfer amount exceeds balance");
                        unchecked {
                            _balances[sender] = senderBalance - amount;
                        }
                        _balances[recipient] += amount;
                        emit Transfer(sender, recipient, amount);
                        _afterTokenTransfer(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:
                     *
                     * - `account` cannot be the zero address.
                     */
                    function _mint(address account, uint256 amount) internal virtual {
                        require(account != address(0), "ERC20: mint to the zero address");
                        _beforeTokenTransfer(address(0), account, amount);
                        _totalSupply += amount;
                        _balances[account] += amount;
                        emit Transfer(address(0), account, amount);
                        _afterTokenTransfer(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 virtual {
                        require(account != address(0), "ERC20: burn from the zero address");
                        _beforeTokenTransfer(account, address(0), amount);
                        uint256 accountBalance = _balances[account];
                        require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
                        unchecked {
                            _balances[account] = accountBalance - amount;
                        }
                        _totalSupply -= amount;
                        emit Transfer(account, address(0), amount);
                        _afterTokenTransfer(account, address(0), amount);
                    }
                    /**
                     * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.
                     *
                     * This 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 virtual {
                        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 Hook that is called before any transfer of tokens. This includes
                     * minting and burning.
                     *
                     * Calling conditions:
                     *
                     * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
                     * will be transferred to `to`.
                     * - when `from` is zero, `amount` tokens will be minted for `to`.
                     * - when `to` is zero, `amount` of ``from``'s tokens will be burned.
                     * - `from` and `to` are never both zero.
                     *
                     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
                     */
                    function _beforeTokenTransfer(
                        address from,
                        address to,
                        uint256 amount
                    ) internal virtual {}
                    /**
                     * @dev Hook that is called after any transfer of tokens. This includes
                     * minting and burning.
                     *
                     * Calling conditions:
                     *
                     * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
                     * has been transferred to `to`.
                     * - when `from` is zero, `amount` tokens have been minted for `to`.
                     * - when `to` is zero, `amount` of ``from``'s tokens have been burned.
                     * - `from` and `to` are never both zero.
                     *
                     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
                     */
                    function _afterTokenTransfer(
                        address from,
                        address to,
                        uint256 amount
                    ) internal virtual {}
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @dev Interface of the ERC20 standard as defined in the EIP.
                 */
                interface IERC20 {
                    /**
                     * @dev Returns the amount of tokens in existence.
                     */
                    function totalSupply() external view returns (uint256);
                    /**
                     * @dev Returns the amount of tokens owned by `account`.
                     */
                    function balanceOf(address account) external view returns (uint256);
                    /**
                     * @dev Moves `amount` tokens from the caller's account to `recipient`.
                     *
                     * Returns a boolean value indicating whether the operation succeeded.
                     *
                     * Emits a {Transfer} event.
                     */
                    function transfer(address recipient, uint256 amount) external returns (bool);
                    /**
                     * @dev Returns the remaining number of tokens that `spender` will be
                     * allowed to spend on behalf of `owner` through {transferFrom}. This is
                     * zero by default.
                     *
                     * This value changes when {approve} or {transferFrom} are called.
                     */
                    function allowance(address owner, address spender) external view returns (uint256);
                    /**
                     * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
                     *
                     * Returns a boolean value indicating whether the operation succeeded.
                     *
                     * IMPORTANT: Beware that changing an allowance with this method brings the risk
                     * that someone may use both the old and the new allowance by unfortunate
                     * transaction ordering. One possible solution to mitigate this race
                     * condition is to first reduce the spender's allowance to 0 and set the
                     * desired value afterwards:
                     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                     *
                     * Emits an {Approval} event.
                     */
                    function approve(address spender, uint256 amount) external returns (bool);
                    /**
                     * @dev Moves `amount` tokens from `sender` to `recipient` using the
                     * allowance mechanism. `amount` is then deducted from the caller's
                     * allowance.
                     *
                     * Returns a boolean value indicating whether the operation succeeded.
                     *
                     * Emits a {Transfer} event.
                     */
                    function transferFrom(
                        address sender,
                        address recipient,
                        uint256 amount
                    ) external returns (bool);
                    /**
                     * @dev Emitted when `value` tokens are moved from one account (`from`) to
                     * another (`to`).
                     *
                     * Note that `value` may be zero.
                     */
                    event Transfer(address indexed from, address indexed to, uint256 value);
                    /**
                     * @dev Emitted when the allowance of a `spender` for an `owner` is set by
                     * a call to {approve}. `value` is the new allowance.
                     */
                    event Approval(address indexed owner, address indexed spender, uint256 value);
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "../IERC20.sol";
                /**
                 * @dev Interface for the optional metadata functions from the ERC20 standard.
                 *
                 * _Available since v4.1._
                 */
                interface IERC20Metadata is IERC20 {
                    /**
                     * @dev Returns the name of the token.
                     */
                    function name() external view returns (string memory);
                    /**
                     * @dev Returns the symbol of the token.
                     */
                    function symbol() external view returns (string memory);
                    /**
                     * @dev Returns the decimals places of the token.
                     */
                    function decimals() external view returns (uint8);
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "../IERC20.sol";
                import "../../../utils/Address.sol";
                /**
                 * @title SafeERC20
                 * @dev Wrappers around ERC20 operations that throw on failure (when the token
                 * contract returns false). Tokens that return no value (and instead revert or
                 * throw on failure) are also supported, non-reverting calls are assumed to be
                 * successful.
                 * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
                 * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
                 */
                library SafeERC20 {
                    using Address for address;
                    function safeTransfer(
                        IERC20 token,
                        address to,
                        uint256 value
                    ) internal {
                        _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
                    }
                    function safeTransferFrom(
                        IERC20 token,
                        address from,
                        address to,
                        uint256 value
                    ) internal {
                        _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
                    }
                    /**
                     * @dev Deprecated. This function has issues similar to the ones found in
                     * {IERC20-approve}, and its usage is discouraged.
                     *
                     * Whenever possible, use {safeIncreaseAllowance} and
                     * {safeDecreaseAllowance} instead.
                     */
                    function safeApprove(
                        IERC20 token,
                        address spender,
                        uint256 value
                    ) internal {
                        // safeApprove should only be called when setting an initial allowance,
                        // or when resetting it to zero. To increase and decrease it, use
                        // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                        require(
                            (value == 0) || (token.allowance(address(this), spender) == 0),
                            "SafeERC20: approve from non-zero to non-zero allowance"
                        );
                        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
                    }
                    function safeIncreaseAllowance(
                        IERC20 token,
                        address spender,
                        uint256 value
                    ) internal {
                        uint256 newAllowance = token.allowance(address(this), spender) + value;
                        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                    }
                    function safeDecreaseAllowance(
                        IERC20 token,
                        address spender,
                        uint256 value
                    ) internal {
                        unchecked {
                            uint256 oldAllowance = token.allowance(address(this), spender);
                            require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
                            uint256 newAllowance = oldAllowance - value;
                            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                        }
                    }
                    /**
                     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                     * on the return value: the return value is optional (but if data is returned, it must not be false).
                     * @param token The token targeted by the call.
                     * @param data The call data (encoded using abi.encode or one of its variants).
                     */
                    function _callOptionalReturn(IERC20 token, bytes memory data) private {
                        // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                        // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
                        // the target address contains contract code and also asserts for success in the low-level call.
                        bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
                        if (returndata.length > 0) {
                            // Return data is optional
                            require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                        }
                    }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @dev Collection of functions related to the address type
                 */
                library Address {
                    /**
                     * @dev Returns true if `account` is a contract.
                     *
                     * [IMPORTANT]
                     * ====
                     * It is unsafe to assume that an address for which this function returns
                     * false is an externally-owned account (EOA) and not a contract.
                     *
                     * Among others, `isContract` will return false for the following
                     * types of addresses:
                     *
                     *  - an externally-owned account
                     *  - a contract in construction
                     *  - an address where a contract will be created
                     *  - an address where a contract lived, but was destroyed
                     * ====
                     */
                    function isContract(address account) internal view returns (bool) {
                        // This method relies on extcodesize, which returns 0 for contracts in
                        // construction, since the code is only stored at the end of the
                        // constructor execution.
                        uint256 size;
                        assembly {
                            size := extcodesize(account)
                        }
                        return size > 0;
                    }
                    /**
                     * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                     * `recipient`, forwarding all available gas and reverting on errors.
                     *
                     * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                     * of certain opcodes, possibly making contracts go over the 2300 gas limit
                     * imposed by `transfer`, making them unable to receive funds via
                     * `transfer`. {sendValue} removes this limitation.
                     *
                     * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                     *
                     * IMPORTANT: because control is transferred to `recipient`, care must be
                     * taken to not create reentrancy vulnerabilities. Consider using
                     * {ReentrancyGuard} or the
                     * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                     */
                    function sendValue(address payable recipient, uint256 amount) internal {
                        require(address(this).balance >= amount, "Address: insufficient balance");
                        (bool success, ) = recipient.call{value: amount}("");
                        require(success, "Address: unable to send value, recipient may have reverted");
                    }
                    /**
                     * @dev Performs a Solidity function call using a low level `call`. A
                     * plain `call` is an unsafe replacement for a function call: use this
                     * function instead.
                     *
                     * If `target` reverts with a revert reason, it is bubbled up by this
                     * function (like regular Solidity function calls).
                     *
                     * Returns the raw returned data. To convert to the expected return value,
                     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                     *
                     * Requirements:
                     *
                     * - `target` must be a contract.
                     * - calling `target` with `data` must not revert.
                     *
                     * _Available since v3.1._
                     */
                    function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                        return functionCall(target, data, "Address: low-level call failed");
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                     * `errorMessage` as a fallback revert reason when `target` reverts.
                     *
                     * _Available since v3.1._
                     */
                    function functionCall(
                        address target,
                        bytes memory data,
                        string memory errorMessage
                    ) internal returns (bytes memory) {
                        return functionCallWithValue(target, data, 0, errorMessage);
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                     * but also transferring `value` wei to `target`.
                     *
                     * Requirements:
                     *
                     * - the calling contract must have an ETH balance of at least `value`.
                     * - the called Solidity function must be `payable`.
                     *
                     * _Available since v3.1._
                     */
                    function functionCallWithValue(
                        address target,
                        bytes memory data,
                        uint256 value
                    ) internal returns (bytes memory) {
                        return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                    }
                    /**
                     * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                     * with `errorMessage` as a fallback revert reason when `target` reverts.
                     *
                     * _Available since v3.1._
                     */
                    function functionCallWithValue(
                        address target,
                        bytes memory data,
                        uint256 value,
                        string memory errorMessage
                    ) internal returns (bytes memory) {
                        require(address(this).balance >= value, "Address: insufficient balance for call");
                        require(isContract(target), "Address: call to non-contract");
                        (bool success, bytes memory returndata) = target.call{value: value}(data);
                        return _verifyCallResult(success, returndata, errorMessage);
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                     * but performing a static call.
                     *
                     * _Available since v3.3._
                     */
                    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                        return functionStaticCall(target, data, "Address: low-level static call failed");
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                     * but performing a static call.
                     *
                     * _Available since v3.3._
                     */
                    function functionStaticCall(
                        address target,
                        bytes memory data,
                        string memory errorMessage
                    ) internal view returns (bytes memory) {
                        require(isContract(target), "Address: static call to non-contract");
                        (bool success, bytes memory returndata) = target.staticcall(data);
                        return _verifyCallResult(success, returndata, errorMessage);
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                     * but performing a delegate call.
                     *
                     * _Available since v3.4._
                     */
                    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                        return functionDelegateCall(target, data, "Address: low-level delegate call failed");
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                     * but performing a delegate call.
                     *
                     * _Available since v3.4._
                     */
                    function functionDelegateCall(
                        address target,
                        bytes memory data,
                        string memory errorMessage
                    ) internal returns (bytes memory) {
                        require(isContract(target), "Address: delegate call to non-contract");
                        (bool success, bytes memory returndata) = target.delegatecall(data);
                        return _verifyCallResult(success, returndata, errorMessage);
                    }
                    function _verifyCallResult(
                        bool success,
                        bytes memory returndata,
                        string memory errorMessage
                    ) private pure returns (bytes memory) {
                        if (success) {
                            return returndata;
                        } else {
                            // Look for revert reason and bubble it up if present
                            if (returndata.length > 0) {
                                // The easiest way to bubble the revert reason is using memory via assembly
                                assembly {
                                    let returndata_size := mload(returndata)
                                    revert(add(32, returndata), returndata_size)
                                }
                            } else {
                                revert(errorMessage);
                            }
                        }
                    }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /*
                 * @dev Provides information about the current execution context, including the
                 * sender of the transaction and its data. While these are generally available
                 * via msg.sender and msg.data, they should not be accessed in such a direct
                 * manner, since when dealing with meta-transactions the account sending and
                 * paying for execution may not be the actual sender (as far as an application
                 * is concerned).
                 *
                 * This contract is only required for intermediate, library-like contracts.
                 */
                abstract contract Context {
                    function _msgSender() internal view virtual returns (address) {
                        return msg.sender;
                    }
                    function _msgData() internal view virtual returns (bytes calldata) {
                        return msg.data;
                    }
                }
                

                File 2 of 5: MaticToken
                pragma solidity 0.5.2;
                
                // File: openzeppelin-solidity/contracts/token/ERC20/IERC20.sol
                
                /**
                 * @title ERC20 interface
                 * @dev see https://github.com/ethereum/EIPs/issues/20
                 */
                interface IERC20 {
                    function transfer(address to, uint256 value) external returns (bool);
                
                    function approve(address spender, uint256 value) external returns (bool);
                
                    function transferFrom(address from, address to, uint256 value) external returns (bool);
                
                    function totalSupply() external view returns (uint256);
                
                    function balanceOf(address who) external view returns (uint256);
                
                    function allowance(address owner, address spender) external view returns (uint256);
                
                    event Transfer(address indexed from, address indexed to, uint256 value);
                
                    event Approval(address indexed owner, address indexed spender, uint256 value);
                }
                
                // File: openzeppelin-solidity/contracts/math/SafeMath.sol
                
                /**
                 * @title SafeMath
                 * @dev Unsigned math operations with safety checks that revert on error
                 */
                library SafeMath {
                    /**
                    * @dev Multiplies two unsigned integers, reverts on 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-solidity/pull/522
                        if (a == 0) {
                            return 0;
                        }
                
                        uint256 c = a * b;
                        require(c / a == b);
                
                        return c;
                    }
                
                    /**
                    * @dev Integer division of two unsigned integers truncating the quotient, reverts on division by zero.
                    */
                    function div(uint256 a, uint256 b) internal pure returns (uint256) {
                        // Solidity only automatically asserts when dividing by 0
                        require(b > 0);
                        uint256 c = a / b;
                        // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                
                        return c;
                    }
                
                    /**
                    * @dev Subtracts two unsigned integers, reverts on overflow (i.e. if subtrahend is greater than minuend).
                    */
                    function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                        require(b <= a);
                        uint256 c = a - b;
                
                        return c;
                    }
                
                    /**
                    * @dev Adds two unsigned integers, reverts on overflow.
                    */
                    function add(uint256 a, uint256 b) internal pure returns (uint256) {
                        uint256 c = a + b;
                        require(c >= a);
                
                        return c;
                    }
                
                    /**
                    * @dev Divides two unsigned integers and returns the remainder (unsigned integer modulo),
                    * reverts when dividing by zero.
                    */
                    function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                        require(b != 0);
                        return a % b;
                    }
                }
                
                // File: openzeppelin-solidity/contracts/token/ERC20/ERC20.sol
                
                /**
                 * @title Standard ERC20 token
                 *
                 * @dev Implementation of the basic standard token.
                 * https://github.com/ethereum/EIPs/blob/master/EIPS/eip-20.md
                 * Originally based on code by FirstBlood:
                 * https://github.com/Firstbloodio/token/blob/master/smart_contract/FirstBloodToken.sol
                 *
                 * This implementation emits additional Approval events, allowing applications to reconstruct the allowance status for
                 * all accounts just by listening to said events. Note that this isn't required by the specification, and other
                 * compliant implementations may not do it.
                 */
                contract ERC20 is IERC20 {
                    using SafeMath for uint256;
                
                    mapping (address => uint256) private _balances;
                
                    mapping (address => mapping (address => uint256)) private _allowed;
                
                    uint256 private _totalSupply;
                
                    /**
                    * @dev Total number of tokens in existence
                    */
                    function totalSupply() public view returns (uint256) {
                        return _totalSupply;
                    }
                
                    /**
                    * @dev Gets the balance of the specified address.
                    * @param owner The address to query the balance of.
                    * @return An uint256 representing the amount owned by the passed address.
                    */
                    function balanceOf(address owner) public view returns (uint256) {
                        return _balances[owner];
                    }
                
                    /**
                     * @dev Function to check the amount of tokens that an owner allowed to a spender.
                     * @param owner address The address which owns the funds.
                     * @param spender address The address which will spend the funds.
                     * @return A uint256 specifying the amount of tokens still available for the spender.
                     */
                    function allowance(address owner, address spender) public view returns (uint256) {
                        return _allowed[owner][spender];
                    }
                
                    /**
                    * @dev Transfer token for a specified address
                    * @param to The address to transfer to.
                    * @param value The amount to be transferred.
                    */
                    function transfer(address to, uint256 value) public returns (bool) {
                        _transfer(msg.sender, to, value);
                        return true;
                    }
                
                    /**
                     * @dev Approve the passed address to spend the specified amount of tokens on behalf of msg.sender.
                     * 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
                     * @param spender The address which will spend the funds.
                     * @param value The amount of tokens to be spent.
                     */
                    function approve(address spender, uint256 value) public returns (bool) {
                        require(spender != address(0));
                
                        _allowed[msg.sender][spender] = value;
                        emit Approval(msg.sender, spender, value);
                        return true;
                    }
                
                    /**
                     * @dev Transfer tokens from one address to another.
                     * Note that while this function emits an Approval event, this is not required as per the specification,
                     * and other compliant implementations may not emit the event.
                     * @param from address The address which you want to send tokens from
                     * @param to address The address which you want to transfer to
                     * @param value uint256 the amount of tokens to be transferred
                     */
                    function transferFrom(address from, address to, uint256 value) public returns (bool) {
                        _allowed[from][msg.sender] = _allowed[from][msg.sender].sub(value);
                        _transfer(from, to, value);
                        emit Approval(from, msg.sender, _allowed[from][msg.sender]);
                        return true;
                    }
                
                    /**
                     * @dev Increase the amount of tokens that an owner allowed to a spender.
                     * approve should be called when allowed_[_spender] == 0. To increment
                     * allowed value is better to use this function to avoid 2 calls (and wait until
                     * the first transaction is mined)
                     * From MonolithDAO Token.sol
                     * Emits an Approval event.
                     * @param spender The address which will spend the funds.
                     * @param addedValue The amount of tokens to increase the allowance by.
                     */
                    function increaseAllowance(address spender, uint256 addedValue) public returns (bool) {
                        require(spender != address(0));
                
                        _allowed[msg.sender][spender] = _allowed[msg.sender][spender].add(addedValue);
                        emit Approval(msg.sender, spender, _allowed[msg.sender][spender]);
                        return true;
                    }
                
                    /**
                     * @dev Decrease the amount of tokens that an owner allowed to a spender.
                     * approve should be called when allowed_[_spender] == 0. To decrement
                     * allowed value is better to use this function to avoid 2 calls (and wait until
                     * the first transaction is mined)
                     * From MonolithDAO Token.sol
                     * Emits an Approval event.
                     * @param spender The address which will spend the funds.
                     * @param subtractedValue The amount of tokens to decrease the allowance by.
                     */
                    function decreaseAllowance(address spender, uint256 subtractedValue) public returns (bool) {
                        require(spender != address(0));
                
                        _allowed[msg.sender][spender] = _allowed[msg.sender][spender].sub(subtractedValue);
                        emit Approval(msg.sender, spender, _allowed[msg.sender][spender]);
                        return true;
                    }
                
                    /**
                    * @dev Transfer token for a specified addresses
                    * @param from The address to transfer from.
                    * @param to The address to transfer to.
                    * @param value The amount to be transferred.
                    */
                    function _transfer(address from, address to, uint256 value) internal {
                        require(to != address(0));
                
                        _balances[from] = _balances[from].sub(value);
                        _balances[to] = _balances[to].add(value);
                        emit Transfer(from, to, value);
                    }
                
                    /**
                     * @dev Internal function that mints an amount of the token and assigns it to
                     * an account. This encapsulates the modification of balances such that the
                     * proper events are emitted.
                     * @param account The account that will receive the created tokens.
                     * @param value The amount that will be created.
                     */
                    function _mint(address account, uint256 value) internal {
                        require(account != address(0));
                
                        _totalSupply = _totalSupply.add(value);
                        _balances[account] = _balances[account].add(value);
                        emit Transfer(address(0), account, value);
                    }
                
                    /**
                     * @dev Internal function that burns an amount of the token of a given
                     * account.
                     * @param account The account whose tokens will be burnt.
                     * @param value The amount that will be burnt.
                     */
                    function _burn(address account, uint256 value) internal {
                        require(account != address(0));
                
                        _totalSupply = _totalSupply.sub(value);
                        _balances[account] = _balances[account].sub(value);
                        emit Transfer(account, address(0), value);
                    }
                
                    /**
                     * @dev Internal function that burns an amount of the token of a given
                     * account, deducting from the sender's allowance for said account. Uses the
                     * internal burn function.
                     * Emits an Approval event (reflecting the reduced allowance).
                     * @param account The account whose tokens will be burnt.
                     * @param value The amount that will be burnt.
                     */
                    function _burnFrom(address account, uint256 value) internal {
                        _allowed[account][msg.sender] = _allowed[account][msg.sender].sub(value);
                        _burn(account, value);
                        emit Approval(account, msg.sender, _allowed[account][msg.sender]);
                    }
                }
                
                // File: openzeppelin-solidity/contracts/access/Roles.sol
                
                /**
                 * @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(account != address(0));
                        require(!has(role, account));
                
                        role.bearer[account] = true;
                    }
                
                    /**
                     * @dev remove an account's access to this role
                     */
                    function remove(Role storage role, address account) internal {
                        require(account != address(0));
                        require(has(role, account));
                
                        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));
                        return role.bearer[account];
                    }
                }
                
                // File: openzeppelin-solidity/contracts/access/roles/PauserRole.sol
                
                contract PauserRole {
                    using Roles for Roles.Role;
                
                    event PauserAdded(address indexed account);
                    event PauserRemoved(address indexed account);
                
                    Roles.Role private _pausers;
                
                    constructor () internal {
                        _addPauser(msg.sender);
                    }
                
                    modifier onlyPauser() {
                        require(isPauser(msg.sender));
                        _;
                    }
                
                    function isPauser(address account) public view returns (bool) {
                        return _pausers.has(account);
                    }
                
                    function addPauser(address account) public onlyPauser {
                        _addPauser(account);
                    }
                
                    function renouncePauser() public {
                        _removePauser(msg.sender);
                    }
                
                    function _addPauser(address account) internal {
                        _pausers.add(account);
                        emit PauserAdded(account);
                    }
                
                    function _removePauser(address account) internal {
                        _pausers.remove(account);
                        emit PauserRemoved(account);
                    }
                }
                
                // File: openzeppelin-solidity/contracts/lifecycle/Pausable.sol
                
                /**
                 * @title Pausable
                 * @dev Base contract which allows children to implement an emergency stop mechanism.
                 */
                contract Pausable is PauserRole {
                    event Paused(address account);
                    event Unpaused(address account);
                
                    bool private _paused;
                
                    constructor () internal {
                        _paused = false;
                    }
                
                    /**
                     * @return true if the contract is paused, false otherwise.
                     */
                    function paused() public view returns (bool) {
                        return _paused;
                    }
                
                    /**
                     * @dev Modifier to make a function callable only when the contract is not paused.
                     */
                    modifier whenNotPaused() {
                        require(!_paused);
                        _;
                    }
                
                    /**
                     * @dev Modifier to make a function callable only when the contract is paused.
                     */
                    modifier whenPaused() {
                        require(_paused);
                        _;
                    }
                
                    /**
                     * @dev called by the owner to pause, triggers stopped state
                     */
                    function pause() public onlyPauser whenNotPaused {
                        _paused = true;
                        emit Paused(msg.sender);
                    }
                
                    /**
                     * @dev called by the owner to unpause, returns to normal state
                     */
                    function unpause() public onlyPauser whenPaused {
                        _paused = false;
                        emit Unpaused(msg.sender);
                    }
                }
                
                // File: openzeppelin-solidity/contracts/token/ERC20/ERC20Pausable.sol
                
                /**
                 * @title Pausable token
                 * @dev ERC20 modified with pausable transfers.
                 **/
                contract ERC20Pausable is ERC20, Pausable {
                    function transfer(address to, uint256 value) public whenNotPaused returns (bool) {
                        return super.transfer(to, value);
                    }
                
                    function transferFrom(address from, address to, uint256 value) public whenNotPaused returns (bool) {
                        return super.transferFrom(from, to, value);
                    }
                
                    function approve(address spender, uint256 value) public whenNotPaused returns (bool) {
                        return super.approve(spender, value);
                    }
                
                    function increaseAllowance(address spender, uint addedValue) public whenNotPaused returns (bool success) {
                        return super.increaseAllowance(spender, addedValue);
                    }
                
                    function decreaseAllowance(address spender, uint subtractedValue) public whenNotPaused returns (bool success) {
                        return super.decreaseAllowance(spender, subtractedValue);
                    }
                }
                
                // File: openzeppelin-solidity/contracts/token/ERC20/ERC20Detailed.sol
                
                /**
                 * @title ERC20Detailed token
                 * @dev The decimals are only for visualization purposes.
                 * All the operations are done using the smallest and indivisible token unit,
                 * just as on Ethereum all the operations are done in wei.
                 */
                contract ERC20Detailed is IERC20 {
                    string private _name;
                    string private _symbol;
                    uint8 private _decimals;
                
                    constructor (string memory name, string memory symbol, uint8 decimals) public {
                        _name = name;
                        _symbol = symbol;
                        _decimals = decimals;
                    }
                
                    /**
                     * @return the name of the token.
                     */
                    function name() public view returns (string memory) {
                        return _name;
                    }
                
                    /**
                     * @return the symbol of the token.
                     */
                    function symbol() public view returns (string memory) {
                        return _symbol;
                    }
                
                    /**
                     * @return the number of decimals of the token.
                     */
                    function decimals() public view returns (uint8) {
                        return _decimals;
                    }
                }
                
                // File: contracts/MaticToken.sol
                
                contract MaticToken is ERC20Pausable, ERC20Detailed {
                    constructor (string memory name, string memory symbol, uint8 decimals, uint256 totalSupply)
                    public
                    ERC20Detailed (name, symbol, decimals) {
                        _mint(msg.sender, totalSupply);
                    }
                }

                File 3 of 5: AggregationRouterV4
                /*
                                                                           ,▄▓▓██▌   ,╓▄▄▓▓▓▓▓▓▓▓▄▄▄,,
                                                                        ,▓██▓███▓▄▓███▓╬╬╬╬╬╬╬╬╬╬╬╬╬▓███▓▄,
                                                                  ▄█   ▓██╬╣███████╬▓▀╬╬▓▓▓████████████▓█████▄,
                                                                 ▓██▌ ▓██╬╣██████╬▓▌  ██████████████████████▌╙╙▀ⁿ
                                                                ▐████████╬▓████▓▓█╨ ▄ ╟█████████▓▓╬╬╬╬╬▓▓█████▓▄
                                                  └▀▓▓▄╓        ╟█▓╣█████▓██████▀ ╓█▌ ███████▓▓▓▓▓╬╬╬╬╬╬╬╬╬╬╬╬▓██▓▄
                                                     └▀████▓▄╥  ▐██╬╬██████████╙ Æ▀─ ▓███▀╚╠╬╩▀▀███████▓▓╬╬╬╬╬╬╬╬╬██▄
                                                        └▀██▓▀▀█████▓╬▓██████▀     ▄█████▒╠"      └╙▓██████▓╬╬╬╬╬╬╬╬██▄
                                                           └▀██▄,└╙▀▀████▌└╙    ^"▀╙╙╙"╙██      @▄    ╙▀███████╬╬╬╬╬╬╬██µ
                                                              └▀██▓▄, ██▌       ╒       ╙█▓     ]▓█▓╔    ▀███████▓╬╬╬╬╬▓█▌
                                                                  ▀█████       ▓         ╟█▌    ]╠██▓░▒╓   ▀████████╬╬╬╬╣█▌
                                                                  ▐████      ╓█▀█▌      ,██▌    ╚Å███▓▒▒╠╓  ╙█████████╬╬╬╣█▌
                                                                  └████     ▓█░░▓█      ▀▀▀    φ▒╫████▒▒▒▒╠╓  █████████▓╬╬▓█µ
                                                                   ╘███µ ▌▄█▓▄▓▀`     ,▀    ,╔╠░▓██████▌╠▒▒▒φ  ██████████╬╬██
                                                                   ▐████µ╙▓▀`     ,▀╙,╔╔φφφ╠░▄▓███████▌░▓╙▒▒▒╠ └██╬███████╬▓█⌐
                                                                   ╫██ ▓▌         ▌φ▒▒░▓██████████████▌▒░▓╚▒▒▒╠ ▓██╬▓██████╣█▌
                                                                   ██▌           ▌╔▒▒▄████████████████▒▒▒░▌╠▒▒▒≥▐██▓╬╬███████▌
                                                                   ██▌      ,╓φ╠▓«▒▒▓████▀  ▀█████████▌▒▒▒╟░▒▒▒▒▐███╬╬╣████▓█▌
                                                                  ▐██      ╠▒▄▓▓███▓████└     ▀████████▌▒▒░▌╚▒▒▒▐███▓╬╬████ ╙▌
                                                                  ███  )  ╠▒░░░▒░╬████▀        └████████░▒▒░╬∩▒▒▓████╬╬╣███
                                                                 ▓██    ╠╠▒▒▐█▀▀▌`░╫██           ███████▒▒▒▒░▒▒½█████╬╬╣███
                                                                ███ ,█▄ ╠▒▒▒╫▌,▄▀,▒╫██           ╟██████▒▒▒░╣⌠▒▓█████╬╬╣██▌
                                                               ╘██µ ██` ╠▒▒░██╬φ╠▄▓██`            ██████░░▌φ╠░▓█████▓╬╬▓██
                                                                ╟██  .φ╠▒░▄█▀░░▄██▀└              █████▌▒╣φ▒░▓██████╬╬╣██
                                                                 ▀██▄▄▄╓▄███████▀                ▐█████░▓φ▒▄███████▓╬╣██
                                                                   ╙▀▀▀██▀└                      ████▓▄▀φ▄▓████████╬▓█▀
                                                                                                ▓███╬╩╔╣██████████▓██└
                                                                                              ╓████▀▄▓████████▀████▀
                                                                                            ,▓███████████████─]██╙
                                                                                         ,▄▓██████████████▀└  ╙
                                                                                    ,╓▄▓███████████████▀╙
                                                                             `"▀▀▀████████▀▀▀▀`▄███▀▀└
                                                                                              └└
                
                
                
                                    11\   11\                     11\             11\   11\            11\                                       11\
                                  1111 |  \__|                    11 |            111\  11 |           11 |                                      11 |
                                  \_11 |  11\ 1111111\   1111111\ 1111111\        1111\ 11 | 111111\ 111111\   11\  11\  11\  111111\   111111\  11 |  11\
                                    11 |  11 |11  __11\ 11  _____|11  __11\       11 11\11 |11  __11\\_11  _|  11 | 11 | 11 |11  __11\ 11  __11\ 11 | 11  |
                                    11 |  11 |11 |  11 |11 /      11 |  11 |      11 \1111 |11111111 | 11 |    11 | 11 | 11 |11 /  11 |11 |  \__|111111  /
                                    11 |  11 |11 |  11 |11 |      11 |  11 |      11 |\111 |11   ____| 11 |11\ 11 | 11 | 11 |11 |  11 |11 |      11  _11<
                                  111111\ 11 |11 |  11 |\1111111\ 11 |  11 |      11 | \11 |\1111111\  \1111  |\11111\1111  |\111111  |11 |      11 | \11\
                                  \______|\__|\__|  \__| \_______|\__|  \__|      \__|  \__| \_______|  \____/  \_____\____/  \______/ \__|      \__|  \__|
                
                
                
                                               111111\                                                               11\     11\
                                              11  __11\                                                              11 |    \__|
                                              11 /  11 | 111111\   111111\   111111\   111111\   111111\   111111\ 111111\   11\  111111\  1111111\
                                              11111111 |11  __11\ 11  __11\ 11  __11\ 11  __11\ 11  __11\  \____11\\_11  _|  11 |11  __11\ 11  __11\
                                              11  __11 |11 /  11 |11 /  11 |11 |  \__|11111111 |11 /  11 | 1111111 | 11 |    11 |11 /  11 |11 |  11 |
                                              11 |  11 |11 |  11 |11 |  11 |11 |      11   ____|11 |  11 |11  __11 | 11 |11\ 11 |11 |  11 |11 |  11 |
                                              11 |  11 |\1111111 |\1111111 |11 |      \1111111\ \1111111 |\1111111 | \1111  |11 |\111111  |11 |  11 |
                                              \__|  \__| \____11 | \____11 |\__|       \_______| \____11 | \_______|  \____/ \__| \______/ \__|  \__|
                                                        11\   11 |11\   11 |                    11\   11 |
                                                        \111111  |\111111  |                    \111111  |
                                                         \______/  \______/                      \______/
                                                                1111111\                        11\
                                                                11  __11\                       11 |
                                                                11 |  11 | 111111\  11\   11\ 111111\    111111\   111111\
                                                                1111111  |11  __11\ 11 |  11 |\_11  _|  11  __11\ 11  __11\
                                                                11  __11< 11 /  11 |11 |  11 |  11 |    11111111 |11 |  \__|
                                                                11 |  11 |11 |  11 |11 |  11 |  11 |11\ 11   ____|11 |
                                                                11 |  11 |\111111  |\111111  |  \1111  |\1111111\ 11 |
                                                                \__|  \__| \______/  \______/    \____/  \_______|\__|
                */
                
                // File @openzeppelin/contracts/utils/Context.sol@v3.4.2-solc-0.7
                
                // SPDX-License-Identifier: MIT
                
                pragma solidity >=0.6.0 <0.8.0;
                
                /*
                 * @dev Provides information about the current execution context, including the
                 * sender of the transaction and its data. While these are generally available
                 * via msg.sender and msg.data, they should not be accessed in such a direct
                 * manner, since when dealing with 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;
                    }
                }
                
                
                // File @openzeppelin/contracts/access/Ownable.sol@v3.4.2-solc-0.7
                
                
                pragma solidity ^0.7.0;
                
                /**
                 * @dev Contract module which provides a basic access control mechanism, where
                 * there is an account (an owner) that can be granted exclusive access to
                 * specific functions.
                 *
                 * By default, the owner account will be the one that deploys the contract. This
                 * can later be changed with {transferOwnership}.
                 *
                 * This module is used through inheritance. It will make available the modifier
                 * `onlyOwner`, which can be applied to your functions to restrict their use to
                 * the owner.
                 */
                abstract contract Ownable is Context {
                    address private _owner;
                
                    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                
                    /**
                     * @dev Initializes the contract setting the deployer as the initial owner.
                     */
                    constructor () {
                        address msgSender = _msgSender();
                        _owner = msgSender;
                        emit OwnershipTransferred(address(0), msgSender);
                    }
                
                    /**
                     * @dev Returns the address of the current owner.
                     */
                    function owner() public view virtual returns (address) {
                        return _owner;
                    }
                
                    /**
                     * @dev Throws if called by any account other than the owner.
                     */
                    modifier onlyOwner() {
                        require(owner() == _msgSender(), "Ownable: caller is not the owner");
                        _;
                    }
                
                    /**
                     * @dev Leaves the contract without owner. It will not be possible to call
                     * `onlyOwner` functions anymore. Can only be called by the current owner.
                     *
                     * NOTE: Renouncing ownership will leave the contract without an owner,
                     * thereby removing any functionality that is only available to the owner.
                     */
                    function renounceOwnership() public virtual onlyOwner {
                        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;
                    }
                }
                
                
                // File @openzeppelin/contracts/token/ERC20/IERC20.sol@v3.4.2-solc-0.7
                
                
                pragma solidity ^0.7.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);
                }
                
                
                // File @openzeppelin/contracts/math/SafeMath.sol@v3.4.2-solc-0.7
                
                
                pragma solidity ^0.7.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, with an overflow flag.
                     *
                     * _Available since v3.4._
                     */
                    function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                        uint256 c = a + b;
                        if (c < a) return (false, 0);
                        return (true, c);
                    }
                
                    /**
                     * @dev Returns the substraction of two unsigned integers, with an overflow flag.
                     *
                     * _Available since v3.4._
                     */
                    function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                        if (b > a) return (false, 0);
                        return (true, a - b);
                    }
                
                    /**
                     * @dev Returns the multiplication of two unsigned integers, with an overflow flag.
                     *
                     * _Available since v3.4._
                     */
                    function tryMul(uint256 a, uint256 b) internal pure returns (bool, 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 (true, 0);
                        uint256 c = a * b;
                        if (c / a != b) return (false, 0);
                        return (true, c);
                    }
                
                    /**
                     * @dev Returns the division of two unsigned integers, with a division by zero flag.
                     *
                     * _Available since v3.4._
                     */
                    function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                        if (b == 0) return (false, 0);
                        return (true, a / b);
                    }
                
                    /**
                     * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
                     *
                     * _Available since v3.4._
                     */
                    function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                        if (b == 0) return (false, 0);
                        return (true, a % b);
                    }
                
                    /**
                     * @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) {
                        require(b <= a, "SafeMath: subtraction overflow");
                        return a - b;
                    }
                
                    /**
                     * @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) {
                        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, reverting 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) {
                        require(b > 0, "SafeMath: division by zero");
                        return a / b;
                    }
                
                    /**
                     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                     * reverting 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) {
                        require(b > 0, "SafeMath: modulo by zero");
                        return a % b;
                    }
                
                    /**
                     * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
                     * overflow (when the result is negative).
                     *
                     * CAUTION: This function is deprecated because it requires allocating memory for the error
                     * message unnecessarily. For custom revert reasons use {trySub}.
                     *
                     * 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);
                        return a - b;
                    }
                
                    /**
                     * @dev Returns the integer division of two unsigned integers, reverting with custom message on
                     * division by zero. The result is rounded towards zero.
                     *
                     * CAUTION: This function is deprecated because it requires allocating memory for the error
                     * message unnecessarily. For custom revert reasons use {tryDiv}.
                     *
                     * 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);
                        return a / b;
                    }
                
                    /**
                     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                     * reverting with custom message when dividing by zero.
                     *
                     * CAUTION: This function is deprecated because it requires allocating memory for the error
                     * message unnecessarily. For custom revert reasons use {tryMod}.
                     *
                     * 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;
                    }
                }
                
                
                // File @openzeppelin/contracts/utils/Address.sol@v3.4.2-solc-0.7
                
                
                pragma solidity ^0.7.0;
                
                /**
                 * @dev Collection of functions related to the address type
                 */
                library Address {
                    /**
                     * @dev Returns true if `account` is a contract.
                     *
                     * [IMPORTANT]
                     * ====
                     * It is unsafe to assume that an address for which this function returns
                     * false is an externally-owned account (EOA) and not a contract.
                     *
                     * Among others, `isContract` will return false for the following
                     * types of addresses:
                     *
                     *  - an externally-owned account
                     *  - a contract in construction
                     *  - an address where a contract will be created
                     *  - an address where a contract lived, but was destroyed
                     * ====
                     */
                    function isContract(address account) internal view returns (bool) {
                        // This method relies on extcodesize, which returns 0 for contracts in
                        // construction, since the code is only stored at the end of the
                        // constructor execution.
                
                        uint256 size;
                        // 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");
                        require(isContract(target), "Address: call to non-contract");
                
                        // solhint-disable-next-line avoid-low-level-calls
                        (bool success, bytes memory returndata) = target.call{ value: value }(data);
                        return _verifyCallResult(success, returndata, errorMessage);
                    }
                
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                     * but performing a static call.
                     *
                     * _Available since v3.3._
                     */
                    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                        return functionStaticCall(target, data, "Address: low-level static call failed");
                    }
                
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                     * but performing a static call.
                     *
                     * _Available since v3.3._
                     */
                    function functionStaticCall(address target, bytes memory data, string memory errorMessage) internal view returns (bytes memory) {
                        require(isContract(target), "Address: static call to non-contract");
                
                        // solhint-disable-next-line avoid-low-level-calls
                        (bool success, bytes memory returndata) = target.staticcall(data);
                        return _verifyCallResult(success, returndata, errorMessage);
                    }
                
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                     * but performing a delegate call.
                     *
                     * _Available since v3.4._
                     */
                    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                        return functionDelegateCall(target, data, "Address: low-level delegate call failed");
                    }
                
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                     * but performing a delegate call.
                     *
                     * _Available since v3.4._
                     */
                    function functionDelegateCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                        require(isContract(target), "Address: delegate call to non-contract");
                
                        // solhint-disable-next-line avoid-low-level-calls
                        (bool success, bytes memory returndata) = target.delegatecall(data);
                        return _verifyCallResult(success, returndata, errorMessage);
                    }
                
                    function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {
                        if (success) {
                            return returndata;
                        } else {
                            // Look for revert reason and bubble it up if present
                            if (returndata.length > 0) {
                                // The easiest way to bubble the revert reason is using memory via assembly
                
                                // solhint-disable-next-line no-inline-assembly
                                assembly {
                                    let returndata_size := mload(returndata)
                                    revert(add(32, returndata), returndata_size)
                                }
                            } else {
                                revert(errorMessage);
                            }
                        }
                    }
                }
                
                
                // File @openzeppelin/contracts/token/ERC20/SafeERC20.sol@v3.4.2-solc-0.7
                
                
                pragma solidity ^0.7.0;
                
                
                
                /**
                 * @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");
                        }
                    }
                }
                
                
                // File contracts/helpers/EthReceiver.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Base contract with common payable logics
                abstract contract EthReceiver {
                    receive() external payable {
                        // solhint-disable-next-line avoid-tx-origin
                        require(msg.sender != tx.origin, "ETH deposit rejected");
                    }
                }
                
                
                // File @openzeppelin/contracts/drafts/IERC20Permit.sol@v3.4.2-solc-0.7
                
                
                pragma solidity >=0.6.0 <0.8.0;
                
                /**
                 * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
                 * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
                 *
                 * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
                 * presenting a message signed by the account. By not relying on `{IERC20-approve}`, the token holder account doesn't
                 * need to send a transaction, and thus is not required to hold Ether at all.
                 */
                interface IERC20Permit {
                    /**
                     * @dev Sets `value` as the allowance of `spender` over `owner`'s tokens,
                     * given `owner`'s signed approval.
                     *
                     * IMPORTANT: The same issues {IERC20-approve} has related to transaction
                     * ordering also apply here.
                     *
                     * Emits an {Approval} event.
                     *
                     * Requirements:
                     *
                     * - `spender` cannot be the zero address.
                     * - `deadline` must be a timestamp in the future.
                     * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
                     * over the EIP712-formatted function arguments.
                     * - the signature must use ``owner``'s current nonce (see {nonces}).
                     *
                     * For more information on the signature format, see the
                     * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
                     * section].
                     */
                    function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) external;
                
                    /**
                     * @dev Returns the current nonce for `owner`. This value must be
                     * included whenever a signature is generated for {permit}.
                     *
                     * Every successful call to {permit} increases ``owner``'s nonce by one. This
                     * prevents a signature from being used multiple times.
                     */
                    function nonces(address owner) external view returns (uint256);
                
                    /**
                     * @dev Returns the domain separator used in the encoding of the signature for `permit`, as defined by {EIP712}.
                     */
                    // solhint-disable-next-line func-name-mixedcase
                    function DOMAIN_SEPARATOR() external view returns (bytes32);
                }
                
                
                // File contracts/helpers/RevertReasonParser.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Library that allows to parse unsuccessful arbitrary calls revert reasons.
                /// See https://solidity.readthedocs.io/en/latest/control-structures.html#revert for details.
                /// Note that we assume revert reason being abi-encoded as Error(string) so it may fail to parse reason
                /// if structured reverts appear in the future.
                ///
                /// All unsuccessful parsings get encoded as Unknown(data) string
                library RevertReasonParser {
                    bytes4 constant private _PANIC_SELECTOR = bytes4(keccak256("Panic(uint256)"));
                    bytes4 constant private _ERROR_SELECTOR = bytes4(keccak256("Error(string)"));
                
                    function parse(bytes memory data, string memory prefix) internal pure returns (string memory) {
                        if (data.length >= 4) {
                            bytes4 selector;
                            assembly {  // solhint-disable-line no-inline-assembly
                                selector := mload(add(data, 0x20))
                            }
                
                            // 68 = 4-byte selector + 32 bytes offset + 32 bytes length
                            if (selector == _ERROR_SELECTOR && data.length >= 68) {
                                uint256 offset;
                                bytes memory reason;
                                // solhint-disable no-inline-assembly
                                assembly {
                                    // 36 = 32 bytes data length + 4-byte selector
                                    offset := mload(add(data, 36))
                                    reason := add(data, add(36, offset))
                                }
                                /*
                                    revert reason is padded up to 32 bytes with ABI encoder: Error(string)
                                    also sometimes there is extra 32 bytes of zeros padded in the end:
                                    https://github.com/ethereum/solidity/issues/10170
                                    because of that we can't check for equality and instead check
                                    that offset + string length + extra 36 bytes is less than overall data length
                                */
                                require(data.length >= 36 + offset + reason.length, "Invalid revert reason");
                                return string(abi.encodePacked(prefix, "Error(", reason, ")"));
                            }
                            // 36 = 4-byte selector + 32 bytes integer
                            else if (selector == _PANIC_SELECTOR && data.length == 36) {
                                uint256 code;
                                // solhint-disable no-inline-assembly
                                assembly {
                                    // 36 = 32 bytes data length + 4-byte selector
                                    code := mload(add(data, 36))
                                }
                                return string(abi.encodePacked(prefix, "Panic(", _toHex(code), ")"));
                            }
                        }
                
                        return string(abi.encodePacked(prefix, "Unknown(", _toHex(data), ")"));
                    }
                
                    function _toHex(uint256 value) private pure returns(string memory) {
                        return _toHex(abi.encodePacked(value));
                    }
                
                    function _toHex(bytes memory data) private pure returns(string memory) {
                        bytes16 alphabet = 0x30313233343536373839616263646566;
                        bytes memory str = new bytes(2 + data.length * 2);
                        str[0] = "0";
                        str[1] = "x";
                        for (uint256 i = 0; i < data.length; i++) {
                            str[2 * i + 2] = alphabet[uint8(data[i] >> 4)];
                            str[2 * i + 3] = alphabet[uint8(data[i] & 0x0f)];
                        }
                        return string(str);
                    }
                }
                
                
                // File contracts/interfaces/IDaiLikePermit.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Interface for DAI-style permits
                interface IDaiLikePermit {
                    function permit(address holder, address spender, uint256 nonce, uint256 expiry, bool allowed, uint8 v, bytes32 r, bytes32 s) external;
                }
                
                
                // File contracts/helpers/Permitable.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                /// @title Base contract with common permit handling logics
                contract Permitable {
                    function _permit(address token, bytes calldata permit) internal {
                        if (permit.length > 0) {
                            bool success;
                            bytes memory result;
                            if (permit.length == 32 * 7) {
                                // solhint-disable-next-line avoid-low-level-calls
                                (success, result) = token.call(abi.encodePacked(IERC20Permit.permit.selector, permit));
                            } else if (permit.length == 32 * 8) {
                                // solhint-disable-next-line avoid-low-level-calls
                                (success, result) = token.call(abi.encodePacked(IDaiLikePermit.permit.selector, permit));
                            } else {
                                revert("Wrong permit length");
                            }
                            if (!success) {
                                revert(RevertReasonParser.parse(result, "Permit failed: "));
                            }
                        }
                    }
                }
                
                
                // File contracts/helpers/UniERC20.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                
                library UniERC20 {
                    using SafeMath for uint256;
                    using SafeERC20 for IERC20;
                
                    IERC20 private constant _ETH_ADDRESS = IERC20(0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE);
                    IERC20 private constant _ZERO_ADDRESS = IERC20(0);
                
                    function isETH(IERC20 token) internal pure returns (bool) {
                        return (token == _ZERO_ADDRESS || token == _ETH_ADDRESS);
                    }
                
                    function uniBalanceOf(IERC20 token, address account) internal view returns (uint256) {
                        if (isETH(token)) {
                            return account.balance;
                        } else {
                            return token.balanceOf(account);
                        }
                    }
                
                    function uniTransfer(IERC20 token, address payable to, uint256 amount) internal {
                        if (amount > 0) {
                            if (isETH(token)) {
                                to.transfer(amount);
                            } else {
                                token.safeTransfer(to, amount);
                            }
                        }
                    }
                
                    function uniApprove(IERC20 token, address to, uint256 amount) internal {
                        require(!isETH(token), "Approve called on ETH");
                
                        // solhint-disable-next-line avoid-low-level-calls
                        (bool success, bytes memory returndata) = address(token).call(abi.encodeWithSelector(token.approve.selector, to, amount));
                
                        if (!success || (returndata.length > 0 && !abi.decode(returndata, (bool)))) {
                            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, to, 0));
                            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, to, amount));
                        }
                    }
                
                    function _callOptionalReturn(IERC20 token, bytes memory data) private {
                        // solhint-disable-next-line avoid-low-level-calls
                        (bool success, bytes memory result) = address(token).call(data);
                        if (!success) {
                            revert(RevertReasonParser.parse(result, "Low-level call failed: "));
                        }
                
                        if (result.length > 0) { // Return data is optional
                            require(abi.decode(result, (bool)), "ERC20 operation did not succeed");
                        }
                    }
                }
                
                
                // File contracts/interfaces/IAggregationExecutor.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Interface for making arbitrary calls during swap
                interface IAggregationExecutor {
                    /// @notice Make calls on `msgSender` with specified data
                    function callBytes(address msgSender, bytes calldata data) external payable;  // 0x2636f7f8
                }
                
                
                // File @openzeppelin/contracts/drafts/EIP712.sol@v3.4.2-solc-0.7
                
                
                pragma solidity >=0.6.0 <0.8.0;
                
                /**
                 * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.
                 *
                 * The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible,
                 * thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding
                 * they need in their contracts using a combination of `abi.encode` and `keccak256`.
                 *
                 * This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding
                 * scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA
                 * ({_hashTypedDataV4}).
                 *
                 * The implementation of the domain separator was designed to be as efficient as possible while still properly updating
                 * the chain id to protect against replay attacks on an eventual fork of the chain.
                 *
                 * NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method
                 * https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].
                 *
                 * _Available since v3.4._
                 */
                abstract contract EIP712 {
                    /* solhint-disable var-name-mixedcase */
                    // Cache the domain separator as an immutable value, but also store the chain id that it corresponds to, in order to
                    // invalidate the cached domain separator if the chain id changes.
                    bytes32 private immutable _CACHED_DOMAIN_SEPARATOR;
                    uint256 private immutable _CACHED_CHAIN_ID;
                
                    bytes32 private immutable _HASHED_NAME;
                    bytes32 private immutable _HASHED_VERSION;
                    bytes32 private immutable _TYPE_HASH;
                    /* solhint-enable var-name-mixedcase */
                
                    /**
                     * @dev Initializes the domain separator and parameter caches.
                     *
                     * The meaning of `name` and `version` is specified in
                     * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:
                     *
                     * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.
                     * - `version`: the current major version of the signing domain.
                     *
                     * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart
                     * contract upgrade].
                     */
                    constructor(string memory name, string memory version) {
                        bytes32 hashedName = keccak256(bytes(name));
                        bytes32 hashedVersion = keccak256(bytes(version));
                        bytes32 typeHash = keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");
                        _HASHED_NAME = hashedName;
                        _HASHED_VERSION = hashedVersion;
                        _CACHED_CHAIN_ID = _getChainId();
                        _CACHED_DOMAIN_SEPARATOR = _buildDomainSeparator(typeHash, hashedName, hashedVersion);
                        _TYPE_HASH = typeHash;
                    }
                
                    /**
                     * @dev Returns the domain separator for the current chain.
                     */
                    function _domainSeparatorV4() internal view virtual returns (bytes32) {
                        if (_getChainId() == _CACHED_CHAIN_ID) {
                            return _CACHED_DOMAIN_SEPARATOR;
                        } else {
                            return _buildDomainSeparator(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION);
                        }
                    }
                
                    function _buildDomainSeparator(bytes32 typeHash, bytes32 name, bytes32 version) private view returns (bytes32) {
                        return keccak256(
                            abi.encode(
                                typeHash,
                                name,
                                version,
                                _getChainId(),
                                address(this)
                            )
                        );
                    }
                
                    /**
                     * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this
                     * function returns the hash of the fully encoded EIP712 message for this domain.
                     *
                     * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:
                     *
                     * ```solidity
                     * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(
                     *     keccak256("Mail(address to,string contents)"),
                     *     mailTo,
                     *     keccak256(bytes(mailContents))
                     * )));
                     * address signer = ECDSA.recover(digest, signature);
                     * ```
                     */
                    function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) {
                        return keccak256(abi.encodePacked("\x19\x01", _domainSeparatorV4(), structHash));
                    }
                
                    function _getChainId() private view returns (uint256 chainId) {
                        this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                        // solhint-disable-next-line no-inline-assembly
                        assembly {
                            chainId := chainid()
                        }
                    }
                }
                
                
                // File contracts/helpers/ECDSA.sol
                
                
                pragma solidity ^0.7.6;
                
                /**
                 * @dev Simplified copy of OpenZeppelin ECDSA library downgraded to 0.7.6
                 * https://github.com/OpenZeppelin/openzeppelin-contracts/blob/541e82144f691aa171c53ba8c3b32ef7f05b99a5/contracts/utils/cryptography/ECDSA.sol
                 *
                 * Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
                 *
                 * These functions can be used to verify that a message was signed by the holder
                 * of the private keys of a given address.
                 */
                library ECDSA {
                    /**
                     * @dev Returns the address that signed a hashed message (`hash`) with
                     * `signature` or error string. This address can then be used for verification purposes.
                     *
                     * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
                     * this function rejects them by requiring the `s` value to be in the lower
                     * half order, and the `v` value to be either 27 or 28.
                     *
                     * IMPORTANT: `hash` _must_ be the result of a hash operation for the
                     * verification to be secure: it is possible to craft signatures that
                     * recover to arbitrary addresses for non-hashed data. A safe way to ensure
                     * this is by receiving a hash of the original message (which may otherwise
                     * be too long), and then calling {toEthSignedMessageHash} on it.
                     *
                     * Documentation for signature generation:
                     * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
                     * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
                     *
                     * _Available since v4.3._
                     */
                    function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address) {
                        // Check the signature length
                        // - case 65: r,s,v signature (standard)
                        // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._
                        if (signature.length == 65) {
                            bytes32 r;
                            bytes32 s;
                            uint8 v;
                            // ecrecover takes the signature parameters, and the only way to get them
                            // currently is to use assembly.
                            assembly {  // solhint-disable-line no-inline-assembly
                                r := mload(add(signature, 0x20))
                                s := mload(add(signature, 0x40))
                                v := byte(0, mload(add(signature, 0x60)))
                            }
                            return tryRecover(hash, v, r, s);
                        } else if (signature.length == 64) {
                            bytes32 r;
                            bytes32 vs;
                            // ecrecover takes the signature parameters, and the only way to get them
                            // currently is to use assembly.
                            assembly {  // solhint-disable-line no-inline-assembly
                                r := mload(add(signature, 0x20))
                                vs := mload(add(signature, 0x40))
                            }
                            return tryRecover(hash, r, vs);
                        } else {
                            return address(0);
                        }
                    }
                
                    /**
                     * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
                     *
                     * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
                     *
                     * _Available since v4.3._
                     */
                    function tryRecover(
                        bytes32 hash,
                        bytes32 r,
                        bytes32 vs
                    ) internal pure returns (address) {
                        bytes32 s;
                        uint8 v;
                        assembly {  // solhint-disable-line no-inline-assembly
                            s := and(vs, 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff)
                            v := add(shr(255, vs), 27)
                        }
                        return tryRecover(hash, v, r, s);
                    }
                
                    /**
                     * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
                     * `r` and `s` signature fields separately.
                     *
                     * _Available since v4.3._
                     */
                    function tryRecover(
                        bytes32 hash,
                        uint8 v,
                        bytes32 r,
                        bytes32 s
                    ) internal pure returns (address) {
                        // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
                        // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
                        // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
                        // signatures from current libraries generate a unique signature with an s-value in the lower half order.
                        //
                        // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
                        // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
                        // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
                        // these malleable signatures as well.
                        if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
                            return address(0);
                        }
                        if (v != 27 && v != 28) {
                            return address(0);
                        }
                
                        // If the signature is valid (and not malleable), return the signer address
                        address signer = ecrecover(hash, v, r, s);
                        if (signer == address(0)) {
                            return address(0);
                        }
                
                        return signer;
                    }
                }
                
                
                // File contracts/interfaces/IERC1271.sol
                
                
                pragma solidity ^0.7.6;
                
                /**
                 * @dev Interface of the ERC1271 standard signature validation method for
                 * contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].
                 */
                interface IERC1271 {
                    /**
                     * @dev Should return whether the signature provided is valid for the provided data
                     * @param hash      Hash of the data to be signed
                     * @param signature Signature byte array associated with _data
                     */
                    function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);
                }
                
                
                // File contracts/interfaces/IWETH.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Interface for WETH tokens
                interface IWETH is IERC20 {
                    function deposit() external payable;
                    function withdraw(uint256 amount) external;
                }
                
                
                // File contracts/LimitOrderProtocolRFQ.sol
                
                
                pragma solidity ^0.7.6;
                pragma abicoder v2;
                
                
                
                
                
                
                
                contract LimitOrderProtocolRFQ is EthReceiver, EIP712("1inch RFQ", "2"), Permitable {
                    using SafeMath for uint256;
                    using SafeERC20 for IERC20;
                
                    event OrderFilledRFQ(
                        bytes32 orderHash,
                        uint256 makingAmount
                    );
                
                    struct OrderRFQ {
                        // lowest 64 bits is the order id, next 64 bits is the expiration timestamp
                        // highest bit is unwrap WETH flag which is set on taker's side
                        // [unwrap eth(1 bit) | unused (127 bits) | expiration timestamp(64 bits) | orderId (64 bits)]
                        uint256 info;
                        IERC20 makerAsset;
                        IERC20 takerAsset;
                        address maker;
                        address allowedSender;  // equals to Zero address on public orders
                        uint256 makingAmount;
                        uint256 takingAmount;
                    }
                
                    bytes32 constant public LIMIT_ORDER_RFQ_TYPEHASH = keccak256(
                        "OrderRFQ(uint256 info,address makerAsset,address takerAsset,address maker,address allowedSender,uint256 makingAmount,uint256 takingAmount)"
                    );
                    uint256 private constant _UNWRAP_WETH_MASK = 1 << 255;
                
                    IWETH private immutable _WETH;  // solhint-disable-line var-name-mixedcase
                    mapping(address => mapping(uint256 => uint256)) private _invalidator;
                
                    constructor(address weth) {
                        _WETH = IWETH(weth);
                    }
                
                    // solhint-disable-next-line func-name-mixedcase
                    function DOMAIN_SEPARATOR() external view returns(bytes32) {
                        return _domainSeparatorV4();
                    }
                
                    /// @notice Returns bitmask for double-spend invalidators based on lowest byte of order.info and filled quotes
                    /// @return Result Each bit represents whenever corresponding quote was filled
                    function invalidatorForOrderRFQ(address maker, uint256 slot) external view returns(uint256) {
                        return _invalidator[maker][slot];
                    }
                
                    /// @notice Cancels order's quote
                    function cancelOrderRFQ(uint256 orderInfo) external {
                        _invalidateOrder(msg.sender, orderInfo);
                    }
                
                    /// @notice Fills order's quote, fully or partially (whichever is possible)
                    /// @param order Order quote to fill
                    /// @param signature Signature to confirm quote ownership
                    /// @param makingAmount Making amount
                    /// @param takingAmount Taking amount
                    function fillOrderRFQ(
                        OrderRFQ memory order,
                        bytes calldata signature,
                        uint256 makingAmount,
                        uint256 takingAmount
                    ) external payable returns(uint256 /* actualMakingAmount */, uint256 /* actualTakingAmount */) {
                        return fillOrderRFQTo(order, signature, makingAmount, takingAmount, payable(msg.sender));
                    }
                
                    /// @notice Fills Same as `fillOrderRFQ` but calls permit first,
                    /// allowing to approve token spending and make a swap in one transaction.
                    /// Also allows to specify funds destination instead of `msg.sender`
                    /// @param order Order quote to fill
                    /// @param signature Signature to confirm quote ownership
                    /// @param makingAmount Making amount
                    /// @param takingAmount Taking amount
                    /// @param target Address that will receive swap funds
                    /// @param permit Should consist of abiencoded token address and encoded `IERC20Permit.permit` call.
                    /// See tests for examples
                    function fillOrderRFQToWithPermit(
                        OrderRFQ memory order,
                        bytes calldata signature,
                        uint256 makingAmount,
                        uint256 takingAmount,
                        address payable target,
                        bytes calldata permit
                    ) external returns(uint256 /* actualMakingAmount */, uint256 /* actualTakingAmount */) {
                        _permit(address(order.takerAsset), permit);
                        return fillOrderRFQTo(order, signature, makingAmount, takingAmount, target);
                    }
                
                    /// @notice Same as `fillOrderRFQ` but allows to specify funds destination instead of `msg.sender`
                    /// @param order Order quote to fill
                    /// @param signature Signature to confirm quote ownership
                    /// @param makingAmount Making amount
                    /// @param takingAmount Taking amount
                    /// @param target Address that will receive swap funds
                    function fillOrderRFQTo(
                        OrderRFQ memory order,
                        bytes calldata signature,
                        uint256 makingAmount,
                        uint256 takingAmount,
                        address payable target
                    ) public payable returns(uint256 /* actualMakingAmount */, uint256 /* actualTakingAmount */) {
                        address maker = order.maker;
                        bool unwrapWETH = (order.info & _UNWRAP_WETH_MASK) > 0;
                        order.info = order.info & (_UNWRAP_WETH_MASK - 1);  // zero-out unwrap weth flag as it is taker-only
                        {  // Stack too deep
                            uint256 info = order.info;
                            // Check time expiration
                            uint256 expiration = uint128(info) >> 64;
                            require(expiration == 0 || block.timestamp <= expiration, "LOP: order expired");  // solhint-disable-line not-rely-on-time
                            _invalidateOrder(maker, info);
                        }
                
                        {  // stack too deep
                            uint256 orderMakingAmount = order.makingAmount;
                            uint256 orderTakingAmount = order.takingAmount;
                            // Compute partial fill if needed
                            if (takingAmount == 0 && makingAmount == 0) {
                                // Two zeros means whole order
                                makingAmount = orderMakingAmount;
                                takingAmount = orderTakingAmount;
                            }
                            else if (takingAmount == 0) {
                                require(makingAmount <= orderMakingAmount, "LOP: making amount exceeded");
                                takingAmount = orderTakingAmount.mul(makingAmount).add(orderMakingAmount - 1).div(orderMakingAmount);
                            }
                            else if (makingAmount == 0) {
                                require(takingAmount <= orderTakingAmount, "LOP: taking amount exceeded");
                                makingAmount = orderMakingAmount.mul(takingAmount).div(orderTakingAmount);
                            }
                            else {
                                revert("LOP: one of amounts should be 0");
                            }
                        }
                
                        require(makingAmount > 0 && takingAmount > 0, "LOP: can't swap 0 amount");
                
                        // Validate order
                        require(order.allowedSender == address(0) || order.allowedSender == msg.sender, "LOP: private order");
                        bytes32 orderHash = _hashTypedDataV4(keccak256(abi.encode(LIMIT_ORDER_RFQ_TYPEHASH, order)));
                        _validate(maker, orderHash, signature);
                
                        // Maker => Taker
                        if (order.makerAsset == _WETH && unwrapWETH) {
                            order.makerAsset.safeTransferFrom(maker, address(this), makingAmount);
                            _WETH.withdraw(makingAmount);
                            target.transfer(makingAmount);
                        } else {
                            order.makerAsset.safeTransferFrom(maker, target, makingAmount);
                        }
                        // Taker => Maker
                        if (order.takerAsset == _WETH && msg.value > 0) {
                            require(msg.value == takingAmount, "LOP: wrong msg.value");
                            _WETH.deposit{ value: takingAmount }();
                            _WETH.transfer(maker, takingAmount);
                        } else {
                            require(msg.value == 0, "LOP: wrong msg.value");
                            order.takerAsset.safeTransferFrom(msg.sender, maker, takingAmount);
                        }
                
                        emit OrderFilledRFQ(orderHash, makingAmount);
                        return (makingAmount, takingAmount);
                    }
                
                    function _validate(address signer, bytes32 orderHash, bytes calldata signature) private view {
                        if (ECDSA.tryRecover(orderHash, signature) != signer) {
                            (bool success, bytes memory result) = signer.staticcall(
                                abi.encodeWithSelector(IERC1271.isValidSignature.selector, orderHash, signature)
                            );
                            require(success && result.length == 32 && abi.decode(result, (bytes4)) == IERC1271.isValidSignature.selector, "LOP: bad signature");
                        }
                    }
                
                    function _invalidateOrder(address maker, uint256 orderInfo) private {
                        uint256 invalidatorSlot = uint64(orderInfo) >> 8;
                        uint256 invalidatorBit = 1 << uint8(orderInfo);
                        mapping(uint256 => uint256) storage invalidatorStorage = _invalidator[maker];
                        uint256 invalidator = invalidatorStorage[invalidatorSlot];
                        require(invalidator & invalidatorBit == 0, "LOP: invalidated order");
                        invalidatorStorage[invalidatorSlot] = invalidator | invalidatorBit;
                    }
                }
                
                
                // File contracts/UnoswapRouter.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                contract UnoswapRouter is EthReceiver, Permitable {
                    uint256 private constant _TRANSFER_FROM_CALL_SELECTOR_32 = 0x23b872dd00000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _WETH_DEPOSIT_CALL_SELECTOR_32 = 0xd0e30db000000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _WETH_WITHDRAW_CALL_SELECTOR_32 = 0x2e1a7d4d00000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _ERC20_TRANSFER_CALL_SELECTOR_32 = 0xa9059cbb00000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _ADDRESS_MASK =   0x000000000000000000000000ffffffffffffffffffffffffffffffffffffffff;
                    uint256 private constant _REVERSE_MASK =   0x8000000000000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _WETH_MASK =      0x4000000000000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _NUMERATOR_MASK = 0x0000000000000000ffffffff0000000000000000000000000000000000000000;
                    /// @dev WETH address is network-specific and needs to be changed before deployment.
                    /// It can not be moved to immutable as immutables are not supported in assembly
                    uint256 private constant _WETH = 0x000000000000000000000000C02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2;
                    uint256 private constant _UNISWAP_PAIR_RESERVES_CALL_SELECTOR_32 = 0x0902f1ac00000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _UNISWAP_PAIR_SWAP_CALL_SELECTOR_32 = 0x022c0d9f00000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _DENOMINATOR = 1000000000;
                    uint256 private constant _NUMERATOR_OFFSET = 160;
                
                    /// @notice Same as `unoswap` but calls permit first,
                    /// allowing to approve token spending and make a swap in one transaction.
                    /// @param srcToken Source token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param pools Pools chain used for swaps. Pools src and dst tokens should match to make swap happen
                    /// @param permit Should contain valid permit that can be used in `IERC20Permit.permit` calls.
                    /// See tests for examples
                    function unoswapWithPermit(
                        IERC20 srcToken,
                        uint256 amount,
                        uint256 minReturn,
                        bytes32[] calldata pools,
                        bytes calldata permit
                    ) external returns(uint256 returnAmount) {
                        _permit(address(srcToken), permit);
                        return unoswap(srcToken, amount, minReturn, pools);
                    }
                
                    /// @notice Performs swap using Uniswap exchange. Wraps and unwraps ETH if required.
                    /// Sending non-zero `msg.value` for anything but ETH swaps is prohibited
                    /// @param srcToken Source token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param pools Pools chain used for swaps. Pools src and dst tokens should match to make swap happen
                    function unoswap(
                        IERC20 srcToken,
                        uint256 amount,
                        uint256 minReturn,
                        // solhint-disable-next-line no-unused-vars
                        bytes32[] calldata pools
                    ) public payable returns(uint256 returnAmount) {
                        assembly {  // solhint-disable-line no-inline-assembly
                            function reRevert() {
                                returndatacopy(0, 0, returndatasize())
                                revert(0, returndatasize())
                            }
                
                            function revertWithReason(m, len) {
                                mstore(0, 0x08c379a000000000000000000000000000000000000000000000000000000000)
                                mstore(0x20, 0x0000002000000000000000000000000000000000000000000000000000000000)
                                mstore(0x40, m)
                                revert(0, len)
                            }
                
                            function swap(emptyPtr, swapAmount, pair, reversed, numerator, dst) -> ret {
                                mstore(emptyPtr, _UNISWAP_PAIR_RESERVES_CALL_SELECTOR_32)
                                if iszero(staticcall(gas(), pair, emptyPtr, 0x4, emptyPtr, 0x40)) {
                                    reRevert()
                                }
                                if iszero(eq(returndatasize(), 0x60)) {
                                    revertWithReason(0x0000001472657365727665732063616c6c206661696c65640000000000000000, 0x59)  // "reserves call failed"
                                }
                
                                let reserve0 := mload(emptyPtr)
                                let reserve1 := mload(add(emptyPtr, 0x20))
                                if reversed {
                                    let tmp := reserve0
                                    reserve0 := reserve1
                                    reserve1 := tmp
                                }
                                ret := mul(swapAmount, numerator)
                                ret := div(mul(ret, reserve1), add(ret, mul(reserve0, _DENOMINATOR)))
                
                                mstore(emptyPtr, _UNISWAP_PAIR_SWAP_CALL_SELECTOR_32)
                                switch reversed
                                case 0 {
                                    mstore(add(emptyPtr, 0x04), 0)
                                    mstore(add(emptyPtr, 0x24), ret)
                                }
                                default {
                                    mstore(add(emptyPtr, 0x04), ret)
                                    mstore(add(emptyPtr, 0x24), 0)
                                }
                                mstore(add(emptyPtr, 0x44), dst)
                                mstore(add(emptyPtr, 0x64), 0x80)
                                mstore(add(emptyPtr, 0x84), 0)
                                if iszero(call(gas(), pair, 0, emptyPtr, 0xa4, 0, 0)) {
                                    reRevert()
                                }
                            }
                
                            let emptyPtr := mload(0x40)
                            mstore(0x40, add(emptyPtr, 0xc0))
                
                            let poolsOffset := add(calldataload(0x64), 0x4)
                            let poolsEndOffset := calldataload(poolsOffset)
                            poolsOffset := add(poolsOffset, 0x20)
                            poolsEndOffset := add(poolsOffset, mul(0x20, poolsEndOffset))
                            let rawPair := calldataload(poolsOffset)
                            switch srcToken
                            case 0 {
                                if iszero(eq(amount, callvalue())) {
                                    revertWithReason(0x00000011696e76616c6964206d73672e76616c75650000000000000000000000, 0x55)  // "invalid msg.value"
                                }
                
                                mstore(emptyPtr, _WETH_DEPOSIT_CALL_SELECTOR_32)
                                if iszero(call(gas(), _WETH, amount, emptyPtr, 0x4, 0, 0)) {
                                    reRevert()
                                }
                
                                mstore(emptyPtr, _ERC20_TRANSFER_CALL_SELECTOR_32)
                                mstore(add(emptyPtr, 0x4), and(rawPair, _ADDRESS_MASK))
                                mstore(add(emptyPtr, 0x24), amount)
                                if iszero(call(gas(), _WETH, 0, emptyPtr, 0x44, 0, 0)) {
                                    reRevert()
                                }
                            }
                            default {
                                if callvalue() {
                                    revertWithReason(0x00000011696e76616c6964206d73672e76616c75650000000000000000000000, 0x55)  // "invalid msg.value"
                                }
                
                                mstore(emptyPtr, _TRANSFER_FROM_CALL_SELECTOR_32)
                                mstore(add(emptyPtr, 0x4), caller())
                                mstore(add(emptyPtr, 0x24), and(rawPair, _ADDRESS_MASK))
                                mstore(add(emptyPtr, 0x44), amount)
                                if iszero(call(gas(), srcToken, 0, emptyPtr, 0x64, 0, 0)) {
                                    reRevert()
                                }
                            }
                
                            returnAmount := amount
                
                            for {let i := add(poolsOffset, 0x20)} lt(i, poolsEndOffset) {i := add(i, 0x20)} {
                                let nextRawPair := calldataload(i)
                
                                returnAmount := swap(
                                    emptyPtr,
                                    returnAmount,
                                    and(rawPair, _ADDRESS_MASK),
                                    and(rawPair, _REVERSE_MASK),
                                    shr(_NUMERATOR_OFFSET, and(rawPair, _NUMERATOR_MASK)),
                                    and(nextRawPair, _ADDRESS_MASK)
                                )
                
                                rawPair := nextRawPair
                            }
                
                            switch and(rawPair, _WETH_MASK)
                            case 0 {
                                returnAmount := swap(
                                    emptyPtr,
                                    returnAmount,
                                    and(rawPair, _ADDRESS_MASK),
                                    and(rawPair, _REVERSE_MASK),
                                    shr(_NUMERATOR_OFFSET, and(rawPair, _NUMERATOR_MASK)),
                                    caller()
                                )
                            }
                            default {
                                returnAmount := swap(
                                    emptyPtr,
                                    returnAmount,
                                    and(rawPair, _ADDRESS_MASK),
                                    and(rawPair, _REVERSE_MASK),
                                    shr(_NUMERATOR_OFFSET, and(rawPair, _NUMERATOR_MASK)),
                                    address()
                                )
                
                                mstore(emptyPtr, _WETH_WITHDRAW_CALL_SELECTOR_32)
                                mstore(add(emptyPtr, 0x04), returnAmount)
                                if iszero(call(gas(), _WETH, 0, emptyPtr, 0x24, 0, 0)) {
                                    reRevert()
                                }
                
                                if iszero(call(gas(), caller(), returnAmount, 0, 0, 0, 0)) {
                                    reRevert()
                                }
                            }
                
                            if lt(returnAmount, minReturn) {
                                revertWithReason(0x000000164d696e2072657475726e206e6f742072656163686564000000000000, 0x5a)  // "Min return not reached"
                            }
                        }
                    }
                }
                
                
                // File @openzeppelin/contracts/utils/SafeCast.sol@v3.4.2-solc-0.7
                
                
                pragma solidity ^0.7.0;
                
                
                /**
                 * @dev Wrappers over Solidity's uintXX/intXX casting operators with added overflow
                 * checks.
                 *
                 * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can
                 * easily result in undesired exploitation or bugs, since developers usually
                 * assume that overflows raise errors. `SafeCast` restores this intuition by
                 * reverting the transaction when such an operation overflows.
                 *
                 * Using this library instead of the unchecked operations eliminates an entire
                 * class of bugs, so it's recommended to use it always.
                 *
                 * Can be combined with {SafeMath} and {SignedSafeMath} to extend it to smaller types, by performing
                 * all math on `uint256` and `int256` and then downcasting.
                 */
                library SafeCast {
                
                    /**
                     * @dev Returns the downcasted uint128 from uint256, reverting on
                     * overflow (when the input is greater than largest uint128).
                     *
                     * Counterpart to Solidity's `uint128` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 128 bits
                     */
                    function toUint128(uint256 value) internal pure returns (uint128) {
                        require(value < 2**128, "SafeCast: value doesn\'t fit in 128 bits");
                        return uint128(value);
                    }
                
                    /**
                     * @dev Returns the downcasted uint64 from uint256, reverting on
                     * overflow (when the input is greater than largest uint64).
                     *
                     * Counterpart to Solidity's `uint64` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 64 bits
                     */
                    function toUint64(uint256 value) internal pure returns (uint64) {
                        require(value < 2**64, "SafeCast: value doesn\'t fit in 64 bits");
                        return uint64(value);
                    }
                
                    /**
                     * @dev Returns the downcasted uint32 from uint256, reverting on
                     * overflow (when the input is greater than largest uint32).
                     *
                     * Counterpart to Solidity's `uint32` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 32 bits
                     */
                    function toUint32(uint256 value) internal pure returns (uint32) {
                        require(value < 2**32, "SafeCast: value doesn\'t fit in 32 bits");
                        return uint32(value);
                    }
                
                    /**
                     * @dev Returns the downcasted uint16 from uint256, reverting on
                     * overflow (when the input is greater than largest uint16).
                     *
                     * Counterpart to Solidity's `uint16` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 16 bits
                     */
                    function toUint16(uint256 value) internal pure returns (uint16) {
                        require(value < 2**16, "SafeCast: value doesn\'t fit in 16 bits");
                        return uint16(value);
                    }
                
                    /**
                     * @dev Returns the downcasted uint8 from uint256, reverting on
                     * overflow (when the input is greater than largest uint8).
                     *
                     * Counterpart to Solidity's `uint8` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 8 bits.
                     */
                    function toUint8(uint256 value) internal pure returns (uint8) {
                        require(value < 2**8, "SafeCast: value doesn\'t fit in 8 bits");
                        return uint8(value);
                    }
                
                    /**
                     * @dev Converts a signed int256 into an unsigned uint256.
                     *
                     * Requirements:
                     *
                     * - input must be greater than or equal to 0.
                     */
                    function toUint256(int256 value) internal pure returns (uint256) {
                        require(value >= 0, "SafeCast: value must be positive");
                        return uint256(value);
                    }
                
                    /**
                     * @dev Returns the downcasted int128 from int256, reverting on
                     * overflow (when the input is less than smallest int128 or
                     * greater than largest int128).
                     *
                     * Counterpart to Solidity's `int128` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 128 bits
                     *
                     * _Available since v3.1._
                     */
                    function toInt128(int256 value) internal pure returns (int128) {
                        require(value >= -2**127 && value < 2**127, "SafeCast: value doesn\'t fit in 128 bits");
                        return int128(value);
                    }
                
                    /**
                     * @dev Returns the downcasted int64 from int256, reverting on
                     * overflow (when the input is less than smallest int64 or
                     * greater than largest int64).
                     *
                     * Counterpart to Solidity's `int64` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 64 bits
                     *
                     * _Available since v3.1._
                     */
                    function toInt64(int256 value) internal pure returns (int64) {
                        require(value >= -2**63 && value < 2**63, "SafeCast: value doesn\'t fit in 64 bits");
                        return int64(value);
                    }
                
                    /**
                     * @dev Returns the downcasted int32 from int256, reverting on
                     * overflow (when the input is less than smallest int32 or
                     * greater than largest int32).
                     *
                     * Counterpart to Solidity's `int32` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 32 bits
                     *
                     * _Available since v3.1._
                     */
                    function toInt32(int256 value) internal pure returns (int32) {
                        require(value >= -2**31 && value < 2**31, "SafeCast: value doesn\'t fit in 32 bits");
                        return int32(value);
                    }
                
                    /**
                     * @dev Returns the downcasted int16 from int256, reverting on
                     * overflow (when the input is less than smallest int16 or
                     * greater than largest int16).
                     *
                     * Counterpart to Solidity's `int16` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 16 bits
                     *
                     * _Available since v3.1._
                     */
                    function toInt16(int256 value) internal pure returns (int16) {
                        require(value >= -2**15 && value < 2**15, "SafeCast: value doesn\'t fit in 16 bits");
                        return int16(value);
                    }
                
                    /**
                     * @dev Returns the downcasted int8 from int256, reverting on
                     * overflow (when the input is less than smallest int8 or
                     * greater than largest int8).
                     *
                     * Counterpart to Solidity's `int8` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 8 bits.
                     *
                     * _Available since v3.1._
                     */
                    function toInt8(int256 value) internal pure returns (int8) {
                        require(value >= -2**7 && value < 2**7, "SafeCast: value doesn\'t fit in 8 bits");
                        return int8(value);
                    }
                
                    /**
                     * @dev Converts an unsigned uint256 into a signed int256.
                     *
                     * Requirements:
                     *
                     * - input must be less than or equal to maxInt256.
                     */
                    function toInt256(uint256 value) internal pure returns (int256) {
                        require(value < 2**255, "SafeCast: value doesn't fit in an int256");
                        return int256(value);
                    }
                }
                
                
                // File contracts/interfaces/IUniswapV3Pool.sol
                
                pragma solidity ^0.7.6;
                
                interface IUniswapV3Pool {
                    /// @notice Swap token0 for token1, or token1 for token0
                    /// @dev The caller of this method receives a callback in the form of IUniswapV3SwapCallback#uniswapV3SwapCallback
                    /// @param recipient The address to receive the output of the swap
                    /// @param zeroForOne The direction of the swap, true for token0 to token1, false for token1 to token0
                    /// @param amountSpecified The amount of the swap, which implicitly configures the swap as exact input (positive), or exact output (negative)
                    /// @param sqrtPriceLimitX96 The Q64.96 sqrt price limit. If zero for one, the price cannot be less than this
                    /// value after the swap. If one for zero, the price cannot be greater than this value after the swap
                    /// @param data Any data to be passed through to the callback
                    /// @return amount0 The delta of the balance of token0 of the pool, exact when negative, minimum when positive
                    /// @return amount1 The delta of the balance of token1 of the pool, exact when negative, minimum when positive
                    function swap(
                        address recipient,
                        bool zeroForOne,
                        int256 amountSpecified,
                        uint160 sqrtPriceLimitX96,
                        bytes calldata data
                    ) external returns (int256 amount0, int256 amount1);
                
                    /// @notice The first of the two tokens of the pool, sorted by address
                    /// @return The token contract address
                    function token0() external view returns (address);
                
                    /// @notice The second of the two tokens of the pool, sorted by address
                    /// @return The token contract address
                    function token1() external view returns (address);
                
                    /// @notice The pool's fee in hundredths of a bip, i.e. 1e-6
                    /// @return The fee
                    function fee() external view returns (uint24);
                }
                
                
                // File contracts/interfaces/IUniswapV3SwapCallback.sol
                
                pragma solidity ^0.7.6;
                
                /// @title Callback for IUniswapV3PoolActions#swap
                /// @notice Any contract that calls IUniswapV3PoolActions#swap must implement this interface
                interface IUniswapV3SwapCallback {
                    /// @notice Called to `msg.sender` after executing a swap via IUniswapV3Pool#swap.
                    /// @dev In the implementation you must pay the pool tokens owed for the swap.
                    /// The caller of this method must be checked to be a UniswapV3Pool deployed by the canonical UniswapV3Factory.
                    /// amount0Delta and amount1Delta can both be 0 if no tokens were swapped.
                    /// @param amount0Delta The amount of token0 that was sent (negative) or must be received (positive) by the pool by
                    /// the end of the swap. If positive, the callback must send that amount of token0 to the pool.
                    /// @param amount1Delta The amount of token1 that was sent (negative) or must be received (positive) by the pool by
                    /// the end of the swap. If positive, the callback must send that amount of token1 to the pool.
                    /// @param data Any data passed through by the caller via the IUniswapV3PoolActions#swap call
                    function uniswapV3SwapCallback(
                        int256 amount0Delta,
                        int256 amount1Delta,
                        bytes calldata data
                    ) external;
                }
                
                
                // File contracts/UnoswapV3Router.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                
                
                
                
                
                
                contract UnoswapV3Router is EthReceiver, Permitable, IUniswapV3SwapCallback {
                    using Address for address payable;
                    using SafeERC20 for IERC20;
                    using SafeMath for uint256;
                
                    uint256 private constant _ONE_FOR_ZERO_MASK = 1 << 255;
                    uint256 private constant _WETH_WRAP_MASK = 1 << 254;
                    uint256 private constant _WETH_UNWRAP_MASK = 1 << 253;
                    bytes32 private constant _POOL_INIT_CODE_HASH = 0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54;
                    bytes32 private constant _FF_FACTORY = 0xff1F98431c8aD98523631AE4a59f267346ea31F9840000000000000000000000;
                    bytes32 private constant _SELECTORS = 0x0dfe1681d21220a7ddca3f430000000000000000000000000000000000000000;
                    uint256 private constant _ADDRESS_MASK =   0x000000000000000000000000ffffffffffffffffffffffffffffffffffffffff;
                    /// @dev The minimum value that can be returned from #getSqrtRatioAtTick. Equivalent to getSqrtRatioAtTick(MIN_TICK)
                    uint160 private constant _MIN_SQRT_RATIO = 4295128739 + 1;
                    /// @dev The maximum value that can be returned from #getSqrtRatioAtTick. Equivalent to getSqrtRatioAtTick(MAX_TICK)
                    uint160 private constant _MAX_SQRT_RATIO = 1461446703485210103287273052203988822378723970342 - 1;
                    IWETH private immutable _WETH;  // solhint-disable-line var-name-mixedcase
                
                    constructor(address weth) {
                        _WETH = IWETH(weth);
                    }
                
                    /// @notice Same as `uniswapV3SwapTo` but calls permit first,
                    /// allowing to approve token spending and make a swap in one transaction.
                    /// @param recipient Address that will receive swap funds
                    /// @param srcToken Source token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param pools Pools chain used for swaps. Pools src and dst tokens should match to make swap happen
                    /// @param permit Should contain valid permit that can be used in `IERC20Permit.permit` calls.
                    /// See tests for examples
                    function uniswapV3SwapToWithPermit(
                        address payable recipient,
                        IERC20 srcToken,
                        uint256 amount,
                        uint256 minReturn,
                        uint256[] calldata pools,
                        bytes calldata permit
                    ) external returns(uint256 returnAmount) {
                        _permit(address(srcToken), permit);
                        return uniswapV3SwapTo(recipient, amount, minReturn, pools);
                    }
                
                    /// @notice Same as `uniswapV3SwapTo` but uses `msg.sender` as recipient
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param pools Pools chain used for swaps. Pools src and dst tokens should match to make swap happen
                    function uniswapV3Swap(
                        uint256 amount,
                        uint256 minReturn,
                        uint256[] calldata pools
                    ) external payable returns(uint256 returnAmount) {
                        return uniswapV3SwapTo(msg.sender, amount, minReturn, pools);
                    }
                
                    /// @notice Performs swap using Uniswap V3 exchange. Wraps and unwraps ETH if required.
                    /// Sending non-zero `msg.value` for anything but ETH swaps is prohibited
                    /// @param recipient Address that will receive swap funds
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param pools Pools chain used for swaps. Pools src and dst tokens should match to make swap happen
                    function uniswapV3SwapTo(
                        address payable recipient,
                        uint256 amount,
                        uint256 minReturn,
                        uint256[] calldata pools
                    ) public payable returns(uint256 returnAmount) {
                        uint256 len = pools.length;
                        require(len > 0, "UNIV3R: empty pools");
                        uint256 lastIndex = len - 1;
                        returnAmount = amount;
                        bool wrapWeth = pools[0] & _WETH_WRAP_MASK > 0;
                        bool unwrapWeth = pools[lastIndex] & _WETH_UNWRAP_MASK > 0;
                        if (wrapWeth) {
                            require(msg.value == amount, "UNIV3R: wrong msg.value");
                            _WETH.deposit{value: amount}();
                        } else {
                            require(msg.value == 0, "UNIV3R: msg.value should be 0");
                        }
                        if (len > 1) {
                            returnAmount = _makeSwap(address(this), wrapWeth ? address(this) : msg.sender, pools[0], returnAmount);
                
                            for (uint256 i = 1; i < lastIndex; i++) {
                                returnAmount = _makeSwap(address(this), address(this), pools[i], returnAmount);
                            }
                            returnAmount = _makeSwap(unwrapWeth ? address(this) : recipient, address(this), pools[lastIndex], returnAmount);
                        } else {
                            returnAmount = _makeSwap(unwrapWeth ? address(this) : recipient, wrapWeth ? address(this) : msg.sender, pools[0], returnAmount);
                        }
                
                        require(returnAmount >= minReturn, "UNIV3R: min return");
                
                        if (unwrapWeth) {
                            _WETH.withdraw(returnAmount);
                            recipient.sendValue(returnAmount);
                        }
                    }
                
                    /// @inheritdoc IUniswapV3SwapCallback
                    function uniswapV3SwapCallback(
                        int256 amount0Delta,
                        int256 amount1Delta,
                        bytes calldata /* data */
                    ) external override {
                        IERC20 token0;
                        IERC20 token1;
                        bytes32 ffFactoryAddress = _FF_FACTORY;
                        bytes32 poolInitCodeHash = _POOL_INIT_CODE_HASH;
                        address payer;
                
                        assembly {  // solhint-disable-line no-inline-assembly
                            function reRevert() {
                                returndatacopy(0, 0, returndatasize())
                                revert(0, returndatasize())
                            }
                
                            function revertWithReason(m, len) {
                                mstore(0x00, 0x08c379a000000000000000000000000000000000000000000000000000000000)
                                mstore(0x20, 0x0000002000000000000000000000000000000000000000000000000000000000)
                                mstore(0x40, m)
                                revert(0, len)
                            }
                
                            let emptyPtr := mload(0x40)
                            let resultPtr := add(emptyPtr, 0x20)
                            mstore(emptyPtr, _SELECTORS)
                
                            if iszero(staticcall(gas(), caller(), emptyPtr, 0x4, resultPtr, 0x20)) {
                                reRevert()
                            }
                            token0 := mload(resultPtr)
                            if iszero(staticcall(gas(), caller(), add(emptyPtr, 0x4), 0x4, resultPtr, 0x20)) {
                                reRevert()
                            }
                            token1 := mload(resultPtr)
                            if iszero(staticcall(gas(), caller(), add(emptyPtr, 0x8), 0x4, resultPtr, 0x20)) {
                                reRevert()
                            }
                            let fee := mload(resultPtr)
                
                            let p := emptyPtr
                            mstore(p, ffFactoryAddress)
                            p := add(p, 21)
                            // Compute the inner hash in-place
                            mstore(p, token0)
                            mstore(add(p, 32), token1)
                            mstore(add(p, 64), fee)
                            mstore(p, keccak256(p, 96))
                            p := add(p, 32)
                            mstore(p, poolInitCodeHash)
                            let pool := and(keccak256(emptyPtr, 85), _ADDRESS_MASK)
                
                            if iszero(eq(pool, caller())) {
                                revertWithReason(0x00000010554e495633523a2062616420706f6f6c000000000000000000000000, 0x54)  // UNIV3R: bad pool
                            }
                
                            calldatacopy(emptyPtr, 0x84, 0x20)
                            payer := mload(emptyPtr)
                        }
                
                        if (amount0Delta > 0) {
                            if (payer == address(this)) {
                                token0.safeTransfer(msg.sender, uint256(amount0Delta));
                            } else {
                                token0.safeTransferFrom(payer, msg.sender, uint256(amount0Delta));
                            }
                        }
                        if (amount1Delta > 0) {
                            if (payer == address(this)) {
                                token1.safeTransfer(msg.sender, uint256(amount1Delta));
                            } else {
                                token1.safeTransferFrom(payer, msg.sender, uint256(amount1Delta));
                            }
                        }
                    }
                
                    function _makeSwap(address recipient, address payer, uint256 pool, uint256 amount) private returns (uint256) {
                        bool zeroForOne = pool & _ONE_FOR_ZERO_MASK == 0;
                        if (zeroForOne) {
                            (, int256 amount1) = IUniswapV3Pool(pool).swap(
                                recipient,
                                zeroForOne,
                                SafeCast.toInt256(amount),
                                _MIN_SQRT_RATIO,
                                abi.encode(payer)
                            );
                            return SafeCast.toUint256(-amount1);
                        } else {
                            (int256 amount0,) = IUniswapV3Pool(pool).swap(
                                recipient,
                                zeroForOne,
                                SafeCast.toInt256(amount),
                                _MAX_SQRT_RATIO,
                                abi.encode(payer)
                            );
                            return SafeCast.toUint256(-amount0);
                        }
                    }
                }
                
                
                // File contracts/interfaces/IClipperExchangeInterface.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Clipper interface subset used in swaps
                interface IClipperExchangeInterface {
                    function sellTokenForToken(IERC20 inputToken, IERC20 outputToken, address recipient, uint256 minBuyAmount, bytes calldata auxiliaryData) external returns (uint256 boughtAmount);
                    function sellEthForToken(IERC20 outputToken, address recipient, uint256 minBuyAmount, bytes calldata auxiliaryData) external payable returns (uint256 boughtAmount);
                    function sellTokenForEth(IERC20 inputToken, address payable recipient, uint256 minBuyAmount, bytes calldata auxiliaryData) external returns (uint256 boughtAmount);
                    function theExchange() external returns (address payable);
                }
                
                
                // File contracts/ClipperRouter.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                
                
                
                /// @title Clipper router that allows to use `ClipperExchangeInterface` for swaps
                contract ClipperRouter is EthReceiver, Permitable {
                    using SafeERC20 for IERC20;
                
                    IWETH private immutable _WETH;  // solhint-disable-line var-name-mixedcase
                    IERC20 private constant _ETH = IERC20(address(0));
                    bytes private constant _INCH_TAG = "1INCH";
                    IClipperExchangeInterface private immutable _clipperExchange;
                    address payable private immutable _clipperPool;
                
                    constructor(
                        address weth,
                        IClipperExchangeInterface clipperExchange
                    ) {
                        _clipperExchange = clipperExchange;
                        _clipperPool = clipperExchange.theExchange();
                        _WETH = IWETH(weth);
                    }
                
                    /// @notice Same as `clipperSwapTo` but calls permit first,
                    /// allowing to approve token spending and make a swap in one transaction.
                    /// @param recipient Address that will receive swap funds
                    /// @param srcToken Source token
                    /// @param dstToken Destination token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param permit Should contain valid permit that can be used in `IERC20Permit.permit` calls.
                    /// See tests for examples
                    function clipperSwapToWithPermit(
                        address payable recipient,
                        IERC20 srcToken,
                        IERC20 dstToken,
                        uint256 amount,
                        uint256 minReturn,
                        bytes calldata permit
                    ) external returns(uint256 returnAmount) {
                        _permit(address(srcToken), permit);
                        return clipperSwapTo(recipient, srcToken, dstToken, amount, minReturn);
                    }
                
                    /// @notice Same as `clipperSwapTo` but uses `msg.sender` as recipient
                    /// @param srcToken Source token
                    /// @param dstToken Destination token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    function clipperSwap(
                        IERC20 srcToken,
                        IERC20 dstToken,
                        uint256 amount,
                        uint256 minReturn
                    ) external payable returns(uint256 returnAmount) {
                        return clipperSwapTo(msg.sender, srcToken, dstToken, amount, minReturn);
                    }
                
                    /// @notice Performs swap using Clipper exchange. Wraps and unwraps ETH if required.
                    /// Sending non-zero `msg.value` for anything but ETH swaps is prohibited
                    /// @param recipient Address that will receive swap funds
                    /// @param srcToken Source token
                    /// @param dstToken Destination token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    function clipperSwapTo(
                        address payable recipient,
                        IERC20 srcToken,
                        IERC20 dstToken,
                        uint256 amount,
                        uint256 minReturn
                    ) public payable returns(uint256 returnAmount) {
                        bool srcETH;
                        if (srcToken == _WETH) {
                            require(msg.value == 0, "CL1IN: msg.value should be 0");
                            _WETH.transferFrom(msg.sender, address(this), amount);
                            _WETH.withdraw(amount);
                            srcETH = true;
                        }
                        else if (srcToken == _ETH) {
                            require(msg.value == amount, "CL1IN: wrong msg.value");
                            srcETH = true;
                        }
                        else {
                            require(msg.value == 0, "CL1IN: msg.value should be 0");
                            srcToken.safeTransferFrom(msg.sender, _clipperPool, amount);
                        }
                
                        if (srcETH) {
                            _clipperPool.transfer(amount);
                            returnAmount = _clipperExchange.sellEthForToken(dstToken, recipient, minReturn, _INCH_TAG);
                        } else if (dstToken == _WETH) {
                            returnAmount = _clipperExchange.sellTokenForEth(srcToken, address(this), minReturn, _INCH_TAG);
                            _WETH.deposit{ value: returnAmount }();
                            _WETH.transfer(recipient, returnAmount);
                        } else if (dstToken == _ETH) {
                            returnAmount = _clipperExchange.sellTokenForEth(srcToken, recipient, minReturn, _INCH_TAG);
                        } else {
                            returnAmount = _clipperExchange.sellTokenForToken(srcToken, dstToken, recipient, minReturn, _INCH_TAG);
                        }
                    }
                }
                
                
                // File contracts/AggregationRouterV4.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                contract AggregationRouterV4 is Ownable, EthReceiver, Permitable, UnoswapRouter, UnoswapV3Router, LimitOrderProtocolRFQ, ClipperRouter {
                    using SafeMath for uint256;
                    using UniERC20 for IERC20;
                    using SafeERC20 for IERC20;
                
                    uint256 private constant _PARTIAL_FILL = 1 << 0;
                    uint256 private constant _REQUIRES_EXTRA_ETH = 1 << 1;
                
                    struct SwapDescription {
                        IERC20 srcToken;
                        IERC20 dstToken;
                        address payable srcReceiver;
                        address payable dstReceiver;
                        uint256 amount;
                        uint256 minReturnAmount;
                        uint256 flags;
                        bytes permit;
                    }
                
                    constructor(address weth, IClipperExchangeInterface _clipperExchange)
                        UnoswapV3Router(weth)
                        LimitOrderProtocolRFQ(weth)
                        ClipperRouter(weth, _clipperExchange)
                    {}  // solhint-disable-line no-empty-blocks
                
                    /// @notice Performs a swap, delegating all calls encoded in `data` to `caller`. See tests for usage examples
                    /// @param caller Aggregation executor that executes calls described in `data`
                    /// @param desc Swap description
                    /// @param data Encoded calls that `caller` should execute in between of swaps
                    /// @return returnAmount Resulting token amount
                    /// @return spentAmount Source token amount
                    /// @return gasLeft Gas left
                    function swap(
                        IAggregationExecutor caller,
                        SwapDescription calldata desc,
                        bytes calldata data
                    )
                        external
                        payable
                        returns (
                            uint256 returnAmount,
                            uint256 spentAmount,
                            uint256 gasLeft
                        )
                    {
                        require(desc.minReturnAmount > 0, "Min return should not be 0");
                        require(data.length > 0, "data should not be empty");
                
                        uint256 flags = desc.flags;
                        IERC20 srcToken = desc.srcToken;
                        IERC20 dstToken = desc.dstToken;
                
                        bool srcETH = srcToken.isETH();
                        if (flags & _REQUIRES_EXTRA_ETH != 0) {
                            require(msg.value > (srcETH ? desc.amount : 0), "Invalid msg.value");
                        } else {
                            require(msg.value == (srcETH ? desc.amount : 0), "Invalid msg.value");
                        }
                
                        if (!srcETH) {
                            _permit(address(srcToken), desc.permit);
                            srcToken.safeTransferFrom(msg.sender, desc.srcReceiver, desc.amount);
                        }
                
                        {
                            bytes memory callData = abi.encodePacked(caller.callBytes.selector, bytes12(0), msg.sender, data);
                            // solhint-disable-next-line avoid-low-level-calls
                            (bool success, bytes memory result) = address(caller).call{value: msg.value}(callData);
                            if (!success) {
                                revert(RevertReasonParser.parse(result, "callBytes failed: "));
                            }
                        }
                
                        spentAmount = desc.amount;
                        returnAmount = dstToken.uniBalanceOf(address(this));
                
                        if (flags & _PARTIAL_FILL != 0) {
                            uint256 unspentAmount = srcToken.uniBalanceOf(address(this));
                            if (unspentAmount > 0) {
                                spentAmount = spentAmount.sub(unspentAmount);
                                srcToken.uniTransfer(msg.sender, unspentAmount);
                            }
                            require(returnAmount.mul(desc.amount) >= desc.minReturnAmount.mul(spentAmount), "Return amount is not enough");
                        } else {
                            require(returnAmount >= desc.minReturnAmount, "Return amount is not enough");
                        }
                
                        address payable dstReceiver = (desc.dstReceiver == address(0)) ? msg.sender : desc.dstReceiver;
                        dstToken.uniTransfer(dstReceiver, returnAmount);
                
                        gasLeft = gasleft();
                    }
                
                    function rescueFunds(IERC20 token, uint256 amount) external onlyOwner {
                        token.uniTransfer(msg.sender, amount);
                    }
                
                    function destroy() external onlyOwner {
                        selfdestruct(msg.sender);
                    }
                }

                File 4 of 5: Proxy
                pragma solidity ^0.5.3;
                
                /// @title Proxy - Generic proxy contract allows to execute all transactions applying the code of a master contract.
                /// @author Stefan George - <stefan@gnosis.io>
                /// @author Richard Meissner - <richard@gnosis.io>
                contract Proxy {
                
                    // masterCopy always needs to be first declared variable, to ensure that it is at the same location in the contracts to which calls are delegated.
                    // To reduce deployment costs this variable is internal and needs to be retrieved via `getStorageAt`
                    address internal masterCopy;
                
                    /// @dev Constructor function sets address of master copy contract.
                    /// @param _masterCopy Master copy address.
                    constructor(address _masterCopy)
                        public
                    {
                        require(_masterCopy != address(0), "Invalid master copy address provided");
                        masterCopy = _masterCopy;
                    }
                
                    /// @dev Fallback function forwards all transactions and returns all received return data.
                    function ()
                        external
                        payable
                    {
                        // solium-disable-next-line security/no-inline-assembly
                        assembly {
                            let masterCopy := and(sload(0), 0xffffffffffffffffffffffffffffffffffffffff)
                            // 0xa619486e == keccak("masterCopy()"). The value is right padded to 32-bytes with 0s
                            if eq(calldataload(0), 0xa619486e00000000000000000000000000000000000000000000000000000000) {
                                mstore(0, masterCopy)
                                return(0, 0x20)
                            }
                            calldatacopy(0, 0, calldatasize())
                            let success := delegatecall(gas, masterCopy, 0, calldatasize(), 0, 0)
                            returndatacopy(0, 0, returndatasize())
                            if eq(success, 0) { revert(0, returndatasize()) }
                            return(0, returndatasize())
                        }
                    }
                }

                File 5 of 5: GnosisSafe
                pragma solidity >=0.5.0 <0.7.0;
                
                /// @title SelfAuthorized - authorizes current contract to perform actions
                /// @author Richard Meissner - <richard@gnosis.pm>
                contract SelfAuthorized {
                    modifier authorized() {
                        require(msg.sender == address(this), "Method can only be called from this contract");
                        _;
                    }
                }
                
                
                
                /// @title MasterCopy - Base for master copy contracts (should always be first super contract)
                ///         This contract is tightly coupled to our proxy contract (see `proxies/Proxy.sol`)
                /// @author Richard Meissner - <richard@gnosis.io>
                contract MasterCopy is SelfAuthorized {
                
                    event ChangedMasterCopy(address masterCopy);
                
                    // masterCopy always needs to be first declared variable, to ensure that it is at the same location as in the Proxy contract.
                    // It should also always be ensured that the address is stored alone (uses a full word)
                    address private masterCopy;
                
                    /// @dev Allows to upgrade the contract. This can only be done via a Safe transaction.
                    /// @param _masterCopy New contract address.
                    function changeMasterCopy(address _masterCopy)
                        public
                        authorized
                    {
                        // Master copy address cannot be null.
                        require(_masterCopy != address(0), "Invalid master copy address provided");
                        masterCopy = _masterCopy;
                        emit ChangedMasterCopy(_masterCopy);
                    }
                }
                
                
                /// @title Module - Base class for modules.
                /// @author Stefan George - <stefan@gnosis.pm>
                /// @author Richard Meissner - <richard@gnosis.pm>
                contract Module is MasterCopy {
                
                    ModuleManager public manager;
                
                    modifier authorized() {
                        require(msg.sender == address(manager), "Method can only be called from manager");
                        _;
                    }
                
                    function setManager()
                        internal
                    {
                        // manager can only be 0 at initalization of contract.
                        // Check ensures that setup function can only be called once.
                        require(address(manager) == address(0), "Manager has already been set");
                        manager = ModuleManager(msg.sender);
                    }
                }
                
                
                
                
                
                /// @title Enum - Collection of enums
                /// @author Richard Meissner - <richard@gnosis.pm>
                contract Enum {
                    enum Operation {
                        Call,
                        DelegateCall
                    }
                }
                
                
                
                
                
                /// @title Executor - A contract that can execute transactions
                /// @author Richard Meissner - <richard@gnosis.pm>
                contract Executor {
                
                    function execute(address to, uint256 value, bytes memory data, Enum.Operation operation, uint256 txGas)
                        internal
                        returns (bool success)
                    {
                        if (operation == Enum.Operation.Call)
                            success = executeCall(to, value, data, txGas);
                        else if (operation == Enum.Operation.DelegateCall)
                            success = executeDelegateCall(to, data, txGas);
                        else
                            success = false;
                    }
                
                    function executeCall(address to, uint256 value, bytes memory data, uint256 txGas)
                        internal
                        returns (bool success)
                    {
                        // solium-disable-next-line security/no-inline-assembly
                        assembly {
                            success := call(txGas, to, value, add(data, 0x20), mload(data), 0, 0)
                        }
                    }
                
                    function executeDelegateCall(address to, bytes memory data, uint256 txGas)
                        internal
                        returns (bool success)
                    {
                        // solium-disable-next-line security/no-inline-assembly
                        assembly {
                            success := delegatecall(txGas, to, add(data, 0x20), mload(data), 0, 0)
                        }
                    }
                }
                
                
                
                /// @title SecuredTokenTransfer - Secure token transfer
                /// @author Richard Meissner - <richard@gnosis.pm>
                contract SecuredTokenTransfer {
                
                    /// @dev Transfers a token and returns if it was a success
                    /// @param token Token that should be transferred
                    /// @param receiver Receiver to whom the token should be transferred
                    /// @param amount The amount of tokens that should be transferred
                    function transferToken (
                        address token,
                        address receiver,
                        uint256 amount
                    )
                        internal
                        returns (bool transferred)
                    {
                        bytes memory data = abi.encodeWithSignature("transfer(address,uint256)", receiver, amount);
                        // solium-disable-next-line security/no-inline-assembly
                        assembly {
                            let success := call(sub(gas, 10000), token, 0, add(data, 0x20), mload(data), 0, 0)
                            let ptr := mload(0x40)
                            mstore(0x40, add(ptr, returndatasize()))
                            returndatacopy(ptr, 0, returndatasize())
                            switch returndatasize()
                            case 0 { transferred := success }
                            case 0x20 { transferred := iszero(or(iszero(success), iszero(mload(ptr)))) }
                            default { transferred := 0 }
                        }
                    }
                }
                
                
                
                
                
                
                
                
                
                
                /// @title Module Manager - A contract that manages modules that can execute transactions via this contract
                /// @author Stefan George - <stefan@gnosis.pm>
                /// @author Richard Meissner - <richard@gnosis.pm>
                contract ModuleManager is SelfAuthorized, Executor {
                
                    event EnabledModule(Module module);
                    event DisabledModule(Module module);
                    event ExecutionFromModuleSuccess(address indexed module);
                    event ExecutionFromModuleFailure(address indexed module);
                
                    address internal constant SENTINEL_MODULES = address(0x1);
                
                    mapping (address => address) internal modules;
                
                    function setupModules(address to, bytes memory data)
                        internal
                    {
                        require(modules[SENTINEL_MODULES] == address(0), "Modules have already been initialized");
                        modules[SENTINEL_MODULES] = SENTINEL_MODULES;
                        if (to != address(0))
                            // Setup has to complete successfully or transaction fails.
                            require(executeDelegateCall(to, data, gasleft()), "Could not finish initialization");
                    }
                
                    /// @dev Allows to add a module to the whitelist.
                    ///      This can only be done via a Safe transaction.
                    /// @param module Module to be whitelisted.
                    function enableModule(Module module)
                        public
                        authorized
                    {
                        // Module address cannot be null or sentinel.
                        require(address(module) != address(0) && address(module) != SENTINEL_MODULES, "Invalid module address provided");
                        // Module cannot be added twice.
                        require(modules[address(module)] == address(0), "Module has already been added");
                        modules[address(module)] = modules[SENTINEL_MODULES];
                        modules[SENTINEL_MODULES] = address(module);
                        emit EnabledModule(module);
                    }
                
                    /// @dev Allows to remove a module from the whitelist.
                    ///      This can only be done via a Safe transaction.
                    /// @param prevModule Module that pointed to the module to be removed in the linked list
                    /// @param module Module to be removed.
                    function disableModule(Module prevModule, Module module)
                        public
                        authorized
                    {
                        // Validate module address and check that it corresponds to module index.
                        require(address(module) != address(0) && address(module) != SENTINEL_MODULES, "Invalid module address provided");
                        require(modules[address(prevModule)] == address(module), "Invalid prevModule, module pair provided");
                        modules[address(prevModule)] = modules[address(module)];
                        modules[address(module)] = address(0);
                        emit DisabledModule(module);
                    }
                
                    /// @dev Allows a Module to execute a Safe transaction without any further confirmations.
                    /// @param to Destination address of module transaction.
                    /// @param value Ether value of module transaction.
                    /// @param data Data payload of module transaction.
                    /// @param operation Operation type of module transaction.
                    function execTransactionFromModule(address to, uint256 value, bytes memory data, Enum.Operation operation)
                        public
                        returns (bool success)
                    {
                        // Only whitelisted modules are allowed.
                        require(msg.sender != SENTINEL_MODULES && modules[msg.sender] != address(0), "Method can only be called from an enabled module");
                        // Execute transaction without further confirmations.
                        success = execute(to, value, data, operation, gasleft());
                        if (success) emit ExecutionFromModuleSuccess(msg.sender);
                        else emit ExecutionFromModuleFailure(msg.sender);
                    }
                
                    /// @dev Allows a Module to execute a Safe transaction without any further confirmations and return data
                    /// @param to Destination address of module transaction.
                    /// @param value Ether value of module transaction.
                    /// @param data Data payload of module transaction.
                    /// @param operation Operation type of module transaction.
                    function execTransactionFromModuleReturnData(address to, uint256 value, bytes memory data, Enum.Operation operation)
                        public
                        returns (bool success, bytes memory returnData)
                    {
                        success = execTransactionFromModule(to, value, data, operation);
                        // solium-disable-next-line security/no-inline-assembly
                        assembly {
                            // Load free memory location
                            let ptr := mload(0x40)
                            // We allocate memory for the return data by setting the free memory location to
                            // current free memory location + data size + 32 bytes for data size value
                            mstore(0x40, add(ptr, add(returndatasize(), 0x20)))
                            // Store the size
                            mstore(ptr, returndatasize())
                            // Store the data
                            returndatacopy(add(ptr, 0x20), 0, returndatasize())
                            // Point the return data to the correct memory location
                            returnData := ptr
                        }
                    }
                
                    /// @dev Returns array of first 10 modules.
                    /// @return Array of modules.
                    function getModules()
                        public
                        view
                        returns (address[] memory)
                    {
                        (address[] memory array,) = getModulesPaginated(SENTINEL_MODULES, 10);
                        return array;
                    }
                
                    /// @dev Returns array of modules.
                    /// @param start Start of the page.
                    /// @param pageSize Maximum number of modules that should be returned.
                    /// @return Array of modules.
                    function getModulesPaginated(address start, uint256 pageSize)
                        public
                        view
                        returns (address[] memory array, address next)
                    {
                        // Init array with max page size
                        array = new address[](pageSize);
                
                        // Populate return array
                        uint256 moduleCount = 0;
                        address currentModule = modules[start];
                        while(currentModule != address(0x0) && currentModule != SENTINEL_MODULES && moduleCount < pageSize) {
                            array[moduleCount] = currentModule;
                            currentModule = modules[currentModule];
                            moduleCount++;
                        }
                        next = currentModule;
                        // Set correct size of returned array
                        // solium-disable-next-line security/no-inline-assembly
                        assembly {
                            mstore(array, moduleCount)
                        }
                    }
                }
                
                
                
                
                /// @title OwnerManager - Manages a set of owners and a threshold to perform actions.
                /// @author Stefan George - <stefan@gnosis.pm>
                /// @author Richard Meissner - <richard@gnosis.pm>
                contract OwnerManager is SelfAuthorized {
                
                    event AddedOwner(address owner);
                    event RemovedOwner(address owner);
                    event ChangedThreshold(uint256 threshold);
                
                    address internal constant SENTINEL_OWNERS = address(0x1);
                
                    mapping(address => address) internal owners;
                    uint256 ownerCount;
                    uint256 internal threshold;
                
                    /// @dev Setup function sets initial storage of contract.
                    /// @param _owners List of Safe owners.
                    /// @param _threshold Number of required confirmations for a Safe transaction.
                    function setupOwners(address[] memory _owners, uint256 _threshold)
                        internal
                    {
                        // Threshold can only be 0 at initialization.
                        // Check ensures that setup function can only be called once.
                        require(threshold == 0, "Owners have already been setup");
                        // Validate that threshold is smaller than number of added owners.
                        require(_threshold <= _owners.length, "Threshold cannot exceed owner count");
                        // There has to be at least one Safe owner.
                        require(_threshold >= 1, "Threshold needs to be greater than 0");
                        // Initializing Safe owners.
                        address currentOwner = SENTINEL_OWNERS;
                        for (uint256 i = 0; i < _owners.length; i++) {
                            // Owner address cannot be null.
                            address owner = _owners[i];
                            require(owner != address(0) && owner != SENTINEL_OWNERS, "Invalid owner address provided");
                            // No duplicate owners allowed.
                            require(owners[owner] == address(0), "Duplicate owner address provided");
                            owners[currentOwner] = owner;
                            currentOwner = owner;
                        }
                        owners[currentOwner] = SENTINEL_OWNERS;
                        ownerCount = _owners.length;
                        threshold = _threshold;
                    }
                
                    /// @dev Allows to add a new owner to the Safe and update the threshold at the same time.
                    ///      This can only be done via a Safe transaction.
                    /// @param owner New owner address.
                    /// @param _threshold New threshold.
                    function addOwnerWithThreshold(address owner, uint256 _threshold)
                        public
                        authorized
                    {
                        // Owner address cannot be null.
                        require(owner != address(0) && owner != SENTINEL_OWNERS, "Invalid owner address provided");
                        // No duplicate owners allowed.
                        require(owners[owner] == address(0), "Address is already an owner");
                        owners[owner] = owners[SENTINEL_OWNERS];
                        owners[SENTINEL_OWNERS] = owner;
                        ownerCount++;
                        emit AddedOwner(owner);
                        // Change threshold if threshold was changed.
                        if (threshold != _threshold)
                            changeThreshold(_threshold);
                    }
                
                    /// @dev Allows to remove an owner from the Safe and update the threshold at the same time.
                    ///      This can only be done via a Safe transaction.
                    /// @param prevOwner Owner that pointed to the owner to be removed in the linked list
                    /// @param owner Owner address to be removed.
                    /// @param _threshold New threshold.
                    function removeOwner(address prevOwner, address owner, uint256 _threshold)
                        public
                        authorized
                    {
                        // Only allow to remove an owner, if threshold can still be reached.
                        require(ownerCount - 1 >= _threshold, "New owner count needs to be larger than new threshold");
                        // Validate owner address and check that it corresponds to owner index.
                        require(owner != address(0) && owner != SENTINEL_OWNERS, "Invalid owner address provided");
                        require(owners[prevOwner] == owner, "Invalid prevOwner, owner pair provided");
                        owners[prevOwner] = owners[owner];
                        owners[owner] = address(0);
                        ownerCount--;
                        emit RemovedOwner(owner);
                        // Change threshold if threshold was changed.
                        if (threshold != _threshold)
                            changeThreshold(_threshold);
                    }
                
                    /// @dev Allows to swap/replace an owner from the Safe with another address.
                    ///      This can only be done via a Safe transaction.
                    /// @param prevOwner Owner that pointed to the owner to be replaced in the linked list
                    /// @param oldOwner Owner address to be replaced.
                    /// @param newOwner New owner address.
                    function swapOwner(address prevOwner, address oldOwner, address newOwner)
                        public
                        authorized
                    {
                        // Owner address cannot be null.
                        require(newOwner != address(0) && newOwner != SENTINEL_OWNERS, "Invalid owner address provided");
                        // No duplicate owners allowed.
                        require(owners[newOwner] == address(0), "Address is already an owner");
                        // Validate oldOwner address and check that it corresponds to owner index.
                        require(oldOwner != address(0) && oldOwner != SENTINEL_OWNERS, "Invalid owner address provided");
                        require(owners[prevOwner] == oldOwner, "Invalid prevOwner, owner pair provided");
                        owners[newOwner] = owners[oldOwner];
                        owners[prevOwner] = newOwner;
                        owners[oldOwner] = address(0);
                        emit RemovedOwner(oldOwner);
                        emit AddedOwner(newOwner);
                    }
                
                    /// @dev Allows to update the number of required confirmations by Safe owners.
                    ///      This can only be done via a Safe transaction.
                    /// @param _threshold New threshold.
                    function changeThreshold(uint256 _threshold)
                        public
                        authorized
                    {
                        // Validate that threshold is smaller than number of owners.
                        require(_threshold <= ownerCount, "Threshold cannot exceed owner count");
                        // There has to be at least one Safe owner.
                        require(_threshold >= 1, "Threshold needs to be greater than 0");
                        threshold = _threshold;
                        emit ChangedThreshold(threshold);
                    }
                
                    function getThreshold()
                        public
                        view
                        returns (uint256)
                    {
                        return threshold;
                    }
                
                    function isOwner(address owner)
                        public
                        view
                        returns (bool)
                    {
                        return owner != SENTINEL_OWNERS && owners[owner] != address(0);
                    }
                
                    /// @dev Returns array of owners.
                    /// @return Array of Safe owners.
                    function getOwners()
                        public
                        view
                        returns (address[] memory)
                    {
                        address[] memory array = new address[](ownerCount);
                
                        // populate return array
                        uint256 index = 0;
                        address currentOwner = owners[SENTINEL_OWNERS];
                        while(currentOwner != SENTINEL_OWNERS) {
                            array[index] = currentOwner;
                            currentOwner = owners[currentOwner];
                            index ++;
                        }
                        return array;
                    }
                }
                
                
                
                
                
                /// @title Fallback Manager - A contract that manages fallback calls made to this contract
                /// @author Richard Meissner - <richard@gnosis.pm>
                contract FallbackManager is SelfAuthorized {
                
                    // keccak256("fallback_manager.handler.address")
                    bytes32 internal constant FALLBACK_HANDLER_STORAGE_SLOT = 0x6c9a6c4a39284e37ed1cf53d337577d14212a4870fb976a4366c693b939918d5;
                
                    function internalSetFallbackHandler(address handler) internal {
                        bytes32 slot = FALLBACK_HANDLER_STORAGE_SLOT;
                        // solium-disable-next-line security/no-inline-assembly
                        assembly {
                            sstore(slot, handler)
                        }
                    }
                
                    /// @dev Allows to add a contract to handle fallback calls.
                    ///      Only fallback calls without value and with data will be forwarded.
                    ///      This can only be done via a Safe transaction.
                    /// @param handler contract to handle fallbacks calls.
                    function setFallbackHandler(address handler)
                        public
                        authorized
                    {
                        internalSetFallbackHandler(handler);
                    }
                
                    function ()
                        external
                        payable
                    {
                        // Only calls without value and with data will be forwarded
                        if (msg.value > 0 || msg.data.length == 0) {
                            return;
                        }
                        bytes32 slot = FALLBACK_HANDLER_STORAGE_SLOT;
                        address handler;
                        // solium-disable-next-line security/no-inline-assembly
                        assembly {
                            handler := sload(slot)
                        }
                
                        if (handler != address(0)) {
                            // solium-disable-next-line security/no-inline-assembly
                            assembly {
                                calldatacopy(0, 0, calldatasize())
                                let success := call(gas, handler, 0, 0, calldatasize(), 0, 0)
                                returndatacopy(0, 0, returndatasize())
                                if eq(success, 0) { revert(0, returndatasize()) }
                                return(0, returndatasize())
                            }
                        }
                    }
                }
                
                
                
                
                
                
                
                /// @title SignatureDecoder - Decodes signatures that a encoded as bytes
                /// @author Ricardo Guilherme Schmidt (Status Research & Development GmbH)
                /// @author Richard Meissner - <richard@gnosis.pm>
                contract SignatureDecoder {
                    
                    /// @dev Recovers address who signed the message
                    /// @param messageHash operation ethereum signed message hash
                    /// @param messageSignature message `txHash` signature
                    /// @param pos which signature to read
                    function recoverKey (
                        bytes32 messageHash,
                        bytes memory messageSignature,
                        uint256 pos
                    )
                        internal
                        pure
                        returns (address)
                    {
                        uint8 v;
                        bytes32 r;
                        bytes32 s;
                        (v, r, s) = signatureSplit(messageSignature, pos);
                        return ecrecover(messageHash, v, r, s);
                    }
                
                    /// @dev divides bytes signature into `uint8 v, bytes32 r, bytes32 s`.
                    /// @notice Make sure to peform a bounds check for @param pos, to avoid out of bounds access on @param signatures
                    /// @param pos which signature to read. A prior bounds check of this parameter should be performed, to avoid out of bounds access
                    /// @param signatures concatenated rsv signatures
                    function signatureSplit(bytes memory signatures, uint256 pos)
                        internal
                        pure
                        returns (uint8 v, bytes32 r, bytes32 s)
                    {
                        // The signature format is a compact form of:
                        //   {bytes32 r}{bytes32 s}{uint8 v}
                        // Compact means, uint8 is not padded to 32 bytes.
                        // solium-disable-next-line security/no-inline-assembly
                        assembly {
                            let signaturePos := mul(0x41, pos)
                            r := mload(add(signatures, add(signaturePos, 0x20)))
                            s := mload(add(signatures, add(signaturePos, 0x40)))
                            // Here we are loading the last 32 bytes, including 31 bytes
                            // of 's'. There is no 'mload8' to do this.
                            //
                            // 'byte' is not working due to the Solidity parser, so lets
                            // use the second best option, 'and'
                            v := and(mload(add(signatures, add(signaturePos, 0x41))), 0xff)
                        }
                    }
                }
                
                
                
                
                contract ISignatureValidatorConstants {
                    // bytes4(keccak256("isValidSignature(bytes,bytes)")
                    bytes4 constant internal EIP1271_MAGIC_VALUE = 0x20c13b0b;
                }
                
                contract ISignatureValidator is ISignatureValidatorConstants {
                
                    /**
                    * @dev Should return whether the signature provided is valid for the provided data
                    * @param _data Arbitrary length data signed on the behalf of address(this)
                    * @param _signature Signature byte array associated with _data
                    *
                    * MUST return the bytes4 magic value 0x20c13b0b when function passes.
                    * MUST NOT modify state (using STATICCALL for solc < 0.5, view modifier for solc > 0.5)
                    * MUST allow external calls
                    */
                    function isValidSignature(
                        bytes memory _data,
                        bytes memory _signature)
                        public
                        view
                        returns (bytes4);
                }
                
                
                /**
                 * @title SafeMath
                 * @dev Math operations with safety checks that revert on error
                 * TODO: remove once open zeppelin update to solc 0.5.0
                 */
                library SafeMath {
                
                  /**
                  * @dev Multiplies two numbers, reverts on 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-solidity/pull/522
                    if (a == 0) {
                      return 0;
                    }
                
                    uint256 c = a * b;
                    require(c / a == b);
                
                    return c;
                  }
                
                  /**
                  * @dev Integer division of two numbers truncating the quotient, reverts on division by zero.
                  */
                  function div(uint256 a, uint256 b) internal pure returns (uint256) {
                    require(b > 0); // Solidity only automatically asserts when dividing by 0
                    uint256 c = a / b;
                    // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                
                    return c;
                  }
                
                  /**
                  * @dev Subtracts two numbers, reverts on overflow (i.e. if subtrahend is greater than minuend).
                  */
                  function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                    require(b <= a);
                    uint256 c = a - b;
                
                    return c;
                  }
                
                  /**
                  * @dev Adds two numbers, reverts on overflow.
                  */
                  function add(uint256 a, uint256 b) internal pure returns (uint256) {
                    uint256 c = a + b;
                    require(c >= a);
                
                    return c;
                  }
                
                  /**
                  * @dev Divides two numbers and returns the remainder (unsigned integer modulo),
                  * reverts when dividing by zero.
                  */
                  function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                    require(b != 0);
                    return a % b;
                  }
                }
                
                /// @title Gnosis Safe - A multisignature wallet with support for confirmations using signed messages based on ERC191.
                /// @author Stefan George - <stefan@gnosis.io>
                /// @author Richard Meissner - <richard@gnosis.io>
                /// @author Ricardo Guilherme Schmidt - (Status Research & Development GmbH) - Gas Token Payment
                contract GnosisSafe
                    is MasterCopy, ModuleManager, OwnerManager, SignatureDecoder, SecuredTokenTransfer, ISignatureValidatorConstants, FallbackManager {
                
                    using SafeMath for uint256;
                
                    string public constant NAME = "Gnosis Safe";
                    string public constant VERSION = "1.1.1";
                
                    //keccak256(
                    //    "EIP712Domain(address verifyingContract)"
                    //);
                    bytes32 private constant DOMAIN_SEPARATOR_TYPEHASH = 0x035aff83d86937d35b32e04f0ddc6ff469290eef2f1b692d8a815c89404d4749;
                
                    //keccak256(
                    //    "SafeTx(address to,uint256 value,bytes data,uint8 operation,uint256 safeTxGas,uint256 baseGas,uint256 gasPrice,address gasToken,address refundReceiver,uint256 nonce)"
                    //);
                    bytes32 private constant SAFE_TX_TYPEHASH = 0xbb8310d486368db6bd6f849402fdd73ad53d316b5a4b2644ad6efe0f941286d8;
                
                    //keccak256(
                    //    "SafeMessage(bytes message)"
                    //);
                    bytes32 private constant SAFE_MSG_TYPEHASH = 0x60b3cbf8b4a223d68d641b3b6ddf9a298e7f33710cf3d3a9d1146b5a6150fbca;
                
                    event ApproveHash(
                        bytes32 indexed approvedHash,
                        address indexed owner
                    );
                    event SignMsg(
                        bytes32 indexed msgHash
                    );
                    event ExecutionFailure(
                        bytes32 txHash, uint256 payment
                    );
                    event ExecutionSuccess(
                        bytes32 txHash, uint256 payment
                    );
                
                    uint256 public nonce;
                    bytes32 public domainSeparator;
                    // Mapping to keep track of all message hashes that have been approve by ALL REQUIRED owners
                    mapping(bytes32 => uint256) public signedMessages;
                    // Mapping to keep track of all hashes (message or transaction) that have been approve by ANY owners
                    mapping(address => mapping(bytes32 => uint256)) public approvedHashes;
                
                    // This constructor ensures that this contract can only be used as a master copy for Proxy contracts
                    constructor() public {
                        // By setting the threshold it is not possible to call setup anymore,
                        // so we create a Safe with 0 owners and threshold 1.
                        // This is an unusable Safe, perfect for the mastercopy
                        threshold = 1;
                    }
                
                    /// @dev Setup function sets initial storage of contract.
                    /// @param _owners List of Safe owners.
                    /// @param _threshold Number of required confirmations for a Safe transaction.
                    /// @param to Contract address for optional delegate call.
                    /// @param data Data payload for optional delegate call.
                    /// @param fallbackHandler Handler for fallback calls to this contract
                    /// @param paymentToken Token that should be used for the payment (0 is ETH)
                    /// @param payment Value that should be paid
                    /// @param paymentReceiver Adddress that should receive the payment (or 0 if tx.origin)
                    function setup(
                        address[] calldata _owners,
                        uint256 _threshold,
                        address to,
                        bytes calldata data,
                        address fallbackHandler,
                        address paymentToken,
                        uint256 payment,
                        address payable paymentReceiver
                    )
                        external
                    {
                        require(domainSeparator == 0, "Domain Separator already set!");
                        domainSeparator = keccak256(abi.encode(DOMAIN_SEPARATOR_TYPEHASH, this));
                        setupOwners(_owners, _threshold);
                        if (fallbackHandler != address(0)) internalSetFallbackHandler(fallbackHandler);
                        // As setupOwners can only be called if the contract has not been initialized we don't need a check for setupModules
                        setupModules(to, data);
                
                        if (payment > 0) {
                            // To avoid running into issues with EIP-170 we reuse the handlePayment function (to avoid adjusting code of that has been verified we do not adjust the method itself)
                            // baseGas = 0, gasPrice = 1 and gas = payment => amount = (payment + 0) * 1 = payment
                            handlePayment(payment, 0, 1, paymentToken, paymentReceiver);
                        }
                    }
                
                    /// @dev Allows to execute a Safe transaction confirmed by required number of owners and then pays the account that submitted the transaction.
                    ///      Note: The fees are always transfered, even if the user transaction fails.
                    /// @param to Destination address of Safe transaction.
                    /// @param value Ether value of Safe transaction.
                    /// @param data Data payload of Safe transaction.
                    /// @param operation Operation type of Safe transaction.
                    /// @param safeTxGas Gas that should be used for the Safe transaction.
                    /// @param baseGas Gas costs for that are indipendent of the transaction execution(e.g. base transaction fee, signature check, payment of the refund)
                    /// @param gasPrice Gas price that should be used for the payment calculation.
                    /// @param gasToken Token address (or 0 if ETH) that is used for the payment.
                    /// @param refundReceiver Address of receiver of gas payment (or 0 if tx.origin).
                    /// @param signatures Packed signature data ({bytes32 r}{bytes32 s}{uint8 v})
                    function execTransaction(
                        address to,
                        uint256 value,
                        bytes calldata data,
                        Enum.Operation operation,
                        uint256 safeTxGas,
                        uint256 baseGas,
                        uint256 gasPrice,
                        address gasToken,
                        address payable refundReceiver,
                        bytes calldata signatures
                    )
                        external
                        returns (bool success)
                    {
                        bytes32 txHash;
                        // Use scope here to limit variable lifetime and prevent `stack too deep` errors
                        {
                            bytes memory txHashData = encodeTransactionData(
                                to, value, data, operation, // Transaction info
                                safeTxGas, baseGas, gasPrice, gasToken, refundReceiver, // Payment info
                                nonce
                            );
                            // Increase nonce and execute transaction.
                            nonce++;
                            txHash = keccak256(txHashData);
                            checkSignatures(txHash, txHashData, signatures, true);
                        }
                        require(gasleft() >= safeTxGas, "Not enough gas to execute safe transaction");
                        // Use scope here to limit variable lifetime and prevent `stack too deep` errors
                        {
                            uint256 gasUsed = gasleft();
                            // If no safeTxGas has been set and the gasPrice is 0 we assume that all available gas can be used
                            success = execute(to, value, data, operation, safeTxGas == 0 && gasPrice == 0 ? gasleft() : safeTxGas);
                            gasUsed = gasUsed.sub(gasleft());
                            // We transfer the calculated tx costs to the tx.origin to avoid sending it to intermediate contracts that have made calls
                            uint256 payment = 0;
                            if (gasPrice > 0) {
                                payment = handlePayment(gasUsed, baseGas, gasPrice, gasToken, refundReceiver);
                            }
                            if (success) emit ExecutionSuccess(txHash, payment);
                            else emit ExecutionFailure(txHash, payment);
                        }
                    }
                
                    function handlePayment(
                        uint256 gasUsed,
                        uint256 baseGas,
                        uint256 gasPrice,
                        address gasToken,
                        address payable refundReceiver
                    )
                        private
                        returns (uint256 payment)
                    {
                        // solium-disable-next-line security/no-tx-origin
                        address payable receiver = refundReceiver == address(0) ? tx.origin : refundReceiver;
                        if (gasToken == address(0)) {
                            // For ETH we will only adjust the gas price to not be higher than the actual used gas price
                            payment = gasUsed.add(baseGas).mul(gasPrice < tx.gasprice ? gasPrice : tx.gasprice);
                            // solium-disable-next-line security/no-send
                            require(receiver.send(payment), "Could not pay gas costs with ether");
                        } else {
                            payment = gasUsed.add(baseGas).mul(gasPrice);
                            require(transferToken(gasToken, receiver, payment), "Could not pay gas costs with token");
                        }
                    }
                
                    /**
                    * @dev Checks whether the signature provided is valid for the provided data, hash. Will revert otherwise.
                    * @param dataHash Hash of the data (could be either a message hash or transaction hash)
                    * @param data That should be signed (this is passed to an external validator contract)
                    * @param signatures Signature data that should be verified. Can be ECDSA signature, contract signature (EIP-1271) or approved hash.
                    * @param consumeHash Indicates that in case of an approved hash the storage can be freed to save gas
                    */
                    function checkSignatures(bytes32 dataHash, bytes memory data, bytes memory signatures, bool consumeHash)
                        internal
                    {
                        // Load threshold to avoid multiple storage loads
                        uint256 _threshold = threshold;
                        // Check that a threshold is set
                        require(_threshold > 0, "Threshold needs to be defined!");
                        // Check that the provided signature data is not too short
                        require(signatures.length >= _threshold.mul(65), "Signatures data too short");
                        // There cannot be an owner with address 0.
                        address lastOwner = address(0);
                        address currentOwner;
                        uint8 v;
                        bytes32 r;
                        bytes32 s;
                        uint256 i;
                        for (i = 0; i < _threshold; i++) {
                            (v, r, s) = signatureSplit(signatures, i);
                            // If v is 0 then it is a contract signature
                            if (v == 0) {
                                // When handling contract signatures the address of the contract is encoded into r
                                currentOwner = address(uint256(r));
                
                                // Check that signature data pointer (s) is not pointing inside the static part of the signatures bytes
                                // This check is not completely accurate, since it is possible that more signatures than the threshold are send.
                                // Here we only check that the pointer is not pointing inside the part that is being processed
                                require(uint256(s) >= _threshold.mul(65), "Invalid contract signature location: inside static part");
                
                                // Check that signature data pointer (s) is in bounds (points to the length of data -> 32 bytes)
                                require(uint256(s).add(32) <= signatures.length, "Invalid contract signature location: length not present");
                
                                // Check if the contract signature is in bounds: start of data is s + 32 and end is start + signature length
                                uint256 contractSignatureLen;
                                // solium-disable-next-line security/no-inline-assembly
                                assembly {
                                    contractSignatureLen := mload(add(add(signatures, s), 0x20))
                                }
                                require(uint256(s).add(32).add(contractSignatureLen) <= signatures.length, "Invalid contract signature location: data not complete");
                
                                // Check signature
                                bytes memory contractSignature;
                                // solium-disable-next-line security/no-inline-assembly
                                assembly {
                                    // The signature data for contract signatures is appended to the concatenated signatures and the offset is stored in s
                                    contractSignature := add(add(signatures, s), 0x20)
                                }
                                require(ISignatureValidator(currentOwner).isValidSignature(data, contractSignature) == EIP1271_MAGIC_VALUE, "Invalid contract signature provided");
                            // If v is 1 then it is an approved hash
                            } else if (v == 1) {
                                // When handling approved hashes the address of the approver is encoded into r
                                currentOwner = address(uint256(r));
                                // Hashes are automatically approved by the sender of the message or when they have been pre-approved via a separate transaction
                                require(msg.sender == currentOwner || approvedHashes[currentOwner][dataHash] != 0, "Hash has not been approved");
                                // Hash has been marked for consumption. If this hash was pre-approved free storage
                                if (consumeHash && msg.sender != currentOwner) {
                                    approvedHashes[currentOwner][dataHash] = 0;
                                }
                            } else if (v > 30) {
                                // To support eth_sign and similar we adjust v and hash the messageHash with the Ethereum message prefix before applying ecrecover
                                currentOwner = ecrecover(keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", dataHash)), v - 4, r, s);
                            } else {
                                // Use ecrecover with the messageHash for EOA signatures
                                currentOwner = ecrecover(dataHash, v, r, s);
                            }
                            require (
                                currentOwner > lastOwner && owners[currentOwner] != address(0) && currentOwner != SENTINEL_OWNERS,
                                "Invalid owner provided"
                            );
                            lastOwner = currentOwner;
                        }
                    }
                
                    /// @dev Allows to estimate a Safe transaction.
                    ///      This method is only meant for estimation purpose, therefore two different protection mechanism against execution in a transaction have been made:
                    ///      1.) The method can only be called from the safe itself
                    ///      2.) The response is returned with a revert
                    ///      When estimating set `from` to the address of the safe.
                    ///      Since the `estimateGas` function includes refunds, call this method to get an estimated of the costs that are deducted from the safe with `execTransaction`
                    /// @param to Destination address of Safe transaction.
                    /// @param value Ether value of Safe transaction.
                    /// @param data Data payload of Safe transaction.
                    /// @param operation Operation type of Safe transaction.
                    /// @return Estimate without refunds and overhead fees (base transaction and payload data gas costs).
                    function requiredTxGas(address to, uint256 value, bytes calldata data, Enum.Operation operation)
                        external
                        authorized
                        returns (uint256)
                    {
                        uint256 startGas = gasleft();
                        // We don't provide an error message here, as we use it to return the estimate
                        // solium-disable-next-line error-reason
                        require(execute(to, value, data, operation, gasleft()));
                        uint256 requiredGas = startGas - gasleft();
                        // Convert response to string and return via error message
                        revert(string(abi.encodePacked(requiredGas)));
                    }
                
                    /**
                    * @dev Marks a hash as approved. This can be used to validate a hash that is used by a signature.
                    * @param hashToApprove The hash that should be marked as approved for signatures that are verified by this contract.
                    */
                    function approveHash(bytes32 hashToApprove)
                        external
                    {
                        require(owners[msg.sender] != address(0), "Only owners can approve a hash");
                        approvedHashes[msg.sender][hashToApprove] = 1;
                        emit ApproveHash(hashToApprove, msg.sender);
                    }
                
                    /**
                    * @dev Marks a message as signed
                    * @param _data Arbitrary length data that should be marked as signed on the behalf of address(this)
                    */
                    function signMessage(bytes calldata _data)
                        external
                        authorized
                    {
                        bytes32 msgHash = getMessageHash(_data);
                        signedMessages[msgHash] = 1;
                        emit SignMsg(msgHash);
                    }
                
                    /**
                    * Implementation of ISignatureValidator (see `interfaces/ISignatureValidator.sol`)
                    * @dev Should return whether the signature provided is valid for the provided data.
                    *       The save does not implement the interface since `checkSignatures` is not a view method.
                    *       The method will not perform any state changes (see parameters of `checkSignatures`)
                    * @param _data Arbitrary length data signed on the behalf of address(this)
                    * @param _signature Signature byte array associated with _data
                    * @return a bool upon valid or invalid signature with corresponding _data
                    */
                    function isValidSignature(bytes calldata _data, bytes calldata _signature)
                        external
                        returns (bytes4)
                    {
                        bytes32 messageHash = getMessageHash(_data);
                        if (_signature.length == 0) {
                            require(signedMessages[messageHash] != 0, "Hash not approved");
                        } else {
                            // consumeHash needs to be false, as the state should not be changed
                            checkSignatures(messageHash, _data, _signature, false);
                        }
                        return EIP1271_MAGIC_VALUE;
                    }
                
                    /// @dev Returns hash of a message that can be signed by owners.
                    /// @param message Message that should be hashed
                    /// @return Message hash.
                    function getMessageHash(
                        bytes memory message
                    )
                        public
                        view
                        returns (bytes32)
                    {
                        bytes32 safeMessageHash = keccak256(
                            abi.encode(SAFE_MSG_TYPEHASH, keccak256(message))
                        );
                        return keccak256(
                            abi.encodePacked(byte(0x19), byte(0x01), domainSeparator, safeMessageHash)
                        );
                    }
                
                    /// @dev Returns the bytes that are hashed to be signed by owners.
                    /// @param to Destination address.
                    /// @param value Ether value.
                    /// @param data Data payload.
                    /// @param operation Operation type.
                    /// @param safeTxGas Fas that should be used for the safe transaction.
                    /// @param baseGas Gas costs for data used to trigger the safe transaction.
                    /// @param gasPrice Maximum gas price that should be used for this transaction.
                    /// @param gasToken Token address (or 0 if ETH) that is used for the payment.
                    /// @param refundReceiver Address of receiver of gas payment (or 0 if tx.origin).
                    /// @param _nonce Transaction nonce.
                    /// @return Transaction hash bytes.
                    function encodeTransactionData(
                        address to,
                        uint256 value,
                        bytes memory data,
                        Enum.Operation operation,
                        uint256 safeTxGas,
                        uint256 baseGas,
                        uint256 gasPrice,
                        address gasToken,
                        address refundReceiver,
                        uint256 _nonce
                    )
                        public
                        view
                        returns (bytes memory)
                    {
                        bytes32 safeTxHash = keccak256(
                            abi.encode(SAFE_TX_TYPEHASH, to, value, keccak256(data), operation, safeTxGas, baseGas, gasPrice, gasToken, refundReceiver, _nonce)
                        );
                        return abi.encodePacked(byte(0x19), byte(0x01), domainSeparator, safeTxHash);
                    }
                
                    /// @dev Returns hash to be signed by owners.
                    /// @param to Destination address.
                    /// @param value Ether value.
                    /// @param data Data payload.
                    /// @param operation Operation type.
                    /// @param safeTxGas Fas that should be used for the safe transaction.
                    /// @param baseGas Gas costs for data used to trigger the safe transaction.
                    /// @param gasPrice Maximum gas price that should be used for this transaction.
                    /// @param gasToken Token address (or 0 if ETH) that is used for the payment.
                    /// @param refundReceiver Address of receiver of gas payment (or 0 if tx.origin).
                    /// @param _nonce Transaction nonce.
                    /// @return Transaction hash.
                    function getTransactionHash(
                        address to,
                        uint256 value,
                        bytes memory data,
                        Enum.Operation operation,
                        uint256 safeTxGas,
                        uint256 baseGas,
                        uint256 gasPrice,
                        address gasToken,
                        address refundReceiver,
                        uint256 _nonce
                    )
                        public
                        view
                        returns (bytes32)
                    {
                        return keccak256(encodeTransactionData(to, value, data, operation, safeTxGas, baseGas, gasPrice, gasToken, refundReceiver, _nonce));
                    }
                }