ETH Price: $1,874.74 (+0.28%)

Transaction Decoder

Block:
11172531 at Nov-01-2020 05:27:09 PM +UTC
Transaction Fee:
0.01200955 ETH $22.51
Gas Used:
480,382 Gas / 25 Gwei

Emitted Events:

79 WETH9.Deposit( dst=[Receiver] UniswapV2_ZapIn_General_V2_4_2, wad=4000000000000000 )
80 WETH9.Approval( src=[Receiver] UniswapV2_ZapIn_General_V2_4_2, guy=[Receiver] UniswapV2Router02, wad=2003003505640870 )
81 WETH9.Transfer( src=[Receiver] UniswapV2_ZapIn_General_V2_4_2, dst=UniswapV2Pair, wad=2003003505640870 )
82 ProxyERC20.Transfer( from=UniswapV2Pair, to=[Receiver] UniswapV2_ZapIn_General_V2_4_2, value=770661829406075401 )
83 UniswapV2Pair.Sync( reserve0=772114436439812310992463, reserve1=2000760598202561885014 )
84 UniswapV2Pair.Swap( sender=[Receiver] UniswapV2Router02, amount0In=0, amount1In=2003003505640870, amount0Out=770661829406075401, amount1Out=0, to=[Receiver] UniswapV2_ZapIn_General_V2_4_2 )
85 ProxyERC20.Approval( owner=[Receiver] UniswapV2_ZapIn_General_V2_4_2, spender=[Receiver] UniswapV2Router02, value=770661829406075401 )
86 WETH9.Approval( src=[Receiver] UniswapV2_ZapIn_General_V2_4_2, guy=[Receiver] UniswapV2Router02, wad=1996996494359130 )
87 ProxyERC20.Transfer( from=[Receiver] UniswapV2_ZapIn_General_V2_4_2, to=UniswapV2Pair, value=770661829406075401 )
88 WETH9.Transfer( src=[Receiver] UniswapV2_ZapIn_General_V2_4_2, dst=UniswapV2Pair, wad=1996996494359129 )
89 UniswapV2Pair.Transfer( from=0x0000000000000000000000000000000000000000, to=[Receiver] UniswapV2_ZapIn_General_V2_4_2, value=27105383961728820 )
90 UniswapV2Pair.Sync( reserve0=772115207101641717067864, reserve1=2000762595199056244143 )
91 UniswapV2Pair.Mint( sender=[Receiver] UniswapV2Router02, amount0=770661829406075401, amount1=1996996494359129 )
92 ProxyERC20.Approval( owner=[Receiver] UniswapV2_ZapIn_General_V2_4_2, spender=[Receiver] UniswapV2Router02, value=0 )
93 WETH9.Approval( src=[Receiver] UniswapV2_ZapIn_General_V2_4_2, guy=[Receiver] UniswapV2Router02, wad=0 )
94 WETH9.Transfer( src=[Receiver] UniswapV2_ZapIn_General_V2_4_2, dst=[Sender] 0x25da7f41ac8144c8b9e2d4f0f07cdb1ebaff4bd5, wad=1 )
95 UniswapV2Pair.Transfer( from=[Receiver] UniswapV2_ZapIn_General_V2_4_2, to=[Sender] 0x25da7f41ac8144c8b9e2d4f0f07cdb1ebaff4bd5, value=27105383961728820 )

Account State Difference:

  Address   Before After State Difference Code
(zhizhu.top)
2,051.754914145935231416 Eth2,051.766923695935231416 Eth0.01200955
0x25DA7f41...eBAfF4BD5
0.445136678271672646 Eth
Nonce: 2
0.429127128271672646 Eth
Nonce: 3
0.01600955
0x705142E6...5Fc4aD6d7
0xC02aaA39...83C756Cc2 7,452,467.629493656520598589 Eth7,452,467.633493656520598589 Eth0.004
0xf80758aB...B6BAA4b5c

Execution Trace

ETH 0.004 UniswapV2_ZapIn_General_V2_4_2.ZapIn( _toWhomToIssue=0x25DA7f41Ac8144C8B9e2d4F0f07cdB1eBAfF4BD5, _FromTokenContractAddress=0x0000000000000000000000000000000000000000, _ToUnipoolToken0=0x57Ab1ec28D129707052df4dF418D58a2D46d5f51, _ToUnipoolToken1=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2, _amount=4000000000000000, _minPoolTokens=26879992642659854 ) => ( 27105383961728820 )
  • ETH 0.004 WETH9.CALL( )
  • UniswapV2Factory.getPair( 0x57Ab1ec28D129707052df4dF418D58a2D46d5f51, 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 ) => ( 0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c )
  • UniswapV2Pair.STATICCALL( )
  • WETH9.allowance( 0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D ) => ( 0 )
  • WETH9.approve( guy=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D, wad=2003003505640870 ) => ( True )
  • UniswapV2Router02.swapExactTokensForTokens( amountIn=2003003505640870, amountOutMin=1, path=[0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2, 0x57Ab1ec28D129707052df4dF418D58a2D46d5f51], to=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, deadline=108555083659983933209597798445644913612440610624038028786991485007418559037440 ) => ( amounts=[2003003505640870, 770661829406075401] )
    • UniswapV2Pair.STATICCALL( )
    • WETH9.transferFrom( src=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, dst=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c, wad=2003003505640870 ) => ( True )
    • UniswapV2Pair.swap( amount0Out=770661829406075401, amount1Out=0, to=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, data=0x )
      • ProxyERC20.transfer( to=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, value=770661829406075401 ) => ( True )
        • MultiCollateralSynth.setMessageSender( sender=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c )
        • MultiCollateralSynth.transfer( to=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, value=770661829406075401 ) => ( True )
          • Exchanger.maxSecsLeftInWaitingPeriod( account=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c, currencyKey=7355534400000000000000000000000000000000000000000000000000000000 ) => ( 0 )
            • ExchangeState.getMaxTimestamp( account=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c, currencyKey=7355534400000000000000000000000000000000000000000000000000000000 ) => ( 0 )
            • FlexibleStorage.getUIntValue( contractName=53797374656D53657474696E6773000000000000000000000000000000000000, record=77616974696E67506572696F6453656373000000000000000000000000000000 ) => ( 300 )
            • Exchanger.settlementOwing( account=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c, currencyKey=7355534400000000000000000000000000000000000000000000000000000000 ) => ( reclaimAmount=0, rebateAmount=0, numEntries=0 )
              • ExchangeState.getLengthOfEntries( account=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c, currencyKey=7355534400000000000000000000000000000000000000000000000000000000 ) => ( 0 )
              • TokenState.balanceOf( 0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c ) => ( 772115207101641717067864 )
              • SystemStatus.requireSynthActive( currencyKey=7355534400000000000000000000000000000000000000000000000000000000 )
              • TokenState.balanceOf( 0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c ) => ( 772115207101641717067864 )
              • TokenState.setBalanceOf( account=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c, value=772114436439812310992463 )
              • TokenState.balanceOf( 0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D ) => ( 0 )
              • TokenState.setBalanceOf( account=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, value=770661829406075401 )
              • ProxyERC20._emit( callData=0x0000000000000000000000000000000000000000000000000AB1F0D9C7B3AA09, numTopics=3, topic1=DDF252AD1BE2C89B69C2B068FC378DAA952BA7F163C4A11628F55A4DF523B3EF, topic2=000000000000000000000000F80758AB42C3B07DA84053FD88804BCB6BAA4B5C, topic3=000000000000000000000000E83554B397BDA8ECAE7FEE5AEE532E83EE9EB29D, topic4=0000000000000000000000000000000000000000000000000000000000000000 )
              • ProxyERC20.balanceOf( owner=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c ) => ( 772114436439812310992463 )
                • MultiCollateralSynth.balanceOf( account=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c ) => ( 772114436439812310992463 )
                  • TokenState.balanceOf( 0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c ) => ( 772114436439812310992463 )
                  • WETH9.balanceOf( 0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c ) => ( 2000760598202561885014 )
                  • ProxyERC20.allowance( owner=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, spender=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D ) => ( 0 )
                    • MultiCollateralSynth.allowance( owner=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, spender=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D ) => ( 0 )
                      • TokenState.allowance( 0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D ) => ( 0 )
                      • ProxyERC20.approve( spender=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D, value=770661829406075401 ) => ( True )
                        • MultiCollateralSynth.setMessageSender( sender=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D )
                        • MultiCollateralSynth.approve( spender=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D, value=770661829406075401 ) => ( True )
                          • TokenState.setAllowance( tokenOwner=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, spender=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D, value=770661829406075401 )
                          • ProxyERC20._emit( callData=0x0000000000000000000000000000000000000000000000000AB1F0D9C7B3AA09, numTopics=3, topic1=8C5BE1E5EBEC7D5BD14F71427D1E84F3DD0314C0F7B2291E5B200AC8C7C3B925, topic2=000000000000000000000000E83554B397BDA8ECAE7FEE5AEE532E83EE9EB29D, topic3=0000000000000000000000007A250D5630B4CF539739DF2C5DACB4C659F2488D, topic4=0000000000000000000000000000000000000000000000000000000000000000 )
                          • WETH9.allowance( 0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D ) => ( 0 )
                          • WETH9.approve( guy=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D, wad=1996996494359130 ) => ( True )
                          • UniswapV2Router02.addLiquidity( tokenA=0x57Ab1ec28D129707052df4dF418D58a2D46d5f51, tokenB=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2, amountADesired=770661829406075401, amountBDesired=1996996494359130, amountAMin=1, amountBMin=1, to=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, deadline=108555083659983933209597798445644913612440610624038028786991485007418559037440 ) => ( amountA=770661829406075401, amountB=1996996494359129, liquidity=27105383961728820 )
                            • UniswapV2Factory.getPair( 0x57Ab1ec28D129707052df4dF418D58a2D46d5f51, 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 ) => ( 0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c )
                            • UniswapV2Pair.STATICCALL( )
                            • ProxyERC20.transferFrom( from=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, to=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c, value=770661829406075401 ) => ( True )
                              • MultiCollateralSynth.setMessageSender( sender=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D )
                              • MultiCollateralSynth.transferFrom( from=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, to=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c, value=770661829406075401 ) => ( True )
                                • Exchanger.maxSecsLeftInWaitingPeriod( account=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, currencyKey=7355534400000000000000000000000000000000000000000000000000000000 ) => ( 0 )
                                  • ExchangeState.getMaxTimestamp( account=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, currencyKey=7355534400000000000000000000000000000000000000000000000000000000 ) => ( 0 )
                                  • FlexibleStorage.getUIntValue( contractName=53797374656D53657474696E6773000000000000000000000000000000000000, record=77616974696E67506572696F6453656373000000000000000000000000000000 ) => ( 300 )
                                  • Exchanger.settlementOwing( account=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, currencyKey=7355534400000000000000000000000000000000000000000000000000000000 ) => ( reclaimAmount=0, rebateAmount=0, numEntries=0 )
                                    • ExchangeState.getLengthOfEntries( account=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, currencyKey=7355534400000000000000000000000000000000000000000000000000000000 ) => ( 0 )
                                    • TokenState.balanceOf( 0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D ) => ( 770661829406075401 )
                                    • SystemStatus.requireSynthActive( currencyKey=7355534400000000000000000000000000000000000000000000000000000000 )
                                    • TokenState.allowance( 0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D ) => ( 770661829406075401 )
                                    • TokenState.allowance( 0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D ) => ( 770661829406075401 )
                                    • TokenState.setAllowance( tokenOwner=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, spender=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D, value=0 )
                                    • TokenState.balanceOf( 0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D ) => ( 770661829406075401 )
                                    • TokenState.setBalanceOf( account=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, value=0 )
                                    • TokenState.balanceOf( 0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c ) => ( 772114436439812310992463 )
                                    • TokenState.setBalanceOf( account=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c, value=772115207101641717067864 )
                                    • ProxyERC20._emit( callData=0x0000000000000000000000000000000000000000000000000AB1F0D9C7B3AA09, numTopics=3, topic1=DDF252AD1BE2C89B69C2B068FC378DAA952BA7F163C4A11628F55A4DF523B3EF, topic2=000000000000000000000000E83554B397BDA8ECAE7FEE5AEE532E83EE9EB29D, topic3=000000000000000000000000F80758AB42C3B07DA84053FD88804BCB6BAA4B5C, topic4=0000000000000000000000000000000000000000000000000000000000000000 )
                                    • WETH9.transferFrom( src=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, dst=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c, wad=1996996494359129 ) => ( True )
                                    • UniswapV2Pair.mint( to=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D ) => ( liquidity=27105383961728820 )
                                      • ProxyERC20.balanceOf( owner=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c ) => ( 772115207101641717067864 )
                                        • MultiCollateralSynth.balanceOf( account=0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c ) => ( 772115207101641717067864 )
                                          • TokenState.balanceOf( 0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c ) => ( 772115207101641717067864 )
                                          • WETH9.balanceOf( 0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c ) => ( 2000762595199056244143 )
                                          • UniswapV2Factory.STATICCALL( )
                                          • ProxyERC20.approve( spender=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D, value=0 ) => ( True )
                                            • MultiCollateralSynth.setMessageSender( sender=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D )
                                            • MultiCollateralSynth.approve( spender=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D, value=0 ) => ( True )
                                              • TokenState.setAllowance( tokenOwner=0xE83554B397BdA8ECAE7FEE5aeE532e83Ee9eB29D, spender=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D, value=0 )
                                              • ProxyERC20._emit( callData=0x0000000000000000000000000000000000000000000000000000000000000000, numTopics=3, topic1=8C5BE1E5EBEC7D5BD14F71427D1E84F3DD0314C0F7B2291E5B200AC8C7C3B925, topic2=000000000000000000000000E83554B397BDA8ECAE7FEE5AEE532E83EE9EB29D, topic3=0000000000000000000000007A250D5630B4CF539739DF2C5DACB4C659F2488D, topic4=0000000000000000000000000000000000000000000000000000000000000000 )
                                              • WETH9.approve( guy=0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D, wad=0 ) => ( True )
                                              • WETH9.transfer( dst=0x25DA7f41Ac8144C8B9e2d4F0f07cdB1eBAfF4BD5, wad=1 ) => ( True )
                                              • UniswapV2Factory.getPair( 0x57Ab1ec28D129707052df4dF418D58a2D46d5f51, 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 ) => ( 0xf80758aB42C3B07dA84053Fd88804bCB6BAA4b5c )
                                              • UniswapV2Pair.transfer( to=0x25DA7f41Ac8144C8B9e2d4F0f07cdB1eBAfF4BD5, value=27105383961728820 ) => ( True )
                                                ZapIn[UniswapV2_ZapIn_General_V2_4_2 (ln:945)]
                                                File 1 of 12: UniswapV2_ZapIn_General_V2_4_2
                                                // ███████╗░█████╗░██████╗░██████╗░███████╗██████╗░░░░███████╗██╗
                                                // ╚════██║██╔══██╗██╔══██╗██╔══██╗██╔════╝██╔══██╗░░░██╔════╝██║
                                                // ░░███╔═╝███████║██████╔╝██████╔╝█████╗░░██████╔╝░░░█████╗░░██║
                                                // ██╔══╝░░██╔══██║██╔═══╝░██╔═══╝░██╔══╝░░██╔══██╗░░░██╔══╝░░██║
                                                // ███████╗██║░░██║██║░░░░░██║░░░░░███████╗██║░░██║██╗██║░░░░░██║
                                                // ╚══════╝╚═╝░░╚═╝╚═╝░░░░░╚═╝░░░░░╚══════╝╚═╝░░╚═╝╚═╝╚═╝░░░░░╚═╝
                                                // Copyright (C) 2020 zapper, nodar, suhail, seb, sumit, apoorv
                                                
                                                // This program is free software: you can redistribute it and/or modify
                                                // it under the terms of the GNU Affero General Public License as published by
                                                // the Free Software Foundation, either version 2 of the License, or
                                                // (at your option) any later version.
                                                //
                                                // This program is distributed in the hope that it will be useful,
                                                // but WITHOUT ANY WARRANTY; without even the implied warranty of
                                                // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                                                // GNU Affero General Public License for more details.
                                                //
                                                
                                                ///@author Zapper
                                                ///@notice This contract adds liquidity to Uniswap V2 pools using ETH or any ERC20 Token.
                                                // SPDX-License-Identifier: GPLv2
                                                
                                                pragma solidity ^0.5.0;
                                                
                                                /**
                                                 * @dev Interface of the ERC20 standard as defined in the EIP. Does not include
                                                 * the optional functions; to access them see {ERC20Detailed}.
                                                 */
                                                interface IERC20 {
                                                    /**
                                                     * @dev Returns the amount of tokens in existence.
                                                     */
                                                    function totalSupply() external view returns (uint256);
                                                
                                                    /**
                                                     * @dev Returns the amount of tokens owned by `account`.
                                                     */
                                                    function balanceOf(address account) external view returns (uint256);
                                                
                                                    /**
                                                     * @dev Moves `amount` tokens from the caller's account to `recipient`.
                                                     *
                                                     * Returns a boolean value indicating whether the operation succeeded.
                                                     *
                                                     * Emits a {Transfer} event.
                                                     */
                                                    function transfer(address recipient, uint256 amount)
                                                        external
                                                        returns (bool);
                                                
                                                    /**
                                                     * @dev Returns the remaining number of tokens that `spender` will be
                                                     * allowed to spend on behalf of `owner` through {transferFrom}. This is
                                                     * zero by default.
                                                     *
                                                     * This value changes when {approve} or {transferFrom} are called.
                                                     */
                                                    function allowance(address owner, address spender)
                                                        external
                                                        view
                                                        returns (uint256);
                                                
                                                    /**
                                                     * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
                                                     *
                                                     * Returns a boolean value indicating whether the operation succeeded.
                                                     *
                                                     * IMPORTANT: Beware that changing an allowance with this method brings the risk
                                                     * that someone may use both the old and the new allowance by unfortunate
                                                     * transaction ordering. One possible solution to mitigate this race
                                                     * condition is to first reduce the spender's allowance to 0 and set the
                                                     * desired value afterwards:
                                                     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                                                     *
                                                     * Emits an {Approval} event.
                                                     */
                                                    function approve(address spender, uint256 amount) external returns (bool);
                                                
                                                    /**
                                                     * @dev Moves `amount` tokens from `sender` to `recipient` using the
                                                     * allowance mechanism. `amount` is then deducted from the caller's
                                                     * allowance.
                                                     *
                                                     * Returns a boolean value indicating whether the operation succeeded.
                                                     *
                                                     * Emits a {Transfer} event.
                                                     */
                                                    function transferFrom(
                                                        address sender,
                                                        address recipient,
                                                        uint256 amount
                                                    ) external returns (bool);
                                                
                                                    /**
                                                     * @dev Emitted when `value` tokens are moved from one account (`from`) to
                                                     * another (`to`).
                                                     *
                                                     * Note that `value` may be zero.
                                                     */
                                                    event Transfer(address indexed from, address indexed to, uint256 value);
                                                
                                                    /**
                                                     * @dev Emitted when the allowance of a `spender` for an `owner` is set by
                                                     * a call to {approve}. `value` is the new allowance.
                                                     */
                                                    event Approval(
                                                        address indexed owner,
                                                        address indexed spender,
                                                        uint256 value
                                                    );
                                                }
                                                
                                                /**
                                                 * @dev Wrappers over Solidity's arithmetic operations with added overflow
                                                 * checks.
                                                 *
                                                 * Arithmetic operations in Solidity wrap on overflow. This can easily result
                                                 * in bugs, because programmers usually assume that an overflow raises an
                                                 * error, which is the standard behavior in high level programming languages.
                                                 * `SafeMath` restores this intuition by reverting the transaction when an
                                                 * operation overflows.
                                                 *
                                                 * Using this library instead of the unchecked operations eliminates an entire
                                                 * class of bugs, so it's recommended to use it always.
                                                 */
                                                library SafeMath {
                                                    /**
                                                     * @dev Returns the addition of two unsigned integers, reverting on
                                                     * overflow.
                                                     *
                                                     * Counterpart to Solidity's `+` operator.
                                                     *
                                                     * Requirements:
                                                     * - Addition cannot overflow.
                                                     */
                                                    function add(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        uint256 c = a + b;
                                                        require(c >= a, "SafeMath: addition overflow");
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the subtraction of two unsigned integers, reverting on
                                                     * overflow (when the result is negative).
                                                     *
                                                     * Counterpart to Solidity's `-` operator.
                                                     *
                                                     * Requirements:
                                                     * - Subtraction cannot overflow.
                                                     */
                                                    function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        return sub(a, b, "SafeMath: subtraction overflow");
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
                                                     * overflow (when the result is negative).
                                                     *
                                                     * Counterpart to Solidity's `-` operator.
                                                     *
                                                     * Requirements:
                                                     * - Subtraction cannot overflow.
                                                     *
                                                     * _Available since v2.4.0._
                                                     */
                                                    function sub(
                                                        uint256 a,
                                                        uint256 b,
                                                        string memory errorMessage
                                                    ) internal pure returns (uint256) {
                                                        require(b <= a, errorMessage);
                                                        uint256 c = a - b;
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the multiplication of two unsigned integers, reverting on
                                                     * overflow.
                                                     *
                                                     * Counterpart to Solidity's `*` operator.
                                                     *
                                                     * Requirements:
                                                     * - Multiplication cannot overflow.
                                                     */
                                                    function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                                                        // benefit is lost if 'b' is also tested.
                                                        // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
                                                        if (a == 0) {
                                                            return 0;
                                                        }
                                                
                                                        uint256 c = a * b;
                                                        require(c / a == b, "SafeMath: multiplication overflow");
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the integer division of two unsigned integers. Reverts on
                                                     * division by zero. The result is rounded towards zero.
                                                     *
                                                     * Counterpart to Solidity's `/` operator. Note: this function uses a
                                                     * `revert` opcode (which leaves remaining gas untouched) while Solidity
                                                     * uses an invalid opcode to revert (consuming all remaining gas).
                                                     *
                                                     * Requirements:
                                                     * - The divisor cannot be zero.
                                                     */
                                                    function div(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        return div(a, b, "SafeMath: division by zero");
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the integer division of two unsigned integers. Reverts with custom message on
                                                     * division by zero. The result is rounded towards zero.
                                                     *
                                                     * Counterpart to Solidity's `/` operator. Note: this function uses a
                                                     * `revert` opcode (which leaves remaining gas untouched) while Solidity
                                                     * uses an invalid opcode to revert (consuming all remaining gas).
                                                     *
                                                     * Requirements:
                                                     * - The divisor cannot be zero.
                                                     *
                                                     * _Available since v2.4.0._
                                                     */
                                                    function div(
                                                        uint256 a,
                                                        uint256 b,
                                                        string memory errorMessage
                                                    ) internal pure returns (uint256) {
                                                        // Solidity only automatically asserts when dividing by 0
                                                        require(b > 0, errorMessage);
                                                        uint256 c = a / b;
                                                        // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                                     * Reverts when dividing by zero.
                                                     *
                                                     * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                                     * opcode (which leaves remaining gas untouched) while Solidity uses an
                                                     * invalid opcode to revert (consuming all remaining gas).
                                                     *
                                                     * Requirements:
                                                     * - The divisor cannot be zero.
                                                     */
                                                    function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        return mod(a, b, "SafeMath: modulo by zero");
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                                     * Reverts with custom message when dividing by zero.
                                                     *
                                                     * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                                     * opcode (which leaves remaining gas untouched) while Solidity uses an
                                                     * invalid opcode to revert (consuming all remaining gas).
                                                     *
                                                     * Requirements:
                                                     * - The divisor cannot be zero.
                                                     *
                                                     * _Available since v2.4.0._
                                                     */
                                                    function mod(
                                                        uint256 a,
                                                        uint256 b,
                                                        string memory errorMessage
                                                    ) internal pure returns (uint256) {
                                                        require(b != 0, errorMessage);
                                                        return a % b;
                                                    }
                                                }
                                                
                                                /**
                                                 * @dev 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) {
                                                        // According to EIP-1052, 0x0 is the value returned for not-yet created accounts
                                                        // and 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470 is returned
                                                        // for accounts without code, i.e. `keccak256('')`
                                                        bytes32 codehash;
                                                
                                                
                                                            bytes32 accountHash
                                                         = 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470;
                                                        // solhint-disable-next-line no-inline-assembly
                                                        assembly {
                                                            codehash := extcodehash(account)
                                                        }
                                                        return (codehash != accountHash && codehash != 0x0);
                                                    }
                                                
                                                    /**
                                                     * @dev Converts an `address` into `address payable`. Note that this is
                                                     * simply a type cast: the actual underlying value is not changed.
                                                     *
                                                     * _Available since v2.4.0._
                                                     */
                                                    function toPayable(address account)
                                                        internal
                                                        pure
                                                        returns (address payable)
                                                    {
                                                        return address(uint160(account));
                                                    }
                                                
                                                    /**
                                                     * @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].
                                                     *
                                                     * _Available since v2.4.0._
                                                     */
                                                    function sendValue(address payable recipient, uint256 amount) internal {
                                                        require(
                                                            address(this).balance >= amount,
                                                            "Address: insufficient balance"
                                                        );
                                                
                                                        // solhint-disable-next-line avoid-call-value
                                                        (bool success, ) = recipient.call.value(amount)("");
                                                        require(
                                                            success,
                                                            "Address: unable to send value, recipient may have reverted"
                                                        );
                                                    }
                                                }
                                                
                                                /**
                                                 * @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 ERC20;` 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)
                                                        );
                                                    }
                                                
                                                    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.
                                                
                                                        // A Solidity high level call has three parts:
                                                        //  1. The target address is checked to verify it contains contract code
                                                        //  2. The call itself is made, and success asserted
                                                        //  3. The return value is decoded, which in turn checks the size of the returned data.
                                                        // solhint-disable-next-line max-line-length
                                                        require(address(token).isContract(), "SafeERC20: call to non-contract");
                                                
                                                        // solhint-disable-next-line avoid-low-level-calls
                                                        (bool success, bytes memory returndata) = address(token).call(data);
                                                        require(success, "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"
                                                            );
                                                        }
                                                    }
                                                }
                                                
                                                /**
                                                 * @dev Contract module that helps prevent reentrant calls to a function.
                                                 *
                                                 * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
                                                 * available, which can be applied to functions to make sure there are no nested
                                                 * (reentrant) calls to them.
                                                 *
                                                 * Note that because there is a single `nonReentrant` guard, functions marked as
                                                 * `nonReentrant` may not call one another. This can be worked around by making
                                                 * those functions `private`, and then adding `external` `nonReentrant` entry
                                                 * points to them.
                                                 *
                                                 * _Since v2.5.0:_ this module is now much more gas efficient, given net gas
                                                 * metering changes introduced in the Istanbul hardfork.
                                                 */
                                                contract ReentrancyGuard {
                                                    bool private _notEntered;
                                                
                                                    constructor() internal {
                                                        // Storing an initial non-zero value makes deployment a bit more
                                                        // expensive, but in exchange the refund on every call to nonReentrant
                                                        // will be lower in amount. Since refunds are capped to a percetange of
                                                        // the total transaction's gas, it is best to keep them low in cases
                                                        // like this one, to increase the likelihood of the full refund coming
                                                        // into effect.
                                                        _notEntered = true;
                                                    }
                                                
                                                    /**
                                                     * @dev Prevents a contract from calling itself, directly or indirectly.
                                                     * Calling a `nonReentrant` function from another `nonReentrant`
                                                     * function is not supported. It is possible to prevent this from happening
                                                     * by making the `nonReentrant` function external, and make it call a
                                                     * `private` function that does the actual work.
                                                     */
                                                    modifier nonReentrant() {
                                                        // On the first call to nonReentrant, _notEntered will be true
                                                        require(_notEntered, "ReentrancyGuard: reentrant call");
                                                
                                                        // Any calls to nonReentrant after this point will fail
                                                        _notEntered = false;
                                                
                                                        _;
                                                
                                                        // By storing the original value once again, a refund is triggered (see
                                                        // https://eips.ethereum.org/EIPS/eip-2200)
                                                        _notEntered = true;
                                                    }
                                                }
                                                
                                                /*
                                                 * @dev Provides information about the current execution context, including the
                                                 * sender of the transaction and its data. While these are generally available
                                                 * via msg.sender and msg.data, they should not be accessed in such a direct
                                                 * manner, since when dealing with GSN meta-transactions the account sending and
                                                 * paying for execution may not be the actual sender (as far as an application
                                                 * is concerned).
                                                 *
                                                 * This contract is only required for intermediate, library-like contracts.
                                                 */
                                                contract Context {
                                                    // Empty internal constructor, to prevent people from mistakenly deploying
                                                    // an instance of this contract, which should be used via inheritance.
                                                    constructor() internal {}
                                                
                                                    // solhint-disable-previous-line no-empty-blocks
                                                
                                                    function _msgSender() internal view returns (address payable) {
                                                        return msg.sender;
                                                    }
                                                
                                                    function _msgData() internal view returns (bytes memory) {
                                                        this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                                                        return msg.data;
                                                    }
                                                }
                                                
                                                /**
                                                 * @dev 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.
                                                 *
                                                 * This module is used through inheritance. It will make available the modifier
                                                 * `onlyOwner`, which can be applied to your functions to restrict their use to
                                                 * the owner.
                                                 */
                                                contract Ownable is Context {
                                                    address payable public _owner;
                                                
                                                    event OwnershipTransferred(
                                                        address indexed previousOwner,
                                                        address indexed newOwner
                                                    );
                                                
                                                    /**
                                                     * @dev Initializes the contract setting the deployer as the initial owner.
                                                     */
                                                    constructor() internal {
                                                        address payable msgSender = _msgSender();
                                                        _owner = msgSender;
                                                        emit OwnershipTransferred(address(0), msgSender);
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the address of the current owner.
                                                     */
                                                    function owner() public view returns (address) {
                                                        return _owner;
                                                    }
                                                
                                                    /**
                                                     * @dev Throws if called by any account other than the owner.
                                                     */
                                                    modifier onlyOwner() {
                                                        require(isOwner(), "Ownable: caller is not the owner");
                                                        _;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns true if the caller is the current owner.
                                                     */
                                                    function isOwner() public view returns (bool) {
                                                        return _msgSender() == _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 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 payable newOwner) public onlyOwner {
                                                        _transferOwnership(newOwner);
                                                    }
                                                
                                                    /**
                                                     * @dev Transfers ownership of the contract to a new account (`newOwner`).
                                                     */
                                                    function _transferOwnership(address payable newOwner) internal {
                                                        require(
                                                            newOwner != address(0),
                                                            "Ownable: new owner is the zero address"
                                                        );
                                                        emit OwnershipTransferred(_owner, newOwner);
                                                        _owner = newOwner;
                                                    }
                                                }
                                                
                                                // import "@uniswap/lib/contracts/libraries/Babylonian.sol";
                                                library Babylonian {
                                                    function sqrt(uint256 y) internal pure returns (uint256 z) {
                                                        if (y > 3) {
                                                            z = y;
                                                            uint256 x = y / 2 + 1;
                                                            while (x < z) {
                                                                z = x;
                                                                x = (y / x + x) / 2;
                                                            }
                                                        } else if (y != 0) {
                                                            z = 1;
                                                        }
                                                        // else z = 0
                                                    }
                                                }
                                                
                                                interface IWETH {
                                                    function deposit() external payable;
                                                
                                                    function transfer(address to, uint256 value) external returns (bool);
                                                
                                                    function withdraw(uint256) external;
                                                }
                                                
                                                interface IUniswapV2Factory {
                                                    function getPair(address tokenA, address tokenB)
                                                        external
                                                        view
                                                        returns (address);
                                                }
                                                
                                                interface IUniswapV2Router02 {
                                                    function factory() external pure returns (address);
                                                
                                                    function WETH() external pure returns (address);
                                                
                                                    function addLiquidity(
                                                        address tokenA,
                                                        address tokenB,
                                                        uint256 amountADesired,
                                                        uint256 amountBDesired,
                                                        uint256 amountAMin,
                                                        uint256 amountBMin,
                                                        address to,
                                                        uint256 deadline
                                                    )
                                                        external
                                                        returns (
                                                            uint256 amountA,
                                                            uint256 amountB,
                                                            uint256 liquidity
                                                        );
                                                
                                                    function addLiquidityETH(
                                                        address token,
                                                        uint256 amountTokenDesired,
                                                        uint256 amountTokenMin,
                                                        uint256 amountETHMin,
                                                        address to,
                                                        uint256 deadline
                                                    )
                                                        external
                                                        payable
                                                        returns (
                                                            uint256 amountToken,
                                                            uint256 amountETH,
                                                            uint256 liquidity
                                                        );
                                                
                                                    function removeLiquidity(
                                                        address tokenA,
                                                        address tokenB,
                                                        uint256 liquidity,
                                                        uint256 amountAMin,
                                                        uint256 amountBMin,
                                                        address to,
                                                        uint256 deadline
                                                    ) external returns (uint256 amountA, uint256 amountB);
                                                
                                                    function removeLiquidityETH(
                                                        address token,
                                                        uint256 liquidity,
                                                        uint256 amountTokenMin,
                                                        uint256 amountETHMin,
                                                        address to,
                                                        uint256 deadline
                                                    ) external returns (uint256 amountToken, uint256 amountETH);
                                                
                                                    function removeLiquidityWithPermit(
                                                        address tokenA,
                                                        address tokenB,
                                                        uint256 liquidity,
                                                        uint256 amountAMin,
                                                        uint256 amountBMin,
                                                        address to,
                                                        uint256 deadline,
                                                        bool approveMax,
                                                        uint8 v,
                                                        bytes32 r,
                                                        bytes32 s
                                                    ) external returns (uint256 amountA, uint256 amountB);
                                                
                                                    function removeLiquidityETHWithPermit(
                                                        address token,
                                                        uint256 liquidity,
                                                        uint256 amountTokenMin,
                                                        uint256 amountETHMin,
                                                        address to,
                                                        uint256 deadline,
                                                        bool approveMax,
                                                        uint8 v,
                                                        bytes32 r,
                                                        bytes32 s
                                                    ) external returns (uint256 amountToken, uint256 amountETH);
                                                
                                                    function swapExactTokensForTokens(
                                                        uint256 amountIn,
                                                        uint256 amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint256 deadline
                                                    ) external returns (uint256[] memory amounts);
                                                
                                                    function swapTokensForExactTokens(
                                                        uint256 amountOut,
                                                        uint256 amountInMax,
                                                        address[] calldata path,
                                                        address to,
                                                        uint256 deadline
                                                    ) external returns (uint256[] memory amounts);
                                                
                                                    function swapExactETHForTokens(
                                                        uint256 amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint256 deadline
                                                    ) external payable returns (uint256[] memory amounts);
                                                
                                                    function swapTokensForExactETH(
                                                        uint256 amountOut,
                                                        uint256 amountInMax,
                                                        address[] calldata path,
                                                        address to,
                                                        uint256 deadline
                                                    ) external returns (uint256[] memory amounts);
                                                
                                                    function swapExactTokensForETH(
                                                        uint256 amountIn,
                                                        uint256 amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint256 deadline
                                                    ) external returns (uint256[] memory amounts);
                                                
                                                    function swapETHForExactTokens(
                                                        uint256 amountOut,
                                                        address[] calldata path,
                                                        address to,
                                                        uint256 deadline
                                                    ) external payable returns (uint256[] memory amounts);
                                                
                                                    function removeLiquidityETHSupportingFeeOnTransferTokens(
                                                        address token,
                                                        uint256 liquidity,
                                                        uint256 amountTokenMin,
                                                        uint256 amountETHMin,
                                                        address to,
                                                        uint256 deadline
                                                    ) external returns (uint256 amountETH);
                                                
                                                    function removeLiquidityETHWithPermitSupportingFeeOnTransferTokens(
                                                        address token,
                                                        uint256 liquidity,
                                                        uint256 amountTokenMin,
                                                        uint256 amountETHMin,
                                                        address to,
                                                        uint256 deadline,
                                                        bool approveMax,
                                                        uint8 v,
                                                        bytes32 r,
                                                        bytes32 s
                                                    ) external returns (uint256 amountETH);
                                                
                                                    function swapExactTokensForTokensSupportingFeeOnTransferTokens(
                                                        uint256 amountIn,
                                                        uint256 amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint256 deadline
                                                    ) external;
                                                
                                                    function swapExactETHForTokensSupportingFeeOnTransferTokens(
                                                        uint256 amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint256 deadline
                                                    ) external payable;
                                                
                                                    function swapExactTokensForETHSupportingFeeOnTransferTokens(
                                                        uint256 amountIn,
                                                        uint256 amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint256 deadline
                                                    ) external;
                                                
                                                    function quote(
                                                        uint256 amountA,
                                                        uint256 reserveA,
                                                        uint256 reserveB
                                                    ) external pure returns (uint256 amountB);
                                                
                                                    function getAmountOut(
                                                        uint256 amountIn,
                                                        uint256 reserveIn,
                                                        uint256 reserveOut
                                                    ) external pure returns (uint256 amountOut);
                                                
                                                    function getAmountIn(
                                                        uint256 amountOut,
                                                        uint256 reserveIn,
                                                        uint256 reserveOut
                                                    ) external pure returns (uint256 amountIn);
                                                
                                                    function getAmountsOut(uint256 amountIn, address[] calldata path)
                                                        external
                                                        view
                                                        returns (uint256[] memory amounts);
                                                
                                                    function getAmountsIn(uint256 amountOut, address[] calldata path)
                                                        external
                                                        view
                                                        returns (uint256[] memory amounts);
                                                }
                                                
                                                interface IUniswapV2Pair {
                                                    function token0() external pure returns (address);
                                                
                                                    function token1() external pure returns (address);
                                                
                                                    function getReserves()
                                                        external
                                                        view
                                                        returns (
                                                            uint112 _reserve0,
                                                            uint112 _reserve1,
                                                            uint32 _blockTimestampLast
                                                        );
                                                }
                                                
                                                contract UniswapV2_ZapIn_General_V2_4_2 is ReentrancyGuard, Ownable {
                                                    using SafeMath for uint256;
                                                    using Address for address;
                                                    using SafeERC20 for IERC20;
                                                
                                                    bool public stopped = false;
                                                    uint16 public goodwill;
                                                    address
                                                        private constant zgoodwillAddress = 0xE737b6AfEC2320f616297e59445b60a11e3eF75F;
                                                
                                                    IUniswapV2Router02 private constant uniswapRouter = IUniswapV2Router02(
                                                        0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D
                                                    );
                                                
                                                    IUniswapV2Factory
                                                        private constant UniSwapV2FactoryAddress = IUniswapV2Factory(
                                                        0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f
                                                    );
                                                
                                                    address
                                                        private constant wethTokenAddress = 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2;
                                                
                                                    uint256
                                                        private constant deadline = 0xf000000000000000000000000000000000000000000000000000000000000000;
                                                
                                                    constructor(uint16 _goodwill) public {
                                                        goodwill = _goodwill;
                                                    }
                                                
                                                    // circuit breaker modifiers
                                                    modifier stopInEmergency {
                                                        if (stopped) {
                                                            revert("Temporarily Paused");
                                                        } else {
                                                            _;
                                                        }
                                                    }
                                                
                                                    /**
                                                    @notice This function is used to invest in given Uniswap V2 pair through ETH/ERC20 Tokens
                                                    @param _FromTokenContractAddress The ERC20 token used for investment (address(0x00) if ether)
                                                    @param _ToUnipoolToken0 The Uniswap V2 pair token0 address
                                                    @param _ToUnipoolToken1 The Uniswap V2 pair token1 address
                                                    @param _amount The amount of fromToken to invest
                                                    @param _minPoolTokens Reverts if less tokens received than this
                                                    @return Amount of LP bought
                                                     */
                                                    function ZapIn(
                                                        address _toWhomToIssue,
                                                        address _FromTokenContractAddress,
                                                        address _ToUnipoolToken0,
                                                        address _ToUnipoolToken1,
                                                        uint256 _amount,
                                                        uint256 _minPoolTokens
                                                    ) public payable nonReentrant stopInEmergency returns (uint256) {
                                                        uint256 toInvest;
                                                        if (_FromTokenContractAddress == address(0)) {
                                                            require(msg.value > 0, "Error: ETH not sent");
                                                            toInvest = msg.value;
                                                        } else {
                                                            require(msg.value == 0, "Error: ETH sent");
                                                            require(_amount > 0, "Error: Invalid ERC amount");
                                                            IERC20(_FromTokenContractAddress).safeTransferFrom(
                                                                msg.sender,
                                                                address(this),
                                                                _amount
                                                            );
                                                            toInvest = _amount;
                                                        }
                                                
                                                        uint256 LPBought = _performZapIn(
                                                            _toWhomToIssue,
                                                            _FromTokenContractAddress,
                                                            _ToUnipoolToken0,
                                                            _ToUnipoolToken1,
                                                            toInvest
                                                        );
                                                        require(LPBought >= _minPoolTokens, "ERR: High Slippage");
                                                
                                                        //get pair address
                                                        address _ToUniPoolAddress = UniSwapV2FactoryAddress.getPair(
                                                            _ToUnipoolToken0,
                                                            _ToUnipoolToken1
                                                        );
                                                
                                                        //transfer goodwill
                                                        uint256 goodwillPortion = _transferGoodwill(
                                                            _ToUniPoolAddress,
                                                            LPBought
                                                        );
                                                
                                                        IERC20(_ToUniPoolAddress).safeTransfer(
                                                            _toWhomToIssue,
                                                            SafeMath.sub(LPBought, goodwillPortion)
                                                        );
                                                        return SafeMath.sub(LPBought, goodwillPortion);
                                                    }
                                                
                                                    function _performZapIn(
                                                        address _toWhomToIssue,
                                                        address _FromTokenContractAddress,
                                                        address _ToUnipoolToken0,
                                                        address _ToUnipoolToken1,
                                                        uint256 _amount
                                                    ) internal returns (uint256) {
                                                        address intermediate = _getIntermediate(
                                                            _FromTokenContractAddress,
                                                            _amount,
                                                            _ToUnipoolToken0,
                                                            _ToUnipoolToken1
                                                        );
                                                
                                                        // swap to intermediate
                                                        uint256 interAmt = _token2Token(
                                                            _FromTokenContractAddress,
                                                            intermediate,
                                                            _amount
                                                        );
                                                
                                                        // divide to swap in amounts
                                                        uint256 token0Bought;
                                                        uint256 token1Bought;
                                                
                                                        IUniswapV2Pair pair = IUniswapV2Pair(
                                                            UniSwapV2FactoryAddress.getPair(_ToUnipoolToken0, _ToUnipoolToken1)
                                                        );
                                                        (uint256 res0, uint256 res1, ) = pair.getReserves();
                                                
                                                        if (intermediate == _ToUnipoolToken0) {
                                                            uint256 amountToSwap = calculateSwapInAmount(res0, interAmt);
                                                            //if no reserve or a new pair is created
                                                            if (amountToSwap <= 0) amountToSwap = interAmt.div(2);
                                                            token1Bought = _token2Token(
                                                                intermediate,
                                                                _ToUnipoolToken1,
                                                                amountToSwap
                                                            );
                                                            token0Bought = interAmt.sub(amountToSwap);
                                                        } else {
                                                            uint256 amountToSwap = calculateSwapInAmount(res1, interAmt);
                                                            //if no reserve or a new pair is created
                                                            if (amountToSwap <= 0) amountToSwap = interAmt.div(2);
                                                            token0Bought = _token2Token(
                                                                intermediate,
                                                                _ToUnipoolToken0,
                                                                amountToSwap
                                                            );
                                                            token1Bought = interAmt.sub(amountToSwap);
                                                        }
                                                
                                                        return
                                                            _uniDeposit(
                                                                _toWhomToIssue,
                                                                _ToUnipoolToken0,
                                                                _ToUnipoolToken1,
                                                                token0Bought,
                                                                token1Bought
                                                            );
                                                    }
                                                
                                                    function _uniDeposit(
                                                        address _toWhomToIssue,
                                                        address _ToUnipoolToken0,
                                                        address _ToUnipoolToken1,
                                                        uint256 token0Bought,
                                                        uint256 token1Bought
                                                    ) internal returns (uint256) {
                                                        IERC20(_ToUnipoolToken0).safeApprove(
                                                            address(uniswapRouter),
                                                            token0Bought
                                                        );
                                                        IERC20(_ToUnipoolToken1).safeApprove(
                                                            address(uniswapRouter),
                                                            token1Bought
                                                        );
                                                
                                                        (uint256 amountA, uint256 amountB, uint256 LP) = uniswapRouter
                                                            .addLiquidity(
                                                            _ToUnipoolToken0,
                                                            _ToUnipoolToken1,
                                                            token0Bought,
                                                            token1Bought,
                                                            1,
                                                            1,
                                                            address(this),
                                                            deadline
                                                        );
                                                        
                                                        IERC20(_ToUnipoolToken0).safeApprove(
                                                            address(uniswapRouter),
                                                            0
                                                        );
                                                        IERC20(_ToUnipoolToken1).safeApprove(
                                                            address(uniswapRouter),
                                                            0
                                                        );
                                                
                                                        //Returning Residue in token0, if any.
                                                        if (token0Bought.sub(amountA) > 0) {
                                                            IERC20(_ToUnipoolToken0).safeTransfer(
                                                                _toWhomToIssue,
                                                                token0Bought.sub(amountA)
                                                            );
                                                        }
                                                
                                                        //Returning Residue in token1, if any
                                                        if (token1Bought.sub(amountB) > 0) {
                                                            IERC20(_ToUnipoolToken1).safeTransfer(
                                                                _toWhomToIssue,
                                                                token1Bought.sub(amountB)
                                                            );
                                                        }
                                                
                                                        return LP;
                                                    }
                                                
                                                    function _getIntermediate(
                                                        address _FromTokenContractAddress,
                                                        uint256 _amount,
                                                        address _ToUnipoolToken0,
                                                        address _ToUnipoolToken1
                                                    ) internal view returns (address) {
                                                        // set from to weth for eth input
                                                        if (_FromTokenContractAddress == address(0)) {
                                                            _FromTokenContractAddress = wethTokenAddress;
                                                        }
                                                
                                                        if (_FromTokenContractAddress == _ToUnipoolToken0) {
                                                            return _ToUnipoolToken0;
                                                        } else if (_FromTokenContractAddress == _ToUnipoolToken1) {
                                                            return _ToUnipoolToken1;
                                                        } else if(_ToUnipoolToken0 == wethTokenAddress || _ToUnipoolToken1 == wethTokenAddress) {
                                                            return wethTokenAddress;  
                                                        } else {
                                                            IUniswapV2Pair pair = IUniswapV2Pair(
                                                                UniSwapV2FactoryAddress.getPair(
                                                                    _ToUnipoolToken0,
                                                                    _ToUnipoolToken1
                                                                )
                                                            );
                                                            (uint256 res0, uint256 res1, ) = pair.getReserves();
                                                
                                                            uint256 ratio;
                                                            bool isToken0Numerator;
                                                            if (res0 >= res1) {
                                                                ratio = res0 / res1;
                                                                isToken0Numerator = true;
                                                            } else {
                                                                ratio = res1 / res0;
                                                            }
                                                
                                                            //find outputs on swap
                                                            uint256 output0 = _calculateSwapOutput(
                                                                _FromTokenContractAddress,
                                                                _amount,
                                                                _ToUnipoolToken0
                                                            );
                                                            uint256 output1 = _calculateSwapOutput(
                                                                _FromTokenContractAddress,
                                                                _amount,
                                                                _ToUnipoolToken1
                                                            );
                                                
                                                            if (isToken0Numerator) {
                                                                if (output1 * ratio >= output0) return _ToUnipoolToken1;
                                                                else return _ToUnipoolToken0;
                                                            } else {
                                                                if (output0 * ratio >= output1) return _ToUnipoolToken0;
                                                                else return _ToUnipoolToken1;
                                                            }
                                                        }
                                                    }
                                                
                                                    function _calculateSwapOutput(
                                                        address _from,
                                                        uint256 _amt,
                                                        address _to
                                                    ) internal view returns (uint256) {
                                                        // check output via tokenA -> tokenB
                                                        address pairA = UniSwapV2FactoryAddress.getPair(_from, _to);
                                                
                                                        uint256 amtA;
                                                        if (pairA != address(0)) {
                                                            address[] memory pathA = new address[](2);
                                                            pathA[0] = _from;
                                                            pathA[1] = _to;
                                                
                                                            amtA = uniswapRouter.getAmountsOut(_amt, pathA)[1];
                                                        }
                                                
                                                        uint256 amtB;
                                                        // check output via tokenA -> weth -> tokenB
                                                        if ((_from != wethTokenAddress) && _to != wethTokenAddress) {
                                                            address[] memory pathB = new address[](3);
                                                            pathB[0] = _from;
                                                            pathB[1] = wethTokenAddress;
                                                            pathB[2] = _to;
                                                
                                                            amtB = uniswapRouter.getAmountsOut(_amt, pathB)[2];
                                                        }
                                                
                                                        if (amtA >= amtB) {
                                                            return amtA;
                                                        } else {
                                                            return amtB;
                                                        }
                                                    }
                                                
                                                    function calculateSwapInAmount(uint256 reserveIn, uint256 userIn)
                                                        public
                                                        pure
                                                        returns (uint256)
                                                    {
                                                        return
                                                            Babylonian
                                                                .sqrt(
                                                                reserveIn.mul(userIn.mul(3988000) + reserveIn.mul(3988009))
                                                            )
                                                                .sub(reserveIn.mul(1997)) / 1994;
                                                    }
                                                
                                                    /**
                                                    @notice This function is used to swap ETH/ERC20 <> ETH/ERC20
                                                    @param _FromTokenContractAddress The token address to swap from. (0x00 for ETH)
                                                    @param _ToTokenContractAddress The token address to swap to. (0x00 for ETH)
                                                    @param tokens2Trade The amount of tokens to swap
                                                    @return tokenBought The quantity of tokens bought
                                                    */
                                                    function _token2Token(
                                                        address _FromTokenContractAddress,
                                                        address _ToTokenContractAddress,
                                                        uint256 tokens2Trade
                                                    ) internal returns (uint256 tokenBought) {
                                                        if (_FromTokenContractAddress == _ToTokenContractAddress) {
                                                            return tokens2Trade;
                                                        }
                                                
                                                        if (_FromTokenContractAddress == address(0)) {
                                                            if (_ToTokenContractAddress == wethTokenAddress) {
                                                                IWETH(wethTokenAddress).deposit.value(tokens2Trade)();
                                                                return tokens2Trade;
                                                            }
                                                
                                                            address[] memory path = new address[](2);
                                                            path[0] = wethTokenAddress;
                                                            path[1] = _ToTokenContractAddress;
                                                            tokenBought = uniswapRouter.swapExactETHForTokens.value(
                                                                tokens2Trade
                                                            )(1, path, address(this), deadline)[path.length - 1];
                                                        } else if (_ToTokenContractAddress == address(0)) {
                                                            if (_FromTokenContractAddress == wethTokenAddress) {
                                                                IWETH(wethTokenAddress).withdraw(tokens2Trade);
                                                                return tokens2Trade;
                                                            }
                                                
                                                            IERC20(_FromTokenContractAddress).safeApprove(
                                                                address(uniswapRouter),
                                                                tokens2Trade
                                                            );
                                                
                                                            address[] memory path = new address[](2);
                                                            path[0] = _FromTokenContractAddress;
                                                            path[1] = wethTokenAddress;
                                                            tokenBought = uniswapRouter.swapExactTokensForETH(
                                                                tokens2Trade,
                                                                1,
                                                                path,
                                                                address(this),
                                                                deadline
                                                            )[path.length - 1];
                                                        } else {
                                                            IERC20(_FromTokenContractAddress).safeApprove(
                                                                address(uniswapRouter),
                                                                tokens2Trade
                                                            );
                                                
                                                            if (_FromTokenContractAddress != wethTokenAddress) {
                                                                if (_ToTokenContractAddress != wethTokenAddress) {
                                                                    // check output via tokenA -> tokenB
                                                                    address pairA = UniSwapV2FactoryAddress.getPair(
                                                                        _FromTokenContractAddress,
                                                                        _ToTokenContractAddress
                                                                    );
                                                                    address[] memory pathA = new address[](2);
                                                                    pathA[0] = _FromTokenContractAddress;
                                                                    pathA[1] = _ToTokenContractAddress;
                                                                    uint256 amtA;
                                                                    if (pairA != address(0)) {
                                                                        amtA = uniswapRouter.getAmountsOut(
                                                                            tokens2Trade,
                                                                            pathA
                                                                        )[1];
                                                                    }
                                                
                                                                    // check output via tokenA -> weth -> tokenB
                                                                    address[] memory pathB = new address[](3);
                                                                    pathB[0] = _FromTokenContractAddress;
                                                                    pathB[1] = wethTokenAddress;
                                                                    pathB[2] = _ToTokenContractAddress;
                                                
                                                                    uint256 amtB = uniswapRouter.getAmountsOut(
                                                                        tokens2Trade,
                                                                        pathB
                                                                    )[2];
                                                
                                                                    if (amtA >= amtB) {
                                                                        tokenBought = uniswapRouter.swapExactTokensForTokens(
                                                                            tokens2Trade,
                                                                            1,
                                                                            pathA,
                                                                            address(this),
                                                                            deadline
                                                                        )[pathA.length - 1];
                                                                    } else {
                                                                        tokenBought = uniswapRouter.swapExactTokensForTokens(
                                                                            tokens2Trade,
                                                                            1,
                                                                            pathB,
                                                                            address(this),
                                                                            deadline
                                                                        )[pathB.length - 1];
                                                                    }
                                                                } else {
                                                                    address[] memory path = new address[](2);
                                                                    path[0] = _FromTokenContractAddress;
                                                                    path[1] = wethTokenAddress;
                                                
                                                                    tokenBought = uniswapRouter.swapExactTokensForTokens(
                                                                        tokens2Trade,
                                                                        1,
                                                                        path,
                                                                        address(this),
                                                                        deadline
                                                                    )[path.length - 1];
                                                                }
                                                            } else {
                                                                address[] memory path = new address[](2);
                                                                path[0] = wethTokenAddress;
                                                                path[1] = _ToTokenContractAddress;
                                                                tokenBought = uniswapRouter.swapExactTokensForTokens(
                                                                    tokens2Trade,
                                                                    1,
                                                                    path,
                                                                    address(this),
                                                                    deadline
                                                                )[path.length - 1];
                                                            }
                                                        }
                                                        require(tokenBought > 0, "Error Swapping Tokens");
                                                    }
                                                
                                                    /**
                                                    @notice This function is used to calculate and transfer goodwill
                                                    @param _tokenContractAddress Token in which goodwill is deducted
                                                    @param tokens2Trade The total amount of tokens to be zapped in
                                                    @return The quantity of goodwill deducted
                                                     */
                                                    function _transferGoodwill(
                                                        address _tokenContractAddress,
                                                        uint256 tokens2Trade
                                                    ) internal returns (uint256 goodwillPortion) {
                                                        goodwillPortion = SafeMath.div(
                                                            SafeMath.mul(tokens2Trade, goodwill),
                                                            10000
                                                        );
                                                
                                                        if (goodwillPortion == 0) {
                                                            return 0;
                                                        }
                                                
                                                        IERC20(_tokenContractAddress).safeTransfer(
                                                            zgoodwillAddress,
                                                            goodwillPortion
                                                        );
                                                    }
                                                
                                                    function set_new_goodwill(uint16 _new_goodwill) public onlyOwner {
                                                        require(
                                                            _new_goodwill >= 0 && _new_goodwill < 10000,
                                                            "GoodWill Value not allowed"
                                                        );
                                                        goodwill = _new_goodwill;
                                                    }
                                                
                                                    function inCaseTokengetsStuck(IERC20 _TokenAddress) public onlyOwner {
                                                        uint256 qty = _TokenAddress.balanceOf(address(this));
                                                        _TokenAddress.safeTransfer(owner(), qty);
                                                    }
                                                
                                                    // - to Pause the contract
                                                    function toggleContractActive() public onlyOwner {
                                                        stopped = !stopped;
                                                    }
                                                
                                                    // - to withdraw any ETH balance sitting in the contract
                                                    function withdraw() public onlyOwner {
                                                        uint256 contractBalance = address(this).balance;
                                                        address payable _to = owner().toPayable();
                                                        _to.transfer(contractBalance);
                                                    }
                                                
                                                    function() external payable {
                                                        require(msg.sender != tx.origin, "Do not send ETH directly");
                                                    }
                                                }

                                                File 2 of 12: WETH9
                                                // Copyright (C) 2015, 2016, 2017 Dapphub
                                                
                                                // This program is free software: you can redistribute it and/or modify
                                                // it under the terms of the GNU General Public License as published by
                                                // the Free Software Foundation, either version 3 of the License, or
                                                // (at your option) any later version.
                                                
                                                // This program is distributed in the hope that it will be useful,
                                                // but WITHOUT ANY WARRANTY; without even the implied warranty of
                                                // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                                                // GNU General Public License for more details.
                                                
                                                // You should have received a copy of the GNU General Public License
                                                // along with this program.  If not, see <http://www.gnu.org/licenses/>.
                                                
                                                pragma solidity ^0.4.18;
                                                
                                                contract WETH9 {
                                                    string public name     = "Wrapped Ether";
                                                    string public symbol   = "WETH";
                                                    uint8  public decimals = 18;
                                                
                                                    event  Approval(address indexed src, address indexed guy, uint wad);
                                                    event  Transfer(address indexed src, address indexed dst, uint wad);
                                                    event  Deposit(address indexed dst, uint wad);
                                                    event  Withdrawal(address indexed src, uint wad);
                                                
                                                    mapping (address => uint)                       public  balanceOf;
                                                    mapping (address => mapping (address => uint))  public  allowance;
                                                
                                                    function() public payable {
                                                        deposit();
                                                    }
                                                    function deposit() public payable {
                                                        balanceOf[msg.sender] += msg.value;
                                                        Deposit(msg.sender, msg.value);
                                                    }
                                                    function withdraw(uint wad) public {
                                                        require(balanceOf[msg.sender] >= wad);
                                                        balanceOf[msg.sender] -= wad;
                                                        msg.sender.transfer(wad);
                                                        Withdrawal(msg.sender, wad);
                                                    }
                                                
                                                    function totalSupply() public view returns (uint) {
                                                        return this.balance;
                                                    }
                                                
                                                    function approve(address guy, uint wad) public returns (bool) {
                                                        allowance[msg.sender][guy] = wad;
                                                        Approval(msg.sender, guy, wad);
                                                        return true;
                                                    }
                                                
                                                    function transfer(address dst, uint wad) public returns (bool) {
                                                        return transferFrom(msg.sender, dst, wad);
                                                    }
                                                
                                                    function transferFrom(address src, address dst, uint wad)
                                                        public
                                                        returns (bool)
                                                    {
                                                        require(balanceOf[src] >= wad);
                                                
                                                        if (src != msg.sender && allowance[src][msg.sender] != uint(-1)) {
                                                            require(allowance[src][msg.sender] >= wad);
                                                            allowance[src][msg.sender] -= wad;
                                                        }
                                                
                                                        balanceOf[src] -= wad;
                                                        balanceOf[dst] += wad;
                                                
                                                        Transfer(src, dst, wad);
                                                
                                                        return true;
                                                    }
                                                }
                                                
                                                
                                                /*
                                                                    GNU GENERAL PUBLIC LICENSE
                                                                       Version 3, 29 June 2007
                                                
                                                 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
                                                 Everyone is permitted to copy and distribute verbatim copies
                                                 of this license document, but changing it is not allowed.
                                                
                                                                            Preamble
                                                
                                                  The GNU General Public License is a free, copyleft license for
                                                software and other kinds of works.
                                                
                                                  The licenses for most software and other practical works are designed
                                                to take away your freedom to share and change the works.  By contrast,
                                                the GNU General Public License is intended to guarantee your freedom to
                                                share and change all versions of a program--to make sure it remains free
                                                software for all its users.  We, the Free Software Foundation, use the
                                                GNU General Public License for most of our software; it applies also to
                                                any other work released this way by its authors.  You can apply it to
                                                your programs, too.
                                                
                                                  When we speak of free software, we are referring to freedom, not
                                                price.  Our General Public Licenses are designed to make sure that you
                                                have the freedom to distribute copies of free software (and charge for
                                                them if you wish), that you receive source code or can get it if you
                                                want it, that you can change the software or use pieces of it in new
                                                free programs, and that you know you can do these things.
                                                
                                                  To protect your rights, we need to prevent others from denying you
                                                these rights or asking you to surrender the rights.  Therefore, you have
                                                certain responsibilities if you distribute copies of the software, or if
                                                you modify it: responsibilities to respect the freedom of others.
                                                
                                                  For example, if you distribute copies of such a program, whether
                                                gratis or for a fee, you must pass on to the recipients the same
                                                freedoms that you received.  You must make sure that they, too, receive
                                                or can get the source code.  And you must show them these terms so they
                                                know their rights.
                                                
                                                  Developers that use the GNU GPL protect your rights with two steps:
                                                (1) assert copyright on the software, and (2) offer you this License
                                                giving you legal permission to copy, distribute and/or modify it.
                                                
                                                  For the developers' and authors' protection, the GPL clearly explains
                                                that there is no warranty for this free software.  For both users' and
                                                authors' sake, the GPL requires that modified versions be marked as
                                                changed, so that their problems will not be attributed erroneously to
                                                authors of previous versions.
                                                
                                                  Some devices are designed to deny users access to install or run
                                                modified versions of the software inside them, although the manufacturer
                                                can do so.  This is fundamentally incompatible with the aim of
                                                protecting users' freedom to change the software.  The systematic
                                                pattern of such abuse occurs in the area of products for individuals to
                                                use, which is precisely where it is most unacceptable.  Therefore, we
                                                have designed this version of the GPL to prohibit the practice for those
                                                products.  If such problems arise substantially in other domains, we
                                                stand ready to extend this provision to those domains in future versions
                                                of the GPL, as needed to protect the freedom of users.
                                                
                                                  Finally, every program is threatened constantly by software patents.
                                                States should not allow patents to restrict development and use of
                                                software on general-purpose computers, but in those that do, we wish to
                                                avoid the special danger that patents applied to a free program could
                                                make it effectively proprietary.  To prevent this, the GPL assures that
                                                patents cannot be used to render the program non-free.
                                                
                                                  The precise terms and conditions for copying, distribution and
                                                modification follow.
                                                
                                                                       TERMS AND CONDITIONS
                                                
                                                  0. Definitions.
                                                
                                                  "This License" refers to version 3 of the GNU General Public License.
                                                
                                                  "Copyright" also means copyright-like laws that apply to other kinds of
                                                works, such as semiconductor masks.
                                                
                                                  "The Program" refers to any copyrightable work licensed under this
                                                License.  Each licensee is addressed as "you".  "Licensees" and
                                                "recipients" may be individuals or organizations.
                                                
                                                  To "modify" a work means to copy from or adapt all or part of the work
                                                in a fashion requiring copyright permission, other than the making of an
                                                exact copy.  The resulting work is called a "modified version" of the
                                                earlier work or a work "based on" the earlier work.
                                                
                                                  A "covered work" means either the unmodified Program or a work based
                                                on the Program.
                                                
                                                  To "propagate" a work means to do anything with it that, without
                                                permission, would make you directly or secondarily liable for
                                                infringement under applicable copyright law, except executing it on a
                                                computer or modifying a private copy.  Propagation includes copying,
                                                distribution (with or without modification), making available to the
                                                public, and in some countries other activities as well.
                                                
                                                  To "convey" a work means any kind of propagation that enables other
                                                parties to make or receive copies.  Mere interaction with a user through
                                                a computer network, with no transfer of a copy, is not conveying.
                                                
                                                  An interactive user interface displays "Appropriate Legal Notices"
                                                to the extent that it includes a convenient and prominently visible
                                                feature that (1) displays an appropriate copyright notice, and (2)
                                                tells the user that there is no warranty for the work (except to the
                                                extent that warranties are provided), that licensees may convey the
                                                work under this License, and how to view a copy of this License.  If
                                                the interface presents a list of user commands or options, such as a
                                                menu, a prominent item in the list meets this criterion.
                                                
                                                  1. Source Code.
                                                
                                                  The "source code" for a work means the preferred form of the work
                                                for making modifications to it.  "Object code" means any non-source
                                                form of a work.
                                                
                                                  A "Standard Interface" means an interface that either is an official
                                                standard defined by a recognized standards body, or, in the case of
                                                interfaces specified for a particular programming language, one that
                                                is widely used among developers working in that language.
                                                
                                                  The "System Libraries" of an executable work include anything, other
                                                than the work as a whole, that (a) is included in the normal form of
                                                packaging a Major Component, but which is not part of that Major
                                                Component, and (b) serves only to enable use of the work with that
                                                Major Component, or to implement a Standard Interface for which an
                                                implementation is available to the public in source code form.  A
                                                "Major Component", in this context, means a major essential component
                                                (kernel, window system, and so on) of the specific operating system
                                                (if any) on which the executable work runs, or a compiler used to
                                                produce the work, or an object code interpreter used to run it.
                                                
                                                  The "Corresponding Source" for a work in object code form means all
                                                the source code needed to generate, install, and (for an executable
                                                work) run the object code and to modify the work, including scripts to
                                                control those activities.  However, it does not include the work's
                                                System Libraries, or general-purpose tools or generally available free
                                                programs which are used unmodified in performing those activities but
                                                which are not part of the work.  For example, Corresponding Source
                                                includes interface definition files associated with source files for
                                                the work, and the source code for shared libraries and dynamically
                                                linked subprograms that the work is specifically designed to require,
                                                such as by intimate data communication or control flow between those
                                                subprograms and other parts of the work.
                                                
                                                  The Corresponding Source need not include anything that users
                                                can regenerate automatically from other parts of the Corresponding
                                                Source.
                                                
                                                  The Corresponding Source for a work in source code form is that
                                                same work.
                                                
                                                  2. Basic Permissions.
                                                
                                                  All rights granted under this License are granted for the term of
                                                copyright on the Program, and are irrevocable provided the stated
                                                conditions are met.  This License explicitly affirms your unlimited
                                                permission to run the unmodified Program.  The output from running a
                                                covered work is covered by this License only if the output, given its
                                                content, constitutes a covered work.  This License acknowledges your
                                                rights of fair use or other equivalent, as provided by copyright law.
                                                
                                                  You may make, run and propagate covered works that you do not
                                                convey, without conditions so long as your license otherwise remains
                                                in force.  You may convey covered works to others for the sole purpose
                                                of having them make modifications exclusively for you, or provide you
                                                with facilities for running those works, provided that you comply with
                                                the terms of this License in conveying all material for which you do
                                                not control copyright.  Those thus making or running the covered works
                                                for you must do so exclusively on your behalf, under your direction
                                                and control, on terms that prohibit them from making any copies of
                                                your copyrighted material outside their relationship with you.
                                                
                                                  Conveying under any other circumstances is permitted solely under
                                                the conditions stated below.  Sublicensing is not allowed; section 10
                                                makes it unnecessary.
                                                
                                                  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
                                                
                                                  No covered work shall be deemed part of an effective technological
                                                measure under any applicable law fulfilling obligations under article
                                                11 of the WIPO copyright treaty adopted on 20 December 1996, or
                                                similar laws prohibiting or restricting circumvention of such
                                                measures.
                                                
                                                  When you convey a covered work, you waive any legal power to forbid
                                                circumvention of technological measures to the extent such circumvention
                                                is effected by exercising rights under this License with respect to
                                                the covered work, and you disclaim any intention to limit operation or
                                                modification of the work as a means of enforcing, against the work's
                                                users, your or third parties' legal rights to forbid circumvention of
                                                technological measures.
                                                
                                                  4. Conveying Verbatim Copies.
                                                
                                                  You may convey verbatim copies of the Program's source code as you
                                                receive it, in any medium, provided that you conspicuously and
                                                appropriately publish on each copy an appropriate copyright notice;
                                                keep intact all notices stating that this License and any
                                                non-permissive terms added in accord with section 7 apply to the code;
                                                keep intact all notices of the absence of any warranty; and give all
                                                recipients a copy of this License along with the Program.
                                                
                                                  You may charge any price or no price for each copy that you convey,
                                                and you may offer support or warranty protection for a fee.
                                                
                                                  5. Conveying Modified Source Versions.
                                                
                                                  You may convey a work based on the Program, or the modifications to
                                                produce it from the Program, in the form of source code under the
                                                terms of section 4, provided that you also meet all of these conditions:
                                                
                                                    a) The work must carry prominent notices stating that you modified
                                                    it, and giving a relevant date.
                                                
                                                    b) The work must carry prominent notices stating that it is
                                                    released under this License and any conditions added under section
                                                    7.  This requirement modifies the requirement in section 4 to
                                                    "keep intact all notices".
                                                
                                                    c) You must license the entire work, as a whole, under this
                                                    License to anyone who comes into possession of a copy.  This
                                                    License will therefore apply, along with any applicable section 7
                                                    additional terms, to the whole of the work, and all its parts,
                                                    regardless of how they are packaged.  This License gives no
                                                    permission to license the work in any other way, but it does not
                                                    invalidate such permission if you have separately received it.
                                                
                                                    d) If the work has interactive user interfaces, each must display
                                                    Appropriate Legal Notices; however, if the Program has interactive
                                                    interfaces that do not display Appropriate Legal Notices, your
                                                    work need not make them do so.
                                                
                                                  A compilation of a covered work with other separate and independent
                                                works, which are not by their nature extensions of the covered work,
                                                and which are not combined with it such as to form a larger program,
                                                in or on a volume of a storage or distribution medium, is called an
                                                "aggregate" if the compilation and its resulting copyright are not
                                                used to limit the access or legal rights of the compilation's users
                                                beyond what the individual works permit.  Inclusion of a covered work
                                                in an aggregate does not cause this License to apply to the other
                                                parts of the aggregate.
                                                
                                                  6. Conveying Non-Source Forms.
                                                
                                                  You may convey a covered work in object code form under the terms
                                                of sections 4 and 5, provided that you also convey the
                                                machine-readable Corresponding Source under the terms of this License,
                                                in one of these ways:
                                                
                                                    a) Convey the object code in, or embodied in, a physical product
                                                    (including a physical distribution medium), accompanied by the
                                                    Corresponding Source fixed on a durable physical medium
                                                    customarily used for software interchange.
                                                
                                                    b) Convey the object code in, or embodied in, a physical product
                                                    (including a physical distribution medium), accompanied by a
                                                    written offer, valid for at least three years and valid for as
                                                    long as you offer spare parts or customer support for that product
                                                    model, to give anyone who possesses the object code either (1) a
                                                    copy of the Corresponding Source for all the software in the
                                                    product that is covered by this License, on a durable physical
                                                    medium customarily used for software interchange, for a price no
                                                    more than your reasonable cost of physically performing this
                                                    conveying of source, or (2) access to copy the
                                                    Corresponding Source from a network server at no charge.
                                                
                                                    c) Convey individual copies of the object code with a copy of the
                                                    written offer to provide the Corresponding Source.  This
                                                    alternative is allowed only occasionally and noncommercially, and
                                                    only if you received the object code with such an offer, in accord
                                                    with subsection 6b.
                                                
                                                    d) Convey the object code by offering access from a designated
                                                    place (gratis or for a charge), and offer equivalent access to the
                                                    Corresponding Source in the same way through the same place at no
                                                    further charge.  You need not require recipients to copy the
                                                    Corresponding Source along with the object code.  If the place to
                                                    copy the object code is a network server, the Corresponding Source
                                                    may be on a different server (operated by you or a third party)
                                                    that supports equivalent copying facilities, provided you maintain
                                                    clear directions next to the object code saying where to find the
                                                    Corresponding Source.  Regardless of what server hosts the
                                                    Corresponding Source, you remain obligated to ensure that it is
                                                    available for as long as needed to satisfy these requirements.
                                                
                                                    e) Convey the object code using peer-to-peer transmission, provided
                                                    you inform other peers where the object code and Corresponding
                                                    Source of the work are being offered to the general public at no
                                                    charge under subsection 6d.
                                                
                                                  A separable portion of the object code, whose source code is excluded
                                                from the Corresponding Source as a System Library, need not be
                                                included in conveying the object code work.
                                                
                                                  A "User Product" is either (1) a "consumer product", which means any
                                                tangible personal property which is normally used for personal, family,
                                                or household purposes, or (2) anything designed or sold for incorporation
                                                into a dwelling.  In determining whether a product is a consumer product,
                                                doubtful cases shall be resolved in favor of coverage.  For a particular
                                                product received by a particular user, "normally used" refers to a
                                                typical or common use of that class of product, regardless of the status
                                                of the particular user or of the way in which the particular user
                                                actually uses, or expects or is expected to use, the product.  A product
                                                is a consumer product regardless of whether the product has substantial
                                                commercial, industrial or non-consumer uses, unless such uses represent
                                                the only significant mode of use of the product.
                                                
                                                  "Installation Information" for a User Product means any methods,
                                                procedures, authorization keys, or other information required to install
                                                and execute modified versions of a covered work in that User Product from
                                                a modified version of its Corresponding Source.  The information must
                                                suffice to ensure that the continued functioning of the modified object
                                                code is in no case prevented or interfered with solely because
                                                modification has been made.
                                                
                                                  If you convey an object code work under this section in, or with, or
                                                specifically for use in, a User Product, and the conveying occurs as
                                                part of a transaction in which the right of possession and use of the
                                                User Product is transferred to the recipient in perpetuity or for a
                                                fixed term (regardless of how the transaction is characterized), the
                                                Corresponding Source conveyed under this section must be accompanied
                                                by the Installation Information.  But this requirement does not apply
                                                if neither you nor any third party retains the ability to install
                                                modified object code on the User Product (for example, the work has
                                                been installed in ROM).
                                                
                                                  The requirement to provide Installation Information does not include a
                                                requirement to continue to provide support service, warranty, or updates
                                                for a work that has been modified or installed by the recipient, or for
                                                the User Product in which it has been modified or installed.  Access to a
                                                network may be denied when the modification itself materially and
                                                adversely affects the operation of the network or violates the rules and
                                                protocols for communication across the network.
                                                
                                                  Corresponding Source conveyed, and Installation Information provided,
                                                in accord with this section must be in a format that is publicly
                                                documented (and with an implementation available to the public in
                                                source code form), and must require no special password or key for
                                                unpacking, reading or copying.
                                                
                                                  7. Additional Terms.
                                                
                                                  "Additional permissions" are terms that supplement the terms of this
                                                License by making exceptions from one or more of its conditions.
                                                Additional permissions that are applicable to the entire Program shall
                                                be treated as though they were included in this License, to the extent
                                                that they are valid under applicable law.  If additional permissions
                                                apply only to part of the Program, that part may be used separately
                                                under those permissions, but the entire Program remains governed by
                                                this License without regard to the additional permissions.
                                                
                                                  When you convey a copy of a covered work, you may at your option
                                                remove any additional permissions from that copy, or from any part of
                                                it.  (Additional permissions may be written to require their own
                                                removal in certain cases when you modify the work.)  You may place
                                                additional permissions on material, added by you to a covered work,
                                                for which you have or can give appropriate copyright permission.
                                                
                                                  Notwithstanding any other provision of this License, for material you
                                                add to a covered work, you may (if authorized by the copyright holders of
                                                that material) supplement the terms of this License with terms:
                                                
                                                    a) Disclaiming warranty or limiting liability differently from the
                                                    terms of sections 15 and 16 of this License; or
                                                
                                                    b) Requiring preservation of specified reasonable legal notices or
                                                    author attributions in that material or in the Appropriate Legal
                                                    Notices displayed by works containing it; or
                                                
                                                    c) Prohibiting misrepresentation of the origin of that material, or
                                                    requiring that modified versions of such material be marked in
                                                    reasonable ways as different from the original version; or
                                                
                                                    d) Limiting the use for publicity purposes of names of licensors or
                                                    authors of the material; or
                                                
                                                    e) Declining to grant rights under trademark law for use of some
                                                    trade names, trademarks, or service marks; or
                                                
                                                    f) Requiring indemnification of licensors and authors of that
                                                    material by anyone who conveys the material (or modified versions of
                                                    it) with contractual assumptions of liability to the recipient, for
                                                    any liability that these contractual assumptions directly impose on
                                                    those licensors and authors.
                                                
                                                  All other non-permissive additional terms are considered "further
                                                restrictions" within the meaning of section 10.  If the Program as you
                                                received it, or any part of it, contains a notice stating that it is
                                                governed by this License along with a term that is a further
                                                restriction, you may remove that term.  If a license document contains
                                                a further restriction but permits relicensing or conveying under this
                                                License, you may add to a covered work material governed by the terms
                                                of that license document, provided that the further restriction does
                                                not survive such relicensing or conveying.
                                                
                                                  If you add terms to a covered work in accord with this section, you
                                                must place, in the relevant source files, a statement of the
                                                additional terms that apply to those files, or a notice indicating
                                                where to find the applicable terms.
                                                
                                                  Additional terms, permissive or non-permissive, may be stated in the
                                                form of a separately written license, or stated as exceptions;
                                                the above requirements apply either way.
                                                
                                                  8. Termination.
                                                
                                                  You may not propagate or modify a covered work except as expressly
                                                provided under this License.  Any attempt otherwise to propagate or
                                                modify it is void, and will automatically terminate your rights under
                                                this License (including any patent licenses granted under the third
                                                paragraph of section 11).
                                                
                                                  However, if you cease all violation of this License, then your
                                                license from a particular copyright holder is reinstated (a)
                                                provisionally, unless and until the copyright holder explicitly and
                                                finally terminates your license, and (b) permanently, if the copyright
                                                holder fails to notify you of the violation by some reasonable means
                                                prior to 60 days after the cessation.
                                                
                                                  Moreover, your license from a particular copyright holder is
                                                reinstated permanently if the copyright holder notifies you of the
                                                violation by some reasonable means, this is the first time you have
                                                received notice of violation of this License (for any work) from that
                                                copyright holder, and you cure the violation prior to 30 days after
                                                your receipt of the notice.
                                                
                                                  Termination of your rights under this section does not terminate the
                                                licenses of parties who have received copies or rights from you under
                                                this License.  If your rights have been terminated and not permanently
                                                reinstated, you do not qualify to receive new licenses for the same
                                                material under section 10.
                                                
                                                  9. Acceptance Not Required for Having Copies.
                                                
                                                  You are not required to accept this License in order to receive or
                                                run a copy of the Program.  Ancillary propagation of a covered work
                                                occurring solely as a consequence of using peer-to-peer transmission
                                                to receive a copy likewise does not require acceptance.  However,
                                                nothing other than this License grants you permission to propagate or
                                                modify any covered work.  These actions infringe copyright if you do
                                                not accept this License.  Therefore, by modifying or propagating a
                                                covered work, you indicate your acceptance of this License to do so.
                                                
                                                  10. Automatic Licensing of Downstream Recipients.
                                                
                                                  Each time you convey a covered work, the recipient automatically
                                                receives a license from the original licensors, to run, modify and
                                                propagate that work, subject to this License.  You are not responsible
                                                for enforcing compliance by third parties with this License.
                                                
                                                  An "entity transaction" is a transaction transferring control of an
                                                organization, or substantially all assets of one, or subdividing an
                                                organization, or merging organizations.  If propagation of a covered
                                                work results from an entity transaction, each party to that
                                                transaction who receives a copy of the work also receives whatever
                                                licenses to the work the party's predecessor in interest had or could
                                                give under the previous paragraph, plus a right to possession of the
                                                Corresponding Source of the work from the predecessor in interest, if
                                                the predecessor has it or can get it with reasonable efforts.
                                                
                                                  You may not impose any further restrictions on the exercise of the
                                                rights granted or affirmed under this License.  For example, you may
                                                not impose a license fee, royalty, or other charge for exercise of
                                                rights granted under this License, and you may not initiate litigation
                                                (including a cross-claim or counterclaim in a lawsuit) alleging that
                                                any patent claim is infringed by making, using, selling, offering for
                                                sale, or importing the Program or any portion of it.
                                                
                                                  11. Patents.
                                                
                                                  A "contributor" is a copyright holder who authorizes use under this
                                                License of the Program or a work on which the Program is based.  The
                                                work thus licensed is called the contributor's "contributor version".
                                                
                                                  A contributor's "essential patent claims" are all patent claims
                                                owned or controlled by the contributor, whether already acquired or
                                                hereafter acquired, that would be infringed by some manner, permitted
                                                by this License, of making, using, or selling its contributor version,
                                                but do not include claims that would be infringed only as a
                                                consequence of further modification of the contributor version.  For
                                                purposes of this definition, "control" includes the right to grant
                                                patent sublicenses in a manner consistent with the requirements of
                                                this License.
                                                
                                                  Each contributor grants you a non-exclusive, worldwide, royalty-free
                                                patent license under the contributor's essential patent claims, to
                                                make, use, sell, offer for sale, import and otherwise run, modify and
                                                propagate the contents of its contributor version.
                                                
                                                  In the following three paragraphs, a "patent license" is any express
                                                agreement or commitment, however denominated, not to enforce a patent
                                                (such as an express permission to practice a patent or covenant not to
                                                sue for patent infringement).  To "grant" such a patent license to a
                                                party means to make such an agreement or commitment not to enforce a
                                                patent against the party.
                                                
                                                  If you convey a covered work, knowingly relying on a patent license,
                                                and the Corresponding Source of the work is not available for anyone
                                                to copy, free of charge and under the terms of this License, through a
                                                publicly available network server or other readily accessible means,
                                                then you must either (1) cause the Corresponding Source to be so
                                                available, or (2) arrange to deprive yourself of the benefit of the
                                                patent license for this particular work, or (3) arrange, in a manner
                                                consistent with the requirements of this License, to extend the patent
                                                license to downstream recipients.  "Knowingly relying" means you have
                                                actual knowledge that, but for the patent license, your conveying the
                                                covered work in a country, or your recipient's use of the covered work
                                                in a country, would infringe one or more identifiable patents in that
                                                country that you have reason to believe are valid.
                                                
                                                  If, pursuant to or in connection with a single transaction or
                                                arrangement, you convey, or propagate by procuring conveyance of, a
                                                covered work, and grant a patent license to some of the parties
                                                receiving the covered work authorizing them to use, propagate, modify
                                                or convey a specific copy of the covered work, then the patent license
                                                you grant is automatically extended to all recipients of the covered
                                                work and works based on it.
                                                
                                                  A patent license is "discriminatory" if it does not include within
                                                the scope of its coverage, prohibits the exercise of, or is
                                                conditioned on the non-exercise of one or more of the rights that are
                                                specifically granted under this License.  You may not convey a covered
                                                work if you are a party to an arrangement with a third party that is
                                                in the business of distributing software, under which you make payment
                                                to the third party based on the extent of your activity of conveying
                                                the work, and under which the third party grants, to any of the
                                                parties who would receive the covered work from you, a discriminatory
                                                patent license (a) in connection with copies of the covered work
                                                conveyed by you (or copies made from those copies), or (b) primarily
                                                for and in connection with specific products or compilations that
                                                contain the covered work, unless you entered into that arrangement,
                                                or that patent license was granted, prior to 28 March 2007.
                                                
                                                  Nothing in this License shall be construed as excluding or limiting
                                                any implied license or other defenses to infringement that may
                                                otherwise be available to you under applicable patent law.
                                                
                                                  12. No Surrender of Others' Freedom.
                                                
                                                  If conditions are imposed on you (whether by court order, agreement or
                                                otherwise) that contradict the conditions of this License, they do not
                                                excuse you from the conditions of this License.  If you cannot convey a
                                                covered work so as to satisfy simultaneously your obligations under this
                                                License and any other pertinent obligations, then as a consequence you may
                                                not convey it at all.  For example, if you agree to terms that obligate you
                                                to collect a royalty for further conveying from those to whom you convey
                                                the Program, the only way you could satisfy both those terms and this
                                                License would be to refrain entirely from conveying the Program.
                                                
                                                  13. Use with the GNU Affero General Public License.
                                                
                                                  Notwithstanding any other provision of this License, you have
                                                permission to link or combine any covered work with a work licensed
                                                under version 3 of the GNU Affero General Public License into a single
                                                combined work, and to convey the resulting work.  The terms of this
                                                License will continue to apply to the part which is the covered work,
                                                but the special requirements of the GNU Affero General Public License,
                                                section 13, concerning interaction through a network will apply to the
                                                combination as such.
                                                
                                                  14. Revised Versions of this License.
                                                
                                                  The Free Software Foundation may publish revised and/or new versions of
                                                the GNU General Public License from time to time.  Such new versions will
                                                be similar in spirit to the present version, but may differ in detail to
                                                address new problems or concerns.
                                                
                                                  Each version is given a distinguishing version number.  If the
                                                Program specifies that a certain numbered version of the GNU General
                                                Public License "or any later version" applies to it, you have the
                                                option of following the terms and conditions either of that numbered
                                                version or of any later version published by the Free Software
                                                Foundation.  If the Program does not specify a version number of the
                                                GNU General Public License, you may choose any version ever published
                                                by the Free Software Foundation.
                                                
                                                  If the Program specifies that a proxy can decide which future
                                                versions of the GNU General Public License can be used, that proxy's
                                                public statement of acceptance of a version permanently authorizes you
                                                to choose that version for the Program.
                                                
                                                  Later license versions may give you additional or different
                                                permissions.  However, no additional obligations are imposed on any
                                                author or copyright holder as a result of your choosing to follow a
                                                later version.
                                                
                                                  15. Disclaimer of Warranty.
                                                
                                                  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
                                                APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
                                                HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
                                                OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
                                                THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
                                                PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
                                                IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
                                                ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
                                                
                                                  16. Limitation of Liability.
                                                
                                                  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
                                                WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
                                                THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
                                                GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
                                                USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
                                                DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
                                                PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
                                                EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
                                                SUCH DAMAGES.
                                                
                                                  17. Interpretation of Sections 15 and 16.
                                                
                                                  If the disclaimer of warranty and limitation of liability provided
                                                above cannot be given local legal effect according to their terms,
                                                reviewing courts shall apply local law that most closely approximates
                                                an absolute waiver of all civil liability in connection with the
                                                Program, unless a warranty or assumption of liability accompanies a
                                                copy of the Program in return for a fee.
                                                
                                                                     END OF TERMS AND CONDITIONS
                                                
                                                            How to Apply These Terms to Your New Programs
                                                
                                                  If you develop a new program, and you want it to be of the greatest
                                                possible use to the public, the best way to achieve this is to make it
                                                free software which everyone can redistribute and change under these terms.
                                                
                                                  To do so, attach the following notices to the program.  It is safest
                                                to attach them to the start of each source file to most effectively
                                                state the exclusion of warranty; and each file should have at least
                                                the "copyright" line and a pointer to where the full notice is found.
                                                
                                                    <one line to give the program's name and a brief idea of what it does.>
                                                    Copyright (C) <year>  <name of author>
                                                
                                                    This program is free software: you can redistribute it and/or modify
                                                    it under the terms of the GNU General Public License as published by
                                                    the Free Software Foundation, either version 3 of the License, or
                                                    (at your option) any later version.
                                                
                                                    This program is distributed in the hope that it will be useful,
                                                    but WITHOUT ANY WARRANTY; without even the implied warranty of
                                                    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                                                    GNU General Public License for more details.
                                                
                                                    You should have received a copy of the GNU General Public License
                                                    along with this program.  If not, see <http://www.gnu.org/licenses/>.
                                                
                                                Also add information on how to contact you by electronic and paper mail.
                                                
                                                  If the program does terminal interaction, make it output a short
                                                notice like this when it starts in an interactive mode:
                                                
                                                    <program>  Copyright (C) <year>  <name of author>
                                                    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
                                                    This is free software, and you are welcome to redistribute it
                                                    under certain conditions; type `show c' for details.
                                                
                                                The hypothetical commands `show w' and `show c' should show the appropriate
                                                parts of the General Public License.  Of course, your program's commands
                                                might be different; for a GUI interface, you would use an "about box".
                                                
                                                  You should also get your employer (if you work as a programmer) or school,
                                                if any, to sign a "copyright disclaimer" for the program, if necessary.
                                                For more information on this, and how to apply and follow the GNU GPL, see
                                                <http://www.gnu.org/licenses/>.
                                                
                                                  The GNU General Public License does not permit incorporating your program
                                                into proprietary programs.  If your program is a subroutine library, you
                                                may consider it more useful to permit linking proprietary applications with
                                                the library.  If this is what you want to do, use the GNU Lesser General
                                                Public License instead of this License.  But first, please read
                                                <http://www.gnu.org/philosophy/why-not-lgpl.html>.
                                                
                                                */

                                                File 3 of 12: UniswapV2Pair
                                                // File: contracts/interfaces/IUniswapV2Pair.sol
                                                
                                                pragma solidity >=0.5.0;
                                                
                                                interface IUniswapV2Pair {
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    function name() external pure returns (string memory);
                                                    function symbol() external pure returns (string memory);
                                                    function decimals() external pure returns (uint8);
                                                    function totalSupply() external view returns (uint);
                                                    function balanceOf(address owner) external view returns (uint);
                                                    function allowance(address owner, address spender) external view returns (uint);
                                                
                                                    function approve(address spender, uint value) external returns (bool);
                                                    function transfer(address to, uint value) external returns (bool);
                                                    function transferFrom(address from, address to, uint value) external returns (bool);
                                                
                                                    function DOMAIN_SEPARATOR() external view returns (bytes32);
                                                    function PERMIT_TYPEHASH() external pure returns (bytes32);
                                                    function nonces(address owner) external view returns (uint);
                                                
                                                    function permit(address owner, address spender, uint value, uint deadline, uint8 v, bytes32 r, bytes32 s) external;
                                                
                                                    event Mint(address indexed sender, uint amount0, uint amount1);
                                                    event Burn(address indexed sender, uint amount0, uint amount1, address indexed to);
                                                    event Swap(
                                                        address indexed sender,
                                                        uint amount0In,
                                                        uint amount1In,
                                                        uint amount0Out,
                                                        uint amount1Out,
                                                        address indexed to
                                                    );
                                                    event Sync(uint112 reserve0, uint112 reserve1);
                                                
                                                    function MINIMUM_LIQUIDITY() external pure returns (uint);
                                                    function factory() external view returns (address);
                                                    function token0() external view returns (address);
                                                    function token1() external view returns (address);
                                                    function getReserves() external view returns (uint112 reserve0, uint112 reserve1, uint32 blockTimestampLast);
                                                    function price0CumulativeLast() external view returns (uint);
                                                    function price1CumulativeLast() external view returns (uint);
                                                    function kLast() external view returns (uint);
                                                
                                                    function mint(address to) external returns (uint liquidity);
                                                    function burn(address to) external returns (uint amount0, uint amount1);
                                                    function swap(uint amount0Out, uint amount1Out, address to, bytes calldata data) external;
                                                    function skim(address to) external;
                                                    function sync() external;
                                                
                                                    function initialize(address, address) external;
                                                }
                                                
                                                // File: contracts/interfaces/IUniswapV2ERC20.sol
                                                
                                                pragma solidity >=0.5.0;
                                                
                                                interface IUniswapV2ERC20 {
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    function name() external pure returns (string memory);
                                                    function symbol() external pure returns (string memory);
                                                    function decimals() external pure returns (uint8);
                                                    function totalSupply() external view returns (uint);
                                                    function balanceOf(address owner) external view returns (uint);
                                                    function allowance(address owner, address spender) external view returns (uint);
                                                
                                                    function approve(address spender, uint value) external returns (bool);
                                                    function transfer(address to, uint value) external returns (bool);
                                                    function transferFrom(address from, address to, uint value) external returns (bool);
                                                
                                                    function DOMAIN_SEPARATOR() external view returns (bytes32);
                                                    function PERMIT_TYPEHASH() external pure returns (bytes32);
                                                    function nonces(address owner) external view returns (uint);
                                                
                                                    function permit(address owner, address spender, uint value, uint deadline, uint8 v, bytes32 r, bytes32 s) external;
                                                }
                                                
                                                // File: contracts/libraries/SafeMath.sol
                                                
                                                pragma solidity =0.5.16;
                                                
                                                // a library for performing overflow-safe math, courtesy of DappHub (https://github.com/dapphub/ds-math)
                                                
                                                library SafeMath {
                                                    function add(uint x, uint y) internal pure returns (uint z) {
                                                        require((z = x + y) >= x, 'ds-math-add-overflow');
                                                    }
                                                
                                                    function sub(uint x, uint y) internal pure returns (uint z) {
                                                        require((z = x - y) <= x, 'ds-math-sub-underflow');
                                                    }
                                                
                                                    function mul(uint x, uint y) internal pure returns (uint z) {
                                                        require(y == 0 || (z = x * y) / y == x, 'ds-math-mul-overflow');
                                                    }
                                                }
                                                
                                                // File: contracts/UniswapV2ERC20.sol
                                                
                                                pragma solidity =0.5.16;
                                                
                                                
                                                
                                                contract UniswapV2ERC20 is IUniswapV2ERC20 {
                                                    using SafeMath for uint;
                                                
                                                    string public constant name = 'Uniswap V2';
                                                    string public constant symbol = 'UNI-V2';
                                                    uint8 public constant decimals = 18;
                                                    uint  public totalSupply;
                                                    mapping(address => uint) public balanceOf;
                                                    mapping(address => mapping(address => uint)) public allowance;
                                                
                                                    bytes32 public DOMAIN_SEPARATOR;
                                                    // keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)");
                                                    bytes32 public constant PERMIT_TYPEHASH = 0x6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9;
                                                    mapping(address => uint) public nonces;
                                                
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    constructor() public {
                                                        uint chainId;
                                                        assembly {
                                                            chainId := chainid
                                                        }
                                                        DOMAIN_SEPARATOR = keccak256(
                                                            abi.encode(
                                                                keccak256('EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)'),
                                                                keccak256(bytes(name)),
                                                                keccak256(bytes('1')),
                                                                chainId,
                                                                address(this)
                                                            )
                                                        );
                                                    }
                                                
                                                    function _mint(address to, uint value) internal {
                                                        totalSupply = totalSupply.add(value);
                                                        balanceOf[to] = balanceOf[to].add(value);
                                                        emit Transfer(address(0), to, value);
                                                    }
                                                
                                                    function _burn(address from, uint value) internal {
                                                        balanceOf[from] = balanceOf[from].sub(value);
                                                        totalSupply = totalSupply.sub(value);
                                                        emit Transfer(from, address(0), value);
                                                    }
                                                
                                                    function _approve(address owner, address spender, uint value) private {
                                                        allowance[owner][spender] = value;
                                                        emit Approval(owner, spender, value);
                                                    }
                                                
                                                    function _transfer(address from, address to, uint value) private {
                                                        balanceOf[from] = balanceOf[from].sub(value);
                                                        balanceOf[to] = balanceOf[to].add(value);
                                                        emit Transfer(from, to, value);
                                                    }
                                                
                                                    function approve(address spender, uint value) external returns (bool) {
                                                        _approve(msg.sender, spender, value);
                                                        return true;
                                                    }
                                                
                                                    function transfer(address to, uint value) external returns (bool) {
                                                        _transfer(msg.sender, to, value);
                                                        return true;
                                                    }
                                                
                                                    function transferFrom(address from, address to, uint value) external returns (bool) {
                                                        if (allowance[from][msg.sender] != uint(-1)) {
                                                            allowance[from][msg.sender] = allowance[from][msg.sender].sub(value);
                                                        }
                                                        _transfer(from, to, value);
                                                        return true;
                                                    }
                                                
                                                    function permit(address owner, address spender, uint value, uint deadline, uint8 v, bytes32 r, bytes32 s) external {
                                                        require(deadline >= block.timestamp, 'UniswapV2: EXPIRED');
                                                        bytes32 digest = keccak256(
                                                            abi.encodePacked(
                                                                '\x19\x01',
                                                                DOMAIN_SEPARATOR,
                                                                keccak256(abi.encode(PERMIT_TYPEHASH, owner, spender, value, nonces[owner]++, deadline))
                                                            )
                                                        );
                                                        address recoveredAddress = ecrecover(digest, v, r, s);
                                                        require(recoveredAddress != address(0) && recoveredAddress == owner, 'UniswapV2: INVALID_SIGNATURE');
                                                        _approve(owner, spender, value);
                                                    }
                                                }
                                                
                                                // File: contracts/libraries/Math.sol
                                                
                                                pragma solidity =0.5.16;
                                                
                                                // a library for performing various math operations
                                                
                                                library Math {
                                                    function min(uint x, uint y) internal pure returns (uint z) {
                                                        z = x < y ? x : y;
                                                    }
                                                
                                                    // babylonian method (https://en.wikipedia.org/wiki/Methods_of_computing_square_roots#Babylonian_method)
                                                    function sqrt(uint y) internal pure returns (uint z) {
                                                        if (y > 3) {
                                                            z = y;
                                                            uint x = y / 2 + 1;
                                                            while (x < z) {
                                                                z = x;
                                                                x = (y / x + x) / 2;
                                                            }
                                                        } else if (y != 0) {
                                                            z = 1;
                                                        }
                                                    }
                                                }
                                                
                                                // File: contracts/libraries/UQ112x112.sol
                                                
                                                pragma solidity =0.5.16;
                                                
                                                // a library for handling binary fixed point numbers (https://en.wikipedia.org/wiki/Q_(number_format))
                                                
                                                // range: [0, 2**112 - 1]
                                                // resolution: 1 / 2**112
                                                
                                                library UQ112x112 {
                                                    uint224 constant Q112 = 2**112;
                                                
                                                    // encode a uint112 as a UQ112x112
                                                    function encode(uint112 y) internal pure returns (uint224 z) {
                                                        z = uint224(y) * Q112; // never overflows
                                                    }
                                                
                                                    // divide a UQ112x112 by a uint112, returning a UQ112x112
                                                    function uqdiv(uint224 x, uint112 y) internal pure returns (uint224 z) {
                                                        z = x / uint224(y);
                                                    }
                                                }
                                                
                                                // File: contracts/interfaces/IERC20.sol
                                                
                                                pragma solidity >=0.5.0;
                                                
                                                interface IERC20 {
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    function name() external view returns (string memory);
                                                    function symbol() external view returns (string memory);
                                                    function decimals() external view returns (uint8);
                                                    function totalSupply() external view returns (uint);
                                                    function balanceOf(address owner) external view returns (uint);
                                                    function allowance(address owner, address spender) external view returns (uint);
                                                
                                                    function approve(address spender, uint value) external returns (bool);
                                                    function transfer(address to, uint value) external returns (bool);
                                                    function transferFrom(address from, address to, uint value) external returns (bool);
                                                }
                                                
                                                // File: contracts/interfaces/IUniswapV2Factory.sol
                                                
                                                pragma solidity >=0.5.0;
                                                
                                                interface IUniswapV2Factory {
                                                    event PairCreated(address indexed token0, address indexed token1, address pair, uint);
                                                
                                                    function feeTo() external view returns (address);
                                                    function feeToSetter() external view returns (address);
                                                
                                                    function getPair(address tokenA, address tokenB) external view returns (address pair);
                                                    function allPairs(uint) external view returns (address pair);
                                                    function allPairsLength() external view returns (uint);
                                                
                                                    function createPair(address tokenA, address tokenB) external returns (address pair);
                                                
                                                    function setFeeTo(address) external;
                                                    function setFeeToSetter(address) external;
                                                }
                                                
                                                // File: contracts/interfaces/IUniswapV2Callee.sol
                                                
                                                pragma solidity >=0.5.0;
                                                
                                                interface IUniswapV2Callee {
                                                    function uniswapV2Call(address sender, uint amount0, uint amount1, bytes calldata data) external;
                                                }
                                                
                                                // File: contracts/UniswapV2Pair.sol
                                                
                                                pragma solidity =0.5.16;
                                                
                                                
                                                
                                                
                                                
                                                
                                                
                                                
                                                contract UniswapV2Pair is IUniswapV2Pair, UniswapV2ERC20 {
                                                    using SafeMath  for uint;
                                                    using UQ112x112 for uint224;
                                                
                                                    uint public constant MINIMUM_LIQUIDITY = 10**3;
                                                    bytes4 private constant SELECTOR = bytes4(keccak256(bytes('transfer(address,uint256)')));
                                                
                                                    address public factory;
                                                    address public token0;
                                                    address public token1;
                                                
                                                    uint112 private reserve0;           // uses single storage slot, accessible via getReserves
                                                    uint112 private reserve1;           // uses single storage slot, accessible via getReserves
                                                    uint32  private blockTimestampLast; // uses single storage slot, accessible via getReserves
                                                
                                                    uint public price0CumulativeLast;
                                                    uint public price1CumulativeLast;
                                                    uint public kLast; // reserve0 * reserve1, as of immediately after the most recent liquidity event
                                                
                                                    uint private unlocked = 1;
                                                    modifier lock() {
                                                        require(unlocked == 1, 'UniswapV2: LOCKED');
                                                        unlocked = 0;
                                                        _;
                                                        unlocked = 1;
                                                    }
                                                
                                                    function getReserves() public view returns (uint112 _reserve0, uint112 _reserve1, uint32 _blockTimestampLast) {
                                                        _reserve0 = reserve0;
                                                        _reserve1 = reserve1;
                                                        _blockTimestampLast = blockTimestampLast;
                                                    }
                                                
                                                    function _safeTransfer(address token, address to, uint value) private {
                                                        (bool success, bytes memory data) = token.call(abi.encodeWithSelector(SELECTOR, to, value));
                                                        require(success && (data.length == 0 || abi.decode(data, (bool))), 'UniswapV2: TRANSFER_FAILED');
                                                    }
                                                
                                                    event Mint(address indexed sender, uint amount0, uint amount1);
                                                    event Burn(address indexed sender, uint amount0, uint amount1, address indexed to);
                                                    event Swap(
                                                        address indexed sender,
                                                        uint amount0In,
                                                        uint amount1In,
                                                        uint amount0Out,
                                                        uint amount1Out,
                                                        address indexed to
                                                    );
                                                    event Sync(uint112 reserve0, uint112 reserve1);
                                                
                                                    constructor() public {
                                                        factory = msg.sender;
                                                    }
                                                
                                                    // called once by the factory at time of deployment
                                                    function initialize(address _token0, address _token1) external {
                                                        require(msg.sender == factory, 'UniswapV2: FORBIDDEN'); // sufficient check
                                                        token0 = _token0;
                                                        token1 = _token1;
                                                    }
                                                
                                                    // update reserves and, on the first call per block, price accumulators
                                                    function _update(uint balance0, uint balance1, uint112 _reserve0, uint112 _reserve1) private {
                                                        require(balance0 <= uint112(-1) && balance1 <= uint112(-1), 'UniswapV2: OVERFLOW');
                                                        uint32 blockTimestamp = uint32(block.timestamp % 2**32);
                                                        uint32 timeElapsed = blockTimestamp - blockTimestampLast; // overflow is desired
                                                        if (timeElapsed > 0 && _reserve0 != 0 && _reserve1 != 0) {
                                                            // * never overflows, and + overflow is desired
                                                            price0CumulativeLast += uint(UQ112x112.encode(_reserve1).uqdiv(_reserve0)) * timeElapsed;
                                                            price1CumulativeLast += uint(UQ112x112.encode(_reserve0).uqdiv(_reserve1)) * timeElapsed;
                                                        }
                                                        reserve0 = uint112(balance0);
                                                        reserve1 = uint112(balance1);
                                                        blockTimestampLast = blockTimestamp;
                                                        emit Sync(reserve0, reserve1);
                                                    }
                                                
                                                    // if fee is on, mint liquidity equivalent to 1/6th of the growth in sqrt(k)
                                                    function _mintFee(uint112 _reserve0, uint112 _reserve1) private returns (bool feeOn) {
                                                        address feeTo = IUniswapV2Factory(factory).feeTo();
                                                        feeOn = feeTo != address(0);
                                                        uint _kLast = kLast; // gas savings
                                                        if (feeOn) {
                                                            if (_kLast != 0) {
                                                                uint rootK = Math.sqrt(uint(_reserve0).mul(_reserve1));
                                                                uint rootKLast = Math.sqrt(_kLast);
                                                                if (rootK > rootKLast) {
                                                                    uint numerator = totalSupply.mul(rootK.sub(rootKLast));
                                                                    uint denominator = rootK.mul(5).add(rootKLast);
                                                                    uint liquidity = numerator / denominator;
                                                                    if (liquidity > 0) _mint(feeTo, liquidity);
                                                                }
                                                            }
                                                        } else if (_kLast != 0) {
                                                            kLast = 0;
                                                        }
                                                    }
                                                
                                                    // this low-level function should be called from a contract which performs important safety checks
                                                    function mint(address to) external lock returns (uint liquidity) {
                                                        (uint112 _reserve0, uint112 _reserve1,) = getReserves(); // gas savings
                                                        uint balance0 = IERC20(token0).balanceOf(address(this));
                                                        uint balance1 = IERC20(token1).balanceOf(address(this));
                                                        uint amount0 = balance0.sub(_reserve0);
                                                        uint amount1 = balance1.sub(_reserve1);
                                                
                                                        bool feeOn = _mintFee(_reserve0, _reserve1);
                                                        uint _totalSupply = totalSupply; // gas savings, must be defined here since totalSupply can update in _mintFee
                                                        if (_totalSupply == 0) {
                                                            liquidity = Math.sqrt(amount0.mul(amount1)).sub(MINIMUM_LIQUIDITY);
                                                           _mint(address(0), MINIMUM_LIQUIDITY); // permanently lock the first MINIMUM_LIQUIDITY tokens
                                                        } else {
                                                            liquidity = Math.min(amount0.mul(_totalSupply) / _reserve0, amount1.mul(_totalSupply) / _reserve1);
                                                        }
                                                        require(liquidity > 0, 'UniswapV2: INSUFFICIENT_LIQUIDITY_MINTED');
                                                        _mint(to, liquidity);
                                                
                                                        _update(balance0, balance1, _reserve0, _reserve1);
                                                        if (feeOn) kLast = uint(reserve0).mul(reserve1); // reserve0 and reserve1 are up-to-date
                                                        emit Mint(msg.sender, amount0, amount1);
                                                    }
                                                
                                                    // this low-level function should be called from a contract which performs important safety checks
                                                    function burn(address to) external lock returns (uint amount0, uint amount1) {
                                                        (uint112 _reserve0, uint112 _reserve1,) = getReserves(); // gas savings
                                                        address _token0 = token0;                                // gas savings
                                                        address _token1 = token1;                                // gas savings
                                                        uint balance0 = IERC20(_token0).balanceOf(address(this));
                                                        uint balance1 = IERC20(_token1).balanceOf(address(this));
                                                        uint liquidity = balanceOf[address(this)];
                                                
                                                        bool feeOn = _mintFee(_reserve0, _reserve1);
                                                        uint _totalSupply = totalSupply; // gas savings, must be defined here since totalSupply can update in _mintFee
                                                        amount0 = liquidity.mul(balance0) / _totalSupply; // using balances ensures pro-rata distribution
                                                        amount1 = liquidity.mul(balance1) / _totalSupply; // using balances ensures pro-rata distribution
                                                        require(amount0 > 0 && amount1 > 0, 'UniswapV2: INSUFFICIENT_LIQUIDITY_BURNED');
                                                        _burn(address(this), liquidity);
                                                        _safeTransfer(_token0, to, amount0);
                                                        _safeTransfer(_token1, to, amount1);
                                                        balance0 = IERC20(_token0).balanceOf(address(this));
                                                        balance1 = IERC20(_token1).balanceOf(address(this));
                                                
                                                        _update(balance0, balance1, _reserve0, _reserve1);
                                                        if (feeOn) kLast = uint(reserve0).mul(reserve1); // reserve0 and reserve1 are up-to-date
                                                        emit Burn(msg.sender, amount0, amount1, to);
                                                    }
                                                
                                                    // this low-level function should be called from a contract which performs important safety checks
                                                    function swap(uint amount0Out, uint amount1Out, address to, bytes calldata data) external lock {
                                                        require(amount0Out > 0 || amount1Out > 0, 'UniswapV2: INSUFFICIENT_OUTPUT_AMOUNT');
                                                        (uint112 _reserve0, uint112 _reserve1,) = getReserves(); // gas savings
                                                        require(amount0Out < _reserve0 && amount1Out < _reserve1, 'UniswapV2: INSUFFICIENT_LIQUIDITY');
                                                
                                                        uint balance0;
                                                        uint balance1;
                                                        { // scope for _token{0,1}, avoids stack too deep errors
                                                        address _token0 = token0;
                                                        address _token1 = token1;
                                                        require(to != _token0 && to != _token1, 'UniswapV2: INVALID_TO');
                                                        if (amount0Out > 0) _safeTransfer(_token0, to, amount0Out); // optimistically transfer tokens
                                                        if (amount1Out > 0) _safeTransfer(_token1, to, amount1Out); // optimistically transfer tokens
                                                        if (data.length > 0) IUniswapV2Callee(to).uniswapV2Call(msg.sender, amount0Out, amount1Out, data);
                                                        balance0 = IERC20(_token0).balanceOf(address(this));
                                                        balance1 = IERC20(_token1).balanceOf(address(this));
                                                        }
                                                        uint amount0In = balance0 > _reserve0 - amount0Out ? balance0 - (_reserve0 - amount0Out) : 0;
                                                        uint amount1In = balance1 > _reserve1 - amount1Out ? balance1 - (_reserve1 - amount1Out) : 0;
                                                        require(amount0In > 0 || amount1In > 0, 'UniswapV2: INSUFFICIENT_INPUT_AMOUNT');
                                                        { // scope for reserve{0,1}Adjusted, avoids stack too deep errors
                                                        uint balance0Adjusted = balance0.mul(1000).sub(amount0In.mul(3));
                                                        uint balance1Adjusted = balance1.mul(1000).sub(amount1In.mul(3));
                                                        require(balance0Adjusted.mul(balance1Adjusted) >= uint(_reserve0).mul(_reserve1).mul(1000**2), 'UniswapV2: K');
                                                        }
                                                
                                                        _update(balance0, balance1, _reserve0, _reserve1);
                                                        emit Swap(msg.sender, amount0In, amount1In, amount0Out, amount1Out, to);
                                                    }
                                                
                                                    // force balances to match reserves
                                                    function skim(address to) external lock {
                                                        address _token0 = token0; // gas savings
                                                        address _token1 = token1; // gas savings
                                                        _safeTransfer(_token0, to, IERC20(_token0).balanceOf(address(this)).sub(reserve0));
                                                        _safeTransfer(_token1, to, IERC20(_token1).balanceOf(address(this)).sub(reserve1));
                                                    }
                                                
                                                    // force reserves to match balances
                                                    function sync() external lock {
                                                        _update(IERC20(token0).balanceOf(address(this)), IERC20(token1).balanceOf(address(this)), reserve0, reserve1);
                                                    }
                                                }

                                                File 4 of 12: ProxyERC20
                                                /**
                                                 *Submitted for verification at Etherscan.io on 2019-08-08
                                                */
                                                
                                                /* ===============================================
                                                * Flattened with Solidifier by Coinage
                                                * 
                                                * https://solidifier.coina.ge
                                                * ===============================================
                                                */
                                                
                                                
                                                /*
                                                -----------------------------------------------------------------
                                                FILE INFORMATION
                                                -----------------------------------------------------------------
                                                
                                                file:       Owned.sol
                                                version:    1.1
                                                author:     Anton Jurisevic
                                                            Dominic Romanowski
                                                
                                                date:       2018-2-26
                                                
                                                -----------------------------------------------------------------
                                                MODULE DESCRIPTION
                                                -----------------------------------------------------------------
                                                
                                                An Owned contract, to be inherited by other contracts.
                                                Requires its owner to be explicitly set in the constructor.
                                                Provides an onlyOwner access modifier.
                                                
                                                To change owner, the current owner must nominate the next owner,
                                                who then has to accept the nomination. The nomination can be
                                                cancelled before it is accepted by the new owner by having the
                                                previous owner change the nomination (setting it to 0).
                                                
                                                -----------------------------------------------------------------
                                                */
                                                
                                                pragma solidity 0.4.25;
                                                
                                                /**
                                                 * @title A contract with an owner.
                                                 * @notice Contract ownership can be transferred by first nominating the new owner,
                                                 * who must then accept the ownership, which prevents accidental incorrect ownership transfers.
                                                 */
                                                contract Owned {
                                                    address public owner;
                                                    address public nominatedOwner;
                                                
                                                    /**
                                                     * @dev Owned Constructor
                                                     */
                                                    constructor(address _owner)
                                                        public
                                                    {
                                                        require(_owner != address(0), "Owner address cannot be 0");
                                                        owner = _owner;
                                                        emit OwnerChanged(address(0), _owner);
                                                    }
                                                
                                                    /**
                                                     * @notice Nominate a new owner of this contract.
                                                     * @dev Only the current owner may nominate a new owner.
                                                     */
                                                    function nominateNewOwner(address _owner)
                                                        external
                                                        onlyOwner
                                                    {
                                                        nominatedOwner = _owner;
                                                        emit OwnerNominated(_owner);
                                                    }
                                                
                                                    /**
                                                     * @notice Accept the nomination to be owner.
                                                     */
                                                    function acceptOwnership()
                                                        external
                                                    {
                                                        require(msg.sender == nominatedOwner, "You must be nominated before you can accept ownership");
                                                        emit OwnerChanged(owner, nominatedOwner);
                                                        owner = nominatedOwner;
                                                        nominatedOwner = address(0);
                                                    }
                                                
                                                    modifier onlyOwner
                                                    {
                                                        require(msg.sender == owner, "Only the contract owner may perform this action");
                                                        _;
                                                    }
                                                
                                                    event OwnerNominated(address newOwner);
                                                    event OwnerChanged(address oldOwner, address newOwner);
                                                }
                                                
                                                
                                                /*
                                                -----------------------------------------------------------------
                                                FILE INFORMATION
                                                -----------------------------------------------------------------
                                                
                                                file:       Proxy.sol
                                                version:    1.3
                                                author:     Anton Jurisevic
                                                
                                                date:       2018-05-29
                                                
                                                -----------------------------------------------------------------
                                                MODULE DESCRIPTION
                                                -----------------------------------------------------------------
                                                
                                                A proxy contract that, if it does not recognise the function
                                                being called on it, passes all value and call data to an
                                                underlying target contract.
                                                
                                                This proxy has the capacity to toggle between DELEGATECALL
                                                and CALL style proxy functionality.
                                                
                                                The former executes in the proxy's context, and so will preserve 
                                                msg.sender and store data at the proxy address. The latter will not.
                                                Therefore, any contract the proxy wraps in the CALL style must
                                                implement the Proxyable interface, in order that it can pass msg.sender
                                                into the underlying contract as the state parameter, messageSender.
                                                
                                                -----------------------------------------------------------------
                                                */
                                                
                                                
                                                contract Proxy is Owned {
                                                
                                                    Proxyable public target;
                                                    bool public useDELEGATECALL;
                                                
                                                    constructor(address _owner)
                                                        Owned(_owner)
                                                        public
                                                    {}
                                                
                                                    function setTarget(Proxyable _target)
                                                        external
                                                        onlyOwner
                                                    {
                                                        target = _target;
                                                        emit TargetUpdated(_target);
                                                    }
                                                
                                                    function setUseDELEGATECALL(bool value) 
                                                        external
                                                        onlyOwner
                                                    {
                                                        useDELEGATECALL = value;
                                                    }
                                                
                                                    function _emit(bytes callData, uint numTopics, bytes32 topic1, bytes32 topic2, bytes32 topic3, bytes32 topic4)
                                                        external
                                                        onlyTarget
                                                    {
                                                        uint size = callData.length;
                                                        bytes memory _callData = callData;
                                                
                                                        assembly {
                                                            /* The first 32 bytes of callData contain its length (as specified by the abi). 
                                                             * Length is assumed to be a uint256 and therefore maximum of 32 bytes
                                                             * in length. It is also leftpadded to be a multiple of 32 bytes.
                                                             * This means moving call_data across 32 bytes guarantees we correctly access
                                                             * the data itself. */
                                                            switch numTopics
                                                            case 0 {
                                                                log0(add(_callData, 32), size)
                                                            } 
                                                            case 1 {
                                                                log1(add(_callData, 32), size, topic1)
                                                            }
                                                            case 2 {
                                                                log2(add(_callData, 32), size, topic1, topic2)
                                                            }
                                                            case 3 {
                                                                log3(add(_callData, 32), size, topic1, topic2, topic3)
                                                            }
                                                            case 4 {
                                                                log4(add(_callData, 32), size, topic1, topic2, topic3, topic4)
                                                            }
                                                        }
                                                    }
                                                
                                                    function()
                                                        external
                                                        payable
                                                    {
                                                        if (useDELEGATECALL) {
                                                            assembly {
                                                                /* Copy call data into free memory region. */
                                                                let free_ptr := mload(0x40)
                                                                calldatacopy(free_ptr, 0, calldatasize)
                                                
                                                                /* Forward all gas and call data to the target contract. */
                                                                let result := delegatecall(gas, sload(target_slot), free_ptr, calldatasize, 0, 0)
                                                                returndatacopy(free_ptr, 0, returndatasize)
                                                
                                                                /* Revert if the call failed, otherwise return the result. */
                                                                if iszero(result) { revert(free_ptr, returndatasize) }
                                                                return(free_ptr, returndatasize)
                                                            }
                                                        } else {
                                                            /* Here we are as above, but must send the messageSender explicitly 
                                                             * since we are using CALL rather than DELEGATECALL. */
                                                            target.setMessageSender(msg.sender);
                                                            assembly {
                                                                let free_ptr := mload(0x40)
                                                                calldatacopy(free_ptr, 0, calldatasize)
                                                
                                                                /* We must explicitly forward ether to the underlying contract as well. */
                                                                let result := call(gas, sload(target_slot), callvalue, free_ptr, calldatasize, 0, 0)
                                                                returndatacopy(free_ptr, 0, returndatasize)
                                                
                                                                if iszero(result) { revert(free_ptr, returndatasize) }
                                                                return(free_ptr, returndatasize)
                                                            }
                                                        }
                                                    }
                                                
                                                    modifier onlyTarget {
                                                        require(Proxyable(msg.sender) == target, "Must be proxy target");
                                                        _;
                                                    }
                                                
                                                    event TargetUpdated(Proxyable newTarget);
                                                }
                                                
                                                
                                                /*
                                                -----------------------------------------------------------------
                                                FILE INFORMATION
                                                -----------------------------------------------------------------
                                                
                                                file:       Proxyable.sol
                                                version:    1.1
                                                author:     Anton Jurisevic
                                                
                                                date:       2018-05-15
                                                
                                                checked:    Mike Spain
                                                approved:   Samuel Brooks
                                                
                                                -----------------------------------------------------------------
                                                MODULE DESCRIPTION
                                                -----------------------------------------------------------------
                                                
                                                A proxyable contract that works hand in hand with the Proxy contract
                                                to allow for anyone to interact with the underlying contract both
                                                directly and through the proxy.
                                                
                                                -----------------------------------------------------------------
                                                */
                                                
                                                
                                                // This contract should be treated like an abstract contract
                                                contract Proxyable is Owned {
                                                    /* The proxy this contract exists behind. */
                                                    Proxy public proxy;
                                                    Proxy public integrationProxy;
                                                
                                                    /* The caller of the proxy, passed through to this contract.
                                                     * Note that every function using this member must apply the onlyProxy or
                                                     * optionalProxy modifiers, otherwise their invocations can use stale values. */
                                                    address messageSender;
                                                
                                                    constructor(address _proxy, address _owner)
                                                        Owned(_owner)
                                                        public
                                                    {
                                                        proxy = Proxy(_proxy);
                                                        emit ProxyUpdated(_proxy);
                                                    }
                                                
                                                    function setProxy(address _proxy)
                                                        external
                                                        onlyOwner
                                                    {
                                                        proxy = Proxy(_proxy);
                                                        emit ProxyUpdated(_proxy);
                                                    }
                                                
                                                    function setIntegrationProxy(address _integrationProxy)
                                                        external
                                                        onlyOwner
                                                    {
                                                        integrationProxy = Proxy(_integrationProxy);
                                                    }
                                                
                                                    function setMessageSender(address sender)
                                                        external
                                                        onlyProxy
                                                    {
                                                        messageSender = sender;
                                                    }
                                                
                                                    modifier onlyProxy {
                                                        require(Proxy(msg.sender) == proxy || Proxy(msg.sender) == integrationProxy, "Only the proxy can call");
                                                        _;
                                                    }
                                                
                                                    modifier optionalProxy
                                                    {
                                                        if (Proxy(msg.sender) != proxy && Proxy(msg.sender) != integrationProxy) {
                                                            messageSender = msg.sender;
                                                        }
                                                        _;
                                                    }
                                                
                                                    modifier optionalProxy_onlyOwner
                                                    {
                                                        if (Proxy(msg.sender) != proxy && Proxy(msg.sender) != integrationProxy) {
                                                            messageSender = msg.sender;
                                                        }
                                                        require(messageSender == owner, "Owner only function");
                                                        _;
                                                    }
                                                
                                                    event ProxyUpdated(address proxyAddress);
                                                }
                                                
                                                
                                                /**
                                                 * @title ERC20 interface
                                                 * @dev see https://github.com/ethereum/EIPs/issues/20
                                                 */
                                                contract IERC20 {
                                                    function totalSupply() public view returns (uint);
                                                
                                                    function balanceOf(address owner) public view returns (uint);
                                                
                                                    function allowance(address owner, address spender) public view returns (uint);
                                                
                                                    function transfer(address to, uint value) public returns (bool);
                                                
                                                    function approve(address spender, uint value) public returns (bool);
                                                
                                                    function transferFrom(address from, address to, uint value) public returns (bool);
                                                
                                                    // ERC20 Optional
                                                    function name() public view returns (string);
                                                    function symbol() public view returns (string);
                                                    function decimals() public view returns (uint8);
                                                
                                                    event Transfer(
                                                      address indexed from,
                                                      address indexed to,
                                                      uint value
                                                    );
                                                
                                                    event Approval(
                                                      address indexed owner,
                                                      address indexed spender,
                                                      uint value
                                                    );
                                                }
                                                
                                                
                                                /*
                                                -----------------------------------------------------------------
                                                FILE INFORMATION
                                                -----------------------------------------------------------------
                                                
                                                file:       ProxyERC20.sol
                                                version:    1.0
                                                author:     Jackson Chan, Clinton Ennis
                                                
                                                date:       2019-06-19
                                                
                                                -----------------------------------------------------------------
                                                MODULE DESCRIPTION
                                                -----------------------------------------------------------------
                                                
                                                A proxy contract that is ERC20 compliant for the Synthetix Network.
                                                
                                                If it does not recognise a function being called on it, passes all
                                                value and call data to an underlying target contract.
                                                
                                                The ERC20 standard has been explicitly implemented to ensure
                                                contract to contract calls are compatable on MAINNET
                                                
                                                -----------------------------------------------------------------
                                                */
                                                
                                                
                                                contract ProxyERC20 is Proxy, IERC20 {
                                                
                                                    constructor(address _owner)
                                                        Proxy(_owner)
                                                        public
                                                    {}
                                                
                                                    // ------------- ERC20 Details ------------- //
                                                
                                                    function name() public view returns (string){
                                                        // Immutable static call from target contract
                                                        return IERC20(target).name();
                                                    }
                                                
                                                    function symbol() public view returns (string){
                                                         // Immutable static call from target contract
                                                        return IERC20(target).symbol();
                                                    }
                                                
                                                    function decimals() public view returns (uint8){
                                                         // Immutable static call from target contract
                                                        return IERC20(target).decimals();
                                                    }
                                                
                                                    // ------------- ERC20 Interface ------------- //
                                                
                                                    /**
                                                    * @dev Total number of tokens in existence
                                                    */
                                                    function totalSupply() public view returns (uint256) {
                                                        // Immutable static call from target contract
                                                        return IERC20(target).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) {
                                                        // Immutable static call from target contract
                                                        return IERC20(target).balanceOf(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)
                                                    {
                                                        // Immutable static call from target contract
                                                        return IERC20(target).allowance(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) {
                                                        // Mutable state call requires the proxy to tell the target who the msg.sender is.
                                                        target.setMessageSender(msg.sender);
                                                
                                                        // Forward the ERC20 call to the target contract
                                                        IERC20(target).transfer(to, value);
                                                
                                                        // Event emitting will occur via Synthetix.Proxy._emit()
                                                        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) {
                                                        // Mutable state call requires the proxy to tell the target who the msg.sender is.
                                                        target.setMessageSender(msg.sender);
                                                
                                                        // Forward the ERC20 call to the target contract
                                                        IERC20(target).approve(spender, value);
                                                
                                                        // Event emitting will occur via Synthetix.Proxy._emit()
                                                        return true;
                                                    }
                                                
                                                    /**
                                                    * @dev Transfer tokens from one address to another
                                                    * @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)
                                                    {
                                                        // Mutable state call requires the proxy to tell the target who the msg.sender is.
                                                        target.setMessageSender(msg.sender);
                                                
                                                        // Forward the ERC20 call to the target contract
                                                        IERC20(target).transferFrom(from, to, value);
                                                
                                                        // Event emitting will occur via Synthetix.Proxy._emit()
                                                        return true;
                                                    }
                                                }

                                                File 5 of 12: UniswapV2Factory
                                                pragma solidity =0.5.16;
                                                
                                                interface IUniswapV2Factory {
                                                    event PairCreated(address indexed token0, address indexed token1, address pair, uint);
                                                
                                                    function feeTo() external view returns (address);
                                                    function feeToSetter() external view returns (address);
                                                
                                                    function getPair(address tokenA, address tokenB) external view returns (address pair);
                                                    function allPairs(uint) external view returns (address pair);
                                                    function allPairsLength() external view returns (uint);
                                                
                                                    function createPair(address tokenA, address tokenB) external returns (address pair);
                                                
                                                    function setFeeTo(address) external;
                                                    function setFeeToSetter(address) external;
                                                }
                                                
                                                interface IUniswapV2Pair {
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    function name() external pure returns (string memory);
                                                    function symbol() external pure returns (string memory);
                                                    function decimals() external pure returns (uint8);
                                                    function totalSupply() external view returns (uint);
                                                    function balanceOf(address owner) external view returns (uint);
                                                    function allowance(address owner, address spender) external view returns (uint);
                                                
                                                    function approve(address spender, uint value) external returns (bool);
                                                    function transfer(address to, uint value) external returns (bool);
                                                    function transferFrom(address from, address to, uint value) external returns (bool);
                                                
                                                    function DOMAIN_SEPARATOR() external view returns (bytes32);
                                                    function PERMIT_TYPEHASH() external pure returns (bytes32);
                                                    function nonces(address owner) external view returns (uint);
                                                
                                                    function permit(address owner, address spender, uint value, uint deadline, uint8 v, bytes32 r, bytes32 s) external;
                                                
                                                    event Mint(address indexed sender, uint amount0, uint amount1);
                                                    event Burn(address indexed sender, uint amount0, uint amount1, address indexed to);
                                                    event Swap(
                                                        address indexed sender,
                                                        uint amount0In,
                                                        uint amount1In,
                                                        uint amount0Out,
                                                        uint amount1Out,
                                                        address indexed to
                                                    );
                                                    event Sync(uint112 reserve0, uint112 reserve1);
                                                
                                                    function MINIMUM_LIQUIDITY() external pure returns (uint);
                                                    function factory() external view returns (address);
                                                    function token0() external view returns (address);
                                                    function token1() external view returns (address);
                                                    function getReserves() external view returns (uint112 reserve0, uint112 reserve1, uint32 blockTimestampLast);
                                                    function price0CumulativeLast() external view returns (uint);
                                                    function price1CumulativeLast() external view returns (uint);
                                                    function kLast() external view returns (uint);
                                                
                                                    function mint(address to) external returns (uint liquidity);
                                                    function burn(address to) external returns (uint amount0, uint amount1);
                                                    function swap(uint amount0Out, uint amount1Out, address to, bytes calldata data) external;
                                                    function skim(address to) external;
                                                    function sync() external;
                                                
                                                    function initialize(address, address) external;
                                                }
                                                
                                                interface IUniswapV2ERC20 {
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    function name() external pure returns (string memory);
                                                    function symbol() external pure returns (string memory);
                                                    function decimals() external pure returns (uint8);
                                                    function totalSupply() external view returns (uint);
                                                    function balanceOf(address owner) external view returns (uint);
                                                    function allowance(address owner, address spender) external view returns (uint);
                                                
                                                    function approve(address spender, uint value) external returns (bool);
                                                    function transfer(address to, uint value) external returns (bool);
                                                    function transferFrom(address from, address to, uint value) external returns (bool);
                                                
                                                    function DOMAIN_SEPARATOR() external view returns (bytes32);
                                                    function PERMIT_TYPEHASH() external pure returns (bytes32);
                                                    function nonces(address owner) external view returns (uint);
                                                
                                                    function permit(address owner, address spender, uint value, uint deadline, uint8 v, bytes32 r, bytes32 s) external;
                                                }
                                                
                                                interface IERC20 {
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    function name() external view returns (string memory);
                                                    function symbol() external view returns (string memory);
                                                    function decimals() external view returns (uint8);
                                                    function totalSupply() external view returns (uint);
                                                    function balanceOf(address owner) external view returns (uint);
                                                    function allowance(address owner, address spender) external view returns (uint);
                                                
                                                    function approve(address spender, uint value) external returns (bool);
                                                    function transfer(address to, uint value) external returns (bool);
                                                    function transferFrom(address from, address to, uint value) external returns (bool);
                                                }
                                                
                                                interface IUniswapV2Callee {
                                                    function uniswapV2Call(address sender, uint amount0, uint amount1, bytes calldata data) external;
                                                }
                                                
                                                contract UniswapV2ERC20 is IUniswapV2ERC20 {
                                                    using SafeMath for uint;
                                                
                                                    string public constant name = 'Uniswap V2';
                                                    string public constant symbol = 'UNI-V2';
                                                    uint8 public constant decimals = 18;
                                                    uint  public totalSupply;
                                                    mapping(address => uint) public balanceOf;
                                                    mapping(address => mapping(address => uint)) public allowance;
                                                
                                                    bytes32 public DOMAIN_SEPARATOR;
                                                    // keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)");
                                                    bytes32 public constant PERMIT_TYPEHASH = 0x6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9;
                                                    mapping(address => uint) public nonces;
                                                
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    constructor() public {
                                                        uint chainId;
                                                        assembly {
                                                            chainId := chainid
                                                        }
                                                        DOMAIN_SEPARATOR = keccak256(
                                                            abi.encode(
                                                                keccak256('EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)'),
                                                                keccak256(bytes(name)),
                                                                keccak256(bytes('1')),
                                                                chainId,
                                                                address(this)
                                                            )
                                                        );
                                                    }
                                                
                                                    function _mint(address to, uint value) internal {
                                                        totalSupply = totalSupply.add(value);
                                                        balanceOf[to] = balanceOf[to].add(value);
                                                        emit Transfer(address(0), to, value);
                                                    }
                                                
                                                    function _burn(address from, uint value) internal {
                                                        balanceOf[from] = balanceOf[from].sub(value);
                                                        totalSupply = totalSupply.sub(value);
                                                        emit Transfer(from, address(0), value);
                                                    }
                                                
                                                    function _approve(address owner, address spender, uint value) private {
                                                        allowance[owner][spender] = value;
                                                        emit Approval(owner, spender, value);
                                                    }
                                                
                                                    function _transfer(address from, address to, uint value) private {
                                                        balanceOf[from] = balanceOf[from].sub(value);
                                                        balanceOf[to] = balanceOf[to].add(value);
                                                        emit Transfer(from, to, value);
                                                    }
                                                
                                                    function approve(address spender, uint value) external returns (bool) {
                                                        _approve(msg.sender, spender, value);
                                                        return true;
                                                    }
                                                
                                                    function transfer(address to, uint value) external returns (bool) {
                                                        _transfer(msg.sender, to, value);
                                                        return true;
                                                    }
                                                
                                                    function transferFrom(address from, address to, uint value) external returns (bool) {
                                                        if (allowance[from][msg.sender] != uint(-1)) {
                                                            allowance[from][msg.sender] = allowance[from][msg.sender].sub(value);
                                                        }
                                                        _transfer(from, to, value);
                                                        return true;
                                                    }
                                                
                                                    function permit(address owner, address spender, uint value, uint deadline, uint8 v, bytes32 r, bytes32 s) external {
                                                        require(deadline >= block.timestamp, 'UniswapV2: EXPIRED');
                                                        bytes32 digest = keccak256(
                                                            abi.encodePacked(
                                                                '\x19\x01',
                                                                DOMAIN_SEPARATOR,
                                                                keccak256(abi.encode(PERMIT_TYPEHASH, owner, spender, value, nonces[owner]++, deadline))
                                                            )
                                                        );
                                                        address recoveredAddress = ecrecover(digest, v, r, s);
                                                        require(recoveredAddress != address(0) && recoveredAddress == owner, 'UniswapV2: INVALID_SIGNATURE');
                                                        _approve(owner, spender, value);
                                                    }
                                                }
                                                
                                                contract UniswapV2Pair is IUniswapV2Pair, UniswapV2ERC20 {
                                                    using SafeMath  for uint;
                                                    using UQ112x112 for uint224;
                                                
                                                    uint public constant MINIMUM_LIQUIDITY = 10**3;
                                                    bytes4 private constant SELECTOR = bytes4(keccak256(bytes('transfer(address,uint256)')));
                                                
                                                    address public factory;
                                                    address public token0;
                                                    address public token1;
                                                
                                                    uint112 private reserve0;           // uses single storage slot, accessible via getReserves
                                                    uint112 private reserve1;           // uses single storage slot, accessible via getReserves
                                                    uint32  private blockTimestampLast; // uses single storage slot, accessible via getReserves
                                                
                                                    uint public price0CumulativeLast;
                                                    uint public price1CumulativeLast;
                                                    uint public kLast; // reserve0 * reserve1, as of immediately after the most recent liquidity event
                                                
                                                    uint private unlocked = 1;
                                                    modifier lock() {
                                                        require(unlocked == 1, 'UniswapV2: LOCKED');
                                                        unlocked = 0;
                                                        _;
                                                        unlocked = 1;
                                                    }
                                                
                                                    function getReserves() public view returns (uint112 _reserve0, uint112 _reserve1, uint32 _blockTimestampLast) {
                                                        _reserve0 = reserve0;
                                                        _reserve1 = reserve1;
                                                        _blockTimestampLast = blockTimestampLast;
                                                    }
                                                
                                                    function _safeTransfer(address token, address to, uint value) private {
                                                        (bool success, bytes memory data) = token.call(abi.encodeWithSelector(SELECTOR, to, value));
                                                        require(success && (data.length == 0 || abi.decode(data, (bool))), 'UniswapV2: TRANSFER_FAILED');
                                                    }
                                                
                                                    event Mint(address indexed sender, uint amount0, uint amount1);
                                                    event Burn(address indexed sender, uint amount0, uint amount1, address indexed to);
                                                    event Swap(
                                                        address indexed sender,
                                                        uint amount0In,
                                                        uint amount1In,
                                                        uint amount0Out,
                                                        uint amount1Out,
                                                        address indexed to
                                                    );
                                                    event Sync(uint112 reserve0, uint112 reserve1);
                                                
                                                    constructor() public {
                                                        factory = msg.sender;
                                                    }
                                                
                                                    // called once by the factory at time of deployment
                                                    function initialize(address _token0, address _token1) external {
                                                        require(msg.sender == factory, 'UniswapV2: FORBIDDEN'); // sufficient check
                                                        token0 = _token0;
                                                        token1 = _token1;
                                                    }
                                                
                                                    // update reserves and, on the first call per block, price accumulators
                                                    function _update(uint balance0, uint balance1, uint112 _reserve0, uint112 _reserve1) private {
                                                        require(balance0 <= uint112(-1) && balance1 <= uint112(-1), 'UniswapV2: OVERFLOW');
                                                        uint32 blockTimestamp = uint32(block.timestamp % 2**32);
                                                        uint32 timeElapsed = blockTimestamp - blockTimestampLast; // overflow is desired
                                                        if (timeElapsed > 0 && _reserve0 != 0 && _reserve1 != 0) {
                                                            // * never overflows, and + overflow is desired
                                                            price0CumulativeLast += uint(UQ112x112.encode(_reserve1).uqdiv(_reserve0)) * timeElapsed;
                                                            price1CumulativeLast += uint(UQ112x112.encode(_reserve0).uqdiv(_reserve1)) * timeElapsed;
                                                        }
                                                        reserve0 = uint112(balance0);
                                                        reserve1 = uint112(balance1);
                                                        blockTimestampLast = blockTimestamp;
                                                        emit Sync(reserve0, reserve1);
                                                    }
                                                
                                                    // if fee is on, mint liquidity equivalent to 1/6th of the growth in sqrt(k)
                                                    function _mintFee(uint112 _reserve0, uint112 _reserve1) private returns (bool feeOn) {
                                                        address feeTo = IUniswapV2Factory(factory).feeTo();
                                                        feeOn = feeTo != address(0);
                                                        uint _kLast = kLast; // gas savings
                                                        if (feeOn) {
                                                            if (_kLast != 0) {
                                                                uint rootK = Math.sqrt(uint(_reserve0).mul(_reserve1));
                                                                uint rootKLast = Math.sqrt(_kLast);
                                                                if (rootK > rootKLast) {
                                                                    uint numerator = totalSupply.mul(rootK.sub(rootKLast));
                                                                    uint denominator = rootK.mul(5).add(rootKLast);
                                                                    uint liquidity = numerator / denominator;
                                                                    if (liquidity > 0) _mint(feeTo, liquidity);
                                                                }
                                                            }
                                                        } else if (_kLast != 0) {
                                                            kLast = 0;
                                                        }
                                                    }
                                                
                                                    // this low-level function should be called from a contract which performs important safety checks
                                                    function mint(address to) external lock returns (uint liquidity) {
                                                        (uint112 _reserve0, uint112 _reserve1,) = getReserves(); // gas savings
                                                        uint balance0 = IERC20(token0).balanceOf(address(this));
                                                        uint balance1 = IERC20(token1).balanceOf(address(this));
                                                        uint amount0 = balance0.sub(_reserve0);
                                                        uint amount1 = balance1.sub(_reserve1);
                                                
                                                        bool feeOn = _mintFee(_reserve0, _reserve1);
                                                        uint _totalSupply = totalSupply; // gas savings, must be defined here since totalSupply can update in _mintFee
                                                        if (_totalSupply == 0) {
                                                            liquidity = Math.sqrt(amount0.mul(amount1)).sub(MINIMUM_LIQUIDITY);
                                                           _mint(address(0), MINIMUM_LIQUIDITY); // permanently lock the first MINIMUM_LIQUIDITY tokens
                                                        } else {
                                                            liquidity = Math.min(amount0.mul(_totalSupply) / _reserve0, amount1.mul(_totalSupply) / _reserve1);
                                                        }
                                                        require(liquidity > 0, 'UniswapV2: INSUFFICIENT_LIQUIDITY_MINTED');
                                                        _mint(to, liquidity);
                                                
                                                        _update(balance0, balance1, _reserve0, _reserve1);
                                                        if (feeOn) kLast = uint(reserve0).mul(reserve1); // reserve0 and reserve1 are up-to-date
                                                        emit Mint(msg.sender, amount0, amount1);
                                                    }
                                                
                                                    // this low-level function should be called from a contract which performs important safety checks
                                                    function burn(address to) external lock returns (uint amount0, uint amount1) {
                                                        (uint112 _reserve0, uint112 _reserve1,) = getReserves(); // gas savings
                                                        address _token0 = token0;                                // gas savings
                                                        address _token1 = token1;                                // gas savings
                                                        uint balance0 = IERC20(_token0).balanceOf(address(this));
                                                        uint balance1 = IERC20(_token1).balanceOf(address(this));
                                                        uint liquidity = balanceOf[address(this)];
                                                
                                                        bool feeOn = _mintFee(_reserve0, _reserve1);
                                                        uint _totalSupply = totalSupply; // gas savings, must be defined here since totalSupply can update in _mintFee
                                                        amount0 = liquidity.mul(balance0) / _totalSupply; // using balances ensures pro-rata distribution
                                                        amount1 = liquidity.mul(balance1) / _totalSupply; // using balances ensures pro-rata distribution
                                                        require(amount0 > 0 && amount1 > 0, 'UniswapV2: INSUFFICIENT_LIQUIDITY_BURNED');
                                                        _burn(address(this), liquidity);
                                                        _safeTransfer(_token0, to, amount0);
                                                        _safeTransfer(_token1, to, amount1);
                                                        balance0 = IERC20(_token0).balanceOf(address(this));
                                                        balance1 = IERC20(_token1).balanceOf(address(this));
                                                
                                                        _update(balance0, balance1, _reserve0, _reserve1);
                                                        if (feeOn) kLast = uint(reserve0).mul(reserve1); // reserve0 and reserve1 are up-to-date
                                                        emit Burn(msg.sender, amount0, amount1, to);
                                                    }
                                                
                                                    // this low-level function should be called from a contract which performs important safety checks
                                                    function swap(uint amount0Out, uint amount1Out, address to, bytes calldata data) external lock {
                                                        require(amount0Out > 0 || amount1Out > 0, 'UniswapV2: INSUFFICIENT_OUTPUT_AMOUNT');
                                                        (uint112 _reserve0, uint112 _reserve1,) = getReserves(); // gas savings
                                                        require(amount0Out < _reserve0 && amount1Out < _reserve1, 'UniswapV2: INSUFFICIENT_LIQUIDITY');
                                                
                                                        uint balance0;
                                                        uint balance1;
                                                        { // scope for _token{0,1}, avoids stack too deep errors
                                                        address _token0 = token0;
                                                        address _token1 = token1;
                                                        require(to != _token0 && to != _token1, 'UniswapV2: INVALID_TO');
                                                        if (amount0Out > 0) _safeTransfer(_token0, to, amount0Out); // optimistically transfer tokens
                                                        if (amount1Out > 0) _safeTransfer(_token1, to, amount1Out); // optimistically transfer tokens
                                                        if (data.length > 0) IUniswapV2Callee(to).uniswapV2Call(msg.sender, amount0Out, amount1Out, data);
                                                        balance0 = IERC20(_token0).balanceOf(address(this));
                                                        balance1 = IERC20(_token1).balanceOf(address(this));
                                                        }
                                                        uint amount0In = balance0 > _reserve0 - amount0Out ? balance0 - (_reserve0 - amount0Out) : 0;
                                                        uint amount1In = balance1 > _reserve1 - amount1Out ? balance1 - (_reserve1 - amount1Out) : 0;
                                                        require(amount0In > 0 || amount1In > 0, 'UniswapV2: INSUFFICIENT_INPUT_AMOUNT');
                                                        { // scope for reserve{0,1}Adjusted, avoids stack too deep errors
                                                        uint balance0Adjusted = balance0.mul(1000).sub(amount0In.mul(3));
                                                        uint balance1Adjusted = balance1.mul(1000).sub(amount1In.mul(3));
                                                        require(balance0Adjusted.mul(balance1Adjusted) >= uint(_reserve0).mul(_reserve1).mul(1000**2), 'UniswapV2: K');
                                                        }
                                                
                                                        _update(balance0, balance1, _reserve0, _reserve1);
                                                        emit Swap(msg.sender, amount0In, amount1In, amount0Out, amount1Out, to);
                                                    }
                                                
                                                    // force balances to match reserves
                                                    function skim(address to) external lock {
                                                        address _token0 = token0; // gas savings
                                                        address _token1 = token1; // gas savings
                                                        _safeTransfer(_token0, to, IERC20(_token0).balanceOf(address(this)).sub(reserve0));
                                                        _safeTransfer(_token1, to, IERC20(_token1).balanceOf(address(this)).sub(reserve1));
                                                    }
                                                
                                                    // force reserves to match balances
                                                    function sync() external lock {
                                                        _update(IERC20(token0).balanceOf(address(this)), IERC20(token1).balanceOf(address(this)), reserve0, reserve1);
                                                    }
                                                }
                                                
                                                contract UniswapV2Factory is IUniswapV2Factory {
                                                    address public feeTo;
                                                    address public feeToSetter;
                                                
                                                    mapping(address => mapping(address => address)) public getPair;
                                                    address[] public allPairs;
                                                
                                                    event PairCreated(address indexed token0, address indexed token1, address pair, uint);
                                                
                                                    constructor(address _feeToSetter) public {
                                                        feeToSetter = _feeToSetter;
                                                    }
                                                
                                                    function allPairsLength() external view returns (uint) {
                                                        return allPairs.length;
                                                    }
                                                
                                                    function createPair(address tokenA, address tokenB) external returns (address pair) {
                                                        require(tokenA != tokenB, 'UniswapV2: IDENTICAL_ADDRESSES');
                                                        (address token0, address token1) = tokenA < tokenB ? (tokenA, tokenB) : (tokenB, tokenA);
                                                        require(token0 != address(0), 'UniswapV2: ZERO_ADDRESS');
                                                        require(getPair[token0][token1] == address(0), 'UniswapV2: PAIR_EXISTS'); // single check is sufficient
                                                        bytes memory bytecode = type(UniswapV2Pair).creationCode;
                                                        bytes32 salt = keccak256(abi.encodePacked(token0, token1));
                                                        assembly {
                                                            pair := create2(0, add(bytecode, 32), mload(bytecode), salt)
                                                        }
                                                        IUniswapV2Pair(pair).initialize(token0, token1);
                                                        getPair[token0][token1] = pair;
                                                        getPair[token1][token0] = pair; // populate mapping in the reverse direction
                                                        allPairs.push(pair);
                                                        emit PairCreated(token0, token1, pair, allPairs.length);
                                                    }
                                                
                                                    function setFeeTo(address _feeTo) external {
                                                        require(msg.sender == feeToSetter, 'UniswapV2: FORBIDDEN');
                                                        feeTo = _feeTo;
                                                    }
                                                
                                                    function setFeeToSetter(address _feeToSetter) external {
                                                        require(msg.sender == feeToSetter, 'UniswapV2: FORBIDDEN');
                                                        feeToSetter = _feeToSetter;
                                                    }
                                                }
                                                
                                                // a library for performing overflow-safe math, courtesy of DappHub (https://github.com/dapphub/ds-math)
                                                
                                                library SafeMath {
                                                    function add(uint x, uint y) internal pure returns (uint z) {
                                                        require((z = x + y) >= x, 'ds-math-add-overflow');
                                                    }
                                                
                                                    function sub(uint x, uint y) internal pure returns (uint z) {
                                                        require((z = x - y) <= x, 'ds-math-sub-underflow');
                                                    }
                                                
                                                    function mul(uint x, uint y) internal pure returns (uint z) {
                                                        require(y == 0 || (z = x * y) / y == x, 'ds-math-mul-overflow');
                                                    }
                                                }
                                                
                                                // a library for performing various math operations
                                                
                                                library Math {
                                                    function min(uint x, uint y) internal pure returns (uint z) {
                                                        z = x < y ? x : y;
                                                    }
                                                
                                                    // babylonian method (https://en.wikipedia.org/wiki/Methods_of_computing_square_roots#Babylonian_method)
                                                    function sqrt(uint y) internal pure returns (uint z) {
                                                        if (y > 3) {
                                                            z = y;
                                                            uint x = y / 2 + 1;
                                                            while (x < z) {
                                                                z = x;
                                                                x = (y / x + x) / 2;
                                                            }
                                                        } else if (y != 0) {
                                                            z = 1;
                                                        }
                                                    }
                                                }
                                                
                                                // a library for handling binary fixed point numbers (https://en.wikipedia.org/wiki/Q_(number_format))
                                                
                                                // range: [0, 2**112 - 1]
                                                // resolution: 1 / 2**112
                                                
                                                library UQ112x112 {
                                                    uint224 constant Q112 = 2**112;
                                                
                                                    // encode a uint112 as a UQ112x112
                                                    function encode(uint112 y) internal pure returns (uint224 z) {
                                                        z = uint224(y) * Q112; // never overflows
                                                    }
                                                
                                                    // divide a UQ112x112 by a uint112, returning a UQ112x112
                                                    function uqdiv(uint224 x, uint112 y) internal pure returns (uint224 z) {
                                                        z = x / uint224(y);
                                                    }
                                                }

                                                File 6 of 12: UniswapV2Router02
                                                pragma solidity =0.6.6;
                                                
                                                interface IUniswapV2Factory {
                                                    event PairCreated(address indexed token0, address indexed token1, address pair, uint);
                                                
                                                    function feeTo() external view returns (address);
                                                    function feeToSetter() external view returns (address);
                                                
                                                    function getPair(address tokenA, address tokenB) external view returns (address pair);
                                                    function allPairs(uint) external view returns (address pair);
                                                    function allPairsLength() external view returns (uint);
                                                
                                                    function createPair(address tokenA, address tokenB) external returns (address pair);
                                                
                                                    function setFeeTo(address) external;
                                                    function setFeeToSetter(address) external;
                                                }
                                                
                                                interface IUniswapV2Pair {
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    function name() external pure returns (string memory);
                                                    function symbol() external pure returns (string memory);
                                                    function decimals() external pure returns (uint8);
                                                    function totalSupply() external view returns (uint);
                                                    function balanceOf(address owner) external view returns (uint);
                                                    function allowance(address owner, address spender) external view returns (uint);
                                                
                                                    function approve(address spender, uint value) external returns (bool);
                                                    function transfer(address to, uint value) external returns (bool);
                                                    function transferFrom(address from, address to, uint value) external returns (bool);
                                                
                                                    function DOMAIN_SEPARATOR() external view returns (bytes32);
                                                    function PERMIT_TYPEHASH() external pure returns (bytes32);
                                                    function nonces(address owner) external view returns (uint);
                                                
                                                    function permit(address owner, address spender, uint value, uint deadline, uint8 v, bytes32 r, bytes32 s) external;
                                                
                                                    event Mint(address indexed sender, uint amount0, uint amount1);
                                                    event Burn(address indexed sender, uint amount0, uint amount1, address indexed to);
                                                    event Swap(
                                                        address indexed sender,
                                                        uint amount0In,
                                                        uint amount1In,
                                                        uint amount0Out,
                                                        uint amount1Out,
                                                        address indexed to
                                                    );
                                                    event Sync(uint112 reserve0, uint112 reserve1);
                                                
                                                    function MINIMUM_LIQUIDITY() external pure returns (uint);
                                                    function factory() external view returns (address);
                                                    function token0() external view returns (address);
                                                    function token1() external view returns (address);
                                                    function getReserves() external view returns (uint112 reserve0, uint112 reserve1, uint32 blockTimestampLast);
                                                    function price0CumulativeLast() external view returns (uint);
                                                    function price1CumulativeLast() external view returns (uint);
                                                    function kLast() external view returns (uint);
                                                
                                                    function mint(address to) external returns (uint liquidity);
                                                    function burn(address to) external returns (uint amount0, uint amount1);
                                                    function swap(uint amount0Out, uint amount1Out, address to, bytes calldata data) external;
                                                    function skim(address to) external;
                                                    function sync() external;
                                                
                                                    function initialize(address, address) external;
                                                }
                                                
                                                interface IUniswapV2Router01 {
                                                    function factory() external pure returns (address);
                                                    function WETH() external pure returns (address);
                                                
                                                    function addLiquidity(
                                                        address tokenA,
                                                        address tokenB,
                                                        uint amountADesired,
                                                        uint amountBDesired,
                                                        uint amountAMin,
                                                        uint amountBMin,
                                                        address to,
                                                        uint deadline
                                                    ) external returns (uint amountA, uint amountB, uint liquidity);
                                                    function addLiquidityETH(
                                                        address token,
                                                        uint amountTokenDesired,
                                                        uint amountTokenMin,
                                                        uint amountETHMin,
                                                        address to,
                                                        uint deadline
                                                    ) external payable returns (uint amountToken, uint amountETH, uint liquidity);
                                                    function removeLiquidity(
                                                        address tokenA,
                                                        address tokenB,
                                                        uint liquidity,
                                                        uint amountAMin,
                                                        uint amountBMin,
                                                        address to,
                                                        uint deadline
                                                    ) external returns (uint amountA, uint amountB);
                                                    function removeLiquidityETH(
                                                        address token,
                                                        uint liquidity,
                                                        uint amountTokenMin,
                                                        uint amountETHMin,
                                                        address to,
                                                        uint deadline
                                                    ) external returns (uint amountToken, uint amountETH);
                                                    function removeLiquidityWithPermit(
                                                        address tokenA,
                                                        address tokenB,
                                                        uint liquidity,
                                                        uint amountAMin,
                                                        uint amountBMin,
                                                        address to,
                                                        uint deadline,
                                                        bool approveMax, uint8 v, bytes32 r, bytes32 s
                                                    ) external returns (uint amountA, uint amountB);
                                                    function removeLiquidityETHWithPermit(
                                                        address token,
                                                        uint liquidity,
                                                        uint amountTokenMin,
                                                        uint amountETHMin,
                                                        address to,
                                                        uint deadline,
                                                        bool approveMax, uint8 v, bytes32 r, bytes32 s
                                                    ) external returns (uint amountToken, uint amountETH);
                                                    function swapExactTokensForTokens(
                                                        uint amountIn,
                                                        uint amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint deadline
                                                    ) external returns (uint[] memory amounts);
                                                    function swapTokensForExactTokens(
                                                        uint amountOut,
                                                        uint amountInMax,
                                                        address[] calldata path,
                                                        address to,
                                                        uint deadline
                                                    ) external returns (uint[] memory amounts);
                                                    function swapExactETHForTokens(uint amountOutMin, address[] calldata path, address to, uint deadline)
                                                        external
                                                        payable
                                                        returns (uint[] memory amounts);
                                                    function swapTokensForExactETH(uint amountOut, uint amountInMax, address[] calldata path, address to, uint deadline)
                                                        external
                                                        returns (uint[] memory amounts);
                                                    function swapExactTokensForETH(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline)
                                                        external
                                                        returns (uint[] memory amounts);
                                                    function swapETHForExactTokens(uint amountOut, address[] calldata path, address to, uint deadline)
                                                        external
                                                        payable
                                                        returns (uint[] memory amounts);
                                                
                                                    function quote(uint amountA, uint reserveA, uint reserveB) external pure returns (uint amountB);
                                                    function getAmountOut(uint amountIn, uint reserveIn, uint reserveOut) external pure returns (uint amountOut);
                                                    function getAmountIn(uint amountOut, uint reserveIn, uint reserveOut) external pure returns (uint amountIn);
                                                    function getAmountsOut(uint amountIn, address[] calldata path) external view returns (uint[] memory amounts);
                                                    function getAmountsIn(uint amountOut, address[] calldata path) external view returns (uint[] memory amounts);
                                                }
                                                
                                                interface IUniswapV2Router02 is IUniswapV2Router01 {
                                                    function removeLiquidityETHSupportingFeeOnTransferTokens(
                                                        address token,
                                                        uint liquidity,
                                                        uint amountTokenMin,
                                                        uint amountETHMin,
                                                        address to,
                                                        uint deadline
                                                    ) external returns (uint amountETH);
                                                    function removeLiquidityETHWithPermitSupportingFeeOnTransferTokens(
                                                        address token,
                                                        uint liquidity,
                                                        uint amountTokenMin,
                                                        uint amountETHMin,
                                                        address to,
                                                        uint deadline,
                                                        bool approveMax, uint8 v, bytes32 r, bytes32 s
                                                    ) external returns (uint amountETH);
                                                
                                                    function swapExactTokensForTokensSupportingFeeOnTransferTokens(
                                                        uint amountIn,
                                                        uint amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint deadline
                                                    ) external;
                                                    function swapExactETHForTokensSupportingFeeOnTransferTokens(
                                                        uint amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint deadline
                                                    ) external payable;
                                                    function swapExactTokensForETHSupportingFeeOnTransferTokens(
                                                        uint amountIn,
                                                        uint amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint deadline
                                                    ) external;
                                                }
                                                
                                                interface IERC20 {
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    function name() external view returns (string memory);
                                                    function symbol() external view returns (string memory);
                                                    function decimals() external view returns (uint8);
                                                    function totalSupply() external view returns (uint);
                                                    function balanceOf(address owner) external view returns (uint);
                                                    function allowance(address owner, address spender) external view returns (uint);
                                                
                                                    function approve(address spender, uint value) external returns (bool);
                                                    function transfer(address to, uint value) external returns (bool);
                                                    function transferFrom(address from, address to, uint value) external returns (bool);
                                                }
                                                
                                                interface IWETH {
                                                    function deposit() external payable;
                                                    function transfer(address to, uint value) external returns (bool);
                                                    function withdraw(uint) external;
                                                }
                                                
                                                contract UniswapV2Router02 is IUniswapV2Router02 {
                                                    using SafeMath for uint;
                                                
                                                    address public immutable override factory;
                                                    address public immutable override WETH;
                                                
                                                    modifier ensure(uint deadline) {
                                                        require(deadline >= block.timestamp, 'UniswapV2Router: EXPIRED');
                                                        _;
                                                    }
                                                
                                                    constructor(address _factory, address _WETH) public {
                                                        factory = _factory;
                                                        WETH = _WETH;
                                                    }
                                                
                                                    receive() external payable {
                                                        assert(msg.sender == WETH); // only accept ETH via fallback from the WETH contract
                                                    }
                                                
                                                    // **** ADD LIQUIDITY ****
                                                    function _addLiquidity(
                                                        address tokenA,
                                                        address tokenB,
                                                        uint amountADesired,
                                                        uint amountBDesired,
                                                        uint amountAMin,
                                                        uint amountBMin
                                                    ) internal virtual returns (uint amountA, uint amountB) {
                                                        // create the pair if it doesn't exist yet
                                                        if (IUniswapV2Factory(factory).getPair(tokenA, tokenB) == address(0)) {
                                                            IUniswapV2Factory(factory).createPair(tokenA, tokenB);
                                                        }
                                                        (uint reserveA, uint reserveB) = UniswapV2Library.getReserves(factory, tokenA, tokenB);
                                                        if (reserveA == 0 && reserveB == 0) {
                                                            (amountA, amountB) = (amountADesired, amountBDesired);
                                                        } else {
                                                            uint amountBOptimal = UniswapV2Library.quote(amountADesired, reserveA, reserveB);
                                                            if (amountBOptimal <= amountBDesired) {
                                                                require(amountBOptimal >= amountBMin, 'UniswapV2Router: INSUFFICIENT_B_AMOUNT');
                                                                (amountA, amountB) = (amountADesired, amountBOptimal);
                                                            } else {
                                                                uint amountAOptimal = UniswapV2Library.quote(amountBDesired, reserveB, reserveA);
                                                                assert(amountAOptimal <= amountADesired);
                                                                require(amountAOptimal >= amountAMin, 'UniswapV2Router: INSUFFICIENT_A_AMOUNT');
                                                                (amountA, amountB) = (amountAOptimal, amountBDesired);
                                                            }
                                                        }
                                                    }
                                                    function addLiquidity(
                                                        address tokenA,
                                                        address tokenB,
                                                        uint amountADesired,
                                                        uint amountBDesired,
                                                        uint amountAMin,
                                                        uint amountBMin,
                                                        address to,
                                                        uint deadline
                                                    ) external virtual override ensure(deadline) returns (uint amountA, uint amountB, uint liquidity) {
                                                        (amountA, amountB) = _addLiquidity(tokenA, tokenB, amountADesired, amountBDesired, amountAMin, amountBMin);
                                                        address pair = UniswapV2Library.pairFor(factory, tokenA, tokenB);
                                                        TransferHelper.safeTransferFrom(tokenA, msg.sender, pair, amountA);
                                                        TransferHelper.safeTransferFrom(tokenB, msg.sender, pair, amountB);
                                                        liquidity = IUniswapV2Pair(pair).mint(to);
                                                    }
                                                    function addLiquidityETH(
                                                        address token,
                                                        uint amountTokenDesired,
                                                        uint amountTokenMin,
                                                        uint amountETHMin,
                                                        address to,
                                                        uint deadline
                                                    ) external virtual override payable ensure(deadline) returns (uint amountToken, uint amountETH, uint liquidity) {
                                                        (amountToken, amountETH) = _addLiquidity(
                                                            token,
                                                            WETH,
                                                            amountTokenDesired,
                                                            msg.value,
                                                            amountTokenMin,
                                                            amountETHMin
                                                        );
                                                        address pair = UniswapV2Library.pairFor(factory, token, WETH);
                                                        TransferHelper.safeTransferFrom(token, msg.sender, pair, amountToken);
                                                        IWETH(WETH).deposit{value: amountETH}();
                                                        assert(IWETH(WETH).transfer(pair, amountETH));
                                                        liquidity = IUniswapV2Pair(pair).mint(to);
                                                        // refund dust eth, if any
                                                        if (msg.value > amountETH) TransferHelper.safeTransferETH(msg.sender, msg.value - amountETH);
                                                    }
                                                
                                                    // **** REMOVE LIQUIDITY ****
                                                    function removeLiquidity(
                                                        address tokenA,
                                                        address tokenB,
                                                        uint liquidity,
                                                        uint amountAMin,
                                                        uint amountBMin,
                                                        address to,
                                                        uint deadline
                                                    ) public virtual override ensure(deadline) returns (uint amountA, uint amountB) {
                                                        address pair = UniswapV2Library.pairFor(factory, tokenA, tokenB);
                                                        IUniswapV2Pair(pair).transferFrom(msg.sender, pair, liquidity); // send liquidity to pair
                                                        (uint amount0, uint amount1) = IUniswapV2Pair(pair).burn(to);
                                                        (address token0,) = UniswapV2Library.sortTokens(tokenA, tokenB);
                                                        (amountA, amountB) = tokenA == token0 ? (amount0, amount1) : (amount1, amount0);
                                                        require(amountA >= amountAMin, 'UniswapV2Router: INSUFFICIENT_A_AMOUNT');
                                                        require(amountB >= amountBMin, 'UniswapV2Router: INSUFFICIENT_B_AMOUNT');
                                                    }
                                                    function removeLiquidityETH(
                                                        address token,
                                                        uint liquidity,
                                                        uint amountTokenMin,
                                                        uint amountETHMin,
                                                        address to,
                                                        uint deadline
                                                    ) public virtual override ensure(deadline) returns (uint amountToken, uint amountETH) {
                                                        (amountToken, amountETH) = removeLiquidity(
                                                            token,
                                                            WETH,
                                                            liquidity,
                                                            amountTokenMin,
                                                            amountETHMin,
                                                            address(this),
                                                            deadline
                                                        );
                                                        TransferHelper.safeTransfer(token, to, amountToken);
                                                        IWETH(WETH).withdraw(amountETH);
                                                        TransferHelper.safeTransferETH(to, amountETH);
                                                    }
                                                    function removeLiquidityWithPermit(
                                                        address tokenA,
                                                        address tokenB,
                                                        uint liquidity,
                                                        uint amountAMin,
                                                        uint amountBMin,
                                                        address to,
                                                        uint deadline,
                                                        bool approveMax, uint8 v, bytes32 r, bytes32 s
                                                    ) external virtual override returns (uint amountA, uint amountB) {
                                                        address pair = UniswapV2Library.pairFor(factory, tokenA, tokenB);
                                                        uint value = approveMax ? uint(-1) : liquidity;
                                                        IUniswapV2Pair(pair).permit(msg.sender, address(this), value, deadline, v, r, s);
                                                        (amountA, amountB) = removeLiquidity(tokenA, tokenB, liquidity, amountAMin, amountBMin, to, deadline);
                                                    }
                                                    function removeLiquidityETHWithPermit(
                                                        address token,
                                                        uint liquidity,
                                                        uint amountTokenMin,
                                                        uint amountETHMin,
                                                        address to,
                                                        uint deadline,
                                                        bool approveMax, uint8 v, bytes32 r, bytes32 s
                                                    ) external virtual override returns (uint amountToken, uint amountETH) {
                                                        address pair = UniswapV2Library.pairFor(factory, token, WETH);
                                                        uint value = approveMax ? uint(-1) : liquidity;
                                                        IUniswapV2Pair(pair).permit(msg.sender, address(this), value, deadline, v, r, s);
                                                        (amountToken, amountETH) = removeLiquidityETH(token, liquidity, amountTokenMin, amountETHMin, to, deadline);
                                                    }
                                                
                                                    // **** REMOVE LIQUIDITY (supporting fee-on-transfer tokens) ****
                                                    function removeLiquidityETHSupportingFeeOnTransferTokens(
                                                        address token,
                                                        uint liquidity,
                                                        uint amountTokenMin,
                                                        uint amountETHMin,
                                                        address to,
                                                        uint deadline
                                                    ) public virtual override ensure(deadline) returns (uint amountETH) {
                                                        (, amountETH) = removeLiquidity(
                                                            token,
                                                            WETH,
                                                            liquidity,
                                                            amountTokenMin,
                                                            amountETHMin,
                                                            address(this),
                                                            deadline
                                                        );
                                                        TransferHelper.safeTransfer(token, to, IERC20(token).balanceOf(address(this)));
                                                        IWETH(WETH).withdraw(amountETH);
                                                        TransferHelper.safeTransferETH(to, amountETH);
                                                    }
                                                    function removeLiquidityETHWithPermitSupportingFeeOnTransferTokens(
                                                        address token,
                                                        uint liquidity,
                                                        uint amountTokenMin,
                                                        uint amountETHMin,
                                                        address to,
                                                        uint deadline,
                                                        bool approveMax, uint8 v, bytes32 r, bytes32 s
                                                    ) external virtual override returns (uint amountETH) {
                                                        address pair = UniswapV2Library.pairFor(factory, token, WETH);
                                                        uint value = approveMax ? uint(-1) : liquidity;
                                                        IUniswapV2Pair(pair).permit(msg.sender, address(this), value, deadline, v, r, s);
                                                        amountETH = removeLiquidityETHSupportingFeeOnTransferTokens(
                                                            token, liquidity, amountTokenMin, amountETHMin, to, deadline
                                                        );
                                                    }
                                                
                                                    // **** SWAP ****
                                                    // requires the initial amount to have already been sent to the first pair
                                                    function _swap(uint[] memory amounts, address[] memory path, address _to) internal virtual {
                                                        for (uint i; i < path.length - 1; i++) {
                                                            (address input, address output) = (path[i], path[i + 1]);
                                                            (address token0,) = UniswapV2Library.sortTokens(input, output);
                                                            uint amountOut = amounts[i + 1];
                                                            (uint amount0Out, uint amount1Out) = input == token0 ? (uint(0), amountOut) : (amountOut, uint(0));
                                                            address to = i < path.length - 2 ? UniswapV2Library.pairFor(factory, output, path[i + 2]) : _to;
                                                            IUniswapV2Pair(UniswapV2Library.pairFor(factory, input, output)).swap(
                                                                amount0Out, amount1Out, to, new bytes(0)
                                                            );
                                                        }
                                                    }
                                                    function swapExactTokensForTokens(
                                                        uint amountIn,
                                                        uint amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint deadline
                                                    ) external virtual override ensure(deadline) returns (uint[] memory amounts) {
                                                        amounts = UniswapV2Library.getAmountsOut(factory, amountIn, path);
                                                        require(amounts[amounts.length - 1] >= amountOutMin, 'UniswapV2Router: INSUFFICIENT_OUTPUT_AMOUNT');
                                                        TransferHelper.safeTransferFrom(
                                                            path[0], msg.sender, UniswapV2Library.pairFor(factory, path[0], path[1]), amounts[0]
                                                        );
                                                        _swap(amounts, path, to);
                                                    }
                                                    function swapTokensForExactTokens(
                                                        uint amountOut,
                                                        uint amountInMax,
                                                        address[] calldata path,
                                                        address to,
                                                        uint deadline
                                                    ) external virtual override ensure(deadline) returns (uint[] memory amounts) {
                                                        amounts = UniswapV2Library.getAmountsIn(factory, amountOut, path);
                                                        require(amounts[0] <= amountInMax, 'UniswapV2Router: EXCESSIVE_INPUT_AMOUNT');
                                                        TransferHelper.safeTransferFrom(
                                                            path[0], msg.sender, UniswapV2Library.pairFor(factory, path[0], path[1]), amounts[0]
                                                        );
                                                        _swap(amounts, path, to);
                                                    }
                                                    function swapExactETHForTokens(uint amountOutMin, address[] calldata path, address to, uint deadline)
                                                        external
                                                        virtual
                                                        override
                                                        payable
                                                        ensure(deadline)
                                                        returns (uint[] memory amounts)
                                                    {
                                                        require(path[0] == WETH, 'UniswapV2Router: INVALID_PATH');
                                                        amounts = UniswapV2Library.getAmountsOut(factory, msg.value, path);
                                                        require(amounts[amounts.length - 1] >= amountOutMin, 'UniswapV2Router: INSUFFICIENT_OUTPUT_AMOUNT');
                                                        IWETH(WETH).deposit{value: amounts[0]}();
                                                        assert(IWETH(WETH).transfer(UniswapV2Library.pairFor(factory, path[0], path[1]), amounts[0]));
                                                        _swap(amounts, path, to);
                                                    }
                                                    function swapTokensForExactETH(uint amountOut, uint amountInMax, address[] calldata path, address to, uint deadline)
                                                        external
                                                        virtual
                                                        override
                                                        ensure(deadline)
                                                        returns (uint[] memory amounts)
                                                    {
                                                        require(path[path.length - 1] == WETH, 'UniswapV2Router: INVALID_PATH');
                                                        amounts = UniswapV2Library.getAmountsIn(factory, amountOut, path);
                                                        require(amounts[0] <= amountInMax, 'UniswapV2Router: EXCESSIVE_INPUT_AMOUNT');
                                                        TransferHelper.safeTransferFrom(
                                                            path[0], msg.sender, UniswapV2Library.pairFor(factory, path[0], path[1]), amounts[0]
                                                        );
                                                        _swap(amounts, path, address(this));
                                                        IWETH(WETH).withdraw(amounts[amounts.length - 1]);
                                                        TransferHelper.safeTransferETH(to, amounts[amounts.length - 1]);
                                                    }
                                                    function swapExactTokensForETH(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline)
                                                        external
                                                        virtual
                                                        override
                                                        ensure(deadline)
                                                        returns (uint[] memory amounts)
                                                    {
                                                        require(path[path.length - 1] == WETH, 'UniswapV2Router: INVALID_PATH');
                                                        amounts = UniswapV2Library.getAmountsOut(factory, amountIn, path);
                                                        require(amounts[amounts.length - 1] >= amountOutMin, 'UniswapV2Router: INSUFFICIENT_OUTPUT_AMOUNT');
                                                        TransferHelper.safeTransferFrom(
                                                            path[0], msg.sender, UniswapV2Library.pairFor(factory, path[0], path[1]), amounts[0]
                                                        );
                                                        _swap(amounts, path, address(this));
                                                        IWETH(WETH).withdraw(amounts[amounts.length - 1]);
                                                        TransferHelper.safeTransferETH(to, amounts[amounts.length - 1]);
                                                    }
                                                    function swapETHForExactTokens(uint amountOut, address[] calldata path, address to, uint deadline)
                                                        external
                                                        virtual
                                                        override
                                                        payable
                                                        ensure(deadline)
                                                        returns (uint[] memory amounts)
                                                    {
                                                        require(path[0] == WETH, 'UniswapV2Router: INVALID_PATH');
                                                        amounts = UniswapV2Library.getAmountsIn(factory, amountOut, path);
                                                        require(amounts[0] <= msg.value, 'UniswapV2Router: EXCESSIVE_INPUT_AMOUNT');
                                                        IWETH(WETH).deposit{value: amounts[0]}();
                                                        assert(IWETH(WETH).transfer(UniswapV2Library.pairFor(factory, path[0], path[1]), amounts[0]));
                                                        _swap(amounts, path, to);
                                                        // refund dust eth, if any
                                                        if (msg.value > amounts[0]) TransferHelper.safeTransferETH(msg.sender, msg.value - amounts[0]);
                                                    }
                                                
                                                    // **** SWAP (supporting fee-on-transfer tokens) ****
                                                    // requires the initial amount to have already been sent to the first pair
                                                    function _swapSupportingFeeOnTransferTokens(address[] memory path, address _to) internal virtual {
                                                        for (uint i; i < path.length - 1; i++) {
                                                            (address input, address output) = (path[i], path[i + 1]);
                                                            (address token0,) = UniswapV2Library.sortTokens(input, output);
                                                            IUniswapV2Pair pair = IUniswapV2Pair(UniswapV2Library.pairFor(factory, input, output));
                                                            uint amountInput;
                                                            uint amountOutput;
                                                            { // scope to avoid stack too deep errors
                                                            (uint reserve0, uint reserve1,) = pair.getReserves();
                                                            (uint reserveInput, uint reserveOutput) = input == token0 ? (reserve0, reserve1) : (reserve1, reserve0);
                                                            amountInput = IERC20(input).balanceOf(address(pair)).sub(reserveInput);
                                                            amountOutput = UniswapV2Library.getAmountOut(amountInput, reserveInput, reserveOutput);
                                                            }
                                                            (uint amount0Out, uint amount1Out) = input == token0 ? (uint(0), amountOutput) : (amountOutput, uint(0));
                                                            address to = i < path.length - 2 ? UniswapV2Library.pairFor(factory, output, path[i + 2]) : _to;
                                                            pair.swap(amount0Out, amount1Out, to, new bytes(0));
                                                        }
                                                    }
                                                    function swapExactTokensForTokensSupportingFeeOnTransferTokens(
                                                        uint amountIn,
                                                        uint amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint deadline
                                                    ) external virtual override ensure(deadline) {
                                                        TransferHelper.safeTransferFrom(
                                                            path[0], msg.sender, UniswapV2Library.pairFor(factory, path[0], path[1]), amountIn
                                                        );
                                                        uint balanceBefore = IERC20(path[path.length - 1]).balanceOf(to);
                                                        _swapSupportingFeeOnTransferTokens(path, to);
                                                        require(
                                                            IERC20(path[path.length - 1]).balanceOf(to).sub(balanceBefore) >= amountOutMin,
                                                            'UniswapV2Router: INSUFFICIENT_OUTPUT_AMOUNT'
                                                        );
                                                    }
                                                    function swapExactETHForTokensSupportingFeeOnTransferTokens(
                                                        uint amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint deadline
                                                    )
                                                        external
                                                        virtual
                                                        override
                                                        payable
                                                        ensure(deadline)
                                                    {
                                                        require(path[0] == WETH, 'UniswapV2Router: INVALID_PATH');
                                                        uint amountIn = msg.value;
                                                        IWETH(WETH).deposit{value: amountIn}();
                                                        assert(IWETH(WETH).transfer(UniswapV2Library.pairFor(factory, path[0], path[1]), amountIn));
                                                        uint balanceBefore = IERC20(path[path.length - 1]).balanceOf(to);
                                                        _swapSupportingFeeOnTransferTokens(path, to);
                                                        require(
                                                            IERC20(path[path.length - 1]).balanceOf(to).sub(balanceBefore) >= amountOutMin,
                                                            'UniswapV2Router: INSUFFICIENT_OUTPUT_AMOUNT'
                                                        );
                                                    }
                                                    function swapExactTokensForETHSupportingFeeOnTransferTokens(
                                                        uint amountIn,
                                                        uint amountOutMin,
                                                        address[] calldata path,
                                                        address to,
                                                        uint deadline
                                                    )
                                                        external
                                                        virtual
                                                        override
                                                        ensure(deadline)
                                                    {
                                                        require(path[path.length - 1] == WETH, 'UniswapV2Router: INVALID_PATH');
                                                        TransferHelper.safeTransferFrom(
                                                            path[0], msg.sender, UniswapV2Library.pairFor(factory, path[0], path[1]), amountIn
                                                        );
                                                        _swapSupportingFeeOnTransferTokens(path, address(this));
                                                        uint amountOut = IERC20(WETH).balanceOf(address(this));
                                                        require(amountOut >= amountOutMin, 'UniswapV2Router: INSUFFICIENT_OUTPUT_AMOUNT');
                                                        IWETH(WETH).withdraw(amountOut);
                                                        TransferHelper.safeTransferETH(to, amountOut);
                                                    }
                                                
                                                    // **** LIBRARY FUNCTIONS ****
                                                    function quote(uint amountA, uint reserveA, uint reserveB) public pure virtual override returns (uint amountB) {
                                                        return UniswapV2Library.quote(amountA, reserveA, reserveB);
                                                    }
                                                
                                                    function getAmountOut(uint amountIn, uint reserveIn, uint reserveOut)
                                                        public
                                                        pure
                                                        virtual
                                                        override
                                                        returns (uint amountOut)
                                                    {
                                                        return UniswapV2Library.getAmountOut(amountIn, reserveIn, reserveOut);
                                                    }
                                                
                                                    function getAmountIn(uint amountOut, uint reserveIn, uint reserveOut)
                                                        public
                                                        pure
                                                        virtual
                                                        override
                                                        returns (uint amountIn)
                                                    {
                                                        return UniswapV2Library.getAmountIn(amountOut, reserveIn, reserveOut);
                                                    }
                                                
                                                    function getAmountsOut(uint amountIn, address[] memory path)
                                                        public
                                                        view
                                                        virtual
                                                        override
                                                        returns (uint[] memory amounts)
                                                    {
                                                        return UniswapV2Library.getAmountsOut(factory, amountIn, path);
                                                    }
                                                
                                                    function getAmountsIn(uint amountOut, address[] memory path)
                                                        public
                                                        view
                                                        virtual
                                                        override
                                                        returns (uint[] memory amounts)
                                                    {
                                                        return UniswapV2Library.getAmountsIn(factory, amountOut, path);
                                                    }
                                                }
                                                
                                                // a library for performing overflow-safe math, courtesy of DappHub (https://github.com/dapphub/ds-math)
                                                
                                                library SafeMath {
                                                    function add(uint x, uint y) internal pure returns (uint z) {
                                                        require((z = x + y) >= x, 'ds-math-add-overflow');
                                                    }
                                                
                                                    function sub(uint x, uint y) internal pure returns (uint z) {
                                                        require((z = x - y) <= x, 'ds-math-sub-underflow');
                                                    }
                                                
                                                    function mul(uint x, uint y) internal pure returns (uint z) {
                                                        require(y == 0 || (z = x * y) / y == x, 'ds-math-mul-overflow');
                                                    }
                                                }
                                                
                                                library UniswapV2Library {
                                                    using SafeMath for uint;
                                                
                                                    // returns sorted token addresses, used to handle return values from pairs sorted in this order
                                                    function sortTokens(address tokenA, address tokenB) internal pure returns (address token0, address token1) {
                                                        require(tokenA != tokenB, 'UniswapV2Library: IDENTICAL_ADDRESSES');
                                                        (token0, token1) = tokenA < tokenB ? (tokenA, tokenB) : (tokenB, tokenA);
                                                        require(token0 != address(0), 'UniswapV2Library: ZERO_ADDRESS');
                                                    }
                                                
                                                    // calculates the CREATE2 address for a pair without making any external calls
                                                    function pairFor(address factory, address tokenA, address tokenB) internal pure returns (address pair) {
                                                        (address token0, address token1) = sortTokens(tokenA, tokenB);
                                                        pair = address(uint(keccak256(abi.encodePacked(
                                                                hex'ff',
                                                                factory,
                                                                keccak256(abi.encodePacked(token0, token1)),
                                                                hex'96e8ac4277198ff8b6f785478aa9a39f403cb768dd02cbee326c3e7da348845f' // init code hash
                                                            ))));
                                                    }
                                                
                                                    // fetches and sorts the reserves for a pair
                                                    function getReserves(address factory, address tokenA, address tokenB) internal view returns (uint reserveA, uint reserveB) {
                                                        (address token0,) = sortTokens(tokenA, tokenB);
                                                        (uint reserve0, uint reserve1,) = IUniswapV2Pair(pairFor(factory, tokenA, tokenB)).getReserves();
                                                        (reserveA, reserveB) = tokenA == token0 ? (reserve0, reserve1) : (reserve1, reserve0);
                                                    }
                                                
                                                    // given some amount of an asset and pair reserves, returns an equivalent amount of the other asset
                                                    function quote(uint amountA, uint reserveA, uint reserveB) internal pure returns (uint amountB) {
                                                        require(amountA > 0, 'UniswapV2Library: INSUFFICIENT_AMOUNT');
                                                        require(reserveA > 0 && reserveB > 0, 'UniswapV2Library: INSUFFICIENT_LIQUIDITY');
                                                        amountB = amountA.mul(reserveB) / reserveA;
                                                    }
                                                
                                                    // given an input amount of an asset and pair reserves, returns the maximum output amount of the other asset
                                                    function getAmountOut(uint amountIn, uint reserveIn, uint reserveOut) internal pure returns (uint amountOut) {
                                                        require(amountIn > 0, 'UniswapV2Library: INSUFFICIENT_INPUT_AMOUNT');
                                                        require(reserveIn > 0 && reserveOut > 0, 'UniswapV2Library: INSUFFICIENT_LIQUIDITY');
                                                        uint amountInWithFee = amountIn.mul(997);
                                                        uint numerator = amountInWithFee.mul(reserveOut);
                                                        uint denominator = reserveIn.mul(1000).add(amountInWithFee);
                                                        amountOut = numerator / denominator;
                                                    }
                                                
                                                    // given an output amount of an asset and pair reserves, returns a required input amount of the other asset
                                                    function getAmountIn(uint amountOut, uint reserveIn, uint reserveOut) internal pure returns (uint amountIn) {
                                                        require(amountOut > 0, 'UniswapV2Library: INSUFFICIENT_OUTPUT_AMOUNT');
                                                        require(reserveIn > 0 && reserveOut > 0, 'UniswapV2Library: INSUFFICIENT_LIQUIDITY');
                                                        uint numerator = reserveIn.mul(amountOut).mul(1000);
                                                        uint denominator = reserveOut.sub(amountOut).mul(997);
                                                        amountIn = (numerator / denominator).add(1);
                                                    }
                                                
                                                    // performs chained getAmountOut calculations on any number of pairs
                                                    function getAmountsOut(address factory, uint amountIn, address[] memory path) internal view returns (uint[] memory amounts) {
                                                        require(path.length >= 2, 'UniswapV2Library: INVALID_PATH');
                                                        amounts = new uint[](path.length);
                                                        amounts[0] = amountIn;
                                                        for (uint i; i < path.length - 1; i++) {
                                                            (uint reserveIn, uint reserveOut) = getReserves(factory, path[i], path[i + 1]);
                                                            amounts[i + 1] = getAmountOut(amounts[i], reserveIn, reserveOut);
                                                        }
                                                    }
                                                
                                                    // performs chained getAmountIn calculations on any number of pairs
                                                    function getAmountsIn(address factory, uint amountOut, address[] memory path) internal view returns (uint[] memory amounts) {
                                                        require(path.length >= 2, 'UniswapV2Library: INVALID_PATH');
                                                        amounts = new uint[](path.length);
                                                        amounts[amounts.length - 1] = amountOut;
                                                        for (uint i = path.length - 1; i > 0; i--) {
                                                            (uint reserveIn, uint reserveOut) = getReserves(factory, path[i - 1], path[i]);
                                                            amounts[i - 1] = getAmountIn(amounts[i], reserveIn, reserveOut);
                                                        }
                                                    }
                                                }
                                                
                                                // helper methods for interacting with ERC20 tokens and sending ETH that do not consistently return true/false
                                                library TransferHelper {
                                                    function safeApprove(address token, address to, uint value) internal {
                                                        // bytes4(keccak256(bytes('approve(address,uint256)')));
                                                        (bool success, bytes memory data) = token.call(abi.encodeWithSelector(0x095ea7b3, to, value));
                                                        require(success && (data.length == 0 || abi.decode(data, (bool))), 'TransferHelper: APPROVE_FAILED');
                                                    }
                                                
                                                    function safeTransfer(address token, address to, uint value) internal {
                                                        // bytes4(keccak256(bytes('transfer(address,uint256)')));
                                                        (bool success, bytes memory data) = token.call(abi.encodeWithSelector(0xa9059cbb, to, value));
                                                        require(success && (data.length == 0 || abi.decode(data, (bool))), 'TransferHelper: TRANSFER_FAILED');
                                                    }
                                                
                                                    function safeTransferFrom(address token, address from, address to, uint value) internal {
                                                        // bytes4(keccak256(bytes('transferFrom(address,address,uint256)')));
                                                        (bool success, bytes memory data) = token.call(abi.encodeWithSelector(0x23b872dd, from, to, value));
                                                        require(success && (data.length == 0 || abi.decode(data, (bool))), 'TransferHelper: TRANSFER_FROM_FAILED');
                                                    }
                                                
                                                    function safeTransferETH(address to, uint value) internal {
                                                        (bool success,) = to.call{value:value}(new bytes(0));
                                                        require(success, 'TransferHelper: ETH_TRANSFER_FAILED');
                                                    }
                                                }

                                                File 7 of 12: MultiCollateralSynth
                                                /*
                                                
                                                ⚠⚠⚠ WARNING WARNING WARNING ⚠⚠⚠
                                                
                                                This is a TARGET contract - DO NOT CONNECT TO IT DIRECTLY IN YOUR CONTRACTS or DAPPS!
                                                
                                                This contract has an associated PROXY that MUST be used for all integrations - this TARGET will be REPLACED in an upcoming Synthetix release!
                                                The proxy can be found by looking up the PROXY property on this contract.
                                                
                                                *//*
                                                   ____            __   __        __   _
                                                  / __/__ __ ___  / /_ / /  ___  / /_ (_)__ __
                                                 _\ \ / // // _ \/ __// _ \/ -_)/ __// / \ \ /
                                                /___/ \_, //_//_/\__//_//_/\__/ \__//_/ /_\_\
                                                     /___/
                                                
                                                * Synthetix: MultiCollateralSynth.sol
                                                *
                                                * Latest source (may be newer): https://github.com/Synthetixio/synthetix/blob/master/contracts/MultiCollateralSynth.sol
                                                * Docs: https://docs.synthetix.io/contracts/MultiCollateralSynth
                                                *
                                                * Contract Dependencies: 
                                                *	- ExternStateToken
                                                *	- IAddressResolver
                                                *	- IERC20
                                                *	- ISynth
                                                *	- MixinResolver
                                                *	- Owned
                                                *	- Proxyable
                                                *	- SelfDestructible
                                                *	- State
                                                *	- Synth
                                                * Libraries: 
                                                *	- SafeDecimalMath
                                                *	- SafeMath
                                                *
                                                * MIT License
                                                * ===========
                                                *
                                                * Copyright (c) 2020 Synthetix
                                                *
                                                * Permission is hereby granted, free of charge, to any person obtaining a copy
                                                * of this software and associated documentation files (the "Software"), to deal
                                                * in the Software without restriction, including without limitation the rights
                                                * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
                                                * copies of the Software, and to permit persons to whom the Software is
                                                * furnished to do so, subject to the following conditions:
                                                *
                                                * The above copyright notice and this permission notice shall be included in all
                                                * copies or substantial portions of the Software.
                                                *
                                                * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
                                                * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
                                                * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
                                                * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
                                                * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
                                                * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
                                                */
                                                
                                                
                                                
                                                pragma solidity ^0.5.16;
                                                
                                                
                                                // https://docs.synthetix.io/contracts/Owned
                                                contract Owned {
                                                    address public owner;
                                                    address public nominatedOwner;
                                                
                                                    constructor(address _owner) public {
                                                        require(_owner != address(0), "Owner address cannot be 0");
                                                        owner = _owner;
                                                        emit OwnerChanged(address(0), _owner);
                                                    }
                                                
                                                    function nominateNewOwner(address _owner) external onlyOwner {
                                                        nominatedOwner = _owner;
                                                        emit OwnerNominated(_owner);
                                                    }
                                                
                                                    function acceptOwnership() external {
                                                        require(msg.sender == nominatedOwner, "You must be nominated before you can accept ownership");
                                                        emit OwnerChanged(owner, nominatedOwner);
                                                        owner = nominatedOwner;
                                                        nominatedOwner = address(0);
                                                    }
                                                
                                                    modifier onlyOwner {
                                                        _onlyOwner();
                                                        _;
                                                    }
                                                
                                                    function _onlyOwner() private view {
                                                        require(msg.sender == owner, "Only the contract owner may perform this action");
                                                    }
                                                
                                                    event OwnerNominated(address newOwner);
                                                    event OwnerChanged(address oldOwner, address newOwner);
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // https://docs.synthetix.io/contracts/SelfDestructible
                                                contract SelfDestructible is Owned {
                                                    uint public constant SELFDESTRUCT_DELAY = 4 weeks;
                                                
                                                    uint public initiationTime;
                                                    bool public selfDestructInitiated;
                                                
                                                    address public selfDestructBeneficiary;
                                                
                                                    constructor() internal {
                                                        // This contract is abstract, and thus cannot be instantiated directly
                                                        require(owner != address(0), "Owner must be set");
                                                        selfDestructBeneficiary = owner;
                                                        emit SelfDestructBeneficiaryUpdated(owner);
                                                    }
                                                
                                                    /**
                                                     * @notice Set the beneficiary address of this contract.
                                                     * @dev Only the contract owner may call this. The provided beneficiary must be non-null.
                                                     * @param _beneficiary The address to pay any eth contained in this contract to upon self-destruction.
                                                     */
                                                    function setSelfDestructBeneficiary(address payable _beneficiary) external onlyOwner {
                                                        require(_beneficiary != address(0), "Beneficiary must not be zero");
                                                        selfDestructBeneficiary = _beneficiary;
                                                        emit SelfDestructBeneficiaryUpdated(_beneficiary);
                                                    }
                                                
                                                    /**
                                                     * @notice Begin the self-destruction counter of this contract.
                                                     * Once the delay has elapsed, the contract may be self-destructed.
                                                     * @dev Only the contract owner may call this.
                                                     */
                                                    function initiateSelfDestruct() external onlyOwner {
                                                        initiationTime = now;
                                                        selfDestructInitiated = true;
                                                        emit SelfDestructInitiated(SELFDESTRUCT_DELAY);
                                                    }
                                                
                                                    /**
                                                     * @notice Terminate and reset the self-destruction timer.
                                                     * @dev Only the contract owner may call this.
                                                     */
                                                    function terminateSelfDestruct() external onlyOwner {
                                                        initiationTime = 0;
                                                        selfDestructInitiated = false;
                                                        emit SelfDestructTerminated();
                                                    }
                                                
                                                    /**
                                                     * @notice If the self-destruction delay has elapsed, destroy this contract and
                                                     * remit any ether it owns to the beneficiary address.
                                                     * @dev Only the contract owner may call this.
                                                     */
                                                    function selfDestruct() external onlyOwner {
                                                        require(selfDestructInitiated, "Self Destruct not yet initiated");
                                                        require(initiationTime + SELFDESTRUCT_DELAY < now, "Self destruct delay not met");
                                                        emit SelfDestructed(selfDestructBeneficiary);
                                                        selfdestruct(address(uint160(selfDestructBeneficiary)));
                                                    }
                                                
                                                    event SelfDestructTerminated();
                                                    event SelfDestructed(address beneficiary);
                                                    event SelfDestructInitiated(uint selfDestructDelay);
                                                    event SelfDestructBeneficiaryUpdated(address newBeneficiary);
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // Internal references
                                                
                                                
                                                // https://docs.synthetix.io/contracts/Proxy
                                                contract Proxy is Owned {
                                                    Proxyable public target;
                                                
                                                    constructor(address _owner) public Owned(_owner) {}
                                                
                                                    function setTarget(Proxyable _target) external onlyOwner {
                                                        target = _target;
                                                        emit TargetUpdated(_target);
                                                    }
                                                
                                                    function _emit(
                                                        bytes calldata callData,
                                                        uint numTopics,
                                                        bytes32 topic1,
                                                        bytes32 topic2,
                                                        bytes32 topic3,
                                                        bytes32 topic4
                                                    ) external onlyTarget {
                                                        uint size = callData.length;
                                                        bytes memory _callData = callData;
                                                
                                                        assembly {
                                                            /* The first 32 bytes of callData contain its length (as specified by the abi).
                                                             * Length is assumed to be a uint256 and therefore maximum of 32 bytes
                                                             * in length. It is also leftpadded to be a multiple of 32 bytes.
                                                             * This means moving call_data across 32 bytes guarantees we correctly access
                                                             * the data itself. */
                                                            switch numTopics
                                                                case 0 {
                                                                    log0(add(_callData, 32), size)
                                                                }
                                                                case 1 {
                                                                    log1(add(_callData, 32), size, topic1)
                                                                }
                                                                case 2 {
                                                                    log2(add(_callData, 32), size, topic1, topic2)
                                                                }
                                                                case 3 {
                                                                    log3(add(_callData, 32), size, topic1, topic2, topic3)
                                                                }
                                                                case 4 {
                                                                    log4(add(_callData, 32), size, topic1, topic2, topic3, topic4)
                                                                }
                                                        }
                                                    }
                                                
                                                    // solhint-disable no-complex-fallback
                                                    function() external payable {
                                                        // Mutable call setting Proxyable.messageSender as this is using call not delegatecall
                                                        target.setMessageSender(msg.sender);
                                                
                                                        assembly {
                                                            let free_ptr := mload(0x40)
                                                            calldatacopy(free_ptr, 0, calldatasize)
                                                
                                                            /* We must explicitly forward ether to the underlying contract as well. */
                                                            let result := call(gas, sload(target_slot), callvalue, free_ptr, calldatasize, 0, 0)
                                                            returndatacopy(free_ptr, 0, returndatasize)
                                                
                                                            if iszero(result) {
                                                                revert(free_ptr, returndatasize)
                                                            }
                                                            return(free_ptr, returndatasize)
                                                        }
                                                    }
                                                
                                                    modifier onlyTarget {
                                                        require(Proxyable(msg.sender) == target, "Must be proxy target");
                                                        _;
                                                    }
                                                
                                                    event TargetUpdated(Proxyable newTarget);
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // Internal references
                                                
                                                
                                                // https://docs.synthetix.io/contracts/Proxyable
                                                contract Proxyable is Owned {
                                                    // This contract should be treated like an abstract contract
                                                
                                                    /* The proxy this contract exists behind. */
                                                    Proxy public proxy;
                                                    Proxy public integrationProxy;
                                                
                                                    /* The caller of the proxy, passed through to this contract.
                                                     * Note that every function using this member must apply the onlyProxy or
                                                     * optionalProxy modifiers, otherwise their invocations can use stale values. */
                                                    address public messageSender;
                                                
                                                    constructor(address payable _proxy) internal {
                                                        // This contract is abstract, and thus cannot be instantiated directly
                                                        require(owner != address(0), "Owner must be set");
                                                
                                                        proxy = Proxy(_proxy);
                                                        emit ProxyUpdated(_proxy);
                                                    }
                                                
                                                    function setProxy(address payable _proxy) external onlyOwner {
                                                        proxy = Proxy(_proxy);
                                                        emit ProxyUpdated(_proxy);
                                                    }
                                                
                                                    function setIntegrationProxy(address payable _integrationProxy) external onlyOwner {
                                                        integrationProxy = Proxy(_integrationProxy);
                                                    }
                                                
                                                    function setMessageSender(address sender) external onlyProxy {
                                                        messageSender = sender;
                                                    }
                                                
                                                    modifier onlyProxy {
                                                        _onlyProxy();
                                                        _;
                                                    }
                                                
                                                    function _onlyProxy() private view {
                                                        require(Proxy(msg.sender) == proxy || Proxy(msg.sender) == integrationProxy, "Only the proxy can call");
                                                    }
                                                
                                                    modifier optionalProxy {
                                                        _optionalProxy();
                                                        _;
                                                    }
                                                
                                                    function _optionalProxy() private {
                                                        if (Proxy(msg.sender) != proxy && Proxy(msg.sender) != integrationProxy && messageSender != msg.sender) {
                                                            messageSender = msg.sender;
                                                        }
                                                    }
                                                
                                                    modifier optionalProxy_onlyOwner {
                                                        _optionalProxy_onlyOwner();
                                                        _;
                                                    }
                                                
                                                    // solhint-disable-next-line func-name-mixedcase
                                                    function _optionalProxy_onlyOwner() private {
                                                        if (Proxy(msg.sender) != proxy && Proxy(msg.sender) != integrationProxy && messageSender != msg.sender) {
                                                            messageSender = msg.sender;
                                                        }
                                                        require(messageSender == owner, "Owner only function");
                                                    }
                                                
                                                    event ProxyUpdated(address proxyAddress);
                                                }
                                                
                                                
                                                /**
                                                 * @dev Wrappers over Solidity's arithmetic operations with added overflow
                                                 * checks.
                                                 *
                                                 * Arithmetic operations in Solidity wrap on overflow. This can easily result
                                                 * in bugs, because programmers usually assume that an overflow raises an
                                                 * error, which is the standard behavior in high level programming languages.
                                                 * `SafeMath` restores this intuition by reverting the transaction when an
                                                 * operation overflows.
                                                 *
                                                 * Using this library instead of the unchecked operations eliminates an entire
                                                 * class of bugs, so it's recommended to use it always.
                                                 */
                                                library SafeMath {
                                                    /**
                                                     * @dev Returns the addition of two unsigned integers, reverting on
                                                     * overflow.
                                                     *
                                                     * Counterpart to Solidity's `+` operator.
                                                     *
                                                     * Requirements:
                                                     * - Addition cannot overflow.
                                                     */
                                                    function add(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        uint256 c = a + b;
                                                        require(c >= a, "SafeMath: addition overflow");
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the subtraction of two unsigned integers, reverting on
                                                     * overflow (when the result is negative).
                                                     *
                                                     * Counterpart to Solidity's `-` operator.
                                                     *
                                                     * Requirements:
                                                     * - Subtraction cannot overflow.
                                                     */
                                                    function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        require(b <= a, "SafeMath: subtraction overflow");
                                                        uint256 c = a - b;
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the multiplication of two unsigned integers, reverting on
                                                     * overflow.
                                                     *
                                                     * Counterpart to Solidity's `*` operator.
                                                     *
                                                     * Requirements:
                                                     * - Multiplication cannot overflow.
                                                     */
                                                    function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                                                        // benefit is lost if 'b' is also tested.
                                                        // See: https://github.com/OpenZeppelin/openzeppelin-solidity/pull/522
                                                        if (a == 0) {
                                                            return 0;
                                                        }
                                                
                                                        uint256 c = a * b;
                                                        require(c / a == b, "SafeMath: multiplication overflow");
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the integer division of two unsigned integers. Reverts on
                                                     * division by zero. The result is rounded towards zero.
                                                     *
                                                     * Counterpart to Solidity's `/` operator. Note: this function uses a
                                                     * `revert` opcode (which leaves remaining gas untouched) while Solidity
                                                     * uses an invalid opcode to revert (consuming all remaining gas).
                                                     *
                                                     * Requirements:
                                                     * - The divisor cannot be zero.
                                                     */
                                                    function div(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        // Solidity only automatically asserts when dividing by 0
                                                        require(b > 0, "SafeMath: division by zero");
                                                        uint256 c = a / b;
                                                        // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                                     * Reverts when dividing by zero.
                                                     *
                                                     * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                                     * opcode (which leaves remaining gas untouched) while Solidity uses an
                                                     * invalid opcode to revert (consuming all remaining gas).
                                                     *
                                                     * Requirements:
                                                     * - The divisor cannot be zero.
                                                     */
                                                    function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        require(b != 0, "SafeMath: modulo by zero");
                                                        return a % b;
                                                    }
                                                }
                                                
                                                
                                                // Libraries
                                                
                                                
                                                // https://docs.synthetix.io/contracts/SafeDecimalMath
                                                library SafeDecimalMath {
                                                    using SafeMath for uint;
                                                
                                                    /* Number of decimal places in the representations. */
                                                    uint8 public constant decimals = 18;
                                                    uint8 public constant highPrecisionDecimals = 27;
                                                
                                                    /* The number representing 1.0. */
                                                    uint public constant UNIT = 10**uint(decimals);
                                                
                                                    /* The number representing 1.0 for higher fidelity numbers. */
                                                    uint public constant PRECISE_UNIT = 10**uint(highPrecisionDecimals);
                                                    uint private constant UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR = 10**uint(highPrecisionDecimals - decimals);
                                                
                                                    /**
                                                     * @return Provides an interface to UNIT.
                                                     */
                                                    function unit() external pure returns (uint) {
                                                        return UNIT;
                                                    }
                                                
                                                    /**
                                                     * @return Provides an interface to PRECISE_UNIT.
                                                     */
                                                    function preciseUnit() external pure returns (uint) {
                                                        return PRECISE_UNIT;
                                                    }
                                                
                                                    /**
                                                     * @return The result of multiplying x and y, interpreting the operands as fixed-point
                                                     * decimals.
                                                     *
                                                     * @dev A unit factor is divided out after the product of x and y is evaluated,
                                                     * so that product must be less than 2**256. As this is an integer division,
                                                     * the internal division always rounds down. This helps save on gas. Rounding
                                                     * is more expensive on gas.
                                                     */
                                                    function multiplyDecimal(uint x, uint y) internal pure returns (uint) {
                                                        /* Divide by UNIT to remove the extra factor introduced by the product. */
                                                        return x.mul(y) / UNIT;
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely multiplying x and y, interpreting the operands
                                                     * as fixed-point decimals of the specified precision unit.
                                                     *
                                                     * @dev The operands should be in the form of a the specified unit factor which will be
                                                     * divided out after the product of x and y is evaluated, so that product must be
                                                     * less than 2**256.
                                                     *
                                                     * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
                                                     * Rounding is useful when you need to retain fidelity for small decimal numbers
                                                     * (eg. small fractions or percentages).
                                                     */
                                                    function _multiplyDecimalRound(
                                                        uint x,
                                                        uint y,
                                                        uint precisionUnit
                                                    ) private pure returns (uint) {
                                                        /* Divide by UNIT to remove the extra factor introduced by the product. */
                                                        uint quotientTimesTen = x.mul(y) / (precisionUnit / 10);
                                                
                                                        if (quotientTimesTen % 10 >= 5) {
                                                            quotientTimesTen += 10;
                                                        }
                                                
                                                        return quotientTimesTen / 10;
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely multiplying x and y, interpreting the operands
                                                     * as fixed-point decimals of a precise unit.
                                                     *
                                                     * @dev The operands should be in the precise unit factor which will be
                                                     * divided out after the product of x and y is evaluated, so that product must be
                                                     * less than 2**256.
                                                     *
                                                     * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
                                                     * Rounding is useful when you need to retain fidelity for small decimal numbers
                                                     * (eg. small fractions or percentages).
                                                     */
                                                    function multiplyDecimalRoundPrecise(uint x, uint y) internal pure returns (uint) {
                                                        return _multiplyDecimalRound(x, y, PRECISE_UNIT);
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely multiplying x and y, interpreting the operands
                                                     * as fixed-point decimals of a standard unit.
                                                     *
                                                     * @dev The operands should be in the standard unit factor which will be
                                                     * divided out after the product of x and y is evaluated, so that product must be
                                                     * less than 2**256.
                                                     *
                                                     * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
                                                     * Rounding is useful when you need to retain fidelity for small decimal numbers
                                                     * (eg. small fractions or percentages).
                                                     */
                                                    function multiplyDecimalRound(uint x, uint y) internal pure returns (uint) {
                                                        return _multiplyDecimalRound(x, y, UNIT);
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely dividing x and y. The return value is a high
                                                     * precision decimal.
                                                     *
                                                     * @dev y is divided after the product of x and the standard precision unit
                                                     * is evaluated, so the product of x and UNIT must be less than 2**256. As
                                                     * this is an integer division, the result is always rounded down.
                                                     * This helps save on gas. Rounding is more expensive on gas.
                                                     */
                                                    function divideDecimal(uint x, uint y) internal pure returns (uint) {
                                                        /* Reintroduce the UNIT factor that will be divided out by y. */
                                                        return x.mul(UNIT).div(y);
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely dividing x and y. The return value is as a rounded
                                                     * decimal in the precision unit specified in the parameter.
                                                     *
                                                     * @dev y is divided after the product of x and the specified precision unit
                                                     * is evaluated, so the product of x and the specified precision unit must
                                                     * be less than 2**256. The result is rounded to the nearest increment.
                                                     */
                                                    function _divideDecimalRound(
                                                        uint x,
                                                        uint y,
                                                        uint precisionUnit
                                                    ) private pure returns (uint) {
                                                        uint resultTimesTen = x.mul(precisionUnit * 10).div(y);
                                                
                                                        if (resultTimesTen % 10 >= 5) {
                                                            resultTimesTen += 10;
                                                        }
                                                
                                                        return resultTimesTen / 10;
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely dividing x and y. The return value is as a rounded
                                                     * standard precision decimal.
                                                     *
                                                     * @dev y is divided after the product of x and the standard precision unit
                                                     * is evaluated, so the product of x and the standard precision unit must
                                                     * be less than 2**256. The result is rounded to the nearest increment.
                                                     */
                                                    function divideDecimalRound(uint x, uint y) internal pure returns (uint) {
                                                        return _divideDecimalRound(x, y, UNIT);
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely dividing x and y. The return value is as a rounded
                                                     * high precision decimal.
                                                     *
                                                     * @dev y is divided after the product of x and the high precision unit
                                                     * is evaluated, so the product of x and the high precision unit must
                                                     * be less than 2**256. The result is rounded to the nearest increment.
                                                     */
                                                    function divideDecimalRoundPrecise(uint x, uint y) internal pure returns (uint) {
                                                        return _divideDecimalRound(x, y, PRECISE_UNIT);
                                                    }
                                                
                                                    /**
                                                     * @dev Convert a standard decimal representation to a high precision one.
                                                     */
                                                    function decimalToPreciseDecimal(uint i) internal pure returns (uint) {
                                                        return i.mul(UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR);
                                                    }
                                                
                                                    /**
                                                     * @dev Convert a high precision decimal to a standard decimal representation.
                                                     */
                                                    function preciseDecimalToDecimal(uint i) internal pure returns (uint) {
                                                        uint quotientTimesTen = i / (UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR / 10);
                                                
                                                        if (quotientTimesTen % 10 >= 5) {
                                                            quotientTimesTen += 10;
                                                        }
                                                
                                                        return quotientTimesTen / 10;
                                                    }
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // https://docs.synthetix.io/contracts/State
                                                contract State is Owned {
                                                    // the address of the contract that can modify variables
                                                    // this can only be changed by the owner of this contract
                                                    address public associatedContract;
                                                
                                                    constructor(address _associatedContract) internal {
                                                        // This contract is abstract, and thus cannot be instantiated directly
                                                        require(owner != address(0), "Owner must be set");
                                                
                                                        associatedContract = _associatedContract;
                                                        emit AssociatedContractUpdated(_associatedContract);
                                                    }
                                                
                                                    /* ========== SETTERS ========== */
                                                
                                                    // Change the associated contract to a new address
                                                    function setAssociatedContract(address _associatedContract) external onlyOwner {
                                                        associatedContract = _associatedContract;
                                                        emit AssociatedContractUpdated(_associatedContract);
                                                    }
                                                
                                                    /* ========== MODIFIERS ========== */
                                                
                                                    modifier onlyAssociatedContract {
                                                        require(msg.sender == associatedContract, "Only the associated contract can perform this action");
                                                        _;
                                                    }
                                                
                                                    /* ========== EVENTS ========== */
                                                
                                                    event AssociatedContractUpdated(address associatedContract);
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // https://docs.synthetix.io/contracts/TokenState
                                                contract TokenState is Owned, State {
                                                    /* ERC20 fields. */
                                                    mapping(address => uint) public balanceOf;
                                                    mapping(address => mapping(address => uint)) public allowance;
                                                
                                                    constructor(address _owner, address _associatedContract) public Owned(_owner) State(_associatedContract) {}
                                                
                                                    /* ========== SETTERS ========== */
                                                
                                                    /**
                                                     * @notice Set ERC20 allowance.
                                                     * @dev Only the associated contract may call this.
                                                     * @param tokenOwner The authorising party.
                                                     * @param spender The authorised party.
                                                     * @param value The total value the authorised party may spend on the
                                                     * authorising party's behalf.
                                                     */
                                                    function setAllowance(
                                                        address tokenOwner,
                                                        address spender,
                                                        uint value
                                                    ) external onlyAssociatedContract {
                                                        allowance[tokenOwner][spender] = value;
                                                    }
                                                
                                                    /**
                                                     * @notice Set the balance in a given account
                                                     * @dev Only the associated contract may call this.
                                                     * @param account The account whose value to set.
                                                     * @param value The new balance of the given account.
                                                     */
                                                    function setBalanceOf(address account, uint value) external onlyAssociatedContract {
                                                        balanceOf[account] = value;
                                                    }
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // Libraries
                                                
                                                
                                                // Internal references
                                                
                                                
                                                // https://docs.synthetix.io/contracts/ExternStateToken
                                                contract ExternStateToken is Owned, SelfDestructible, Proxyable {
                                                    using SafeMath for uint;
                                                    using SafeDecimalMath for uint;
                                                
                                                    /* ========== STATE VARIABLES ========== */
                                                
                                                    /* Stores balances and allowances. */
                                                    TokenState public tokenState;
                                                
                                                    /* Other ERC20 fields. */
                                                    string public name;
                                                    string public symbol;
                                                    uint public totalSupply;
                                                    uint8 public decimals;
                                                
                                                    constructor(
                                                        address payable _proxy,
                                                        TokenState _tokenState,
                                                        string memory _name,
                                                        string memory _symbol,
                                                        uint _totalSupply,
                                                        uint8 _decimals,
                                                        address _owner
                                                    ) public Owned(_owner) SelfDestructible() Proxyable(_proxy) {
                                                        tokenState = _tokenState;
                                                
                                                        name = _name;
                                                        symbol = _symbol;
                                                        totalSupply = _totalSupply;
                                                        decimals = _decimals;
                                                    }
                                                
                                                    /* ========== VIEWS ========== */
                                                
                                                    /**
                                                     * @notice Returns the ERC20 allowance of one party to spend on behalf of another.
                                                     * @param owner The party authorising spending of their funds.
                                                     * @param spender The party spending tokenOwner's funds.
                                                     */
                                                    function allowance(address owner, address spender) public view returns (uint) {
                                                        return tokenState.allowance(owner, spender);
                                                    }
                                                
                                                    /**
                                                     * @notice Returns the ERC20 token balance of a given account.
                                                     */
                                                    function balanceOf(address account) external view returns (uint) {
                                                        return tokenState.balanceOf(account);
                                                    }
                                                
                                                    /* ========== MUTATIVE FUNCTIONS ========== */
                                                
                                                    /**
                                                     * @notice Set the address of the TokenState contract.
                                                     * @dev This can be used to "pause" transfer functionality, by pointing the tokenState at 0x000..
                                                     * as balances would be unreachable.
                                                     */
                                                    function setTokenState(TokenState _tokenState) external optionalProxy_onlyOwner {
                                                        tokenState = _tokenState;
                                                        emitTokenStateUpdated(address(_tokenState));
                                                    }
                                                
                                                    function _internalTransfer(
                                                        address from,
                                                        address to,
                                                        uint value
                                                    ) internal returns (bool) {
                                                        /* Disallow transfers to irretrievable-addresses. */
                                                        require(to != address(0) && to != address(this) && to != address(proxy), "Cannot transfer to this address");
                                                
                                                        // Insufficient balance will be handled by the safe subtraction.
                                                        tokenState.setBalanceOf(from, tokenState.balanceOf(from).sub(value));
                                                        tokenState.setBalanceOf(to, tokenState.balanceOf(to).add(value));
                                                
                                                        // Emit a standard ERC20 transfer event
                                                        emitTransfer(from, to, value);
                                                
                                                        return true;
                                                    }
                                                
                                                    /**
                                                     * @dev Perform an ERC20 token transfer. Designed to be called by transfer functions possessing
                                                     * the onlyProxy or optionalProxy modifiers.
                                                     */
                                                    function _transferByProxy(
                                                        address from,
                                                        address to,
                                                        uint value
                                                    ) internal returns (bool) {
                                                        return _internalTransfer(from, to, value);
                                                    }
                                                
                                                    /*
                                                     * @dev Perform an ERC20 token transferFrom. Designed to be called by transferFrom functions
                                                     * possessing the optionalProxy or optionalProxy modifiers.
                                                     */
                                                    function _transferFromByProxy(
                                                        address sender,
                                                        address from,
                                                        address to,
                                                        uint value
                                                    ) internal returns (bool) {
                                                        /* Insufficient allowance will be handled by the safe subtraction. */
                                                        tokenState.setAllowance(from, sender, tokenState.allowance(from, sender).sub(value));
                                                        return _internalTransfer(from, to, value);
                                                    }
                                                
                                                    /**
                                                     * @notice Approves spender to transfer on the message sender's behalf.
                                                     */
                                                    function approve(address spender, uint value) public optionalProxy returns (bool) {
                                                        address sender = messageSender;
                                                
                                                        tokenState.setAllowance(sender, spender, value);
                                                        emitApproval(sender, spender, value);
                                                        return true;
                                                    }
                                                
                                                    /* ========== EVENTS ========== */
                                                    function addressToBytes32(address input) internal pure returns (bytes32) {
                                                        return bytes32(uint256(uint160(input)));
                                                    }
                                                
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                    bytes32 internal constant TRANSFER_SIG = keccak256("Transfer(address,address,uint256)");
                                                
                                                    function emitTransfer(
                                                        address from,
                                                        address to,
                                                        uint value
                                                    ) internal {
                                                        proxy._emit(abi.encode(value), 3, TRANSFER_SIG, addressToBytes32(from), addressToBytes32(to), 0);
                                                    }
                                                
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                    bytes32 internal constant APPROVAL_SIG = keccak256("Approval(address,address,uint256)");
                                                
                                                    function emitApproval(
                                                        address owner,
                                                        address spender,
                                                        uint value
                                                    ) internal {
                                                        proxy._emit(abi.encode(value), 3, APPROVAL_SIG, addressToBytes32(owner), addressToBytes32(spender), 0);
                                                    }
                                                
                                                    event TokenStateUpdated(address newTokenState);
                                                    bytes32 internal constant TOKENSTATEUPDATED_SIG = keccak256("TokenStateUpdated(address)");
                                                
                                                    function emitTokenStateUpdated(address newTokenState) internal {
                                                        proxy._emit(abi.encode(newTokenState), 1, TOKENSTATEUPDATED_SIG, 0, 0, 0);
                                                    }
                                                }
                                                
                                                
                                                interface IAddressResolver {
                                                    function getAddress(bytes32 name) external view returns (address);
                                                
                                                    function getSynth(bytes32 key) external view returns (address);
                                                
                                                    function requireAndGetAddress(bytes32 name, string calldata reason) external view returns (address);
                                                }
                                                
                                                
                                                interface ISynth {
                                                    // Views
                                                    function currencyKey() external view returns (bytes32);
                                                
                                                    function transferableSynths(address account) external view returns (uint);
                                                
                                                    // Mutative functions
                                                    function transferAndSettle(address to, uint value) external returns (bool);
                                                
                                                    function transferFromAndSettle(
                                                        address from,
                                                        address to,
                                                        uint value
                                                    ) external returns (bool);
                                                
                                                    // Restricted: used internally to Synthetix
                                                    function burn(address account, uint amount) external;
                                                
                                                    function issue(address account, uint amount) external;
                                                }
                                                
                                                
                                                interface IIssuer {
                                                    // Views
                                                    function anySynthOrSNXRateIsInvalid() external view returns (bool anyRateInvalid);
                                                
                                                    function availableCurrencyKeys() external view returns (bytes32[] memory);
                                                
                                                    function availableSynthCount() external view returns (uint);
                                                
                                                    function availableSynths(uint index) external view returns (ISynth);
                                                
                                                    function canBurnSynths(address account) external view returns (bool);
                                                
                                                    function collateral(address account) external view returns (uint);
                                                
                                                    function collateralisationRatio(address issuer) external view returns (uint);
                                                
                                                    function collateralisationRatioAndAnyRatesInvalid(address _issuer)
                                                        external
                                                        view
                                                        returns (uint cratio, bool anyRateIsInvalid);
                                                
                                                    function debtBalanceOf(address issuer, bytes32 currencyKey) external view returns (uint debtBalance);
                                                
                                                    function issuanceRatio() external view returns (uint);
                                                
                                                    function lastIssueEvent(address account) external view returns (uint);
                                                
                                                    function maxIssuableSynths(address issuer) external view returns (uint maxIssuable);
                                                
                                                    function minimumStakeTime() external view returns (uint);
                                                
                                                    function remainingIssuableSynths(address issuer)
                                                        external
                                                        view
                                                        returns (
                                                            uint maxIssuable,
                                                            uint alreadyIssued,
                                                            uint totalSystemDebt
                                                        );
                                                
                                                    function synths(bytes32 currencyKey) external view returns (ISynth);
                                                
                                                    function synthsByAddress(address synthAddress) external view returns (bytes32);
                                                
                                                    function totalIssuedSynths(bytes32 currencyKey, bool excludeEtherCollateral) external view returns (uint);
                                                
                                                    function transferableSynthetixAndAnyRateIsInvalid(address account, uint balance)
                                                        external
                                                        view
                                                        returns (uint transferable, bool anyRateIsInvalid);
                                                
                                                    // Restricted: used internally to Synthetix
                                                    function issueSynths(address from, uint amount) external;
                                                
                                                    function issueSynthsOnBehalf(
                                                        address issueFor,
                                                        address from,
                                                        uint amount
                                                    ) external;
                                                
                                                    function issueMaxSynths(address from) external;
                                                
                                                    function issueMaxSynthsOnBehalf(address issueFor, address from) external;
                                                
                                                    function burnSynths(address from, uint amount) external;
                                                
                                                    function burnSynthsOnBehalf(
                                                        address burnForAddress,
                                                        address from,
                                                        uint amount
                                                    ) external;
                                                
                                                    function burnSynthsToTarget(address from) external;
                                                
                                                    function burnSynthsToTargetOnBehalf(address burnForAddress, address from) external;
                                                
                                                    function liquidateDelinquentAccount(
                                                        address account,
                                                        uint susdAmount,
                                                        address liquidator
                                                    ) external returns (uint totalRedeemed, uint amountToLiquidate);
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // https://docs.synthetix.io/contracts/AddressResolver
                                                contract AddressResolver is Owned, IAddressResolver {
                                                    mapping(bytes32 => address) public repository;
                                                
                                                    constructor(address _owner) public Owned(_owner) {}
                                                
                                                    /* ========== MUTATIVE FUNCTIONS ========== */
                                                
                                                    function importAddresses(bytes32[] calldata names, address[] calldata destinations) external onlyOwner {
                                                        require(names.length == destinations.length, "Input lengths must match");
                                                
                                                        for (uint i = 0; i < names.length; i++) {
                                                            repository[names[i]] = destinations[i];
                                                        }
                                                    }
                                                
                                                    /* ========== VIEWS ========== */
                                                
                                                    function getAddress(bytes32 name) external view returns (address) {
                                                        return repository[name];
                                                    }
                                                
                                                    function requireAndGetAddress(bytes32 name, string calldata reason) external view returns (address) {
                                                        address _foundAddress = repository[name];
                                                        require(_foundAddress != address(0), reason);
                                                        return _foundAddress;
                                                    }
                                                
                                                    function getSynth(bytes32 key) external view returns (address) {
                                                        IIssuer issuer = IIssuer(repository["Issuer"]);
                                                        require(address(issuer) != address(0), "Cannot find Issuer address");
                                                        return address(issuer.synths(key));
                                                    }
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // Internal references
                                                
                                                
                                                // https://docs.synthetix.io/contracts/MixinResolver
                                                contract MixinResolver is Owned {
                                                    AddressResolver public resolver;
                                                
                                                    mapping(bytes32 => address) private addressCache;
                                                
                                                    bytes32[] public resolverAddressesRequired;
                                                
                                                    uint public constant MAX_ADDRESSES_FROM_RESOLVER = 24;
                                                
                                                    constructor(address _resolver, bytes32[MAX_ADDRESSES_FROM_RESOLVER] memory _addressesToCache) internal {
                                                        // This contract is abstract, and thus cannot be instantiated directly
                                                        require(owner != address(0), "Owner must be set");
                                                
                                                        for (uint i = 0; i < _addressesToCache.length; i++) {
                                                            if (_addressesToCache[i] != bytes32(0)) {
                                                                resolverAddressesRequired.push(_addressesToCache[i]);
                                                            } else {
                                                                // End early once an empty item is found - assumes there are no empty slots in
                                                                // _addressesToCache
                                                                break;
                                                            }
                                                        }
                                                        resolver = AddressResolver(_resolver);
                                                        // Do not sync the cache as addresses may not be in the resolver yet
                                                    }
                                                
                                                    /* ========== SETTERS ========== */
                                                    function setResolverAndSyncCache(AddressResolver _resolver) external onlyOwner {
                                                        resolver = _resolver;
                                                
                                                        for (uint i = 0; i < resolverAddressesRequired.length; i++) {
                                                            bytes32 name = resolverAddressesRequired[i];
                                                            // Note: can only be invoked once the resolver has all the targets needed added
                                                            addressCache[name] = resolver.requireAndGetAddress(name, "Resolver missing target");
                                                        }
                                                    }
                                                
                                                    /* ========== VIEWS ========== */
                                                
                                                    function requireAndGetAddress(bytes32 name, string memory reason) internal view returns (address) {
                                                        address _foundAddress = addressCache[name];
                                                        require(_foundAddress != address(0), reason);
                                                        return _foundAddress;
                                                    }
                                                
                                                    // Note: this could be made external in a utility contract if addressCache was made public
                                                    // (used for deployment)
                                                    function isResolverCached(AddressResolver _resolver) external view returns (bool) {
                                                        if (resolver != _resolver) {
                                                            return false;
                                                        }
                                                
                                                        // otherwise, check everything
                                                        for (uint i = 0; i < resolverAddressesRequired.length; i++) {
                                                            bytes32 name = resolverAddressesRequired[i];
                                                            // false if our cache is invalid or if the resolver doesn't have the required address
                                                            if (resolver.getAddress(name) != addressCache[name] || addressCache[name] == address(0)) {
                                                                return false;
                                                            }
                                                        }
                                                
                                                        return true;
                                                    }
                                                
                                                    // Note: can be made external into a utility contract (used for deployment)
                                                    function getResolverAddressesRequired()
                                                        external
                                                        view
                                                        returns (bytes32[MAX_ADDRESSES_FROM_RESOLVER] memory addressesRequired)
                                                    {
                                                        for (uint i = 0; i < resolverAddressesRequired.length; i++) {
                                                            addressesRequired[i] = resolverAddressesRequired[i];
                                                        }
                                                    }
                                                
                                                    /* ========== INTERNAL FUNCTIONS ========== */
                                                    function appendToAddressCache(bytes32 name) internal {
                                                        resolverAddressesRequired.push(name);
                                                        require(resolverAddressesRequired.length < MAX_ADDRESSES_FROM_RESOLVER, "Max resolver cache size met");
                                                        // Because this is designed to be called internally in constructors, we don't
                                                        // check the address exists already in the resolver
                                                        addressCache[name] = resolver.getAddress(name);
                                                    }
                                                }
                                                
                                                
                                                interface IERC20 {
                                                    // ERC20 Optional Views
                                                    function name() external view returns (string memory);
                                                
                                                    function symbol() external view returns (string memory);
                                                
                                                    function decimals() external view returns (uint8);
                                                
                                                    // Views
                                                    function totalSupply() external view returns (uint);
                                                
                                                    function balanceOf(address owner) external view returns (uint);
                                                
                                                    function allowance(address owner, address spender) external view returns (uint);
                                                
                                                    // Mutative functions
                                                    function transfer(address to, uint value) external returns (bool);
                                                
                                                    function approve(address spender, uint value) external returns (bool);
                                                
                                                    function transferFrom(
                                                        address from,
                                                        address to,
                                                        uint value
                                                    ) external returns (bool);
                                                
                                                    // Events
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                }
                                                
                                                
                                                interface ISystemStatus {
                                                    struct Status {
                                                        bool canSuspend;
                                                        bool canResume;
                                                    }
                                                
                                                    struct Suspension {
                                                        bool suspended;
                                                        // reason is an integer code,
                                                        // 0 => no reason, 1 => upgrading, 2+ => defined by system usage
                                                        uint248 reason;
                                                    }
                                                
                                                    // Views
                                                    function accessControl(bytes32 section, address account) external view returns (bool canSuspend, bool canResume);
                                                
                                                    function requireSystemActive() external view;
                                                
                                                    function requireIssuanceActive() external view;
                                                
                                                    function requireExchangeActive() external view;
                                                
                                                    function requireSynthActive(bytes32 currencyKey) external view;
                                                
                                                    function requireSynthsActive(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey) external view;
                                                
                                                    function synthSuspension(bytes32 currencyKey) external view returns (bool suspended, uint248 reason);
                                                
                                                    // Restricted functions
                                                    function suspendSynth(bytes32 currencyKey, uint256 reason) external;
                                                
                                                    function updateAccessControl(
                                                        bytes32 section,
                                                        address account,
                                                        bool canSuspend,
                                                        bool canResume
                                                    ) external;
                                                }
                                                
                                                
                                                interface IFeePool {
                                                    // Views
                                                
                                                    // solhint-disable-next-line func-name-mixedcase
                                                    function FEE_ADDRESS() external view returns (address);
                                                
                                                    function feesAvailable(address account) external view returns (uint, uint);
                                                
                                                    function feePeriodDuration() external view returns (uint);
                                                
                                                    function isFeesClaimable(address account) external view returns (bool);
                                                
                                                    function targetThreshold() external view returns (uint);
                                                
                                                    function totalFeesAvailable() external view returns (uint);
                                                
                                                    function totalRewardsAvailable() external view returns (uint);
                                                
                                                    // Mutative Functions
                                                    function claimFees() external returns (bool);
                                                
                                                    function claimOnBehalf(address claimingForAddress) external returns (bool);
                                                
                                                    function closeCurrentFeePeriod() external;
                                                
                                                    // Restricted: used internally to Synthetix
                                                    function appendAccountIssuanceRecord(
                                                        address account,
                                                        uint lockedAmount,
                                                        uint debtEntryIndex
                                                    ) external;
                                                
                                                    function recordFeePaid(uint sUSDAmount) external;
                                                
                                                    function setRewardsToDistribute(uint amount) external;
                                                }
                                                
                                                
                                                interface IExchanger {
                                                    // Views
                                                    function calculateAmountAfterSettlement(
                                                        address from,
                                                        bytes32 currencyKey,
                                                        uint amount,
                                                        uint refunded
                                                    ) external view returns (uint amountAfterSettlement);
                                                
                                                    function isSynthRateInvalid(bytes32 currencyKey) external view returns (bool);
                                                
                                                    function maxSecsLeftInWaitingPeriod(address account, bytes32 currencyKey) external view returns (uint);
                                                
                                                    function settlementOwing(address account, bytes32 currencyKey)
                                                        external
                                                        view
                                                        returns (
                                                            uint reclaimAmount,
                                                            uint rebateAmount,
                                                            uint numEntries
                                                        );
                                                
                                                    function hasWaitingPeriodOrSettlementOwing(address account, bytes32 currencyKey) external view returns (bool);
                                                
                                                    function feeRateForExchange(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey)
                                                        external
                                                        view
                                                        returns (uint exchangeFeeRate);
                                                
                                                    function getAmountsForExchange(
                                                        uint sourceAmount,
                                                        bytes32 sourceCurrencyKey,
                                                        bytes32 destinationCurrencyKey
                                                    )
                                                        external
                                                        view
                                                        returns (
                                                            uint amountReceived,
                                                            uint fee,
                                                            uint exchangeFeeRate
                                                        );
                                                
                                                    function priceDeviationThresholdFactor() external view returns (uint);
                                                
                                                    function waitingPeriodSecs() external view returns (uint);
                                                
                                                    // Mutative functions
                                                    function exchange(
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address destinationAddress
                                                    ) external returns (uint amountReceived);
                                                
                                                    function exchangeOnBehalf(
                                                        address exchangeForAddress,
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey
                                                    ) external returns (uint amountReceived);
                                                
                                                    function exchangeWithTracking(
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address destinationAddress,
                                                        address originator,
                                                        bytes32 trackingCode
                                                    ) external returns (uint amountReceived);
                                                
                                                    function exchangeOnBehalfWithTracking(
                                                        address exchangeForAddress,
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address originator,
                                                        bytes32 trackingCode
                                                    ) external returns (uint amountReceived);
                                                
                                                    function settle(address from, bytes32 currencyKey)
                                                        external
                                                        returns (
                                                            uint reclaimed,
                                                            uint refunded,
                                                            uint numEntries
                                                        );
                                                
                                                    function setLastExchangeRateForSynth(bytes32 currencyKey, uint rate) external;
                                                
                                                    function suspendSynthWithInvalidRate(bytes32 currencyKey) external;
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // Internal references
                                                
                                                
                                                contract Synth is Owned, IERC20, ExternStateToken, MixinResolver, ISynth {
                                                    /* ========== STATE VARIABLES ========== */
                                                
                                                    // Currency key which identifies this Synth to the Synthetix system
                                                    bytes32 public currencyKey;
                                                
                                                    uint8 public constant DECIMALS = 18;
                                                
                                                    // Where fees are pooled in sUSD
                                                    address public constant FEE_ADDRESS = 0xfeEFEEfeefEeFeefEEFEEfEeFeefEEFeeFEEFEeF;
                                                
                                                    /* ========== ADDRESS RESOLVER CONFIGURATION ========== */
                                                
                                                    bytes32 private constant CONTRACT_SYSTEMSTATUS = "SystemStatus";
                                                    bytes32 private constant CONTRACT_EXCHANGER = "Exchanger";
                                                    bytes32 private constant CONTRACT_ISSUER = "Issuer";
                                                    bytes32 private constant CONTRACT_FEEPOOL = "FeePool";
                                                
                                                    bytes32[24] internal addressesToCache = [CONTRACT_SYSTEMSTATUS, CONTRACT_EXCHANGER, CONTRACT_ISSUER, CONTRACT_FEEPOOL];
                                                
                                                    /* ========== CONSTRUCTOR ========== */
                                                
                                                    constructor(
                                                        address payable _proxy,
                                                        TokenState _tokenState,
                                                        string memory _tokenName,
                                                        string memory _tokenSymbol,
                                                        address _owner,
                                                        bytes32 _currencyKey,
                                                        uint _totalSupply,
                                                        address _resolver
                                                    )
                                                        public
                                                        ExternStateToken(_proxy, _tokenState, _tokenName, _tokenSymbol, _totalSupply, DECIMALS, _owner)
                                                        MixinResolver(_resolver, addressesToCache)
                                                    {
                                                        require(_proxy != address(0), "_proxy cannot be 0");
                                                        require(_owner != address(0), "_owner cannot be 0");
                                                
                                                        currencyKey = _currencyKey;
                                                    }
                                                
                                                    /* ========== MUTATIVE FUNCTIONS ========== */
                                                
                                                    function transfer(address to, uint value) public optionalProxy returns (bool) {
                                                        _ensureCanTransfer(messageSender, value);
                                                
                                                        // transfers to FEE_ADDRESS will be exchanged into sUSD and recorded as fee
                                                        if (to == FEE_ADDRESS) {
                                                            return _transferToFeeAddress(to, value);
                                                        }
                                                
                                                        // transfers to 0x address will be burned
                                                        if (to == address(0)) {
                                                            return _internalBurn(messageSender, value);
                                                        }
                                                
                                                        return super._internalTransfer(messageSender, to, value);
                                                    }
                                                
                                                    function transferAndSettle(address to, uint value) public optionalProxy returns (bool) {
                                                        // Exchanger.settle ensures synth is active
                                                        (, , uint numEntriesSettled) = exchanger().settle(messageSender, currencyKey);
                                                
                                                        // Save gas instead of calling transferableSynths
                                                        uint balanceAfter = value;
                                                
                                                        if (numEntriesSettled > 0) {
                                                            balanceAfter = tokenState.balanceOf(messageSender);
                                                        }
                                                
                                                        // Reduce the value to transfer if balance is insufficient after reclaimed
                                                        value = value > balanceAfter ? balanceAfter : value;
                                                
                                                        return super._internalTransfer(messageSender, to, value);
                                                    }
                                                
                                                    function transferFrom(
                                                        address from,
                                                        address to,
                                                        uint value
                                                    ) public optionalProxy returns (bool) {
                                                        _ensureCanTransfer(from, value);
                                                
                                                        return _internalTransferFrom(from, to, value);
                                                    }
                                                
                                                    function transferFromAndSettle(
                                                        address from,
                                                        address to,
                                                        uint value
                                                    ) public optionalProxy returns (bool) {
                                                        // Exchanger.settle() ensures synth is active
                                                        (, , uint numEntriesSettled) = exchanger().settle(from, currencyKey);
                                                
                                                        // Save gas instead of calling transferableSynths
                                                        uint balanceAfter = value;
                                                
                                                        if (numEntriesSettled > 0) {
                                                            balanceAfter = tokenState.balanceOf(from);
                                                        }
                                                
                                                        // Reduce the value to transfer if balance is insufficient after reclaimed
                                                        value = value >= balanceAfter ? balanceAfter : value;
                                                
                                                        return _internalTransferFrom(from, to, value);
                                                    }
                                                
                                                    /**
                                                     * @notice _transferToFeeAddress function
                                                     * non-sUSD synths are exchanged into sUSD via synthInitiatedExchange
                                                     * notify feePool to record amount as fee paid to feePool */
                                                    function _transferToFeeAddress(address to, uint value) internal returns (bool) {
                                                        uint amountInUSD;
                                                
                                                        // sUSD can be transferred to FEE_ADDRESS directly
                                                        if (currencyKey == "sUSD") {
                                                            amountInUSD = value;
                                                            super._internalTransfer(messageSender, to, value);
                                                        } else {
                                                            // else exchange synth into sUSD and send to FEE_ADDRESS
                                                            amountInUSD = exchanger().exchange(messageSender, currencyKey, value, "sUSD", FEE_ADDRESS);
                                                        }
                                                
                                                        // Notify feePool to record sUSD to distribute as fees
                                                        feePool().recordFeePaid(amountInUSD);
                                                
                                                        return true;
                                                    }
                                                
                                                    function issue(address account, uint amount) external onlyInternalContracts {
                                                        _internalIssue(account, amount);
                                                    }
                                                
                                                    function burn(address account, uint amount) external onlyInternalContracts {
                                                        _internalBurn(account, amount);
                                                    }
                                                
                                                    function _internalIssue(address account, uint amount) internal {
                                                        tokenState.setBalanceOf(account, tokenState.balanceOf(account).add(amount));
                                                        totalSupply = totalSupply.add(amount);
                                                        emitTransfer(address(0), account, amount);
                                                        emitIssued(account, amount);
                                                    }
                                                
                                                    function _internalBurn(address account, uint amount) internal returns (bool) {
                                                        tokenState.setBalanceOf(account, tokenState.balanceOf(account).sub(amount));
                                                        totalSupply = totalSupply.sub(amount);
                                                        emitTransfer(account, address(0), amount);
                                                        emitBurned(account, amount);
                                                
                                                        return true;
                                                    }
                                                
                                                    // Allow owner to set the total supply on import.
                                                    function setTotalSupply(uint amount) external optionalProxy_onlyOwner {
                                                        totalSupply = amount;
                                                    }
                                                
                                                    /* ========== VIEWS ========== */
                                                    function systemStatus() internal view returns (ISystemStatus) {
                                                        return ISystemStatus(requireAndGetAddress(CONTRACT_SYSTEMSTATUS, "Missing SystemStatus address"));
                                                    }
                                                
                                                    function feePool() internal view returns (IFeePool) {
                                                        return IFeePool(requireAndGetAddress(CONTRACT_FEEPOOL, "Missing FeePool address"));
                                                    }
                                                
                                                    function exchanger() internal view returns (IExchanger) {
                                                        return IExchanger(requireAndGetAddress(CONTRACT_EXCHANGER, "Missing Exchanger address"));
                                                    }
                                                
                                                    function issuer() internal view returns (IIssuer) {
                                                        return IIssuer(requireAndGetAddress(CONTRACT_ISSUER, "Missing Issuer address"));
                                                    }
                                                
                                                    function _ensureCanTransfer(address from, uint value) internal view {
                                                        require(exchanger().maxSecsLeftInWaitingPeriod(from, currencyKey) == 0, "Cannot transfer during waiting period");
                                                        require(transferableSynths(from) >= value, "Insufficient balance after any settlement owing");
                                                        systemStatus().requireSynthActive(currencyKey);
                                                    }
                                                
                                                    function transferableSynths(address account) public view returns (uint) {
                                                        (uint reclaimAmount, , ) = exchanger().settlementOwing(account, currencyKey);
                                                
                                                        // Note: ignoring rebate amount here because a settle() is required in order to
                                                        // allow the transfer to actually work
                                                
                                                        uint balance = tokenState.balanceOf(account);
                                                
                                                        if (reclaimAmount > balance) {
                                                            return 0;
                                                        } else {
                                                            return balance.sub(reclaimAmount);
                                                        }
                                                    }
                                                
                                                    /* ========== INTERNAL FUNCTIONS ========== */
                                                
                                                    function _internalTransferFrom(
                                                        address from,
                                                        address to,
                                                        uint value
                                                    ) internal returns (bool) {
                                                        // Skip allowance update in case of infinite allowance
                                                        if (tokenState.allowance(from, messageSender) != uint(-1)) {
                                                            // Reduce the allowance by the amount we're transferring.
                                                            // The safeSub call will handle an insufficient allowance.
                                                            tokenState.setAllowance(from, messageSender, tokenState.allowance(from, messageSender).sub(value));
                                                        }
                                                
                                                        return super._internalTransfer(from, to, value);
                                                    }
                                                
                                                    /* ========== MODIFIERS ========== */
                                                
                                                    modifier onlyInternalContracts() {
                                                        bool isFeePool = msg.sender == address(feePool());
                                                        bool isExchanger = msg.sender == address(exchanger());
                                                        bool isIssuer = msg.sender == address(issuer());
                                                
                                                        require(isFeePool || isExchanger || isIssuer, "Only FeePool, Exchanger or Issuer contracts allowed");
                                                        _;
                                                    }
                                                
                                                    /* ========== EVENTS ========== */
                                                    event Issued(address indexed account, uint value);
                                                    bytes32 private constant ISSUED_SIG = keccak256("Issued(address,uint256)");
                                                
                                                    function emitIssued(address account, uint value) internal {
                                                        proxy._emit(abi.encode(value), 2, ISSUED_SIG, addressToBytes32(account), 0, 0);
                                                    }
                                                
                                                    event Burned(address indexed account, uint value);
                                                    bytes32 private constant BURNED_SIG = keccak256("Burned(address,uint256)");
                                                
                                                    function emitBurned(address account, uint value) internal {
                                                        proxy._emit(abi.encode(value), 2, BURNED_SIG, addressToBytes32(account), 0, 0);
                                                    }
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // https://docs.synthetix.io/contracts/MultiCollateralSynth
                                                contract MultiCollateralSynth is Synth {
                                                    bytes32 public multiCollateralKey;
                                                
                                                    /* ========== CONSTRUCTOR ========== */
                                                
                                                    constructor(
                                                        address payable _proxy,
                                                        TokenState _tokenState,
                                                        string memory _tokenName,
                                                        string memory _tokenSymbol,
                                                        address _owner,
                                                        bytes32 _currencyKey,
                                                        uint _totalSupply,
                                                        address _resolver,
                                                        bytes32 _multiCollateralKey
                                                    ) public Synth(_proxy, _tokenState, _tokenName, _tokenSymbol, _owner, _currencyKey, _totalSupply, _resolver) {
                                                        multiCollateralKey = _multiCollateralKey;
                                                
                                                        appendToAddressCache(multiCollateralKey);
                                                    }
                                                
                                                    /* ========== VIEWS ======================= */
                                                
                                                    function multiCollateral() internal view returns (address) {
                                                        return requireAndGetAddress(multiCollateralKey, "Resolver is missing multiCollateral address");
                                                    }
                                                
                                                    /* ========== MUTATIVE FUNCTIONS ========== */
                                                
                                                    /**
                                                     * @notice Function that allows multi Collateral to issue a certain number of synths from an account.
                                                     * @param account Account to issue synths to
                                                     * @param amount Number of synths
                                                     */
                                                    function issue(address account, uint amount) external onlyInternalContracts {
                                                        super._internalIssue(account, amount);
                                                    }
                                                
                                                    /**
                                                     * @notice Function that allows multi Collateral to burn a certain number of synths from an account.
                                                     * @param account Account to burn synths from
                                                     * @param amount Number of synths
                                                     */
                                                    function burn(address account, uint amount) external onlyInternalContracts {
                                                        super._internalBurn(account, amount);
                                                    }
                                                
                                                    /* ========== MODIFIERS ========== */
                                                
                                                    // Contracts directly interacting with multiCollateralSynth to issue and burn
                                                    modifier onlyInternalContracts() {
                                                        bool isFeePool = msg.sender == address(feePool());
                                                        bool isExchanger = msg.sender == address(exchanger());
                                                        bool isIssuer = msg.sender == address(issuer());
                                                        bool isMultiCollateral = msg.sender == address(multiCollateral());
                                                
                                                        require(
                                                            isFeePool || isExchanger || isIssuer || isMultiCollateral,
                                                            "Only FeePool, Exchanger, Issuer or MultiCollateral contracts allowed"
                                                        );
                                                        _;
                                                    }
                                                }
                                                
                                                    

                                                File 8 of 12: Exchanger
                                                /*
                                                   ____            __   __        __   _
                                                  / __/__ __ ___  / /_ / /  ___  / /_ (_)__ __
                                                 _\ \ / // // _ \/ __// _ \/ -_)/ __// / \ \ /
                                                /___/ \_, //_//_/\__//_//_/\__/ \__//_/ /_\_\
                                                     /___/
                                                
                                                * Synthetix: Exchanger.sol
                                                *
                                                * Latest source (may be newer): https://github.com/Synthetixio/synthetix/blob/master/contracts/Exchanger.sol
                                                * Docs: https://docs.synthetix.io/contracts/Exchanger
                                                *
                                                * Contract Dependencies: 
                                                *	- IAddressResolver
                                                *	- IExchanger
                                                *	- MixinResolver
                                                *	- MixinSystemSettings
                                                *	- Owned
                                                * Libraries: 
                                                *	- SafeDecimalMath
                                                *	- SafeMath
                                                *
                                                * MIT License
                                                * ===========
                                                *
                                                * Copyright (c) 2020 Synthetix
                                                *
                                                * Permission is hereby granted, free of charge, to any person obtaining a copy
                                                * of this software and associated documentation files (the "Software"), to deal
                                                * in the Software without restriction, including without limitation the rights
                                                * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
                                                * copies of the Software, and to permit persons to whom the Software is
                                                * furnished to do so, subject to the following conditions:
                                                *
                                                * The above copyright notice and this permission notice shall be included in all
                                                * copies or substantial portions of the Software.
                                                *
                                                * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
                                                * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
                                                * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
                                                * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
                                                * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
                                                * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
                                                */
                                                
                                                
                                                
                                                pragma solidity ^0.5.16;
                                                
                                                
                                                // https://docs.synthetix.io/contracts/Owned
                                                contract Owned {
                                                    address public owner;
                                                    address public nominatedOwner;
                                                
                                                    constructor(address _owner) public {
                                                        require(_owner != address(0), "Owner address cannot be 0");
                                                        owner = _owner;
                                                        emit OwnerChanged(address(0), _owner);
                                                    }
                                                
                                                    function nominateNewOwner(address _owner) external onlyOwner {
                                                        nominatedOwner = _owner;
                                                        emit OwnerNominated(_owner);
                                                    }
                                                
                                                    function acceptOwnership() external {
                                                        require(msg.sender == nominatedOwner, "You must be nominated before you can accept ownership");
                                                        emit OwnerChanged(owner, nominatedOwner);
                                                        owner = nominatedOwner;
                                                        nominatedOwner = address(0);
                                                    }
                                                
                                                    modifier onlyOwner {
                                                        _onlyOwner();
                                                        _;
                                                    }
                                                
                                                    function _onlyOwner() private view {
                                                        require(msg.sender == owner, "Only the contract owner may perform this action");
                                                    }
                                                
                                                    event OwnerNominated(address newOwner);
                                                    event OwnerChanged(address oldOwner, address newOwner);
                                                }
                                                
                                                
                                                interface IAddressResolver {
                                                    function getAddress(bytes32 name) external view returns (address);
                                                
                                                    function getSynth(bytes32 key) external view returns (address);
                                                
                                                    function requireAndGetAddress(bytes32 name, string calldata reason) external view returns (address);
                                                }
                                                
                                                
                                                interface ISynth {
                                                    // Views
                                                    function currencyKey() external view returns (bytes32);
                                                
                                                    function transferableSynths(address account) external view returns (uint);
                                                
                                                    // Mutative functions
                                                    function transferAndSettle(address to, uint value) external returns (bool);
                                                
                                                    function transferFromAndSettle(
                                                        address from,
                                                        address to,
                                                        uint value
                                                    ) external returns (bool);
                                                
                                                    // Restricted: used internally to Synthetix
                                                    function burn(address account, uint amount) external;
                                                
                                                    function issue(address account, uint amount) external;
                                                }
                                                
                                                
                                                interface IIssuer {
                                                    // Views
                                                    function anySynthOrSNXRateIsInvalid() external view returns (bool anyRateInvalid);
                                                
                                                    function availableCurrencyKeys() external view returns (bytes32[] memory);
                                                
                                                    function availableSynthCount() external view returns (uint);
                                                
                                                    function availableSynths(uint index) external view returns (ISynth);
                                                
                                                    function canBurnSynths(address account) external view returns (bool);
                                                
                                                    function collateral(address account) external view returns (uint);
                                                
                                                    function collateralisationRatio(address issuer) external view returns (uint);
                                                
                                                    function collateralisationRatioAndAnyRatesInvalid(address _issuer)
                                                        external
                                                        view
                                                        returns (uint cratio, bool anyRateIsInvalid);
                                                
                                                    function debtBalanceOf(address issuer, bytes32 currencyKey) external view returns (uint debtBalance);
                                                
                                                    function issuanceRatio() external view returns (uint);
                                                
                                                    function debtSnapshotStaleTime() external view returns (uint);
                                                
                                                    function lastIssueEvent(address account) external view returns (uint);
                                                
                                                    function maxIssuableSynths(address issuer) external view returns (uint maxIssuable);
                                                
                                                    function minimumStakeTime() external view returns (uint);
                                                
                                                    function remainingIssuableSynths(address issuer)
                                                        external
                                                        view
                                                        returns (
                                                            uint maxIssuable,
                                                            uint alreadyIssued,
                                                            uint totalSystemDebt
                                                        );
                                                
                                                    function synths(bytes32 currencyKey) external view returns (ISynth);
                                                
                                                    function synthsByAddress(address synthAddress) external view returns (bytes32);
                                                
                                                    function totalIssuedSynths(bytes32 currencyKey, bool excludeEtherCollateral) external view returns (uint);
                                                
                                                    function currentSNXIssuedDebtForCurrencies(bytes32[] calldata currencyKeys)
                                                        external
                                                        view
                                                        returns (uint[] memory snxIssuedDebts, bool anyRateIsInvalid);
                                                
                                                    function cachedSNXIssuedDebtForCurrencies(bytes32[] calldata currencyKeys)
                                                        external
                                                        view
                                                        returns (uint[] memory snxIssuedDebts);
                                                
                                                    function currentSNXIssuedDebt() external view returns (uint snxIssuedDebt, bool anyRateIsInvalid);
                                                
                                                    function cachedSNXIssuedDebtInfo()
                                                        external
                                                        view
                                                        returns (
                                                            uint cachedDebt,
                                                            uint timestamp,
                                                            bool isInvalid
                                                        );
                                                
                                                    function debtCacheIsStale() external view returns (bool);
                                                
                                                    function transferableSynthetixAndAnyRateIsInvalid(address account, uint balance)
                                                        external
                                                        view
                                                        returns (uint transferable, bool anyRateIsInvalid);
                                                
                                                    // Restricted: used internally to Synthetix
                                                    function issueSynths(address from, uint amount) external;
                                                
                                                    function issueSynthsOnBehalf(
                                                        address issueFor,
                                                        address from,
                                                        uint amount
                                                    ) external;
                                                
                                                    function issueMaxSynths(address from) external;
                                                
                                                    function issueMaxSynthsOnBehalf(address issueFor, address from) external;
                                                
                                                    function burnSynths(address from, uint amount) external;
                                                
                                                    function burnSynthsOnBehalf(
                                                        address burnForAddress,
                                                        address from,
                                                        uint amount
                                                    ) external;
                                                
                                                    function burnSynthsToTarget(address from) external;
                                                
                                                    function burnSynthsToTargetOnBehalf(address burnForAddress, address from) external;
                                                
                                                    function liquidateDelinquentAccount(
                                                        address account,
                                                        uint susdAmount,
                                                        address liquidator
                                                    ) external returns (uint totalRedeemed, uint amountToLiquidate);
                                                
                                                    function cacheSNXIssuedDebt() external;
                                                
                                                    function updateSNXIssuedDebtForCurrencies(bytes32[] calldata currencyKeys) external;
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // https://docs.synthetix.io/contracts/AddressResolver
                                                contract AddressResolver is Owned, IAddressResolver {
                                                    mapping(bytes32 => address) public repository;
                                                
                                                    constructor(address _owner) public Owned(_owner) {}
                                                
                                                    /* ========== MUTATIVE FUNCTIONS ========== */
                                                
                                                    function importAddresses(bytes32[] calldata names, address[] calldata destinations) external onlyOwner {
                                                        require(names.length == destinations.length, "Input lengths must match");
                                                
                                                        for (uint i = 0; i < names.length; i++) {
                                                            repository[names[i]] = destinations[i];
                                                        }
                                                    }
                                                
                                                    /* ========== VIEWS ========== */
                                                
                                                    function getAddress(bytes32 name) external view returns (address) {
                                                        return repository[name];
                                                    }
                                                
                                                    function requireAndGetAddress(bytes32 name, string calldata reason) external view returns (address) {
                                                        address _foundAddress = repository[name];
                                                        require(_foundAddress != address(0), reason);
                                                        return _foundAddress;
                                                    }
                                                
                                                    function getSynth(bytes32 key) external view returns (address) {
                                                        IIssuer issuer = IIssuer(repository["Issuer"]);
                                                        require(address(issuer) != address(0), "Cannot find Issuer address");
                                                        return address(issuer.synths(key));
                                                    }
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // Internal references
                                                
                                                
                                                // https://docs.synthetix.io/contracts/MixinResolver
                                                contract MixinResolver is Owned {
                                                    AddressResolver public resolver;
                                                
                                                    mapping(bytes32 => address) private addressCache;
                                                
                                                    bytes32[] public resolverAddressesRequired;
                                                
                                                    uint public constant MAX_ADDRESSES_FROM_RESOLVER = 24;
                                                
                                                    constructor(address _resolver, bytes32[MAX_ADDRESSES_FROM_RESOLVER] memory _addressesToCache) internal {
                                                        // This contract is abstract, and thus cannot be instantiated directly
                                                        require(owner != address(0), "Owner must be set");
                                                
                                                        for (uint i = 0; i < _addressesToCache.length; i++) {
                                                            if (_addressesToCache[i] != bytes32(0)) {
                                                                resolverAddressesRequired.push(_addressesToCache[i]);
                                                            } else {
                                                                // End early once an empty item is found - assumes there are no empty slots in
                                                                // _addressesToCache
                                                                break;
                                                            }
                                                        }
                                                        resolver = AddressResolver(_resolver);
                                                        // Do not sync the cache as addresses may not be in the resolver yet
                                                    }
                                                
                                                    /* ========== SETTERS ========== */
                                                    function setResolverAndSyncCache(AddressResolver _resolver) external onlyOwner {
                                                        resolver = _resolver;
                                                
                                                        for (uint i = 0; i < resolverAddressesRequired.length; i++) {
                                                            bytes32 name = resolverAddressesRequired[i];
                                                            // Note: can only be invoked once the resolver has all the targets needed added
                                                            addressCache[name] = resolver.requireAndGetAddress(name, "Resolver missing target");
                                                        }
                                                    }
                                                
                                                    /* ========== VIEWS ========== */
                                                
                                                    function requireAndGetAddress(bytes32 name, string memory reason) internal view returns (address) {
                                                        address _foundAddress = addressCache[name];
                                                        require(_foundAddress != address(0), reason);
                                                        return _foundAddress;
                                                    }
                                                
                                                    // Note: this could be made external in a utility contract if addressCache was made public
                                                    // (used for deployment)
                                                    function isResolverCached(AddressResolver _resolver) external view returns (bool) {
                                                        if (resolver != _resolver) {
                                                            return false;
                                                        }
                                                
                                                        // otherwise, check everything
                                                        for (uint i = 0; i < resolverAddressesRequired.length; i++) {
                                                            bytes32 name = resolverAddressesRequired[i];
                                                            // false if our cache is invalid or if the resolver doesn't have the required address
                                                            if (resolver.getAddress(name) != addressCache[name] || addressCache[name] == address(0)) {
                                                                return false;
                                                            }
                                                        }
                                                
                                                        return true;
                                                    }
                                                
                                                    // Note: can be made external into a utility contract (used for deployment)
                                                    function getResolverAddressesRequired()
                                                        external
                                                        view
                                                        returns (bytes32[MAX_ADDRESSES_FROM_RESOLVER] memory addressesRequired)
                                                    {
                                                        for (uint i = 0; i < resolverAddressesRequired.length; i++) {
                                                            addressesRequired[i] = resolverAddressesRequired[i];
                                                        }
                                                    }
                                                
                                                    /* ========== INTERNAL FUNCTIONS ========== */
                                                    function appendToAddressCache(bytes32 name) internal {
                                                        resolverAddressesRequired.push(name);
                                                        require(resolverAddressesRequired.length < MAX_ADDRESSES_FROM_RESOLVER, "Max resolver cache size met");
                                                        // Because this is designed to be called internally in constructors, we don't
                                                        // check the address exists already in the resolver
                                                        addressCache[name] = resolver.getAddress(name);
                                                    }
                                                }
                                                
                                                
                                                interface IFlexibleStorage {
                                                    // Views
                                                    function getUIntValue(bytes32 contractName, bytes32 record) external view returns (uint);
                                                
                                                    function getUIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (uint[] memory);
                                                
                                                    function getIntValue(bytes32 contractName, bytes32 record) external view returns (int);
                                                
                                                    function getIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (int[] memory);
                                                
                                                    function getAddressValue(bytes32 contractName, bytes32 record) external view returns (address);
                                                
                                                    function getAddressValues(bytes32 contractName, bytes32[] calldata records) external view returns (address[] memory);
                                                
                                                    function getBoolValue(bytes32 contractName, bytes32 record) external view returns (bool);
                                                
                                                    function getBoolValues(bytes32 contractName, bytes32[] calldata records) external view returns (bool[] memory);
                                                
                                                    function getBytes32Value(bytes32 contractName, bytes32 record) external view returns (bytes32);
                                                
                                                    function getBytes32Values(bytes32 contractName, bytes32[] calldata records) external view returns (bytes32[] memory);
                                                
                                                    // Mutative functions
                                                    function deleteUIntValue(bytes32 contractName, bytes32 record) external;
                                                
                                                    function deleteIntValue(bytes32 contractName, bytes32 record) external;
                                                
                                                    function deleteAddressValue(bytes32 contractName, bytes32 record) external;
                                                
                                                    function deleteBoolValue(bytes32 contractName, bytes32 record) external;
                                                
                                                    function deleteBytes32Value(bytes32 contractName, bytes32 record) external;
                                                
                                                    function setUIntValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        uint value
                                                    ) external;
                                                
                                                    function setUIntValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        uint[] calldata values
                                                    ) external;
                                                
                                                    function setIntValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        int value
                                                    ) external;
                                                
                                                    function setIntValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        int[] calldata values
                                                    ) external;
                                                
                                                    function setAddressValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        address value
                                                    ) external;
                                                
                                                    function setAddressValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        address[] calldata values
                                                    ) external;
                                                
                                                    function setBoolValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        bool value
                                                    ) external;
                                                
                                                    function setBoolValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        bool[] calldata values
                                                    ) external;
                                                
                                                    function setBytes32Value(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        bytes32 value
                                                    ) external;
                                                
                                                    function setBytes32Values(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        bytes32[] calldata values
                                                    ) external;
                                                }
                                                
                                                
                                                // Internal references
                                                
                                                
                                                contract MixinSystemSettings is MixinResolver {
                                                    bytes32 internal constant SETTING_CONTRACT_NAME = "SystemSettings";
                                                
                                                    bytes32 internal constant SETTING_WAITING_PERIOD_SECS = "waitingPeriodSecs";
                                                    bytes32 internal constant SETTING_PRICE_DEVIATION_THRESHOLD_FACTOR = "priceDeviationThresholdFactor";
                                                    bytes32 internal constant SETTING_ISSUANCE_RATIO = "issuanceRatio";
                                                    bytes32 internal constant SETTING_FEE_PERIOD_DURATION = "feePeriodDuration";
                                                    bytes32 internal constant SETTING_TARGET_THRESHOLD = "targetThreshold";
                                                    bytes32 internal constant SETTING_LIQUIDATION_DELAY = "liquidationDelay";
                                                    bytes32 internal constant SETTING_LIQUIDATION_RATIO = "liquidationRatio";
                                                    bytes32 internal constant SETTING_LIQUIDATION_PENALTY = "liquidationPenalty";
                                                    bytes32 internal constant SETTING_RATE_STALE_PERIOD = "rateStalePeriod";
                                                    bytes32 internal constant SETTING_EXCHANGE_FEE_RATE = "exchangeFeeRate";
                                                    bytes32 internal constant SETTING_MINIMUM_STAKE_TIME = "minimumStakeTime";
                                                    bytes32 internal constant SETTING_AGGREGATOR_WARNING_FLAGS = "aggregatorWarningFlags";
                                                    bytes32 internal constant SETTING_TRADING_REWARDS_ENABLED = "tradingRewardsEnabled";
                                                    bytes32 internal constant SETTING_DEBT_SNAPSHOT_STALE_TIME = "debtSnapshotStaleTime";
                                                
                                                    bytes32 private constant CONTRACT_FLEXIBLESTORAGE = "FlexibleStorage";
                                                
                                                    constructor() internal {
                                                        appendToAddressCache(CONTRACT_FLEXIBLESTORAGE);
                                                    }
                                                
                                                    function flexibleStorage() internal view returns (IFlexibleStorage) {
                                                        return IFlexibleStorage(requireAndGetAddress(CONTRACT_FLEXIBLESTORAGE, "Missing FlexibleStorage address"));
                                                    }
                                                
                                                    function getTradingRewardsEnabled() internal view returns (bool) {
                                                        return flexibleStorage().getBoolValue(SETTING_CONTRACT_NAME, SETTING_TRADING_REWARDS_ENABLED);
                                                    }
                                                
                                                    function getWaitingPeriodSecs() internal view returns (uint) {
                                                        return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_WAITING_PERIOD_SECS);
                                                    }
                                                
                                                    function getPriceDeviationThresholdFactor() internal view returns (uint) {
                                                        return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_PRICE_DEVIATION_THRESHOLD_FACTOR);
                                                    }
                                                
                                                    function getIssuanceRatio() internal view returns (uint) {
                                                        // lookup on flexible storage directly for gas savings (rather than via SystemSettings)
                                                        return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_ISSUANCE_RATIO);
                                                    }
                                                
                                                    function getFeePeriodDuration() internal view returns (uint) {
                                                        // lookup on flexible storage directly for gas savings (rather than via SystemSettings)
                                                        return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_FEE_PERIOD_DURATION);
                                                    }
                                                
                                                    function getTargetThreshold() internal view returns (uint) {
                                                        // lookup on flexible storage directly for gas savings (rather than via SystemSettings)
                                                        return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_TARGET_THRESHOLD);
                                                    }
                                                
                                                    function getLiquidationDelay() internal view returns (uint) {
                                                        return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_LIQUIDATION_DELAY);
                                                    }
                                                
                                                    function getLiquidationRatio() internal view returns (uint) {
                                                        return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_LIQUIDATION_RATIO);
                                                    }
                                                
                                                    function getLiquidationPenalty() internal view returns (uint) {
                                                        return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_LIQUIDATION_PENALTY);
                                                    }
                                                
                                                    function getRateStalePeriod() internal view returns (uint) {
                                                        return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_RATE_STALE_PERIOD);
                                                    }
                                                
                                                    function getExchangeFeeRate(bytes32 currencyKey) internal view returns (uint) {
                                                        return
                                                            flexibleStorage().getUIntValue(
                                                                SETTING_CONTRACT_NAME,
                                                                keccak256(abi.encodePacked(SETTING_EXCHANGE_FEE_RATE, currencyKey))
                                                            );
                                                    }
                                                
                                                    function getMinimumStakeTime() internal view returns (uint) {
                                                        return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_MINIMUM_STAKE_TIME);
                                                    }
                                                
                                                    function getAggregatorWarningFlags() internal view returns (address) {
                                                        return flexibleStorage().getAddressValue(SETTING_CONTRACT_NAME, SETTING_AGGREGATOR_WARNING_FLAGS);
                                                    }
                                                
                                                    function getDebtSnapshotStaleTime() internal view returns (uint) {
                                                        return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_DEBT_SNAPSHOT_STALE_TIME);
                                                    }
                                                
                                                }
                                                
                                                
                                                interface IExchanger {
                                                    // Views
                                                    function calculateAmountAfterSettlement(
                                                        address from,
                                                        bytes32 currencyKey,
                                                        uint amount,
                                                        uint refunded
                                                    ) external view returns (uint amountAfterSettlement);
                                                
                                                    function isSynthRateInvalid(bytes32 currencyKey) external view returns (bool);
                                                
                                                    function maxSecsLeftInWaitingPeriod(address account, bytes32 currencyKey) external view returns (uint);
                                                
                                                    function settlementOwing(address account, bytes32 currencyKey)
                                                        external
                                                        view
                                                        returns (
                                                            uint reclaimAmount,
                                                            uint rebateAmount,
                                                            uint numEntries
                                                        );
                                                
                                                    function hasWaitingPeriodOrSettlementOwing(address account, bytes32 currencyKey) external view returns (bool);
                                                
                                                    function feeRateForExchange(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey)
                                                        external
                                                        view
                                                        returns (uint exchangeFeeRate);
                                                
                                                    function getAmountsForExchange(
                                                        uint sourceAmount,
                                                        bytes32 sourceCurrencyKey,
                                                        bytes32 destinationCurrencyKey
                                                    )
                                                        external
                                                        view
                                                        returns (
                                                            uint amountReceived,
                                                            uint fee,
                                                            uint exchangeFeeRate
                                                        );
                                                
                                                    function priceDeviationThresholdFactor() external view returns (uint);
                                                
                                                    function waitingPeriodSecs() external view returns (uint);
                                                
                                                    // Mutative functions
                                                    function exchange(
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address destinationAddress
                                                    ) external returns (uint amountReceived);
                                                
                                                    function exchangeOnBehalf(
                                                        address exchangeForAddress,
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey
                                                    ) external returns (uint amountReceived);
                                                
                                                    function exchangeWithTracking(
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address destinationAddress,
                                                        address originator,
                                                        bytes32 trackingCode
                                                    ) external returns (uint amountReceived);
                                                
                                                    function exchangeOnBehalfWithTracking(
                                                        address exchangeForAddress,
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address originator,
                                                        bytes32 trackingCode
                                                    ) external returns (uint amountReceived);
                                                
                                                    function settle(address from, bytes32 currencyKey)
                                                        external
                                                        returns (
                                                            uint reclaimed,
                                                            uint refunded,
                                                            uint numEntries
                                                        );
                                                
                                                    function setLastExchangeRateForSynth(bytes32 currencyKey, uint rate) external;
                                                
                                                    function suspendSynthWithInvalidRate(bytes32 currencyKey) external;
                                                }
                                                
                                                
                                                /**
                                                 * @dev Wrappers over Solidity's arithmetic operations with added overflow
                                                 * checks.
                                                 *
                                                 * Arithmetic operations in Solidity wrap on overflow. This can easily result
                                                 * in bugs, because programmers usually assume that an overflow raises an
                                                 * error, which is the standard behavior in high level programming languages.
                                                 * `SafeMath` restores this intuition by reverting the transaction when an
                                                 * operation overflows.
                                                 *
                                                 * Using this library instead of the unchecked operations eliminates an entire
                                                 * class of bugs, so it's recommended to use it always.
                                                 */
                                                library SafeMath {
                                                    /**
                                                     * @dev Returns the addition of two unsigned integers, reverting on
                                                     * overflow.
                                                     *
                                                     * Counterpart to Solidity's `+` operator.
                                                     *
                                                     * Requirements:
                                                     * - Addition cannot overflow.
                                                     */
                                                    function add(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        uint256 c = a + b;
                                                        require(c >= a, "SafeMath: addition overflow");
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the subtraction of two unsigned integers, reverting on
                                                     * overflow (when the result is negative).
                                                     *
                                                     * Counterpart to Solidity's `-` operator.
                                                     *
                                                     * Requirements:
                                                     * - Subtraction cannot overflow.
                                                     */
                                                    function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        require(b <= a, "SafeMath: subtraction overflow");
                                                        uint256 c = a - b;
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the multiplication of two unsigned integers, reverting on
                                                     * overflow.
                                                     *
                                                     * Counterpart to Solidity's `*` operator.
                                                     *
                                                     * Requirements:
                                                     * - Multiplication cannot overflow.
                                                     */
                                                    function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                                                        // benefit is lost if 'b' is also tested.
                                                        // See: https://github.com/OpenZeppelin/openzeppelin-solidity/pull/522
                                                        if (a == 0) {
                                                            return 0;
                                                        }
                                                
                                                        uint256 c = a * b;
                                                        require(c / a == b, "SafeMath: multiplication overflow");
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the integer division of two unsigned integers. Reverts on
                                                     * division by zero. The result is rounded towards zero.
                                                     *
                                                     * Counterpart to Solidity's `/` operator. Note: this function uses a
                                                     * `revert` opcode (which leaves remaining gas untouched) while Solidity
                                                     * uses an invalid opcode to revert (consuming all remaining gas).
                                                     *
                                                     * Requirements:
                                                     * - The divisor cannot be zero.
                                                     */
                                                    function div(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        // Solidity only automatically asserts when dividing by 0
                                                        require(b > 0, "SafeMath: division by zero");
                                                        uint256 c = a / b;
                                                        // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                                                
                                                        return c;
                                                    }
                                                
                                                    /**
                                                     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                                     * Reverts when dividing by zero.
                                                     *
                                                     * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                                     * opcode (which leaves remaining gas untouched) while Solidity uses an
                                                     * invalid opcode to revert (consuming all remaining gas).
                                                     *
                                                     * Requirements:
                                                     * - The divisor cannot be zero.
                                                     */
                                                    function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                                                        require(b != 0, "SafeMath: modulo by zero");
                                                        return a % b;
                                                    }
                                                }
                                                
                                                
                                                // Libraries
                                                
                                                
                                                // https://docs.synthetix.io/contracts/SafeDecimalMath
                                                library SafeDecimalMath {
                                                    using SafeMath for uint;
                                                
                                                    /* Number of decimal places in the representations. */
                                                    uint8 public constant decimals = 18;
                                                    uint8 public constant highPrecisionDecimals = 27;
                                                
                                                    /* The number representing 1.0. */
                                                    uint public constant UNIT = 10**uint(decimals);
                                                
                                                    /* The number representing 1.0 for higher fidelity numbers. */
                                                    uint public constant PRECISE_UNIT = 10**uint(highPrecisionDecimals);
                                                    uint private constant UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR = 10**uint(highPrecisionDecimals - decimals);
                                                
                                                    /**
                                                     * @return Provides an interface to UNIT.
                                                     */
                                                    function unit() external pure returns (uint) {
                                                        return UNIT;
                                                    }
                                                
                                                    /**
                                                     * @return Provides an interface to PRECISE_UNIT.
                                                     */
                                                    function preciseUnit() external pure returns (uint) {
                                                        return PRECISE_UNIT;
                                                    }
                                                
                                                    /**
                                                     * @return The result of multiplying x and y, interpreting the operands as fixed-point
                                                     * decimals.
                                                     *
                                                     * @dev A unit factor is divided out after the product of x and y is evaluated,
                                                     * so that product must be less than 2**256. As this is an integer division,
                                                     * the internal division always rounds down. This helps save on gas. Rounding
                                                     * is more expensive on gas.
                                                     */
                                                    function multiplyDecimal(uint x, uint y) internal pure returns (uint) {
                                                        /* Divide by UNIT to remove the extra factor introduced by the product. */
                                                        return x.mul(y) / UNIT;
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely multiplying x and y, interpreting the operands
                                                     * as fixed-point decimals of the specified precision unit.
                                                     *
                                                     * @dev The operands should be in the form of a the specified unit factor which will be
                                                     * divided out after the product of x and y is evaluated, so that product must be
                                                     * less than 2**256.
                                                     *
                                                     * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
                                                     * Rounding is useful when you need to retain fidelity for small decimal numbers
                                                     * (eg. small fractions or percentages).
                                                     */
                                                    function _multiplyDecimalRound(
                                                        uint x,
                                                        uint y,
                                                        uint precisionUnit
                                                    ) private pure returns (uint) {
                                                        /* Divide by UNIT to remove the extra factor introduced by the product. */
                                                        uint quotientTimesTen = x.mul(y) / (precisionUnit / 10);
                                                
                                                        if (quotientTimesTen % 10 >= 5) {
                                                            quotientTimesTen += 10;
                                                        }
                                                
                                                        return quotientTimesTen / 10;
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely multiplying x and y, interpreting the operands
                                                     * as fixed-point decimals of a precise unit.
                                                     *
                                                     * @dev The operands should be in the precise unit factor which will be
                                                     * divided out after the product of x and y is evaluated, so that product must be
                                                     * less than 2**256.
                                                     *
                                                     * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
                                                     * Rounding is useful when you need to retain fidelity for small decimal numbers
                                                     * (eg. small fractions or percentages).
                                                     */
                                                    function multiplyDecimalRoundPrecise(uint x, uint y) internal pure returns (uint) {
                                                        return _multiplyDecimalRound(x, y, PRECISE_UNIT);
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely multiplying x and y, interpreting the operands
                                                     * as fixed-point decimals of a standard unit.
                                                     *
                                                     * @dev The operands should be in the standard unit factor which will be
                                                     * divided out after the product of x and y is evaluated, so that product must be
                                                     * less than 2**256.
                                                     *
                                                     * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
                                                     * Rounding is useful when you need to retain fidelity for small decimal numbers
                                                     * (eg. small fractions or percentages).
                                                     */
                                                    function multiplyDecimalRound(uint x, uint y) internal pure returns (uint) {
                                                        return _multiplyDecimalRound(x, y, UNIT);
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely dividing x and y. The return value is a high
                                                     * precision decimal.
                                                     *
                                                     * @dev y is divided after the product of x and the standard precision unit
                                                     * is evaluated, so the product of x and UNIT must be less than 2**256. As
                                                     * this is an integer division, the result is always rounded down.
                                                     * This helps save on gas. Rounding is more expensive on gas.
                                                     */
                                                    function divideDecimal(uint x, uint y) internal pure returns (uint) {
                                                        /* Reintroduce the UNIT factor that will be divided out by y. */
                                                        return x.mul(UNIT).div(y);
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely dividing x and y. The return value is as a rounded
                                                     * decimal in the precision unit specified in the parameter.
                                                     *
                                                     * @dev y is divided after the product of x and the specified precision unit
                                                     * is evaluated, so the product of x and the specified precision unit must
                                                     * be less than 2**256. The result is rounded to the nearest increment.
                                                     */
                                                    function _divideDecimalRound(
                                                        uint x,
                                                        uint y,
                                                        uint precisionUnit
                                                    ) private pure returns (uint) {
                                                        uint resultTimesTen = x.mul(precisionUnit * 10).div(y);
                                                
                                                        if (resultTimesTen % 10 >= 5) {
                                                            resultTimesTen += 10;
                                                        }
                                                
                                                        return resultTimesTen / 10;
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely dividing x and y. The return value is as a rounded
                                                     * standard precision decimal.
                                                     *
                                                     * @dev y is divided after the product of x and the standard precision unit
                                                     * is evaluated, so the product of x and the standard precision unit must
                                                     * be less than 2**256. The result is rounded to the nearest increment.
                                                     */
                                                    function divideDecimalRound(uint x, uint y) internal pure returns (uint) {
                                                        return _divideDecimalRound(x, y, UNIT);
                                                    }
                                                
                                                    /**
                                                     * @return The result of safely dividing x and y. The return value is as a rounded
                                                     * high precision decimal.
                                                     *
                                                     * @dev y is divided after the product of x and the high precision unit
                                                     * is evaluated, so the product of x and the high precision unit must
                                                     * be less than 2**256. The result is rounded to the nearest increment.
                                                     */
                                                    function divideDecimalRoundPrecise(uint x, uint y) internal pure returns (uint) {
                                                        return _divideDecimalRound(x, y, PRECISE_UNIT);
                                                    }
                                                
                                                    /**
                                                     * @dev Convert a standard decimal representation to a high precision one.
                                                     */
                                                    function decimalToPreciseDecimal(uint i) internal pure returns (uint) {
                                                        return i.mul(UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR);
                                                    }
                                                
                                                    /**
                                                     * @dev Convert a high precision decimal to a standard decimal representation.
                                                     */
                                                    function preciseDecimalToDecimal(uint i) internal pure returns (uint) {
                                                        uint quotientTimesTen = i / (UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR / 10);
                                                
                                                        if (quotientTimesTen % 10 >= 5) {
                                                            quotientTimesTen += 10;
                                                        }
                                                
                                                        return quotientTimesTen / 10;
                                                    }
                                                }
                                                
                                                
                                                interface IERC20 {
                                                    // ERC20 Optional Views
                                                    function name() external view returns (string memory);
                                                
                                                    function symbol() external view returns (string memory);
                                                
                                                    function decimals() external view returns (uint8);
                                                
                                                    // Views
                                                    function totalSupply() external view returns (uint);
                                                
                                                    function balanceOf(address owner) external view returns (uint);
                                                
                                                    function allowance(address owner, address spender) external view returns (uint);
                                                
                                                    // Mutative functions
                                                    function transfer(address to, uint value) external returns (bool);
                                                
                                                    function approve(address spender, uint value) external returns (bool);
                                                
                                                    function transferFrom(
                                                        address from,
                                                        address to,
                                                        uint value
                                                    ) external returns (bool);
                                                
                                                    // Events
                                                    event Transfer(address indexed from, address indexed to, uint value);
                                                
                                                    event Approval(address indexed owner, address indexed spender, uint value);
                                                }
                                                
                                                
                                                interface ISystemStatus {
                                                    struct Status {
                                                        bool canSuspend;
                                                        bool canResume;
                                                    }
                                                
                                                    struct Suspension {
                                                        bool suspended;
                                                        // reason is an integer code,
                                                        // 0 => no reason, 1 => upgrading, 2+ => defined by system usage
                                                        uint248 reason;
                                                    }
                                                
                                                    // Views
                                                    function accessControl(bytes32 section, address account) external view returns (bool canSuspend, bool canResume);
                                                
                                                    function requireSystemActive() external view;
                                                
                                                    function requireIssuanceActive() external view;
                                                
                                                    function requireExchangeActive() external view;
                                                
                                                    function requireSynthActive(bytes32 currencyKey) external view;
                                                
                                                    function requireSynthsActive(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey) external view;
                                                
                                                    function synthSuspension(bytes32 currencyKey) external view returns (bool suspended, uint248 reason);
                                                
                                                    // Restricted functions
                                                    function suspendSynth(bytes32 currencyKey, uint256 reason) external;
                                                
                                                    function updateAccessControl(
                                                        bytes32 section,
                                                        address account,
                                                        bool canSuspend,
                                                        bool canResume
                                                    ) external;
                                                }
                                                
                                                
                                                interface IExchangeState {
                                                    // Views
                                                    struct ExchangeEntry {
                                                        bytes32 src;
                                                        uint amount;
                                                        bytes32 dest;
                                                        uint amountReceived;
                                                        uint exchangeFeeRate;
                                                        uint timestamp;
                                                        uint roundIdForSrc;
                                                        uint roundIdForDest;
                                                    }
                                                
                                                    function getLengthOfEntries(address account, bytes32 currencyKey) external view returns (uint);
                                                
                                                    function getEntryAt(
                                                        address account,
                                                        bytes32 currencyKey,
                                                        uint index
                                                    )
                                                        external
                                                        view
                                                        returns (
                                                            bytes32 src,
                                                            uint amount,
                                                            bytes32 dest,
                                                            uint amountReceived,
                                                            uint exchangeFeeRate,
                                                            uint timestamp,
                                                            uint roundIdForSrc,
                                                            uint roundIdForDest
                                                        );
                                                
                                                    function getMaxTimestamp(address account, bytes32 currencyKey) external view returns (uint);
                                                
                                                    // Mutative functions
                                                    function appendExchangeEntry(
                                                        address account,
                                                        bytes32 src,
                                                        uint amount,
                                                        bytes32 dest,
                                                        uint amountReceived,
                                                        uint exchangeFeeRate,
                                                        uint timestamp,
                                                        uint roundIdForSrc,
                                                        uint roundIdForDest
                                                    ) external;
                                                
                                                    function removeEntries(address account, bytes32 currencyKey) external;
                                                }
                                                
                                                
                                                // https://docs.synthetix.io/contracts/source/interfaces/IExchangeRates
                                                interface IExchangeRates {
                                                    // Structs
                                                    struct RateAndUpdatedTime {
                                                        uint216 rate;
                                                        uint40 time;
                                                    }
                                                
                                                    struct InversePricing {
                                                        uint entryPoint;
                                                        uint upperLimit;
                                                        uint lowerLimit;
                                                        bool frozenAtUpperLimit;
                                                        bool frozenAtLowerLimit;
                                                    }
                                                
                                                    // Views
                                                    function aggregators(bytes32 currencyKey) external view returns (address);
                                                
                                                    function aggregatorWarningFlags() external view returns (address);
                                                
                                                    function anyRateIsInvalid(bytes32[] calldata currencyKeys) external view returns (bool);
                                                
                                                    function canFreezeRate(bytes32 currencyKey) external view returns (bool);
                                                
                                                    function currentRoundForRate(bytes32 currencyKey) external view returns (uint);
                                                
                                                    function currenciesUsingAggregator(address aggregator) external view returns (bytes32[] memory);
                                                
                                                    function effectiveValue(
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey
                                                    ) external view returns (uint value);
                                                
                                                    function effectiveValueAndRates(
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey
                                                    )
                                                        external
                                                        view
                                                        returns (
                                                            uint value,
                                                            uint sourceRate,
                                                            uint destinationRate
                                                        );
                                                
                                                    function effectiveValueAtRound(
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        uint roundIdForSrc,
                                                        uint roundIdForDest
                                                    ) external view returns (uint value);
                                                
                                                    function getCurrentRoundId(bytes32 currencyKey) external view returns (uint);
                                                
                                                    function getLastRoundIdBeforeElapsedSecs(
                                                        bytes32 currencyKey,
                                                        uint startingRoundId,
                                                        uint startingTimestamp,
                                                        uint timediff
                                                    ) external view returns (uint);
                                                
                                                    function inversePricing(bytes32 currencyKey)
                                                        external
                                                        view
                                                        returns (
                                                            uint entryPoint,
                                                            uint upperLimit,
                                                            uint lowerLimit,
                                                            bool frozenAtUpperLimit,
                                                            bool frozenAtLowerLimit
                                                        );
                                                
                                                    function lastRateUpdateTimes(bytes32 currencyKey) external view returns (uint256);
                                                
                                                    function oracle() external view returns (address);
                                                
                                                    function rateAndTimestampAtRound(bytes32 currencyKey, uint roundId) external view returns (uint rate, uint time);
                                                
                                                    function rateAndUpdatedTime(bytes32 currencyKey) external view returns (uint rate, uint time);
                                                
                                                    function rateAndInvalid(bytes32 currencyKey) external view returns (uint rate, bool isInvalid);
                                                
                                                    function rateForCurrency(bytes32 currencyKey) external view returns (uint);
                                                
                                                    function rateIsFlagged(bytes32 currencyKey) external view returns (bool);
                                                
                                                    function rateIsFrozen(bytes32 currencyKey) external view returns (bool);
                                                
                                                    function rateIsInvalid(bytes32 currencyKey) external view returns (bool);
                                                
                                                    function rateIsStale(bytes32 currencyKey) external view returns (bool);
                                                
                                                    function rateStalePeriod() external view returns (uint);
                                                
                                                    function ratesAndUpdatedTimeForCurrencyLastNRounds(bytes32 currencyKey, uint numRounds)
                                                        external
                                                        view
                                                        returns (uint[] memory rates, uint[] memory times);
                                                
                                                    function ratesAndInvalidForCurrencies(bytes32[] calldata currencyKeys)
                                                        external
                                                        view
                                                        returns (uint[] memory rates, bool anyRateInvalid);
                                                
                                                    function ratesForCurrencies(bytes32[] calldata currencyKeys) external view returns (uint[] memory);
                                                
                                                    // Mutative functions
                                                    function freezeRate(bytes32 currencyKey) external;
                                                }
                                                
                                                
                                                interface ISynthetix {
                                                    // Views
                                                    function anySynthOrSNXRateIsInvalid() external view returns (bool anyRateInvalid);
                                                
                                                    function availableCurrencyKeys() external view returns (bytes32[] memory);
                                                
                                                    function availableSynthCount() external view returns (uint);
                                                
                                                    function availableSynths(uint index) external view returns (ISynth);
                                                
                                                    function collateral(address account) external view returns (uint);
                                                
                                                    function collateralisationRatio(address issuer) external view returns (uint);
                                                
                                                    function debtBalanceOf(address issuer, bytes32 currencyKey) external view returns (uint);
                                                
                                                    function isWaitingPeriod(bytes32 currencyKey) external view returns (bool);
                                                
                                                    function maxIssuableSynths(address issuer) external view returns (uint maxIssuable);
                                                
                                                    function remainingIssuableSynths(address issuer)
                                                        external
                                                        view
                                                        returns (
                                                            uint maxIssuable,
                                                            uint alreadyIssued,
                                                            uint totalSystemDebt
                                                        );
                                                
                                                    function synths(bytes32 currencyKey) external view returns (ISynth);
                                                
                                                    function synthsByAddress(address synthAddress) external view returns (bytes32);
                                                
                                                    function totalIssuedSynths(bytes32 currencyKey) external view returns (uint);
                                                
                                                    function totalIssuedSynthsExcludeEtherCollateral(bytes32 currencyKey) external view returns (uint);
                                                
                                                    function transferableSynthetix(address account) external view returns (uint transferable);
                                                
                                                    // Mutative Functions
                                                    function burnSynths(uint amount) external;
                                                
                                                    function burnSynthsOnBehalf(address burnForAddress, uint amount) external;
                                                
                                                    function burnSynthsToTarget() external;
                                                
                                                    function burnSynthsToTargetOnBehalf(address burnForAddress) external;
                                                
                                                    function exchange(
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey
                                                    ) external returns (uint amountReceived);
                                                
                                                    function exchangeOnBehalf(
                                                        address exchangeForAddress,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey
                                                    ) external returns (uint amountReceived);
                                                
                                                    function exchangeWithTracking(
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address originator,
                                                        bytes32 trackingCode
                                                    ) external returns (uint amountReceived);
                                                
                                                    function exchangeOnBehalfWithTracking(
                                                        address exchangeForAddress,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address originator,
                                                        bytes32 trackingCode
                                                    ) external returns (uint amountReceived);
                                                
                                                    function issueMaxSynths() external;
                                                
                                                    function issueMaxSynthsOnBehalf(address issueForAddress) external;
                                                
                                                    function issueSynths(uint amount) external;
                                                
                                                    function issueSynthsOnBehalf(address issueForAddress, uint amount) external;
                                                
                                                    function mint() external returns (bool);
                                                
                                                    function settle(bytes32 currencyKey)
                                                        external
                                                        returns (
                                                            uint reclaimed,
                                                            uint refunded,
                                                            uint numEntries
                                                        );
                                                
                                                    function liquidateDelinquentAccount(address account, uint susdAmount) external returns (bool);
                                                }
                                                
                                                
                                                interface IFeePool {
                                                    // Views
                                                
                                                    // solhint-disable-next-line func-name-mixedcase
                                                    function FEE_ADDRESS() external view returns (address);
                                                
                                                    function feesAvailable(address account) external view returns (uint, uint);
                                                
                                                    function feePeriodDuration() external view returns (uint);
                                                
                                                    function isFeesClaimable(address account) external view returns (bool);
                                                
                                                    function targetThreshold() external view returns (uint);
                                                
                                                    function totalFeesAvailable() external view returns (uint);
                                                
                                                    function totalRewardsAvailable() external view returns (uint);
                                                
                                                    // Mutative Functions
                                                    function claimFees() external returns (bool);
                                                
                                                    function claimOnBehalf(address claimingForAddress) external returns (bool);
                                                
                                                    function closeCurrentFeePeriod() external;
                                                
                                                    // Restricted: used internally to Synthetix
                                                    function appendAccountIssuanceRecord(
                                                        address account,
                                                        uint lockedAmount,
                                                        uint debtEntryIndex
                                                    ) external;
                                                
                                                    function recordFeePaid(uint sUSDAmount) external;
                                                
                                                    function setRewardsToDistribute(uint amount) external;
                                                }
                                                
                                                
                                                interface IDelegateApprovals {
                                                    // Views
                                                    function canBurnFor(address authoriser, address delegate) external view returns (bool);
                                                
                                                    function canIssueFor(address authoriser, address delegate) external view returns (bool);
                                                
                                                    function canClaimFor(address authoriser, address delegate) external view returns (bool);
                                                
                                                    function canExchangeFor(address authoriser, address delegate) external view returns (bool);
                                                
                                                    // Mutative
                                                    function approveAllDelegatePowers(address delegate) external;
                                                
                                                    function removeAllDelegatePowers(address delegate) external;
                                                
                                                    function approveBurnOnBehalf(address delegate) external;
                                                
                                                    function removeBurnOnBehalf(address delegate) external;
                                                
                                                    function approveIssueOnBehalf(address delegate) external;
                                                
                                                    function removeIssueOnBehalf(address delegate) external;
                                                
                                                    function approveClaimOnBehalf(address delegate) external;
                                                
                                                    function removeClaimOnBehalf(address delegate) external;
                                                
                                                    function approveExchangeOnBehalf(address delegate) external;
                                                
                                                    function removeExchangeOnBehalf(address delegate) external;
                                                }
                                                
                                                
                                                interface ITradingRewards {
                                                    /* ========== VIEWS ========== */
                                                
                                                    function getAvailableRewards() external view returns (uint);
                                                
                                                    function getUnassignedRewards() external view returns (uint);
                                                
                                                    function getRewardsToken() external view returns (address);
                                                
                                                    function getPeriodController() external view returns (address);
                                                
                                                    function getCurrentPeriod() external view returns (uint);
                                                
                                                    function getPeriodIsClaimable(uint periodID) external view returns (bool);
                                                
                                                    function getPeriodIsFinalized(uint periodID) external view returns (bool);
                                                
                                                    function getPeriodRecordedFees(uint periodID) external view returns (uint);
                                                
                                                    function getPeriodTotalRewards(uint periodID) external view returns (uint);
                                                
                                                    function getPeriodAvailableRewards(uint periodID) external view returns (uint);
                                                
                                                    function getUnaccountedFeesForAccountForPeriod(address account, uint periodID) external view returns (uint);
                                                
                                                    function getAvailableRewardsForAccountForPeriod(address account, uint periodID) external view returns (uint);
                                                
                                                    function getAvailableRewardsForAccountForPeriods(address account, uint[] calldata periodIDs)
                                                        external
                                                        view
                                                        returns (uint totalRewards);
                                                
                                                    /* ========== MUTATIVE FUNCTIONS ========== */
                                                
                                                    function claimRewardsForPeriod(uint periodID) external;
                                                
                                                    function claimRewardsForPeriods(uint[] calldata periodIDs) external;
                                                
                                                    /* ========== RESTRICTED FUNCTIONS ========== */
                                                
                                                    function recordExchangeFeeForAccount(uint usdFeeAmount, address account) external;
                                                
                                                    function closeCurrentPeriodWithRewards(uint rewards) external;
                                                
                                                    function recoverEther(address payable recoverAddress) external;
                                                
                                                    function recoverTokens(address tokenAddress, address recoverAddress) external;
                                                
                                                    function recoverUnassignedRewardTokens(address recoverAddress) external;
                                                
                                                    function recoverAssignedRewardTokensAndDestroyPeriod(address recoverAddress, uint periodID) external;
                                                
                                                    function setPeriodController(address newPeriodController) external;
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // Libraries
                                                
                                                
                                                // Internal references
                                                
                                                
                                                // Used to have strongly-typed access to internal mutative functions in Synthetix
                                                interface ISynthetixInternal {
                                                    function emitExchangeTracking(
                                                        bytes32 trackingCode,
                                                        bytes32 toCurrencyKey,
                                                        uint256 toAmount
                                                    ) external;
                                                
                                                    function emitSynthExchange(
                                                        address account,
                                                        bytes32 fromCurrencyKey,
                                                        uint fromAmount,
                                                        bytes32 toCurrencyKey,
                                                        uint toAmount,
                                                        address toAddress
                                                    ) external;
                                                
                                                    function emitExchangeReclaim(
                                                        address account,
                                                        bytes32 currencyKey,
                                                        uint amount
                                                    ) external;
                                                
                                                    function emitExchangeRebate(
                                                        address account,
                                                        bytes32 currencyKey,
                                                        uint amount
                                                    ) external;
                                                }
                                                
                                                
                                                interface IIssuerInternal {
                                                    function updateSNXIssuedDebtOnExchange(bytes32[2] calldata currencyKeys, uint[2] calldata currencyRates) external;
                                                }
                                                
                                                
                                                // https://docs.synthetix.io/contracts/Exchanger
                                                contract Exchanger is Owned, MixinResolver, MixinSystemSettings, IExchanger {
                                                    using SafeMath for uint;
                                                    using SafeDecimalMath for uint;
                                                
                                                    struct ExchangeEntrySettlement {
                                                        bytes32 src;
                                                        uint amount;
                                                        bytes32 dest;
                                                        uint reclaim;
                                                        uint rebate;
                                                        uint srcRoundIdAtPeriodEnd;
                                                        uint destRoundIdAtPeriodEnd;
                                                        uint timestamp;
                                                    }
                                                
                                                    bytes32 private constant sUSD = "sUSD";
                                                
                                                    // SIP-65: Decentralized circuit breaker
                                                    uint public constant CIRCUIT_BREAKER_SUSPENSION_REASON = 65;
                                                
                                                    mapping(bytes32 => uint) public lastExchangeRate;
                                                
                                                    /* ========== ADDRESS RESOLVER CONFIGURATION ========== */
                                                
                                                    bytes32 private constant CONTRACT_SYSTEMSTATUS = "SystemStatus";
                                                    bytes32 private constant CONTRACT_EXCHANGESTATE = "ExchangeState";
                                                    bytes32 private constant CONTRACT_EXRATES = "ExchangeRates";
                                                    bytes32 private constant CONTRACT_SYNTHETIX = "Synthetix";
                                                    bytes32 private constant CONTRACT_FEEPOOL = "FeePool";
                                                    bytes32 private constant CONTRACT_TRADING_REWARDS = "TradingRewards";
                                                    bytes32 private constant CONTRACT_DELEGATEAPPROVALS = "DelegateApprovals";
                                                    bytes32 private constant CONTRACT_ISSUER = "Issuer";
                                                
                                                    bytes32[24] private addressesToCache = [
                                                        CONTRACT_SYSTEMSTATUS,
                                                        CONTRACT_EXCHANGESTATE,
                                                        CONTRACT_EXRATES,
                                                        CONTRACT_SYNTHETIX,
                                                        CONTRACT_FEEPOOL,
                                                        CONTRACT_TRADING_REWARDS,
                                                        CONTRACT_DELEGATEAPPROVALS,
                                                        CONTRACT_ISSUER
                                                    ];
                                                
                                                    constructor(address _owner, address _resolver)
                                                        public
                                                        Owned(_owner)
                                                        MixinResolver(_resolver, addressesToCache)
                                                        MixinSystemSettings()
                                                    {}
                                                
                                                    /* ========== VIEWS ========== */
                                                
                                                    function systemStatus() internal view returns (ISystemStatus) {
                                                        return ISystemStatus(requireAndGetAddress(CONTRACT_SYSTEMSTATUS, "Missing SystemStatus address"));
                                                    }
                                                
                                                    function exchangeState() internal view returns (IExchangeState) {
                                                        return IExchangeState(requireAndGetAddress(CONTRACT_EXCHANGESTATE, "Missing ExchangeState address"));
                                                    }
                                                
                                                    function exchangeRates() internal view returns (IExchangeRates) {
                                                        return IExchangeRates(requireAndGetAddress(CONTRACT_EXRATES, "Missing ExchangeRates address"));
                                                    }
                                                
                                                    function synthetix() internal view returns (ISynthetix) {
                                                        return ISynthetix(requireAndGetAddress(CONTRACT_SYNTHETIX, "Missing Synthetix address"));
                                                    }
                                                
                                                    function feePool() internal view returns (IFeePool) {
                                                        return IFeePool(requireAndGetAddress(CONTRACT_FEEPOOL, "Missing FeePool address"));
                                                    }
                                                
                                                    function tradingRewards() internal view returns (ITradingRewards) {
                                                        return ITradingRewards(requireAndGetAddress(CONTRACT_TRADING_REWARDS, "Missing TradingRewards address"));
                                                    }
                                                
                                                    function delegateApprovals() internal view returns (IDelegateApprovals) {
                                                        return IDelegateApprovals(requireAndGetAddress(CONTRACT_DELEGATEAPPROVALS, "Missing DelegateApprovals address"));
                                                    }
                                                
                                                    function issuer() internal view returns (IIssuer) {
                                                        return IIssuer(requireAndGetAddress(CONTRACT_ISSUER, "Missing Issuer address"));
                                                    }
                                                
                                                    function maxSecsLeftInWaitingPeriod(address account, bytes32 currencyKey) public view returns (uint) {
                                                        return secsLeftInWaitingPeriodForExchange(exchangeState().getMaxTimestamp(account, currencyKey));
                                                    }
                                                
                                                    function waitingPeriodSecs() external view returns (uint) {
                                                        return getWaitingPeriodSecs();
                                                    }
                                                
                                                    function tradingRewardsEnabled() external view returns (bool) {
                                                        return getTradingRewardsEnabled();
                                                    }
                                                
                                                    function priceDeviationThresholdFactor() external view returns (uint) {
                                                        return getPriceDeviationThresholdFactor();
                                                    }
                                                
                                                    function settlementOwing(address account, bytes32 currencyKey)
                                                        public
                                                        view
                                                        returns (
                                                            uint reclaimAmount,
                                                            uint rebateAmount,
                                                            uint numEntries
                                                        )
                                                    {
                                                        (reclaimAmount, rebateAmount, numEntries, ) = _settlementOwing(account, currencyKey);
                                                    }
                                                
                                                    // Internal function to emit events for each individual rebate and reclaim entry
                                                    function _settlementOwing(address account, bytes32 currencyKey)
                                                        internal
                                                        view
                                                        returns (
                                                            uint reclaimAmount,
                                                            uint rebateAmount,
                                                            uint numEntries,
                                                            ExchangeEntrySettlement[] memory
                                                        )
                                                    {
                                                        // Need to sum up all reclaim and rebate amounts for the user and the currency key
                                                        numEntries = exchangeState().getLengthOfEntries(account, currencyKey);
                                                
                                                        // For each unsettled exchange
                                                        ExchangeEntrySettlement[] memory settlements = new ExchangeEntrySettlement[](numEntries);
                                                        for (uint i = 0; i < numEntries; i++) {
                                                            uint reclaim;
                                                            uint rebate;
                                                            // fetch the entry from storage
                                                            IExchangeState.ExchangeEntry memory exchangeEntry = _getExchangeEntry(account, currencyKey, i);
                                                
                                                            // determine the last round ids for src and dest pairs when period ended or latest if not over
                                                            (uint srcRoundIdAtPeriodEnd, uint destRoundIdAtPeriodEnd) = getRoundIdsAtPeriodEnd(exchangeEntry);
                                                
                                                            // given these round ids, determine what effective value they should have received
                                                            uint destinationAmount = exchangeRates().effectiveValueAtRound(
                                                                exchangeEntry.src,
                                                                exchangeEntry.amount,
                                                                exchangeEntry.dest,
                                                                srcRoundIdAtPeriodEnd,
                                                                destRoundIdAtPeriodEnd
                                                            );
                                                
                                                            // and deduct the fee from this amount using the exchangeFeeRate from storage
                                                            uint amountShouldHaveReceived = _getAmountReceivedForExchange(destinationAmount, exchangeEntry.exchangeFeeRate);
                                                
                                                            // SIP-65 settlements where the amount at end of waiting period is beyond the threshold, then
                                                            // settle with no reclaim or rebate
                                                            if (!_isDeviationAboveThreshold(exchangeEntry.amountReceived, amountShouldHaveReceived)) {
                                                                if (exchangeEntry.amountReceived > amountShouldHaveReceived) {
                                                                    // if they received more than they should have, add to the reclaim tally
                                                                    reclaim = exchangeEntry.amountReceived.sub(amountShouldHaveReceived);
                                                                    reclaimAmount = reclaimAmount.add(reclaim);
                                                                } else if (amountShouldHaveReceived > exchangeEntry.amountReceived) {
                                                                    // if less, add to the rebate tally
                                                                    rebate = amountShouldHaveReceived.sub(exchangeEntry.amountReceived);
                                                                    rebateAmount = rebateAmount.add(rebate);
                                                                }
                                                            }
                                                
                                                            settlements[i] = ExchangeEntrySettlement({
                                                                src: exchangeEntry.src,
                                                                amount: exchangeEntry.amount,
                                                                dest: exchangeEntry.dest,
                                                                reclaim: reclaim,
                                                                rebate: rebate,
                                                                srcRoundIdAtPeriodEnd: srcRoundIdAtPeriodEnd,
                                                                destRoundIdAtPeriodEnd: destRoundIdAtPeriodEnd,
                                                                timestamp: exchangeEntry.timestamp
                                                            });
                                                        }
                                                
                                                        return (reclaimAmount, rebateAmount, numEntries, settlements);
                                                    }
                                                
                                                    function _getExchangeEntry(
                                                        address account,
                                                        bytes32 currencyKey,
                                                        uint index
                                                    ) internal view returns (IExchangeState.ExchangeEntry memory) {
                                                        (
                                                            bytes32 src,
                                                            uint amount,
                                                            bytes32 dest,
                                                            uint amountReceived,
                                                            uint exchangeFeeRate,
                                                            uint timestamp,
                                                            uint roundIdForSrc,
                                                            uint roundIdForDest
                                                        ) = exchangeState().getEntryAt(account, currencyKey, index);
                                                
                                                        return
                                                            IExchangeState.ExchangeEntry({
                                                                src: src,
                                                                amount: amount,
                                                                dest: dest,
                                                                amountReceived: amountReceived,
                                                                exchangeFeeRate: exchangeFeeRate,
                                                                timestamp: timestamp,
                                                                roundIdForSrc: roundIdForSrc,
                                                                roundIdForDest: roundIdForDest
                                                            });
                                                    }
                                                
                                                    function hasWaitingPeriodOrSettlementOwing(address account, bytes32 currencyKey) external view returns (bool) {
                                                        if (maxSecsLeftInWaitingPeriod(account, currencyKey) != 0) {
                                                            return true;
                                                        }
                                                
                                                        (uint reclaimAmount, , , ) = _settlementOwing(account, currencyKey);
                                                
                                                        return reclaimAmount > 0;
                                                    }
                                                
                                                    /* ========== SETTERS ========== */
                                                
                                                    function calculateAmountAfterSettlement(
                                                        address from,
                                                        bytes32 currencyKey,
                                                        uint amount,
                                                        uint refunded
                                                    ) public view returns (uint amountAfterSettlement) {
                                                        amountAfterSettlement = amount;
                                                
                                                        // balance of a synth will show an amount after settlement
                                                        uint balanceOfSourceAfterSettlement = IERC20(address(issuer().synths(currencyKey))).balanceOf(from);
                                                
                                                        // when there isn't enough supply (either due to reclamation settlement or because the number is too high)
                                                        if (amountAfterSettlement > balanceOfSourceAfterSettlement) {
                                                            // then the amount to exchange is reduced to their remaining supply
                                                            amountAfterSettlement = balanceOfSourceAfterSettlement;
                                                        }
                                                
                                                        if (refunded > 0) {
                                                            amountAfterSettlement = amountAfterSettlement.add(refunded);
                                                        }
                                                    }
                                                
                                                    function isSynthRateInvalid(bytes32 currencyKey) external view returns (bool) {
                                                        return _isSynthRateInvalid(currencyKey, exchangeRates().rateForCurrency(currencyKey));
                                                    }
                                                
                                                    /* ========== MUTATIVE FUNCTIONS ========== */
                                                    function exchange(
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address destinationAddress
                                                    ) external onlySynthetixorSynth returns (uint amountReceived) {
                                                        uint fee;
                                                        (amountReceived, fee) = _exchange(from, sourceCurrencyKey, sourceAmount, destinationCurrencyKey, destinationAddress);
                                                
                                                        _processTradingRewards(fee, destinationAddress);
                                                    }
                                                
                                                    function exchangeOnBehalf(
                                                        address exchangeForAddress,
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey
                                                    ) external onlySynthetixorSynth returns (uint amountReceived) {
                                                        require(delegateApprovals().canExchangeFor(exchangeForAddress, from), "Not approved to act on behalf");
                                                
                                                        uint fee;
                                                        (amountReceived, fee) = _exchange(
                                                            exchangeForAddress,
                                                            sourceCurrencyKey,
                                                            sourceAmount,
                                                            destinationCurrencyKey,
                                                            exchangeForAddress
                                                        );
                                                
                                                        _processTradingRewards(fee, exchangeForAddress);
                                                    }
                                                
                                                    function exchangeWithTracking(
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address destinationAddress,
                                                        address originator,
                                                        bytes32 trackingCode
                                                    ) external onlySynthetixorSynth returns (uint amountReceived) {
                                                        uint fee;
                                                        (amountReceived, fee) = _exchange(from, sourceCurrencyKey, sourceAmount, destinationCurrencyKey, destinationAddress);
                                                
                                                        _processTradingRewards(fee, originator);
                                                
                                                        _emitTrackingEvent(trackingCode, destinationCurrencyKey, amountReceived);
                                                    }
                                                
                                                    function exchangeOnBehalfWithTracking(
                                                        address exchangeForAddress,
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address originator,
                                                        bytes32 trackingCode
                                                    ) external onlySynthetixorSynth returns (uint amountReceived) {
                                                        require(delegateApprovals().canExchangeFor(exchangeForAddress, from), "Not approved to act on behalf");
                                                
                                                        uint fee;
                                                        (amountReceived, fee) = _exchange(
                                                            exchangeForAddress,
                                                            sourceCurrencyKey,
                                                            sourceAmount,
                                                            destinationCurrencyKey,
                                                            exchangeForAddress
                                                        );
                                                
                                                        _processTradingRewards(fee, originator);
                                                
                                                        _emitTrackingEvent(trackingCode, destinationCurrencyKey, amountReceived);
                                                    }
                                                
                                                    function _emitTrackingEvent(
                                                        bytes32 trackingCode,
                                                        bytes32 toCurrencyKey,
                                                        uint256 toAmount
                                                    ) internal {
                                                        ISynthetixInternal(address(synthetix())).emitExchangeTracking(trackingCode, toCurrencyKey, toAmount);
                                                    }
                                                
                                                    function _processTradingRewards(uint fee, address originator) internal {
                                                        if (fee > 0 && originator != address(0) && getTradingRewardsEnabled()) {
                                                            tradingRewards().recordExchangeFeeForAccount(fee, originator);
                                                        }
                                                    }
                                                
                                                    function _exchange(
                                                        address from,
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey,
                                                        address destinationAddress
                                                    ) internal returns (uint amountReceived, uint fee) {
                                                        _ensureCanExchange(sourceCurrencyKey, sourceAmount, destinationCurrencyKey);
                                                
                                                        (, uint refunded, uint numEntriesSettled) = _internalSettle(from, sourceCurrencyKey, false);
                                                
                                                        uint sourceAmountAfterSettlement = sourceAmount;
                                                
                                                        // when settlement was required
                                                        if (numEntriesSettled > 0) {
                                                            // ensure the sourceAmount takes this into account
                                                            sourceAmountAfterSettlement = calculateAmountAfterSettlement(from, sourceCurrencyKey, sourceAmount, refunded);
                                                
                                                            // If, after settlement the user has no balance left (highly unlikely), then return to prevent
                                                            // emitting events of 0 and don't revert so as to ensure the settlement queue is emptied
                                                            if (sourceAmountAfterSettlement == 0) {
                                                                return (0, 0);
                                                            }
                                                        }
                                                
                                                        uint exchangeFeeRate;
                                                        uint sourceRate;
                                                        uint destinationRate;
                                                
                                                        // Note: `fee` is denominated in the destinationCurrencyKey.
                                                        (amountReceived, fee, exchangeFeeRate, sourceRate, destinationRate) = _getAmountsForExchangeMinusFees(
                                                            sourceAmountAfterSettlement,
                                                            sourceCurrencyKey,
                                                            destinationCurrencyKey
                                                        );
                                                
                                                        // SIP-65: Decentralized Circuit Breaker
                                                        if (_isSynthRateInvalid(sourceCurrencyKey, sourceRate)) {
                                                            systemStatus().suspendSynth(sourceCurrencyKey, CIRCUIT_BREAKER_SUSPENSION_REASON);
                                                            return (0, 0);
                                                        } else {
                                                            lastExchangeRate[sourceCurrencyKey] = sourceRate;
                                                        }
                                                
                                                        if (_isSynthRateInvalid(destinationCurrencyKey, destinationRate)) {
                                                            systemStatus().suspendSynth(destinationCurrencyKey, CIRCUIT_BREAKER_SUSPENSION_REASON);
                                                            return (0, 0);
                                                        } else {
                                                            lastExchangeRate[destinationCurrencyKey] = destinationRate;
                                                        }
                                                
                                                        // Note: We don't need to check their balance as the burn() below will do a safe subtraction which requires
                                                        // the subtraction to not overflow, which would happen if their balance is not sufficient.
                                                
                                                        // Burn the source amount
                                                        issuer().synths(sourceCurrencyKey).burn(from, sourceAmountAfterSettlement);
                                                
                                                        // Issue their new synths
                                                        issuer().synths(destinationCurrencyKey).issue(destinationAddress, amountReceived);
                                                
                                                        // Remit the fee if required
                                                        if (fee > 0) {
                                                            // Normalize fee to sUSD
                                                            // Note: `fee` is being reused to avoid stack too deep errors.
                                                            fee = exchangeRates().effectiveValue(destinationCurrencyKey, fee, sUSD);
                                                
                                                            // Remit the fee in sUSDs
                                                            issuer().synths(sUSD).issue(feePool().FEE_ADDRESS(), fee);
                                                
                                                            // Tell the fee pool about this
                                                            feePool().recordFeePaid(fee);
                                                        }
                                                
                                                        // Note: As of this point, `fee` is denominated in sUSD.
                                                
                                                        // Nothing changes as far as issuance data goes because the total value in the system hasn't changed.
                                                        // But we will update the debt snapshot in case exchange rates have fluctuated since the last exchange
                                                        // in these currencies
                                                        IIssuerInternal(address(issuer())).updateSNXIssuedDebtOnExchange(
                                                            [sourceCurrencyKey, destinationCurrencyKey],
                                                            [sourceRate, destinationRate]
                                                        );
                                                
                                                        // Let the DApps know there was a Synth exchange
                                                        ISynthetixInternal(address(synthetix())).emitSynthExchange(
                                                            from,
                                                            sourceCurrencyKey,
                                                            sourceAmountAfterSettlement,
                                                            destinationCurrencyKey,
                                                            amountReceived,
                                                            destinationAddress
                                                        );
                                                
                                                        // persist the exchange information for the dest key
                                                        appendExchange(
                                                            destinationAddress,
                                                            sourceCurrencyKey,
                                                            sourceAmountAfterSettlement,
                                                            destinationCurrencyKey,
                                                            amountReceived,
                                                            exchangeFeeRate
                                                        );
                                                    }
                                                
                                                    // Note: this function can intentionally be called by anyone on behalf of anyone else (the caller just pays the gas)
                                                    function settle(address from, bytes32 currencyKey)
                                                        external
                                                        returns (
                                                            uint reclaimed,
                                                            uint refunded,
                                                            uint numEntriesSettled
                                                        )
                                                    {
                                                        systemStatus().requireSynthActive(currencyKey);
                                                        return _internalSettle(from, currencyKey, true);
                                                    }
                                                
                                                    function suspendSynthWithInvalidRate(bytes32 currencyKey) external {
                                                        systemStatus().requireSystemActive();
                                                        require(issuer().synths(currencyKey) != ISynth(0), "No such synth");
                                                        require(_isSynthRateInvalid(currencyKey, exchangeRates().rateForCurrency(currencyKey)), "Synth price is valid");
                                                        systemStatus().suspendSynth(currencyKey, CIRCUIT_BREAKER_SUSPENSION_REASON);
                                                    }
                                                
                                                    // SIP-78
                                                    function setLastExchangeRateForSynth(bytes32 currencyKey, uint rate) external onlyExchangeRates {
                                                        require(rate > 0, "Rate must be above 0");
                                                        lastExchangeRate[currencyKey] = rate;
                                                    }
                                                
                                                    /* ========== INTERNAL FUNCTIONS ========== */
                                                
                                                    function _ensureCanExchange(
                                                        bytes32 sourceCurrencyKey,
                                                        uint sourceAmount,
                                                        bytes32 destinationCurrencyKey
                                                    ) internal view {
                                                        require(sourceCurrencyKey != destinationCurrencyKey, "Can't be same synth");
                                                        require(sourceAmount > 0, "Zero amount");
                                                
                                                        bytes32[] memory synthKeys = new bytes32[](2);
                                                        synthKeys[0] = sourceCurrencyKey;
                                                        synthKeys[1] = destinationCurrencyKey;
                                                        require(!exchangeRates().anyRateIsInvalid(synthKeys), "Src/dest rate invalid or not found");
                                                    }
                                                
                                                    function _isSynthRateInvalid(bytes32 currencyKey, uint currentRate) internal view returns (bool) {
                                                        if (currentRate == 0) {
                                                            return true;
                                                        }
                                                
                                                        uint lastRateFromExchange = lastExchangeRate[currencyKey];
                                                
                                                        if (lastRateFromExchange > 0) {
                                                            return _isDeviationAboveThreshold(lastRateFromExchange, currentRate);
                                                        }
                                                
                                                        // if no last exchange for this synth, then we need to look up last 3 rates (+1 for current rate)
                                                        (uint[] memory rates, ) = exchangeRates().ratesAndUpdatedTimeForCurrencyLastNRounds(currencyKey, 4);
                                                
                                                        // start at index 1 to ignore current rate
                                                        for (uint i = 1; i < rates.length; i++) {
                                                            // ignore any empty rates in the past (otherwise we will never be able to get validity)
                                                            if (rates[i] > 0 && _isDeviationAboveThreshold(rates[i], currentRate)) {
                                                                return true;
                                                            }
                                                        }
                                                
                                                        return false;
                                                    }
                                                
                                                    function _isDeviationAboveThreshold(uint base, uint comparison) internal view returns (bool) {
                                                        if (base == 0 || comparison == 0) {
                                                            return true;
                                                        }
                                                
                                                        uint factor;
                                                        if (comparison > base) {
                                                            factor = comparison.divideDecimal(base);
                                                        } else {
                                                            factor = base.divideDecimal(comparison);
                                                        }
                                                
                                                        return factor >= getPriceDeviationThresholdFactor();
                                                    }
                                                
                                                    function _internalSettle(
                                                        address from,
                                                        bytes32 currencyKey,
                                                        bool updateCache
                                                    )
                                                        internal
                                                        returns (
                                                            uint reclaimed,
                                                            uint refunded,
                                                            uint numEntriesSettled
                                                        )
                                                    {
                                                        require(maxSecsLeftInWaitingPeriod(from, currencyKey) == 0, "Cannot settle during waiting period");
                                                
                                                        (
                                                            uint reclaimAmount,
                                                            uint rebateAmount,
                                                            uint entries,
                                                            ExchangeEntrySettlement[] memory settlements
                                                        ) = _settlementOwing(from, currencyKey);
                                                
                                                        if (reclaimAmount > rebateAmount) {
                                                            reclaimed = reclaimAmount.sub(rebateAmount);
                                                            reclaim(from, currencyKey, reclaimed);
                                                        } else if (rebateAmount > reclaimAmount) {
                                                            refunded = rebateAmount.sub(reclaimAmount);
                                                            refund(from, currencyKey, refunded);
                                                        }
                                                
                                                        if (updateCache) {
                                                            bytes32[] memory key = new bytes32[](1);
                                                            key[0] = currencyKey;
                                                            issuer().updateSNXIssuedDebtForCurrencies(key);
                                                        }
                                                
                                                        // emit settlement event for each settled exchange entry
                                                        for (uint i = 0; i < settlements.length; i++) {
                                                            emit ExchangeEntrySettled(
                                                                from,
                                                                settlements[i].src,
                                                                settlements[i].amount,
                                                                settlements[i].dest,
                                                                settlements[i].reclaim,
                                                                settlements[i].rebate,
                                                                settlements[i].srcRoundIdAtPeriodEnd,
                                                                settlements[i].destRoundIdAtPeriodEnd,
                                                                settlements[i].timestamp
                                                            );
                                                        }
                                                
                                                        numEntriesSettled = entries;
                                                
                                                        // Now remove all entries, even if no reclaim and no rebate
                                                        exchangeState().removeEntries(from, currencyKey);
                                                    }
                                                
                                                    function reclaim(
                                                        address from,
                                                        bytes32 currencyKey,
                                                        uint amount
                                                    ) internal {
                                                        // burn amount from user
                                                        issuer().synths(currencyKey).burn(from, amount);
                                                        ISynthetixInternal(address(synthetix())).emitExchangeReclaim(from, currencyKey, amount);
                                                    }
                                                
                                                    function refund(
                                                        address from,
                                                        bytes32 currencyKey,
                                                        uint amount
                                                    ) internal {
                                                        // issue amount to user
                                                        issuer().synths(currencyKey).issue(from, amount);
                                                        ISynthetixInternal(address(synthetix())).emitExchangeRebate(from, currencyKey, amount);
                                                    }
                                                
                                                    function secsLeftInWaitingPeriodForExchange(uint timestamp) internal view returns (uint) {
                                                        uint _waitingPeriodSecs = getWaitingPeriodSecs();
                                                        if (timestamp == 0 || now >= timestamp.add(_waitingPeriodSecs)) {
                                                            return 0;
                                                        }
                                                
                                                        return timestamp.add(_waitingPeriodSecs).sub(now);
                                                    }
                                                
                                                    function feeRateForExchange(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey)
                                                        external
                                                        view
                                                        returns (uint exchangeFeeRate)
                                                    {
                                                        exchangeFeeRate = _feeRateForExchange(sourceCurrencyKey, destinationCurrencyKey);
                                                    }
                                                
                                                    function _feeRateForExchange(
                                                        bytes32, // API for source in case pricing model evolves to include source rate /* sourceCurrencyKey */
                                                        bytes32 destinationCurrencyKey
                                                    ) internal view returns (uint exchangeFeeRate) {
                                                        return getExchangeFeeRate(destinationCurrencyKey);
                                                    }
                                                
                                                    function getAmountsForExchange(
                                                        uint sourceAmount,
                                                        bytes32 sourceCurrencyKey,
                                                        bytes32 destinationCurrencyKey
                                                    )
                                                        external
                                                        view
                                                        returns (
                                                            uint amountReceived,
                                                            uint fee,
                                                            uint exchangeFeeRate
                                                        )
                                                    {
                                                        (amountReceived, fee, exchangeFeeRate, , ) = _getAmountsForExchangeMinusFees(
                                                            sourceAmount,
                                                            sourceCurrencyKey,
                                                            destinationCurrencyKey
                                                        );
                                                    }
                                                
                                                    function _getAmountsForExchangeMinusFees(
                                                        uint sourceAmount,
                                                        bytes32 sourceCurrencyKey,
                                                        bytes32 destinationCurrencyKey
                                                    )
                                                        internal
                                                        view
                                                        returns (
                                                            uint amountReceived,
                                                            uint fee,
                                                            uint exchangeFeeRate,
                                                            uint sourceRate,
                                                            uint destinationRate
                                                        )
                                                    {
                                                        uint destinationAmount;
                                                        (destinationAmount, sourceRate, destinationRate) = exchangeRates().effectiveValueAndRates(
                                                            sourceCurrencyKey,
                                                            sourceAmount,
                                                            destinationCurrencyKey
                                                        );
                                                        exchangeFeeRate = _feeRateForExchange(sourceCurrencyKey, destinationCurrencyKey);
                                                        amountReceived = _getAmountReceivedForExchange(destinationAmount, exchangeFeeRate);
                                                        fee = destinationAmount.sub(amountReceived);
                                                    }
                                                
                                                    function _getAmountReceivedForExchange(uint destinationAmount, uint exchangeFeeRate)
                                                        internal
                                                        pure
                                                        returns (uint amountReceived)
                                                    {
                                                        amountReceived = destinationAmount.multiplyDecimal(SafeDecimalMath.unit().sub(exchangeFeeRate));
                                                    }
                                                
                                                    function appendExchange(
                                                        address account,
                                                        bytes32 src,
                                                        uint amount,
                                                        bytes32 dest,
                                                        uint amountReceived,
                                                        uint exchangeFeeRate
                                                    ) internal {
                                                        IExchangeRates exRates = exchangeRates();
                                                        uint roundIdForSrc = exRates.getCurrentRoundId(src);
                                                        uint roundIdForDest = exRates.getCurrentRoundId(dest);
                                                        exchangeState().appendExchangeEntry(
                                                            account,
                                                            src,
                                                            amount,
                                                            dest,
                                                            amountReceived,
                                                            exchangeFeeRate,
                                                            now,
                                                            roundIdForSrc,
                                                            roundIdForDest
                                                        );
                                                
                                                        emit ExchangeEntryAppended(
                                                            account,
                                                            src,
                                                            amount,
                                                            dest,
                                                            amountReceived,
                                                            exchangeFeeRate,
                                                            roundIdForSrc,
                                                            roundIdForDest
                                                        );
                                                    }
                                                
                                                    function getRoundIdsAtPeriodEnd(IExchangeState.ExchangeEntry memory exchangeEntry)
                                                        internal
                                                        view
                                                        returns (uint srcRoundIdAtPeriodEnd, uint destRoundIdAtPeriodEnd)
                                                    {
                                                        IExchangeRates exRates = exchangeRates();
                                                        uint _waitingPeriodSecs = getWaitingPeriodSecs();
                                                
                                                        srcRoundIdAtPeriodEnd = exRates.getLastRoundIdBeforeElapsedSecs(
                                                            exchangeEntry.src,
                                                            exchangeEntry.roundIdForSrc,
                                                            exchangeEntry.timestamp,
                                                            _waitingPeriodSecs
                                                        );
                                                        destRoundIdAtPeriodEnd = exRates.getLastRoundIdBeforeElapsedSecs(
                                                            exchangeEntry.dest,
                                                            exchangeEntry.roundIdForDest,
                                                            exchangeEntry.timestamp,
                                                            _waitingPeriodSecs
                                                        );
                                                    }
                                                
                                                    // ========== MODIFIERS ==========
                                                
                                                    modifier onlySynthetixorSynth() {
                                                        ISynthetix _synthetix = synthetix();
                                                        require(
                                                            msg.sender == address(_synthetix) || _synthetix.synthsByAddress(msg.sender) != bytes32(0),
                                                            "Exchanger: Only synthetix or a synth contract can perform this action"
                                                        );
                                                        _;
                                                    }
                                                
                                                    modifier onlyExchangeRates() {
                                                        IExchangeRates _exchangeRates = exchangeRates();
                                                        require(msg.sender == address(_exchangeRates), "Restricted to ExchangeRates");
                                                        _;
                                                    }
                                                
                                                    // ========== EVENTS ==========
                                                    event ExchangeEntryAppended(
                                                        address indexed account,
                                                        bytes32 src,
                                                        uint256 amount,
                                                        bytes32 dest,
                                                        uint256 amountReceived,
                                                        uint256 exchangeFeeRate,
                                                        uint256 roundIdForSrc,
                                                        uint256 roundIdForDest
                                                    );
                                                
                                                    event ExchangeEntrySettled(
                                                        address indexed from,
                                                        bytes32 src,
                                                        uint256 amount,
                                                        bytes32 dest,
                                                        uint256 reclaim,
                                                        uint256 rebate,
                                                        uint256 srcRoundIdAtPeriodEnd,
                                                        uint256 destRoundIdAtPeriodEnd,
                                                        uint256 exchangeTimestamp
                                                    );
                                                }
                                                
                                                    

                                                File 9 of 12: ExchangeState
                                                /*
                                                * Synthetix - ExchangeState.sol
                                                *
                                                * https://github.com/Synthetixio/synthetix
                                                * https://synthetix.io
                                                *
                                                * MIT License
                                                * ===========
                                                *
                                                * Copyright (c) 2020 Synthetix
                                                *
                                                * Permission is hereby granted, free of charge, to any person obtaining a copy
                                                * of this software and associated documentation files (the "Software"), to deal
                                                * in the Software without restriction, including without limitation the rights
                                                * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
                                                * copies of the Software, and to permit persons to whom the Software is
                                                * furnished to do so, subject to the following conditions:
                                                *
                                                * The above copyright notice and this permission notice shall be included in all
                                                * copies or substantial portions of the Software.
                                                *
                                                * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
                                                * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
                                                * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
                                                * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
                                                * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,	
                                                * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
                                                */
                                                    
                                                /* ===============================================
                                                * Flattened with Solidifier by Coinage
                                                * 
                                                * https://solidifier.coina.ge
                                                * ===============================================
                                                */
                                                
                                                
                                                /*
                                                -----------------------------------------------------------------
                                                FILE INFORMATION
                                                -----------------------------------------------------------------
                                                
                                                file:       Owned.sol
                                                version:    1.1
                                                author:     Anton Jurisevic
                                                            Dominic Romanowski
                                                
                                                date:       2018-2-26
                                                
                                                -----------------------------------------------------------------
                                                MODULE DESCRIPTION
                                                -----------------------------------------------------------------
                                                
                                                An Owned contract, to be inherited by other contracts.
                                                Requires its owner to be explicitly set in the constructor.
                                                Provides an onlyOwner access modifier.
                                                
                                                To change owner, the current owner must nominate the next owner,
                                                who then has to accept the nomination. The nomination can be
                                                cancelled before it is accepted by the new owner by having the
                                                previous owner change the nomination (setting it to 0).
                                                
                                                -----------------------------------------------------------------
                                                */
                                                
                                                pragma solidity 0.4.25;
                                                
                                                
                                                /**
                                                 * @title A contract with an owner.
                                                 * @notice Contract ownership can be transferred by first nominating the new owner,
                                                 * who must then accept the ownership, which prevents accidental incorrect ownership transfers.
                                                 */
                                                contract Owned {
                                                    address public owner;
                                                    address public nominatedOwner;
                                                
                                                    /**
                                                     * @dev Owned Constructor
                                                     */
                                                    constructor(address _owner) public {
                                                        require(_owner != address(0), "Owner address cannot be 0");
                                                        owner = _owner;
                                                        emit OwnerChanged(address(0), _owner);
                                                    }
                                                
                                                    /**
                                                     * @notice Nominate a new owner of this contract.
                                                     * @dev Only the current owner may nominate a new owner.
                                                     */
                                                    function nominateNewOwner(address _owner) external onlyOwner {
                                                        nominatedOwner = _owner;
                                                        emit OwnerNominated(_owner);
                                                    }
                                                
                                                    /**
                                                     * @notice Accept the nomination to be owner.
                                                     */
                                                    function acceptOwnership() external {
                                                        require(msg.sender == nominatedOwner, "You must be nominated before you can accept ownership");
                                                        emit OwnerChanged(owner, nominatedOwner);
                                                        owner = nominatedOwner;
                                                        nominatedOwner = address(0);
                                                    }
                                                
                                                    modifier onlyOwner {
                                                        require(msg.sender == owner, "Only the contract owner may perform this action");
                                                        _;
                                                    }
                                                
                                                    event OwnerNominated(address newOwner);
                                                    event OwnerChanged(address oldOwner, address newOwner);
                                                }
                                                
                                                
                                                /*
                                                -----------------------------------------------------------------
                                                FILE INFORMATION
                                                -----------------------------------------------------------------
                                                
                                                file:       State.sol
                                                version:    1.1
                                                author:     Dominic Romanowski
                                                            Anton Jurisevic
                                                
                                                date:       2018-05-15
                                                
                                                -----------------------------------------------------------------
                                                MODULE DESCRIPTION
                                                -----------------------------------------------------------------
                                                
                                                This contract is used side by side with external state token
                                                contracts, such as Synthetix and Synth.
                                                It provides an easy way to upgrade contract logic while
                                                maintaining all user balances and allowances. This is designed
                                                to make the changeover as easy as possible, since mappings
                                                are not so cheap or straightforward to migrate.
                                                
                                                The first deployed contract would create this state contract,
                                                using it as its store of balances.
                                                When a new contract is deployed, it links to the existing
                                                state contract, whose owner would then change its associated
                                                contract to the new one.
                                                
                                                -----------------------------------------------------------------
                                                */
                                                
                                                
                                                contract State is Owned {
                                                    // the address of the contract that can modify variables
                                                    // this can only be changed by the owner of this contract
                                                    address public associatedContract;
                                                
                                                    constructor(address _owner, address _associatedContract) public Owned(_owner) {
                                                        associatedContract = _associatedContract;
                                                        emit AssociatedContractUpdated(_associatedContract);
                                                    }
                                                
                                                    /* ========== SETTERS ========== */
                                                
                                                    // Change the associated contract to a new address
                                                    function setAssociatedContract(address _associatedContract) external onlyOwner {
                                                        associatedContract = _associatedContract;
                                                        emit AssociatedContractUpdated(_associatedContract);
                                                    }
                                                
                                                    /* ========== MODIFIERS ========== */
                                                
                                                    modifier onlyAssociatedContract {
                                                        require(msg.sender == associatedContract, "Only the associated contract can perform this action");
                                                        _;
                                                    }
                                                
                                                    /* ========== EVENTS ========== */
                                                
                                                    event AssociatedContractUpdated(address associatedContract);
                                                }
                                                
                                                
                                                contract ExchangeState is State {
                                                    struct ExchangeEntry {
                                                        bytes32 src;
                                                        uint amount;
                                                        bytes32 dest;
                                                        uint amountReceived;
                                                        uint exchangeFeeRate;
                                                        uint timestamp;
                                                        uint roundIdForSrc;
                                                        uint roundIdForDest;
                                                    }
                                                
                                                    mapping(address => mapping(bytes32 => ExchangeEntry[])) public exchanges;
                                                
                                                    uint public maxEntriesInQueue = 12;
                                                
                                                    constructor(address _owner, address _associatedContract) public State(_owner, _associatedContract) {}
                                                
                                                    /* ========== SETTERS ========== */
                                                
                                                    function setMaxEntriesInQueue(uint _maxEntriesInQueue) external onlyOwner {
                                                        maxEntriesInQueue = _maxEntriesInQueue;
                                                    }
                                                
                                                    /* ========== MUTATIVE FUNCTIONS ========== */
                                                
                                                    function appendExchangeEntry(
                                                        address account,
                                                        bytes32 src,
                                                        uint amount,
                                                        bytes32 dest,
                                                        uint amountReceived,
                                                        uint exchangeFeeRate,
                                                        uint timestamp,
                                                        uint roundIdForSrc,
                                                        uint roundIdForDest
                                                    ) external onlyAssociatedContract {
                                                        require(exchanges[account][dest].length < maxEntriesInQueue, "Max queue length reached");
                                                
                                                        exchanges[account][dest].push(
                                                            ExchangeEntry({
                                                                src: src,
                                                                amount: amount,
                                                                dest: dest,
                                                                amountReceived: amountReceived,
                                                                exchangeFeeRate: exchangeFeeRate,
                                                                timestamp: timestamp,
                                                                roundIdForSrc: roundIdForSrc,
                                                                roundIdForDest: roundIdForDest
                                                            })
                                                        );
                                                    }
                                                
                                                    function removeEntries(address account, bytes32 currencyKey) external onlyAssociatedContract {
                                                        delete exchanges[account][currencyKey];
                                                    }
                                                
                                                    /* ========== VIEWS ========== */
                                                
                                                    function getLengthOfEntries(address account, bytes32 currencyKey) external view returns (uint) {
                                                        return exchanges[account][currencyKey].length;
                                                    }
                                                
                                                    function getEntryAt(address account, bytes32 currencyKey, uint index)
                                                        external
                                                        view
                                                        returns (
                                                            bytes32 src,
                                                            uint amount,
                                                            bytes32 dest,
                                                            uint amountReceived,
                                                            uint exchangeFeeRate,
                                                            uint timestamp,
                                                            uint roundIdForSrc,
                                                            uint roundIdForDest
                                                        )
                                                    {
                                                        ExchangeEntry storage entry = exchanges[account][currencyKey][index];
                                                        return (
                                                            entry.src,
                                                            entry.amount,
                                                            entry.dest,
                                                            entry.amountReceived,
                                                            entry.exchangeFeeRate,
                                                            entry.timestamp,
                                                            entry.roundIdForSrc,
                                                            entry.roundIdForDest
                                                        );
                                                    }
                                                
                                                    function getMaxTimestamp(address account, bytes32 currencyKey) external view returns (uint) {
                                                        ExchangeEntry[] storage userEntries = exchanges[account][currencyKey];
                                                        uint timestamp = 0;
                                                        for (uint i = 0; i < userEntries.length; i++) {
                                                            if (userEntries[i].timestamp > timestamp) {
                                                                timestamp = userEntries[i].timestamp;
                                                            }
                                                        }
                                                        return timestamp;
                                                    }
                                                }
                                                
                                                
                                                    

                                                File 10 of 12: FlexibleStorage
                                                /*
                                                   ____            __   __        __   _
                                                  / __/__ __ ___  / /_ / /  ___  / /_ (_)__ __
                                                 _\ \ / // // _ \/ __// _ \/ -_)/ __// / \ \ /
                                                /___/ \_, //_//_/\__//_//_/\__/ \__//_/ /_\_\
                                                     /___/
                                                
                                                * Synthetix: FlexibleStorage.sol
                                                *
                                                * Latest source (may be newer): https://github.com/Synthetixio/synthetix/blob/master/contracts/FlexibleStorage.sol
                                                * Docs: https://docs.synthetix.io/contracts/FlexibleStorage
                                                *
                                                * Contract Dependencies: 
                                                *	- ContractStorage
                                                *	- IFlexibleStorage
                                                * Libraries: (none)
                                                *
                                                * MIT License
                                                * ===========
                                                *
                                                * Copyright (c) 2020 Synthetix
                                                *
                                                * Permission is hereby granted, free of charge, to any person obtaining a copy
                                                * of this software and associated documentation files (the "Software"), to deal
                                                * in the Software without restriction, including without limitation the rights
                                                * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
                                                * copies of the Software, and to permit persons to whom the Software is
                                                * furnished to do so, subject to the following conditions:
                                                *
                                                * The above copyright notice and this permission notice shall be included in all
                                                * copies or substantial portions of the Software.
                                                *
                                                * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
                                                * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
                                                * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
                                                * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
                                                * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
                                                * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
                                                */
                                                
                                                
                                                
                                                pragma solidity >=0.4.24;
                                                
                                                
                                                interface IAddressResolver {
                                                    function getAddress(bytes32 name) external view returns (address);
                                                
                                                    function getSynth(bytes32 key) external view returns (address);
                                                
                                                    function requireAndGetAddress(bytes32 name, string calldata reason) external view returns (address);
                                                }
                                                
                                                
                                                // Internal References
                                                
                                                
                                                // https://docs.synthetix.io/contracts/source/contracts/ContractStorage
                                                contract ContractStorage {
                                                    IAddressResolver public resolverProxy;
                                                
                                                    mapping(bytes32 => bytes32) public hashes;
                                                
                                                    constructor(address _resolver) internal {
                                                        // ReadProxyAddressResolver
                                                        resolverProxy = IAddressResolver(_resolver);
                                                    }
                                                
                                                    /* ========== INTERNAL FUNCTIONS ========== */
                                                
                                                    function _memoizeHash(bytes32 contractName) internal returns (bytes32) {
                                                        bytes32 hashKey = hashes[contractName];
                                                        if (hashKey == bytes32(0)) {
                                                            // set to unique hash at the time of creation
                                                            hashKey = keccak256(abi.encodePacked(msg.sender, contractName, block.number));
                                                            hashes[contractName] = hashKey;
                                                        }
                                                        return hashKey;
                                                    }
                                                
                                                    /* ========== VIEWS ========== */
                                                
                                                    /* ========== RESTRICTED FUNCTIONS ========== */
                                                
                                                    function migrateContractKey(
                                                        bytes32 fromContractName,
                                                        bytes32 toContractName,
                                                        bool removeAccessFromPreviousContract
                                                    ) external onlyContract(fromContractName) {
                                                        require(hashes[fromContractName] != bytes32(0), "Cannot migrate empty contract");
                                                
                                                        hashes[toContractName] = hashes[fromContractName];
                                                
                                                        if (removeAccessFromPreviousContract) {
                                                            delete hashes[fromContractName];
                                                        }
                                                
                                                        emit KeyMigrated(fromContractName, toContractName, removeAccessFromPreviousContract);
                                                    }
                                                
                                                    /* ========== MODIFIERS ========== */
                                                
                                                    modifier onlyContract(bytes32 contractName) {
                                                        address callingContract = resolverProxy.requireAndGetAddress(
                                                            contractName,
                                                            "Cannot find contract in Address Resolver"
                                                        );
                                                        require(callingContract == msg.sender, "Can only be invoked by the configured contract");
                                                        _;
                                                    }
                                                
                                                    /* ========== EVENTS ========== */
                                                
                                                    event KeyMigrated(bytes32 fromContractName, bytes32 toContractName, bool removeAccessFromPreviousContract);
                                                }
                                                
                                                
                                                interface IFlexibleStorage {
                                                    // Views
                                                    function getUIntValue(bytes32 contractName, bytes32 record) external view returns (uint);
                                                
                                                    function getUIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (uint[] memory);
                                                
                                                    function getIntValue(bytes32 contractName, bytes32 record) external view returns (int);
                                                
                                                    function getIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (int[] memory);
                                                
                                                    function getAddressValue(bytes32 contractName, bytes32 record) external view returns (address);
                                                
                                                    function getAddressValues(bytes32 contractName, bytes32[] calldata records) external view returns (address[] memory);
                                                
                                                    function getBoolValue(bytes32 contractName, bytes32 record) external view returns (bool);
                                                
                                                    function getBoolValues(bytes32 contractName, bytes32[] calldata records) external view returns (bool[] memory);
                                                
                                                    function getBytes32Value(bytes32 contractName, bytes32 record) external view returns (bytes32);
                                                
                                                    function getBytes32Values(bytes32 contractName, bytes32[] calldata records) external view returns (bytes32[] memory);
                                                
                                                    // Mutative functions
                                                    function deleteUIntValue(bytes32 contractName, bytes32 record) external;
                                                
                                                    function deleteIntValue(bytes32 contractName, bytes32 record) external;
                                                
                                                    function deleteAddressValue(bytes32 contractName, bytes32 record) external;
                                                
                                                    function deleteBoolValue(bytes32 contractName, bytes32 record) external;
                                                
                                                    function deleteBytes32Value(bytes32 contractName, bytes32 record) external;
                                                
                                                    function setUIntValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        uint value
                                                    ) external;
                                                
                                                    function setUIntValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        uint[] calldata values
                                                    ) external;
                                                
                                                    function setIntValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        int value
                                                    ) external;
                                                
                                                    function setIntValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        int[] calldata values
                                                    ) external;
                                                
                                                    function setAddressValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        address value
                                                    ) external;
                                                
                                                    function setAddressValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        address[] calldata values
                                                    ) external;
                                                
                                                    function setBoolValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        bool value
                                                    ) external;
                                                
                                                    function setBoolValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        bool[] calldata values
                                                    ) external;
                                                
                                                    function setBytes32Value(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        bytes32 value
                                                    ) external;
                                                
                                                    function setBytes32Values(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        bytes32[] calldata values
                                                    ) external;
                                                }
                                                
                                                
                                                // Inheritance
                                                
                                                
                                                // Internal References
                                                
                                                
                                                // https://docs.synthetix.io/contracts/source/contracts/FlexibleStorage
                                                contract FlexibleStorage is ContractStorage, IFlexibleStorage {
                                                    mapping(bytes32 => mapping(bytes32 => uint)) internal uintStorage;
                                                    mapping(bytes32 => mapping(bytes32 => int)) internal intStorage;
                                                    mapping(bytes32 => mapping(bytes32 => address)) internal addressStorage;
                                                    mapping(bytes32 => mapping(bytes32 => bool)) internal boolStorage;
                                                    mapping(bytes32 => mapping(bytes32 => bytes32)) internal bytes32Storage;
                                                
                                                    constructor(address _resolver) public ContractStorage(_resolver) {}
                                                
                                                    /* ========== INTERNAL FUNCTIONS ========== */
                                                
                                                    function _setUIntValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        uint value
                                                    ) internal {
                                                        uintStorage[_memoizeHash(contractName)][record] = value;
                                                        emit ValueSetUInt(contractName, record, value);
                                                    }
                                                
                                                    function _setIntValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        int value
                                                    ) internal {
                                                        intStorage[_memoizeHash(contractName)][record] = value;
                                                        emit ValueSetInt(contractName, record, value);
                                                    }
                                                
                                                    function _setAddressValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        address value
                                                    ) internal {
                                                        addressStorage[_memoizeHash(contractName)][record] = value;
                                                        emit ValueSetAddress(contractName, record, value);
                                                    }
                                                
                                                    function _setBoolValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        bool value
                                                    ) internal {
                                                        boolStorage[_memoizeHash(contractName)][record] = value;
                                                        emit ValueSetBool(contractName, record, value);
                                                    }
                                                
                                                    function _setBytes32Value(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        bytes32 value
                                                    ) internal {
                                                        bytes32Storage[_memoizeHash(contractName)][record] = value;
                                                        emit ValueSetBytes32(contractName, record, value);
                                                    }
                                                
                                                    /* ========== VIEWS ========== */
                                                
                                                    function getUIntValue(bytes32 contractName, bytes32 record) external view returns (uint) {
                                                        return uintStorage[hashes[contractName]][record];
                                                    }
                                                
                                                    function getUIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (uint[] memory) {
                                                        uint[] memory results = new uint[](records.length);
                                                
                                                        mapping(bytes32 => uint) storage data = uintStorage[hashes[contractName]];
                                                        for (uint i = 0; i < records.length; i++) {
                                                            results[i] = data[records[i]];
                                                        }
                                                        return results;
                                                    }
                                                
                                                    function getIntValue(bytes32 contractName, bytes32 record) external view returns (int) {
                                                        return intStorage[hashes[contractName]][record];
                                                    }
                                                
                                                    function getIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (int[] memory) {
                                                        int[] memory results = new int[](records.length);
                                                
                                                        mapping(bytes32 => int) storage data = intStorage[hashes[contractName]];
                                                        for (uint i = 0; i < records.length; i++) {
                                                            results[i] = data[records[i]];
                                                        }
                                                        return results;
                                                    }
                                                
                                                    function getAddressValue(bytes32 contractName, bytes32 record) external view returns (address) {
                                                        return addressStorage[hashes[contractName]][record];
                                                    }
                                                
                                                    function getAddressValues(bytes32 contractName, bytes32[] calldata records) external view returns (address[] memory) {
                                                        address[] memory results = new address[](records.length);
                                                
                                                        mapping(bytes32 => address) storage data = addressStorage[hashes[contractName]];
                                                        for (uint i = 0; i < records.length; i++) {
                                                            results[i] = data[records[i]];
                                                        }
                                                        return results;
                                                    }
                                                
                                                    function getBoolValue(bytes32 contractName, bytes32 record) external view returns (bool) {
                                                        return boolStorage[hashes[contractName]][record];
                                                    }
                                                
                                                    function getBoolValues(bytes32 contractName, bytes32[] calldata records) external view returns (bool[] memory) {
                                                        bool[] memory results = new bool[](records.length);
                                                
                                                        mapping(bytes32 => bool) storage data = boolStorage[hashes[contractName]];
                                                        for (uint i = 0; i < records.length; i++) {
                                                            results[i] = data[records[i]];
                                                        }
                                                        return results;
                                                    }
                                                
                                                    function getBytes32Value(bytes32 contractName, bytes32 record) external view returns (bytes32) {
                                                        return bytes32Storage[hashes[contractName]][record];
                                                    }
                                                
                                                    function getBytes32Values(bytes32 contractName, bytes32[] calldata records) external view returns (bytes32[] memory) {
                                                        bytes32[] memory results = new bytes32[](records.length);
                                                
                                                        mapping(bytes32 => bytes32) storage data = bytes32Storage[hashes[contractName]];
                                                        for (uint i = 0; i < records.length; i++) {
                                                            results[i] = data[records[i]];
                                                        }
                                                        return results;
                                                    }
                                                
                                                    /* ========== RESTRICTED FUNCTIONS ========== */
                                                    function setUIntValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        uint value
                                                    ) external onlyContract(contractName) {
                                                        _setUIntValue(contractName, record, value);
                                                    }
                                                
                                                    function setUIntValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        uint[] calldata values
                                                    ) external onlyContract(contractName) {
                                                        require(records.length == values.length, "Input lengths must match");
                                                
                                                        for (uint i = 0; i < records.length; i++) {
                                                            _setUIntValue(contractName, records[i], values[i]);
                                                        }
                                                    }
                                                
                                                    function deleteUIntValue(bytes32 contractName, bytes32 record) external onlyContract(contractName) {
                                                        uint value = uintStorage[hashes[contractName]][record];
                                                        emit ValueDeletedUInt(contractName, record, value);
                                                        delete uintStorage[hashes[contractName]][record];
                                                    }
                                                
                                                    function setIntValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        int value
                                                    ) external onlyContract(contractName) {
                                                        _setIntValue(contractName, record, value);
                                                    }
                                                
                                                    function setIntValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        int[] calldata values
                                                    ) external onlyContract(contractName) {
                                                        require(records.length == values.length, "Input lengths must match");
                                                
                                                        for (uint i = 0; i < records.length; i++) {
                                                            _setIntValue(contractName, records[i], values[i]);
                                                        }
                                                    }
                                                
                                                    function deleteIntValue(bytes32 contractName, bytes32 record) external onlyContract(contractName) {
                                                        int value = intStorage[hashes[contractName]][record];
                                                        emit ValueDeletedInt(contractName, record, value);
                                                        delete intStorage[hashes[contractName]][record];
                                                    }
                                                
                                                    function setAddressValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        address value
                                                    ) external onlyContract(contractName) {
                                                        _setAddressValue(contractName, record, value);
                                                    }
                                                
                                                    function setAddressValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        address[] calldata values
                                                    ) external onlyContract(contractName) {
                                                        require(records.length == values.length, "Input lengths must match");
                                                
                                                        for (uint i = 0; i < records.length; i++) {
                                                            _setAddressValue(contractName, records[i], values[i]);
                                                        }
                                                    }
                                                
                                                    function deleteAddressValue(bytes32 contractName, bytes32 record) external onlyContract(contractName) {
                                                        address value = addressStorage[hashes[contractName]][record];
                                                        emit ValueDeletedAddress(contractName, record, value);
                                                        delete addressStorage[hashes[contractName]][record];
                                                    }
                                                
                                                    function setBoolValue(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        bool value
                                                    ) external onlyContract(contractName) {
                                                        _setBoolValue(contractName, record, value);
                                                    }
                                                
                                                    function setBoolValues(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        bool[] calldata values
                                                    ) external onlyContract(contractName) {
                                                        require(records.length == values.length, "Input lengths must match");
                                                
                                                        for (uint i = 0; i < records.length; i++) {
                                                            _setBoolValue(contractName, records[i], values[i]);
                                                        }
                                                    }
                                                
                                                    function deleteBoolValue(bytes32 contractName, bytes32 record) external onlyContract(contractName) {
                                                        bool value = boolStorage[hashes[contractName]][record];
                                                        emit ValueDeletedBool(contractName, record, value);
                                                        delete boolStorage[hashes[contractName]][record];
                                                    }
                                                
                                                    function setBytes32Value(
                                                        bytes32 contractName,
                                                        bytes32 record,
                                                        bytes32 value
                                                    ) external onlyContract(contractName) {
                                                        _setBytes32Value(contractName, record, value);
                                                    }
                                                
                                                    function setBytes32Values(
                                                        bytes32 contractName,
                                                        bytes32[] calldata records,
                                                        bytes32[] calldata values
                                                    ) external onlyContract(contractName) {
                                                        require(records.length == values.length, "Input lengths must match");
                                                
                                                        for (uint i = 0; i < records.length; i++) {
                                                            _setBytes32Value(contractName, records[i], values[i]);
                                                        }
                                                    }
                                                
                                                    function deleteBytes32Value(bytes32 contractName, bytes32 record) external onlyContract(contractName) {
                                                        bytes32 value = bytes32Storage[hashes[contractName]][record];
                                                        emit ValueDeletedBytes32(contractName, record, value);
                                                        delete bytes32Storage[hashes[contractName]][record];
                                                    }
                                                
                                                    /* ========== EVENTS ========== */
                                                
                                                    event ValueSetUInt(bytes32 contractName, bytes32 record, uint value);
                                                    event ValueDeletedUInt(bytes32 contractName, bytes32 record, uint value);
                                                
                                                    event ValueSetInt(bytes32 contractName, bytes32 record, int value);
                                                    event ValueDeletedInt(bytes32 contractName, bytes32 record, int value);
                                                
                                                    event ValueSetAddress(bytes32 contractName, bytes32 record, address value);
                                                    event ValueDeletedAddress(bytes32 contractName, bytes32 record, address value);
                                                
                                                    event ValueSetBool(bytes32 contractName, bytes32 record, bool value);
                                                    event ValueDeletedBool(bytes32 contractName, bytes32 record, bool value);
                                                
                                                    event ValueSetBytes32(bytes32 contractName, bytes32 record, bytes32 value);
                                                    event ValueDeletedBytes32(bytes32 contractName, bytes32 record, bytes32 value);
                                                }
                                                
                                                    

                                                File 11 of 12: TokenState
                                                /*
                                                 * Nomin TokenState Contract
                                                 *
                                                 * Stores ERC20 balance and approval information for the
                                                 * nomin component of the Havven stablecoin system.
                                                 *
                                                 * version: nUSDa.1
                                                 * date: 29 Jun 2018
                                                 * url: https://github.com/Havven/havven/releases/tag/nUSDa.1
                                                 */
                                                 
                                                 
                                                pragma solidity 0.4.24;
                                                 
                                                 
                                                /*
                                                -----------------------------------------------------------------
                                                FILE INFORMATION
                                                -----------------------------------------------------------------
                                                 
                                                file:       Owned.sol
                                                version:    1.1
                                                author:     Anton Jurisevic
                                                            Dominic Romanowski
                                                 
                                                date:       2018-2-26
                                                 
                                                -----------------------------------------------------------------
                                                MODULE DESCRIPTION
                                                -----------------------------------------------------------------
                                                 
                                                An Owned contract, to be inherited by other contracts.
                                                Requires its owner to be explicitly set in the constructor.
                                                Provides an onlyOwner access modifier.
                                                 
                                                To change owner, the current owner must nominate the next owner,
                                                who then has to accept the nomination. The nomination can be
                                                cancelled before it is accepted by the new owner by having the
                                                previous owner change the nomination (setting it to 0).
                                                 
                                                -----------------------------------------------------------------
                                                */
                                                 
                                                 
                                                /**
                                                 * @title A contract with an owner.
                                                 * @notice Contract ownership can be transferred by first nominating the new owner,
                                                 * who must then accept the ownership, which prevents accidental incorrect ownership transfers.
                                                 */
                                                contract Owned {
                                                    address public owner;
                                                    address public nominatedOwner;
                                                 
                                                    /**
                                                     * @dev Owned Constructor
                                                     */
                                                    constructor(address _owner)
                                                        public
                                                    {
                                                        require(_owner != address(0));
                                                        owner = _owner;
                                                        emit OwnerChanged(address(0), _owner);
                                                    }
                                                 
                                                    /**
                                                     * @notice Nominate a new owner of this contract.
                                                     * @dev Only the current owner may nominate a new owner.
                                                     */
                                                    function nominateNewOwner(address _owner)
                                                        external
                                                        onlyOwner
                                                    {
                                                        nominatedOwner = _owner;
                                                        emit OwnerNominated(_owner);
                                                    }
                                                 
                                                    /**
                                                     * @notice Accept the nomination to be owner.
                                                     */
                                                    function acceptOwnership()
                                                        external
                                                    {
                                                        require(msg.sender == nominatedOwner);
                                                        emit OwnerChanged(owner, nominatedOwner);
                                                        owner = nominatedOwner;
                                                        nominatedOwner = address(0);
                                                    }
                                                 
                                                    modifier onlyOwner
                                                    {
                                                        require(msg.sender == owner);
                                                        _;
                                                    }
                                                 
                                                    event OwnerNominated(address newOwner);
                                                    event OwnerChanged(address oldOwner, address newOwner);
                                                }
                                                 
                                                 
                                                /*
                                                -----------------------------------------------------------------
                                                FILE INFORMATION
                                                -----------------------------------------------------------------
                                                 
                                                file:       State.sol
                                                version:    1.1
                                                author:     Dominic Romanowski
                                                            Anton Jurisevic
                                                 
                                                date:       2018-05-15
                                                 
                                                -----------------------------------------------------------------
                                                MODULE DESCRIPTION
                                                -----------------------------------------------------------------
                                                 
                                                This contract is used side by side with external state token
                                                contracts, such as Havven and Nomin.
                                                It provides an easy way to upgrade contract logic while
                                                maintaining all user balances and allowances. This is designed
                                                to make the changeover as easy as possible, since mappings
                                                are not so cheap or straightforward to migrate.
                                                 
                                                The first deployed contract would create this state contract,
                                                using it as its store of balances.
                                                When a new contract is deployed, it links to the existing
                                                state contract, whose owner would then change its associated
                                                contract to the new one.
                                                 
                                                -----------------------------------------------------------------
                                                */
                                                 
                                                 
                                                contract State is Owned {
                                                    // the address of the contract that can modify variables
                                                    // this can only be changed by the owner of this contract
                                                    address public associatedContract;
                                                 
                                                 
                                                    constructor(address _owner, address _associatedContract)
                                                        Owned(_owner)
                                                        public
                                                    {
                                                        associatedContract = _associatedContract;
                                                        emit AssociatedContractUpdated(_associatedContract);
                                                    }
                                                 
                                                    /* ========== SETTERS ========== */
                                                 
                                                    // Change the associated contract to a new address
                                                    function setAssociatedContract(address _associatedContract)
                                                        external
                                                        onlyOwner
                                                    {
                                                        associatedContract = _associatedContract;
                                                        emit AssociatedContractUpdated(_associatedContract);
                                                    }
                                                 
                                                    /* ========== MODIFIERS ========== */
                                                 
                                                    modifier onlyAssociatedContract
                                                    {
                                                        require(msg.sender == associatedContract);
                                                        _;
                                                    }
                                                 
                                                    /* ========== EVENTS ========== */
                                                 
                                                    event AssociatedContractUpdated(address associatedContract);
                                                }
                                                 
                                                 
                                                /*
                                                -----------------------------------------------------------------
                                                FILE INFORMATION
                                                -----------------------------------------------------------------
                                                 
                                                file:       TokenState.sol
                                                version:    1.1
                                                author:     Dominic Romanowski
                                                            Anton Jurisevic
                                                 
                                                date:       2018-05-15
                                                 
                                                -----------------------------------------------------------------
                                                MODULE DESCRIPTION
                                                -----------------------------------------------------------------
                                                 
                                                A contract that holds the state of an ERC20 compliant token.
                                                 
                                                This contract is used side by side with external state token
                                                contracts, such as Havven and Nomin.
                                                It provides an easy way to upgrade contract logic while
                                                maintaining all user balances and allowances. This is designed
                                                to make the changeover as easy as possible, since mappings
                                                are not so cheap or straightforward to migrate.
                                                 
                                                The first deployed contract would create this state contract,
                                                using it as its store of balances.
                                                When a new contract is deployed, it links to the existing
                                                state contract, whose owner would then change its associated
                                                contract to the new one.
                                                 
                                                -----------------------------------------------------------------
                                                */
                                                 
                                                 
                                                /**
                                                 * @title ERC20 Token State
                                                 * @notice Stores balance information of an ERC20 token contract.
                                                 */
                                                contract TokenState is State {
                                                 
                                                    /* ERC20 fields. */
                                                    mapping(address => uint) public balanceOf;
                                                    mapping(address => mapping(address => uint)) public allowance;
                                                 
                                                    /**
                                                     * @dev Constructor
                                                     * @param _owner The address which controls this contract.
                                                     * @param _associatedContract The ERC20 contract whose state this composes.
                                                     */
                                                    constructor(address _owner, address _associatedContract)
                                                        State(_owner, _associatedContract)
                                                        public
                                                    {}
                                                 
                                                    /* ========== SETTERS ========== */
                                                 
                                                    /**
                                                     * @notice Set ERC20 allowance.
                                                     * @dev Only the associated contract may call this.
                                                     * @param tokenOwner The authorising party.
                                                     * @param spender The authorised party.
                                                     * @param value The total value the authorised party may spend on the
                                                     * authorising party's behalf.
                                                     */
                                                    function setAllowance(address tokenOwner, address spender, uint value)
                                                        external
                                                        onlyAssociatedContract
                                                    {
                                                        allowance[tokenOwner][spender] = value;
                                                    }
                                                 
                                                    /**
                                                     * @notice Set the balance in a given account
                                                     * @dev Only the associated contract may call this.
                                                     * @param account The account whose value to set.
                                                     * @param value The new balance of the given account.
                                                     */
                                                    function setBalanceOf(address account, uint value)
                                                        external
                                                        onlyAssociatedContract
                                                    {
                                                        balanceOf[account] = value;
                                                    }
                                                }

                                                File 12 of 12: SystemStatus
                                                /*
                                                   ____            __   __        __   _
                                                  / __/__ __ ___  / /_ / /  ___  / /_ (_)__ __
                                                 _\ \ / // // _ \/ __// _ \/ -_)/ __// / \ \ /
                                                /___/ \_, //_//_/\__//_//_/\__/ \__//_/ /_\_\
                                                     /___/
                                                
                                                * Synthetix: SystemStatus.sol
                                                *
                                                * Latest source (may be newer): https://github.com/Synthetixio/synthetix/blob/master/contracts/SystemStatus.sol
                                                * Docs: https://docs.synthetix.io/contracts/SystemStatus
                                                *
                                                * Contract Dependencies: 
                                                *	- Owned
                                                * Libraries: (none)
                                                *
                                                * MIT License
                                                * ===========
                                                *
                                                * Copyright (c) 2020 Synthetix
                                                *
                                                * Permission is hereby granted, free of charge, to any person obtaining a copy
                                                * of this software and associated documentation files (the "Software"), to deal
                                                * in the Software without restriction, including without limitation the rights
                                                * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
                                                * copies of the Software, and to permit persons to whom the Software is
                                                * furnished to do so, subject to the following conditions:
                                                *
                                                * The above copyright notice and this permission notice shall be included in all
                                                * copies or substantial portions of the Software.
                                                *
                                                * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
                                                * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
                                                * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
                                                * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
                                                * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
                                                * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
                                                */
                                                
                                                /* ===============================================
                                                * Flattened with Solidifier by Coinage
                                                * 
                                                * https://solidifier.coina.ge
                                                * ===============================================
                                                */
                                                
                                                
                                                pragma solidity 0.4.25;
                                                
                                                
                                                // https://docs.synthetix.io/contracts/Owned
                                                contract Owned {
                                                    address public owner;
                                                    address public nominatedOwner;
                                                
                                                    /**
                                                     * @dev Owned Constructor
                                                     */
                                                    constructor(address _owner) public {
                                                        require(_owner != address(0), "Owner address cannot be 0");
                                                        owner = _owner;
                                                        emit OwnerChanged(address(0), _owner);
                                                    }
                                                
                                                    /**
                                                     * @notice Nominate a new owner of this contract.
                                                     * @dev Only the current owner may nominate a new owner.
                                                     */
                                                    function nominateNewOwner(address _owner) external onlyOwner {
                                                        nominatedOwner = _owner;
                                                        emit OwnerNominated(_owner);
                                                    }
                                                
                                                    /**
                                                     * @notice Accept the nomination to be owner.
                                                     */
                                                    function acceptOwnership() external {
                                                        require(msg.sender == nominatedOwner, "You must be nominated before you can accept ownership");
                                                        emit OwnerChanged(owner, nominatedOwner);
                                                        owner = nominatedOwner;
                                                        nominatedOwner = address(0);
                                                    }
                                                
                                                    modifier onlyOwner {
                                                        require(msg.sender == owner, "Only the contract owner may perform this action");
                                                        _;
                                                    }
                                                
                                                    event OwnerNominated(address newOwner);
                                                    event OwnerChanged(address oldOwner, address newOwner);
                                                }
                                                
                                                
                                                // https://docs.synthetix.io/contracts/SystemStatus
                                                contract SystemStatus is Owned {
                                                    struct Status {
                                                        bool canSuspend;
                                                        bool canResume;
                                                    }
                                                
                                                    mapping(bytes32 => mapping(address => Status)) public accessControl;
                                                
                                                    struct Suspension {
                                                        bool suspended;
                                                        // reason is an integer code,
                                                        // 0 => no reason, 1 => upgrading, 2+ => defined by system usage
                                                        uint248 reason;
                                                    }
                                                
                                                    uint248 public constant SUSPENSION_REASON_UPGRADE = 1;
                                                
                                                    bytes32 public constant SECTION_SYSTEM = "System";
                                                    bytes32 public constant SECTION_ISSUANCE = "Issuance";
                                                    bytes32 public constant SECTION_EXCHANGE = "Exchange";
                                                    bytes32 public constant SECTION_SYNTH = "Synth";
                                                
                                                    Suspension public systemSuspension;
                                                
                                                    Suspension public issuanceSuspension;
                                                
                                                    Suspension public exchangeSuspension;
                                                
                                                    mapping(bytes32 => Suspension) public synthSuspension;
                                                
                                                    constructor(address _owner) public Owned(_owner) {
                                                        _internalUpdateAccessControl(SECTION_SYSTEM, _owner, true, true);
                                                        _internalUpdateAccessControl(SECTION_ISSUANCE, _owner, true, true);
                                                        _internalUpdateAccessControl(SECTION_EXCHANGE, _owner, true, true);
                                                        _internalUpdateAccessControl(SECTION_SYNTH, _owner, true, true);
                                                    }
                                                
                                                    /* ========== VIEWS ========== */
                                                    function requireSystemActive() external view {
                                                        _internalRequireSystemActive();
                                                    }
                                                
                                                    function requireIssuanceActive() external view {
                                                        // Issuance requires the system be active
                                                        _internalRequireSystemActive();
                                                        require(!issuanceSuspension.suspended, "Issuance is suspended. Operation prohibited");
                                                    }
                                                
                                                    function requireExchangeActive() external view {
                                                        // Issuance requires the system be active
                                                        _internalRequireSystemActive();
                                                        require(!exchangeSuspension.suspended, "Exchange is suspended. Operation prohibited");
                                                    }
                                                
                                                    function requireSynthActive(bytes32 currencyKey) external view {
                                                        // Synth exchange and transfer requires the system be active
                                                        _internalRequireSystemActive();
                                                        require(!synthSuspension[currencyKey].suspended, "Synth is suspended. Operation prohibited");
                                                    }
                                                
                                                    function requireSynthsActive(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey) external view {
                                                        // Synth exchange and transfer requires the system be active
                                                        _internalRequireSystemActive();
                                                
                                                        require(
                                                            !synthSuspension[sourceCurrencyKey].suspended && !synthSuspension[destinationCurrencyKey].suspended,
                                                            "One or more synths are suspended. Operation prohibited"
                                                        );
                                                    }
                                                
                                                    function isSystemUpgrading() external view returns (bool) {
                                                        return systemSuspension.suspended && systemSuspension.reason == SUSPENSION_REASON_UPGRADE;
                                                    }
                                                
                                                    function getSynthSuspensions(bytes32[] synths)
                                                        external
                                                        view
                                                        returns (bool[] memory suspensions, uint256[] memory reasons)
                                                    {
                                                        suspensions = new bool[](synths.length);
                                                        reasons = new uint256[](synths.length);
                                                
                                                        for (uint i = 0; i < synths.length; i++) {
                                                            suspensions[i] = synthSuspension[synths[i]].suspended;
                                                            reasons[i] = synthSuspension[synths[i]].reason;
                                                        }
                                                    }
                                                
                                                    /* ========== MUTATIVE FUNCTIONS ========== */
                                                    function updateAccessControl(bytes32 section, address account, bool canSuspend, bool canResume) external onlyOwner {
                                                        _internalUpdateAccessControl(section, account, canSuspend, canResume);
                                                    }
                                                
                                                    function suspendSystem(uint256 reason) external {
                                                        _requireAccessToSuspend(SECTION_SYSTEM);
                                                        systemSuspension.suspended = true;
                                                        systemSuspension.reason = uint248(reason);
                                                        emit SystemSuspended(systemSuspension.reason);
                                                    }
                                                
                                                    function resumeSystem() external {
                                                        _requireAccessToResume(SECTION_SYSTEM);
                                                        systemSuspension.suspended = false;
                                                        emit SystemResumed(uint256(systemSuspension.reason));
                                                        systemSuspension.reason = 0;
                                                    }
                                                
                                                    function suspendIssuance(uint256 reason) external {
                                                        _requireAccessToSuspend(SECTION_ISSUANCE);
                                                        issuanceSuspension.suspended = true;
                                                        issuanceSuspension.reason = uint248(reason);
                                                        emit IssuanceSuspended(reason);
                                                    }
                                                
                                                    function resumeIssuance() external {
                                                        _requireAccessToResume(SECTION_ISSUANCE);
                                                        issuanceSuspension.suspended = false;
                                                        emit IssuanceResumed(uint256(issuanceSuspension.reason));
                                                        issuanceSuspension.reason = 0;
                                                    }
                                                
                                                    function suspendExchange(uint256 reason) external {
                                                        _requireAccessToSuspend(SECTION_EXCHANGE);
                                                        exchangeSuspension.suspended = true;
                                                        exchangeSuspension.reason = uint248(reason);
                                                        emit ExchangeSuspended(reason);
                                                    }
                                                
                                                    function resumeExchange() external {
                                                        _requireAccessToResume(SECTION_EXCHANGE);
                                                        exchangeSuspension.suspended = false;
                                                        emit ExchangeResumed(uint256(exchangeSuspension.reason));
                                                        exchangeSuspension.reason = 0;
                                                    }
                                                
                                                    function suspendSynth(bytes32 currencyKey, uint256 reason) external {
                                                        _requireAccessToSuspend(SECTION_SYNTH);
                                                        synthSuspension[currencyKey].suspended = true;
                                                        synthSuspension[currencyKey].reason = uint248(reason);
                                                        emit SynthSuspended(currencyKey, reason);
                                                    }
                                                
                                                    function resumeSynth(bytes32 currencyKey) external {
                                                        _requireAccessToResume(SECTION_SYNTH);
                                                        emit SynthResumed(currencyKey, uint256(synthSuspension[currencyKey].reason));
                                                        delete synthSuspension[currencyKey];
                                                    }
                                                
                                                    /* ========== INTERNAL FUNCTIONS ========== */
                                                
                                                    function _requireAccessToSuspend(bytes32 section) internal view {
                                                        require(accessControl[section][msg.sender].canSuspend, "Restricted to access control list");
                                                    }
                                                
                                                    function _requireAccessToResume(bytes32 section) internal view {
                                                        require(accessControl[section][msg.sender].canResume, "Restricted to access control list");
                                                    }
                                                
                                                    function _internalRequireSystemActive() internal view {
                                                        require(
                                                            !systemSuspension.suspended,
                                                            systemSuspension.reason == SUSPENSION_REASON_UPGRADE
                                                                ? "Synthetix is suspended, upgrade in progress... please stand by"
                                                                : "Synthetix is suspended. Operation prohibited"
                                                        );
                                                    }
                                                
                                                    function _internalUpdateAccessControl(bytes32 section, address account, bool canSuspend, bool canResume) internal {
                                                        require(
                                                            section == SECTION_SYSTEM ||
                                                                section == SECTION_ISSUANCE ||
                                                                section == SECTION_EXCHANGE ||
                                                                section == SECTION_SYNTH,
                                                            "Invalid section supplied"
                                                        );
                                                        accessControl[section][account].canSuspend = canSuspend;
                                                        accessControl[section][account].canResume = canResume;
                                                        emit AccessControlUpdated(section, account, canSuspend, canResume);
                                                    }
                                                
                                                    /* ========== EVENTS ========== */
                                                
                                                    event SystemSuspended(uint256 reason);
                                                    event SystemResumed(uint256 reason);
                                                
                                                    event IssuanceSuspended(uint256 reason);
                                                    event IssuanceResumed(uint256 reason);
                                                
                                                    event ExchangeSuspended(uint256 reason);
                                                    event ExchangeResumed(uint256 reason);
                                                
                                                    event SynthSuspended(bytes32 currencyKey, uint256 reason);
                                                    event SynthResumed(bytes32 currencyKey, uint256 reason);
                                                
                                                    event AccessControlUpdated(bytes32 indexed section, address indexed account, bool canSuspend, bool canResume);
                                                }