ETH Price: $1,992.96 (-0.87%)

Transaction Decoder

Block:
18345143 at Oct-14-2023 12:47:35 AM +UTC
Transaction Fee:
0.00187237242673588 ETH $3.73
Gas Used:
124,492 Gas / 15.04010239 Gwei

Emitted Events:

439 OrbRoot.Transfer( from=[Receiver] 0x445947140f5e1b742439f6ee24a7690d077bbb89, to=UniswapV2Pair, value=6321550000000000000000 )
440 FiatTokenProxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x00000000000000000000000096d95e95d9e6013675cf451020193cef488ffecb, 0x000000000000000000000000c113aa252b00b71475b02333904e89875c744c5c, 000000000000000000000000000000000000000000000000000000000fb825c8 )
441 UniswapV2Pair.Sync( reserve0=245057791380993456496595, reserve1=9989723050 )
442 UniswapV2Pair.Swap( sender=[Receiver] 0x445947140f5e1b742439f6ee24a7690d077bbb89, amount0In=6321550000000000000000, amount1In=0, amount0Out=0, amount1Out=263726536, to=0xC113aA25...75c744c5C )

Account State Difference:

  Address   Before After State Difference Code
0x00000000...7B5C2ECA1
0.997665523003373098 Eth
Nonce: 25421
0.995793150576637218 Eth
Nonce: 25422
0.00187237242673588
0x3C917054...A0Ab695cd
(Titan Builder)
9.995119708616512961 Eth9.996364628616512961 Eth0.00124492
0x96d95E95...f488FfeCb
0xA0b86991...E3606eB48

Execution Trace

MEV Bot: 0x445...B89.bba64976( )
  • 0xa89a138e0a9289278b7723353c1135ef4650dec3.bba64976( )
    • OrbRoot.balanceOf( account=0x445947140f5e1b742439F6EE24a7690d077BBB89 ) => ( 6321550000000000000000 )
    • OrbRoot.transfer( to=0x96d95E95D9e6013675cF451020193cef488FfeCb, amount=6321550000000000000000 ) => ( True )
    • UniswapV2Pair.STATICCALL( )
    • UniswapV2Pair.swap( amount0Out=0, amount1Out=263726536, to=0xC113aA252b00B71475b02333904E89875c744c5C, data=0x )
      • FiatTokenProxy.a9059cbb( )
        • FiatTokenV2_1.transfer( to=0xC113aA252b00B71475b02333904E89875c744c5C, value=263726536 ) => ( True )
        • OrbRoot.balanceOf( account=0x96d95E95D9e6013675cF451020193cef488FfeCb ) => ( 245057791380993456496595 )
        • FiatTokenProxy.70a08231( )
          • FiatTokenV2_1.balanceOf( account=0x96d95E95D9e6013675cF451020193cef488FfeCb ) => ( 9989723050 )
            File 1 of 4: 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 2 of 4: OrbRoot
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts (last updated v4.7.0) (access/AccessControl.sol)
            pragma solidity ^0.8.0;
            import "./IAccessControl.sol";
            import "../utils/Context.sol";
            import "../utils/Strings.sol";
            import "../utils/introspection/ERC165.sol";
            /**
             * @dev Contract module that allows children to implement role-based access
             * control mechanisms. This is a lightweight version that doesn't allow enumerating role
             * members except through off-chain means by accessing the contract event logs. Some
             * applications may benefit from on-chain enumerability, for those cases see
             * {AccessControlEnumerable}.
             *
             * Roles are referred to by their `bytes32` identifier. These should be exposed
             * in the external API and be unique. The best way to achieve this is by
             * using `public constant` hash digests:
             *
             * ```
             * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
             * ```
             *
             * Roles can be used to represent a set of permissions. To restrict access to a
             * function call, use {hasRole}:
             *
             * ```
             * function foo() public {
             *     require(hasRole(MY_ROLE, msg.sender));
             *     ...
             * }
             * ```
             *
             * Roles can be granted and revoked dynamically via the {grantRole} and
             * {revokeRole} functions. Each role has an associated admin role, and only
             * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
             *
             * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
             * that only accounts with this role will be able to grant or revoke other
             * roles. More complex role relationships can be created by using
             * {_setRoleAdmin}.
             *
             * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
             * grant and revoke this role. Extra precautions should be taken to secure
             * accounts that have been granted it.
             */
            abstract contract AccessControl is Context, IAccessControl, ERC165 {
                struct RoleData {
                    mapping(address => bool) members;
                    bytes32 adminRole;
                }
                mapping(bytes32 => RoleData) private _roles;
                bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
                /**
                 * @dev Modifier that checks that an account has a specific role. Reverts
                 * with a standardized message including the required role.
                 *
                 * The format of the revert reason is given by the following regular expression:
                 *
                 *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
                 *
                 * _Available since v4.1._
                 */
                modifier onlyRole(bytes32 role) {
                    _checkRole(role);
                    _;
                }
                /**
                 * @dev See {IERC165-supportsInterface}.
                 */
                function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                    return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);
                }
                /**
                 * @dev Returns `true` if `account` has been granted `role`.
                 */
                function hasRole(bytes32 role, address account) public view virtual override returns (bool) {
                    return _roles[role].members[account];
                }
                /**
                 * @dev Revert with a standard message if `_msgSender()` is missing `role`.
                 * Overriding this function changes the behavior of the {onlyRole} modifier.
                 *
                 * Format of the revert message is described in {_checkRole}.
                 *
                 * _Available since v4.6._
                 */
                function _checkRole(bytes32 role) internal view virtual {
                    _checkRole(role, _msgSender());
                }
                /**
                 * @dev Revert with a standard message if `account` is missing `role`.
                 *
                 * The format of the revert reason is given by the following regular expression:
                 *
                 *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
                 */
                function _checkRole(bytes32 role, address account) internal view virtual {
                    if (!hasRole(role, account)) {
                        revert(
                            string(
                                abi.encodePacked(
                                    "AccessControl: account ",
                                    Strings.toHexString(uint160(account), 20),
                                    " is missing role ",
                                    Strings.toHexString(uint256(role), 32)
                                )
                            )
                        );
                    }
                }
                /**
                 * @dev Returns the admin role that controls `role`. See {grantRole} and
                 * {revokeRole}.
                 *
                 * To change a role's admin, use {_setRoleAdmin}.
                 */
                function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) {
                    return _roles[role].adminRole;
                }
                /**
                 * @dev Grants `role` to `account`.
                 *
                 * If `account` had not been already granted `role`, emits a {RoleGranted}
                 * event.
                 *
                 * Requirements:
                 *
                 * - the caller must have ``role``'s admin role.
                 *
                 * May emit a {RoleGranted} event.
                 */
                function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
                    _grantRole(role, account);
                }
                /**
                 * @dev Revokes `role` from `account`.
                 *
                 * If `account` had been granted `role`, emits a {RoleRevoked} event.
                 *
                 * Requirements:
                 *
                 * - the caller must have ``role``'s admin role.
                 *
                 * May emit a {RoleRevoked} event.
                 */
                function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
                    _revokeRole(role, account);
                }
                /**
                 * @dev Revokes `role` from the calling account.
                 *
                 * Roles are often managed via {grantRole} and {revokeRole}: this function's
                 * purpose is to provide a mechanism for accounts to lose their privileges
                 * if they are compromised (such as when a trusted device is misplaced).
                 *
                 * If the calling account had been revoked `role`, emits a {RoleRevoked}
                 * event.
                 *
                 * Requirements:
                 *
                 * - the caller must be `account`.
                 *
                 * May emit a {RoleRevoked} event.
                 */
                function renounceRole(bytes32 role, address account) public virtual override {
                    require(account == _msgSender(), "AccessControl: can only renounce roles for self");
                    _revokeRole(role, account);
                }
                /**
                 * @dev Grants `role` to `account`.
                 *
                 * If `account` had not been already granted `role`, emits a {RoleGranted}
                 * event. Note that unlike {grantRole}, this function doesn't perform any
                 * checks on the calling account.
                 *
                 * May emit a {RoleGranted} event.
                 *
                 * [WARNING]
                 * ====
                 * This function should only be called from the constructor when setting
                 * up the initial roles for the system.
                 *
                 * Using this function in any other way is effectively circumventing the admin
                 * system imposed by {AccessControl}.
                 * ====
                 *
                 * NOTE: This function is deprecated in favor of {_grantRole}.
                 */
                function _setupRole(bytes32 role, address account) internal virtual {
                    _grantRole(role, account);
                }
                /**
                 * @dev Sets `adminRole` as ``role``'s admin role.
                 *
                 * Emits a {RoleAdminChanged} event.
                 */
                function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
                    bytes32 previousAdminRole = getRoleAdmin(role);
                    _roles[role].adminRole = adminRole;
                    emit RoleAdminChanged(role, previousAdminRole, adminRole);
                }
                /**
                 * @dev Grants `role` to `account`.
                 *
                 * Internal function without access restriction.
                 *
                 * May emit a {RoleGranted} event.
                 */
                function _grantRole(bytes32 role, address account) internal virtual {
                    if (!hasRole(role, account)) {
                        _roles[role].members[account] = true;
                        emit RoleGranted(role, account, _msgSender());
                    }
                }
                /**
                 * @dev Revokes `role` from `account`.
                 *
                 * Internal function without access restriction.
                 *
                 * May emit a {RoleRevoked} event.
                 */
                function _revokeRole(bytes32 role, address account) internal virtual {
                    if (hasRole(role, account)) {
                        _roles[role].members[account] = false;
                        emit RoleRevoked(role, account, _msgSender());
                    }
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts (last updated v4.5.0) (access/AccessControlEnumerable.sol)
            pragma solidity ^0.8.0;
            import "./IAccessControlEnumerable.sol";
            import "./AccessControl.sol";
            import "../utils/structs/EnumerableSet.sol";
            /**
             * @dev Extension of {AccessControl} that allows enumerating the members of each role.
             */
            abstract contract AccessControlEnumerable is IAccessControlEnumerable, AccessControl {
                using EnumerableSet for EnumerableSet.AddressSet;
                mapping(bytes32 => EnumerableSet.AddressSet) private _roleMembers;
                /**
                 * @dev See {IERC165-supportsInterface}.
                 */
                function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                    return interfaceId == type(IAccessControlEnumerable).interfaceId || super.supportsInterface(interfaceId);
                }
                /**
                 * @dev Returns one of the accounts that have `role`. `index` must be a
                 * value between 0 and {getRoleMemberCount}, non-inclusive.
                 *
                 * Role bearers are not sorted in any particular way, and their ordering may
                 * change at any point.
                 *
                 * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
                 * you perform all queries on the same block. See the following
                 * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
                 * for more information.
                 */
                function getRoleMember(bytes32 role, uint256 index) public view virtual override returns (address) {
                    return _roleMembers[role].at(index);
                }
                /**
                 * @dev Returns the number of accounts that have `role`. Can be used
                 * together with {getRoleMember} to enumerate all bearers of a role.
                 */
                function getRoleMemberCount(bytes32 role) public view virtual override returns (uint256) {
                    return _roleMembers[role].length();
                }
                /**
                 * @dev Overload {_grantRole} to track enumerable memberships
                 */
                function _grantRole(bytes32 role, address account) internal virtual override {
                    super._grantRole(role, account);
                    _roleMembers[role].add(account);
                }
                /**
                 * @dev Overload {_revokeRole} to track enumerable memberships
                 */
                function _revokeRole(bytes32 role, address account) internal virtual override {
                    super._revokeRole(role, account);
                    _roleMembers[role].remove(account);
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev External interface of AccessControl declared to support ERC165 detection.
             */
            interface IAccessControl {
                /**
                 * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
                 *
                 * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
                 * {RoleAdminChanged} not being emitted signaling this.
                 *
                 * _Available since v3.1._
                 */
                event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
                /**
                 * @dev Emitted when `account` is granted `role`.
                 *
                 * `sender` is the account that originated the contract call, an admin role
                 * bearer except when using {AccessControl-_setupRole}.
                 */
                event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);
                /**
                 * @dev Emitted when `account` is revoked `role`.
                 *
                 * `sender` is the account that originated the contract call:
                 *   - if using `revokeRole`, it is the admin role bearer
                 *   - if using `renounceRole`, it is the role bearer (i.e. `account`)
                 */
                event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);
                /**
                 * @dev Returns `true` if `account` has been granted `role`.
                 */
                function hasRole(bytes32 role, address account) external view returns (bool);
                /**
                 * @dev Returns the admin role that controls `role`. See {grantRole} and
                 * {revokeRole}.
                 *
                 * To change a role's admin, use {AccessControl-_setRoleAdmin}.
                 */
                function getRoleAdmin(bytes32 role) external view returns (bytes32);
                /**
                 * @dev Grants `role` to `account`.
                 *
                 * If `account` had not been already granted `role`, emits a {RoleGranted}
                 * event.
                 *
                 * Requirements:
                 *
                 * - the caller must have ``role``'s admin role.
                 */
                function grantRole(bytes32 role, address account) external;
                /**
                 * @dev Revokes `role` from `account`.
                 *
                 * If `account` had been granted `role`, emits a {RoleRevoked} event.
                 *
                 * Requirements:
                 *
                 * - the caller must have ``role``'s admin role.
                 */
                function revokeRole(bytes32 role, address account) external;
                /**
                 * @dev Revokes `role` from the calling account.
                 *
                 * Roles are often managed via {grantRole} and {revokeRole}: this function's
                 * purpose is to provide a mechanism for accounts to lose their privileges
                 * if they are compromised (such as when a trusted device is misplaced).
                 *
                 * If the calling account had been granted `role`, emits a {RoleRevoked}
                 * event.
                 *
                 * Requirements:
                 *
                 * - the caller must be `account`.
                 */
                function renounceRole(bytes32 role, address account) external;
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (access/IAccessControlEnumerable.sol)
            pragma solidity ^0.8.0;
            import "./IAccessControl.sol";
            /**
             * @dev External interface of AccessControlEnumerable declared to support ERC165 detection.
             */
            interface IAccessControlEnumerable is IAccessControl {
                /**
                 * @dev Returns one of the accounts that have `role`. `index` must be a
                 * value between 0 and {getRoleMemberCount}, non-inclusive.
                 *
                 * Role bearers are not sorted in any particular way, and their ordering may
                 * change at any point.
                 *
                 * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
                 * you perform all queries on the same block. See the following
                 * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
                 * for more information.
                 */
                function getRoleMember(bytes32 role, uint256 index) external view returns (address);
                /**
                 * @dev Returns the number of accounts that have `role`. Can be used
                 * together with {getRoleMember} to enumerate all bearers of a role.
                 */
                function getRoleMemberCount(bytes32 role) external view returns (uint256);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol)
            pragma solidity ^0.8.0;
            import "../utils/Context.sol";
            /**
             * @dev Contract module which provides a basic access control mechanism, where
             * there is an account (an owner) that can be granted exclusive access to
             * specific functions.
             *
             * By default, the owner account will be the one that deploys the contract. This
             * can later be changed with {transferOwnership}.
             *
             * This module is used through inheritance. It will make available the modifier
             * `onlyOwner`, which can be applied to your functions to restrict their use to
             * the owner.
             */
            abstract contract Ownable is Context {
                address private _owner;
                event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                /**
                 * @dev Initializes the contract setting the deployer as the initial owner.
                 */
                constructor() {
                    _transferOwnership(_msgSender());
                }
                /**
                 * @dev Throws if called by any account other than the owner.
                 */
                modifier onlyOwner() {
                    _checkOwner();
                    _;
                }
                /**
                 * @dev Returns the address of the current owner.
                 */
                function owner() public view virtual returns (address) {
                    return _owner;
                }
                /**
                 * @dev Throws if the sender is not the owner.
                 */
                function _checkOwner() internal view virtual {
                    require(owner() == _msgSender(), "Ownable: caller is not the owner");
                }
                /**
                 * @dev Leaves the contract without owner. It will not be possible to call
                 * `onlyOwner` functions anymore. Can only be called by the current owner.
                 *
                 * NOTE: Renouncing ownership will leave the contract without an owner,
                 * thereby removing any functionality that is only available to the owner.
                 */
                function renounceOwnership() public virtual onlyOwner {
                    _transferOwnership(address(0));
                }
                /**
                 * @dev Transfers ownership of the contract to a new account (`newOwner`).
                 * Can only be called by the current owner.
                 */
                function transferOwnership(address newOwner) public virtual onlyOwner {
                    require(newOwner != address(0), "Ownable: new owner is the zero address");
                    _transferOwnership(newOwner);
                }
                /**
                 * @dev Transfers ownership of the contract to a new account (`newOwner`).
                 * Internal function without access restriction.
                 */
                function _transferOwnership(address newOwner) internal virtual {
                    address oldOwner = _owner;
                    _owner = newOwner;
                    emit OwnershipTransferred(oldOwner, newOwner);
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)
            pragma solidity ^0.8.0;
            import "../utils/Context.sol";
            /**
             * @dev Contract module which allows children to implement an emergency stop
             * mechanism that can be triggered by an authorized account.
             *
             * This module is used through inheritance. It will make available the
             * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
             * the functions of your contract. Note that they will not be pausable by
             * simply including this module, only once the modifiers are put in place.
             */
            abstract contract Pausable is Context {
                /**
                 * @dev Emitted when the pause is triggered by `account`.
                 */
                event Paused(address account);
                /**
                 * @dev Emitted when the pause is lifted by `account`.
                 */
                event Unpaused(address account);
                bool private _paused;
                /**
                 * @dev Initializes the contract in unpaused state.
                 */
                constructor() {
                    _paused = false;
                }
                /**
                 * @dev Modifier to make a function callable only when the contract is not paused.
                 *
                 * Requirements:
                 *
                 * - The contract must not be paused.
                 */
                modifier whenNotPaused() {
                    _requireNotPaused();
                    _;
                }
                /**
                 * @dev Modifier to make a function callable only when the contract is paused.
                 *
                 * Requirements:
                 *
                 * - The contract must be paused.
                 */
                modifier whenPaused() {
                    _requirePaused();
                    _;
                }
                /**
                 * @dev Returns true if the contract is paused, and false otherwise.
                 */
                function paused() public view virtual returns (bool) {
                    return _paused;
                }
                /**
                 * @dev Throws if the contract is paused.
                 */
                function _requireNotPaused() internal view virtual {
                    require(!paused(), "Pausable: paused");
                }
                /**
                 * @dev Throws if the contract is not paused.
                 */
                function _requirePaused() internal view virtual {
                    require(paused(), "Pausable: not paused");
                }
                /**
                 * @dev Triggers stopped state.
                 *
                 * Requirements:
                 *
                 * - The contract must not be paused.
                 */
                function _pause() internal virtual whenNotPaused {
                    _paused = true;
                    emit Paused(_msgSender());
                }
                /**
                 * @dev Returns to normal state.
                 *
                 * Requirements:
                 *
                 * - The contract must be paused.
                 */
                function _unpause() internal virtual whenPaused {
                    _paused = false;
                    emit Unpaused(_msgSender());
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC1155/IERC1155.sol)
            pragma solidity ^0.8.0;
            import "../../utils/introspection/IERC165.sol";
            /**
             * @dev Required interface of an ERC1155 compliant contract, as defined in the
             * https://eips.ethereum.org/EIPS/eip-1155[EIP].
             *
             * _Available since v3.1._
             */
            interface IERC1155 is IERC165 {
                /**
                 * @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
                 */
                event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
                /**
                 * @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
                 * transfers.
                 */
                event TransferBatch(
                    address indexed operator,
                    address indexed from,
                    address indexed to,
                    uint256[] ids,
                    uint256[] values
                );
                /**
                 * @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
                 * `approved`.
                 */
                event ApprovalForAll(address indexed account, address indexed operator, bool approved);
                /**
                 * @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
                 *
                 * If an {URI} event was emitted for `id`, the standard
                 * https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
                 * returned by {IERC1155MetadataURI-uri}.
                 */
                event URI(string value, uint256 indexed id);
                /**
                 * @dev Returns the amount of tokens of token type `id` owned by `account`.
                 *
                 * Requirements:
                 *
                 * - `account` cannot be the zero address.
                 */
                function balanceOf(address account, uint256 id) external view returns (uint256);
                /**
                 * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
                 *
                 * Requirements:
                 *
                 * - `accounts` and `ids` must have the same length.
                 */
                function balanceOfBatch(address[] calldata accounts, uint256[] calldata ids)
                    external
                    view
                    returns (uint256[] memory);
                /**
                 * @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
                 *
                 * Emits an {ApprovalForAll} event.
                 *
                 * Requirements:
                 *
                 * - `operator` cannot be the caller.
                 */
                function setApprovalForAll(address operator, bool approved) external;
                /**
                 * @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
                 *
                 * See {setApprovalForAll}.
                 */
                function isApprovedForAll(address account, address operator) external view returns (bool);
                /**
                 * @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
                 *
                 * Emits a {TransferSingle} event.
                 *
                 * Requirements:
                 *
                 * - `to` cannot be the zero address.
                 * - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}.
                 * - `from` must have a balance of tokens of type `id` of at least `amount`.
                 * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
                 * acceptance magic value.
                 */
                function safeTransferFrom(
                    address from,
                    address to,
                    uint256 id,
                    uint256 amount,
                    bytes calldata data
                ) external;
                /**
                 * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
                 *
                 * Emits a {TransferBatch} event.
                 *
                 * Requirements:
                 *
                 * - `ids` and `amounts` must have the same length.
                 * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
                 * acceptance magic value.
                 */
                function safeBatchTransferFrom(
                    address from,
                    address to,
                    uint256[] calldata ids,
                    uint256[] calldata amounts,
                    bytes calldata data
                ) external;
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC20/ERC20.sol)
            pragma solidity ^0.8.0;
            import "./IERC20.sol";
            import "./extensions/IERC20Metadata.sol";
            import "../../utils/Context.sol";
            /**
             * @dev Implementation of the {IERC20} interface.
             *
             * This implementation is agnostic to the way tokens are created. This means
             * that a supply mechanism has to be added in a derived contract using {_mint}.
             * For a generic mechanism see {ERC20PresetMinterPauser}.
             *
             * TIP: For a detailed writeup see our guide
             * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How
             * to implement supply mechanisms].
             *
             * We have followed general OpenZeppelin Contracts guidelines: functions revert
             * instead returning `false` on failure. This behavior is nonetheless
             * conventional and does not conflict with the expectations of ERC20
             * applications.
             *
             * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
             * This allows applications to reconstruct the allowance for all accounts just
             * by listening to said events. Other implementations of the EIP may not emit
             * these events, as it isn't required by the specification.
             *
             * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
             * functions have been added to mitigate the well-known issues around setting
             * allowances. See {IERC20-approve}.
             */
            contract ERC20 is Context, IERC20, IERC20Metadata {
                mapping(address => uint256) private _balances;
                mapping(address => mapping(address => uint256)) private _allowances;
                uint256 private _totalSupply;
                string private _name;
                string private _symbol;
                /**
                 * @dev Sets the values for {name} and {symbol}.
                 *
                 * The default value of {decimals} is 18. To select a different value for
                 * {decimals} you should overload it.
                 *
                 * All two of these values are immutable: they can only be set once during
                 * construction.
                 */
                constructor(string memory name_, string memory symbol_) {
                    _name = name_;
                    _symbol = symbol_;
                }
                /**
                 * @dev Returns the name of the token.
                 */
                function name() public view virtual override returns (string memory) {
                    return _name;
                }
                /**
                 * @dev Returns the symbol of the token, usually a shorter version of the
                 * name.
                 */
                function symbol() public view virtual override returns (string memory) {
                    return _symbol;
                }
                /**
                 * @dev Returns the number of decimals used to get its user representation.
                 * For example, if `decimals` equals `2`, a balance of `505` tokens should
                 * be displayed to a user as `5.05` (`505 / 10 ** 2`).
                 *
                 * Tokens usually opt for a value of 18, imitating the relationship between
                 * Ether and Wei. This is the value {ERC20} uses, unless this function is
                 * overridden;
                 *
                 * NOTE: This information is only used for _display_ purposes: it in
                 * no way affects any of the arithmetic of the contract, including
                 * {IERC20-balanceOf} and {IERC20-transfer}.
                 */
                function decimals() public view virtual override returns (uint8) {
                    return 18;
                }
                /**
                 * @dev See {IERC20-totalSupply}.
                 */
                function totalSupply() public view virtual override returns (uint256) {
                    return _totalSupply;
                }
                /**
                 * @dev See {IERC20-balanceOf}.
                 */
                function balanceOf(address account) public view virtual override returns (uint256) {
                    return _balances[account];
                }
                /**
                 * @dev See {IERC20-transfer}.
                 *
                 * Requirements:
                 *
                 * - `to` cannot be the zero address.
                 * - the caller must have a balance of at least `amount`.
                 */
                function transfer(address to, uint256 amount) public virtual override returns (bool) {
                    address owner = _msgSender();
                    _transfer(owner, to, amount);
                    return true;
                }
                /**
                 * @dev See {IERC20-allowance}.
                 */
                function allowance(address owner, address spender) public view virtual override returns (uint256) {
                    return _allowances[owner][spender];
                }
                /**
                 * @dev See {IERC20-approve}.
                 *
                 * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on
                 * `transferFrom`. This is semantically equivalent to an infinite approval.
                 *
                 * Requirements:
                 *
                 * - `spender` cannot be the zero address.
                 */
                function approve(address spender, uint256 amount) public virtual override returns (bool) {
                    address owner = _msgSender();
                    _approve(owner, spender, amount);
                    return true;
                }
                /**
                 * @dev See {IERC20-transferFrom}.
                 *
                 * Emits an {Approval} event indicating the updated allowance. This is not
                 * required by the EIP. See the note at the beginning of {ERC20}.
                 *
                 * NOTE: Does not update the allowance if the current allowance
                 * is the maximum `uint256`.
                 *
                 * Requirements:
                 *
                 * - `from` and `to` cannot be the zero address.
                 * - `from` must have a balance of at least `amount`.
                 * - the caller must have allowance for ``from``'s tokens of at least
                 * `amount`.
                 */
                function transferFrom(
                    address from,
                    address to,
                    uint256 amount
                ) public virtual override returns (bool) {
                    address spender = _msgSender();
                    _spendAllowance(from, spender, amount);
                    _transfer(from, to, amount);
                    return true;
                }
                /**
                 * @dev Atomically increases the allowance granted to `spender` by the caller.
                 *
                 * This is an alternative to {approve} that can be used as a mitigation for
                 * problems described in {IERC20-approve}.
                 *
                 * Emits an {Approval} event indicating the updated allowance.
                 *
                 * Requirements:
                 *
                 * - `spender` cannot be the zero address.
                 */
                function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
                    address owner = _msgSender();
                    _approve(owner, spender, allowance(owner, spender) + addedValue);
                    return true;
                }
                /**
                 * @dev Atomically decreases the allowance granted to `spender` by the caller.
                 *
                 * This is an alternative to {approve} that can be used as a mitigation for
                 * problems described in {IERC20-approve}.
                 *
                 * Emits an {Approval} event indicating the updated allowance.
                 *
                 * Requirements:
                 *
                 * - `spender` cannot be the zero address.
                 * - `spender` must have allowance for the caller of at least
                 * `subtractedValue`.
                 */
                function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
                    address owner = _msgSender();
                    uint256 currentAllowance = allowance(owner, spender);
                    require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
                    unchecked {
                        _approve(owner, spender, currentAllowance - subtractedValue);
                    }
                    return true;
                }
                /**
                 * @dev Moves `amount` of tokens from `from` to `to`.
                 *
                 * This internal function is equivalent to {transfer}, and can be used to
                 * e.g. implement automatic token fees, slashing mechanisms, etc.
                 *
                 * Emits a {Transfer} event.
                 *
                 * Requirements:
                 *
                 * - `from` cannot be the zero address.
                 * - `to` cannot be the zero address.
                 * - `from` must have a balance of at least `amount`.
                 */
                function _transfer(
                    address from,
                    address to,
                    uint256 amount
                ) internal virtual {
                    require(from != address(0), "ERC20: transfer from the zero address");
                    require(to != address(0), "ERC20: transfer to the zero address");
                    _beforeTokenTransfer(from, to, amount);
                    uint256 fromBalance = _balances[from];
                    require(fromBalance >= amount, "ERC20: transfer amount exceeds balance");
                    unchecked {
                        _balances[from] = fromBalance - amount;
                    }
                    _balances[to] += amount;
                    emit Transfer(from, to, amount);
                    _afterTokenTransfer(from, to, amount);
                }
                /** @dev Creates `amount` tokens and assigns them to `account`, increasing
                 * the total supply.
                 *
                 * Emits a {Transfer} event with `from` set to the zero address.
                 *
                 * Requirements:
                 *
                 * - `account` cannot be the zero address.
                 */
                function _mint(address account, uint256 amount) internal virtual {
                    require(account != address(0), "ERC20: mint to the zero address");
                    _beforeTokenTransfer(address(0), account, amount);
                    _totalSupply += amount;
                    _balances[account] += amount;
                    emit Transfer(address(0), account, amount);
                    _afterTokenTransfer(address(0), account, amount);
                }
                /**
                 * @dev Destroys `amount` tokens from `account`, reducing the
                 * total supply.
                 *
                 * Emits a {Transfer} event with `to` set to the zero address.
                 *
                 * Requirements:
                 *
                 * - `account` cannot be the zero address.
                 * - `account` must have at least `amount` tokens.
                 */
                function _burn(address account, uint256 amount) internal virtual {
                    require(account != address(0), "ERC20: burn from the zero address");
                    _beforeTokenTransfer(account, address(0), amount);
                    uint256 accountBalance = _balances[account];
                    require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
                    unchecked {
                        _balances[account] = accountBalance - amount;
                    }
                    _totalSupply -= amount;
                    emit Transfer(account, address(0), amount);
                    _afterTokenTransfer(account, address(0), amount);
                }
                /**
                 * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.
                 *
                 * This internal function is equivalent to `approve`, and can be used to
                 * e.g. set automatic allowances for certain subsystems, etc.
                 *
                 * Emits an {Approval} event.
                 *
                 * Requirements:
                 *
                 * - `owner` cannot be the zero address.
                 * - `spender` cannot be the zero address.
                 */
                function _approve(
                    address owner,
                    address spender,
                    uint256 amount
                ) internal virtual {
                    require(owner != address(0), "ERC20: approve from the zero address");
                    require(spender != address(0), "ERC20: approve to the zero address");
                    _allowances[owner][spender] = amount;
                    emit Approval(owner, spender, amount);
                }
                /**
                 * @dev Updates `owner` s allowance for `spender` based on spent `amount`.
                 *
                 * Does not update the allowance amount in case of infinite allowance.
                 * Revert if not enough allowance is available.
                 *
                 * Might emit an {Approval} event.
                 */
                function _spendAllowance(
                    address owner,
                    address spender,
                    uint256 amount
                ) internal virtual {
                    uint256 currentAllowance = allowance(owner, spender);
                    if (currentAllowance != type(uint256).max) {
                        require(currentAllowance >= amount, "ERC20: insufficient allowance");
                        unchecked {
                            _approve(owner, spender, currentAllowance - amount);
                        }
                    }
                }
                /**
                 * @dev Hook that is called before any transfer of tokens. This includes
                 * minting and burning.
                 *
                 * Calling conditions:
                 *
                 * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
                 * will be transferred to `to`.
                 * - when `from` is zero, `amount` tokens will be minted for `to`.
                 * - when `to` is zero, `amount` of ``from``'s tokens will be burned.
                 * - `from` and `to` are never both zero.
                 *
                 * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
                 */
                function _beforeTokenTransfer(
                    address from,
                    address to,
                    uint256 amount
                ) internal virtual {}
                /**
                 * @dev Hook that is called after any transfer of tokens. This includes
                 * minting and burning.
                 *
                 * Calling conditions:
                 *
                 * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
                 * has been transferred to `to`.
                 * - when `from` is zero, `amount` tokens have been minted for `to`.
                 * - when `to` is zero, `amount` of ``from``'s tokens have been burned.
                 * - `from` and `to` are never both zero.
                 *
                 * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
                 */
                function _afterTokenTransfer(
                    address from,
                    address to,
                    uint256 amount
                ) internal virtual {}
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts (last updated v4.5.0) (token/ERC20/extensions/ERC20Burnable.sol)
            pragma solidity ^0.8.0;
            import "../ERC20.sol";
            import "../../../utils/Context.sol";
            /**
             * @dev Extension of {ERC20} that allows token holders to destroy both their own
             * tokens and those that they have an allowance for, in a way that can be
             * recognized off-chain (via event analysis).
             */
            abstract contract ERC20Burnable is Context, ERC20 {
                /**
                 * @dev Destroys `amount` tokens from the caller.
                 *
                 * See {ERC20-_burn}.
                 */
                function burn(uint256 amount) public virtual {
                    _burn(_msgSender(), amount);
                }
                /**
                 * @dev Destroys `amount` tokens from `account`, deducting from the caller's
                 * allowance.
                 *
                 * See {ERC20-_burn} and {ERC20-allowance}.
                 *
                 * Requirements:
                 *
                 * - the caller must have allowance for ``accounts``'s tokens of at least
                 * `amount`.
                 */
                function burnFrom(address account, uint256 amount) public virtual {
                    _spendAllowance(account, _msgSender(), amount);
                    _burn(account, amount);
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/ERC20Pausable.sol)
            pragma solidity ^0.8.0;
            import "../ERC20.sol";
            import "../../../security/Pausable.sol";
            /**
             * @dev ERC20 token with pausable token transfers, minting and burning.
             *
             * Useful for scenarios such as preventing trades until the end of an evaluation
             * period, or having an emergency switch for freezing all token transfers in the
             * event of a large bug.
             */
            abstract contract ERC20Pausable is ERC20, Pausable {
                /**
                 * @dev See {ERC20-_beforeTokenTransfer}.
                 *
                 * Requirements:
                 *
                 * - the contract must not be paused.
                 */
                function _beforeTokenTransfer(
                    address from,
                    address to,
                    uint256 amount
                ) internal virtual override {
                    super._beforeTokenTransfer(from, to, amount);
                    require(!paused(), "ERC20Pausable: token transfer while paused");
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)
            pragma solidity ^0.8.0;
            import "../IERC20.sol";
            /**
             * @dev Interface for the optional metadata functions from the ERC20 standard.
             *
             * _Available since v4.1._
             */
            interface IERC20Metadata is IERC20 {
                /**
                 * @dev Returns the name of the token.
                 */
                function name() external view returns (string memory);
                /**
                 * @dev Returns the symbol of the token.
                 */
                function symbol() external view returns (string memory);
                /**
                 * @dev Returns the decimals places of the token.
                 */
                function decimals() external view returns (uint8);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Interface of the ERC20 standard as defined in the EIP.
             */
            interface IERC20 {
                /**
                 * @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 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 `to`.
                 *
                 * Returns a boolean value indicating whether the operation succeeded.
                 *
                 * Emits a {Transfer} event.
                 */
                function transfer(address to, 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 `from` to `to` 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 from,
                    address to,
                    uint256 amount
                ) external returns (bool);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/IERC721.sol)
            pragma solidity ^0.8.0;
            import "../../utils/introspection/IERC165.sol";
            /**
             * @dev Required interface of an ERC721 compliant contract.
             */
            interface IERC721 is IERC165 {
                /**
                 * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
                 */
                event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
                /**
                 * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
                 */
                event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
                /**
                 * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
                 */
                event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
                /**
                 * @dev Returns the number of tokens in ``owner``'s account.
                 */
                function balanceOf(address owner) external view returns (uint256 balance);
                /**
                 * @dev Returns the owner of the `tokenId` token.
                 *
                 * Requirements:
                 *
                 * - `tokenId` must exist.
                 */
                function ownerOf(uint256 tokenId) external view returns (address owner);
                /**
                 * @dev Safely transfers `tokenId` token from `from` to `to`.
                 *
                 * Requirements:
                 *
                 * - `from` cannot be the zero address.
                 * - `to` cannot be the zero address.
                 * - `tokenId` token must exist and be owned by `from`.
                 * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
                 * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                 *
                 * Emits a {Transfer} event.
                 */
                function safeTransferFrom(
                    address from,
                    address to,
                    uint256 tokenId,
                    bytes calldata data
                ) external;
                /**
                 * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
                 * are aware of the ERC721 protocol to prevent tokens from being forever locked.
                 *
                 * Requirements:
                 *
                 * - `from` cannot be the zero address.
                 * - `to` cannot be the zero address.
                 * - `tokenId` token must exist and be owned by `from`.
                 * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}.
                 * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                 *
                 * Emits a {Transfer} event.
                 */
                function safeTransferFrom(
                    address from,
                    address to,
                    uint256 tokenId
                ) external;
                /**
                 * @dev Transfers `tokenId` token from `from` to `to`.
                 *
                 * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
                 *
                 * Requirements:
                 *
                 * - `from` cannot be the zero address.
                 * - `to` cannot be the zero address.
                 * - `tokenId` token must be owned by `from`.
                 * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
                 *
                 * Emits a {Transfer} event.
                 */
                function transferFrom(
                    address from,
                    address to,
                    uint256 tokenId
                ) external;
                /**
                 * @dev Gives permission to `to` to transfer `tokenId` token to another account.
                 * The approval is cleared when the token is transferred.
                 *
                 * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
                 *
                 * Requirements:
                 *
                 * - The caller must own the token or be an approved operator.
                 * - `tokenId` must exist.
                 *
                 * Emits an {Approval} event.
                 */
                function approve(address to, uint256 tokenId) external;
                /**
                 * @dev Approve or remove `operator` as an operator for the caller.
                 * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
                 *
                 * Requirements:
                 *
                 * - The `operator` cannot be the caller.
                 *
                 * Emits an {ApprovalForAll} event.
                 */
                function setApprovalForAll(address operator, bool _approved) external;
                /**
                 * @dev Returns the account approved for `tokenId` token.
                 *
                 * Requirements:
                 *
                 * - `tokenId` must exist.
                 */
                function getApproved(uint256 tokenId) external view returns (address operator);
                /**
                 * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
                 *
                 * See {setApprovalForAll}
                 */
                function isApprovedForAll(address owner, address operator) external view returns (bool);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Provides information about the current execution context, including the
             * sender of the transaction and its data. While these are generally available
             * via msg.sender and msg.data, they should not be accessed in such a direct
             * manner, since when dealing with meta-transactions the account sending and
             * paying for execution may not be the actual sender (as far as an application
             * is concerned).
             *
             * This contract is only required for intermediate, library-like contracts.
             */
            abstract contract Context {
                function _msgSender() internal view virtual returns (address) {
                    return msg.sender;
                }
                function _msgData() internal view virtual returns (bytes calldata) {
                    return msg.data;
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/Counters.sol)
            pragma solidity ^0.8.0;
            /**
             * @title Counters
             * @author Matt Condon (@shrugs)
             * @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
             * of elements in a mapping, issuing ERC721 ids, or counting request ids.
             *
             * Include with `using Counters for Counters.Counter;`
             */
            library Counters {
                struct Counter {
                    // This variable should never be directly accessed by users of the library: interactions must be restricted to
                    // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
                    // this feature: see https://github.com/ethereum/solidity/issues/4637
                    uint256 _value; // default: 0
                }
                function current(Counter storage counter) internal view returns (uint256) {
                    return counter._value;
                }
                function increment(Counter storage counter) internal {
                    unchecked {
                        counter._value += 1;
                    }
                }
                function decrement(Counter storage counter) internal {
                    uint256 value = counter._value;
                    require(value > 0, "Counter: decrement overflow");
                    unchecked {
                        counter._value = value - 1;
                    }
                }
                function reset(Counter storage counter) internal {
                    counter._value = 0;
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
            pragma solidity ^0.8.0;
            import "./IERC165.sol";
            /**
             * @dev Implementation of the {IERC165} interface.
             *
             * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
             * for the additional interface id that will be supported. For example:
             *
             * ```solidity
             * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
             *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
             * }
             * ```
             *
             * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
             */
            abstract contract ERC165 is IERC165 {
                /**
                 * @dev See {IERC165-supportsInterface}.
                 */
                function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                    return interfaceId == type(IERC165).interfaceId;
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Interface of the ERC165 standard, as defined in the
             * https://eips.ethereum.org/EIPS/eip-165[EIP].
             *
             * Implementers can declare support of contract interfaces, which can then be
             * queried by others ({ERC165Checker}).
             *
             * For an implementation, see {ERC165}.
             */
            interface IERC165 {
                /**
                 * @dev Returns true if this contract implements the interface defined by
                 * `interfaceId`. See the corresponding
                 * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
                 * to learn more about how these ids are created.
                 *
                 * This function call must use less than 30 000 gas.
                 */
                function supportsInterface(bytes4 interfaceId) external view returns (bool);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev String operations.
             */
            library Strings {
                bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
                uint8 private constant _ADDRESS_LENGTH = 20;
                /**
                 * @dev Converts a `uint256` to its ASCII `string` decimal representation.
                 */
                function toString(uint256 value) internal pure returns (string memory) {
                    // Inspired by OraclizeAPI's implementation - MIT licence
                    // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
                    if (value == 0) {
                        return "0";
                    }
                    uint256 temp = value;
                    uint256 digits;
                    while (temp != 0) {
                        digits++;
                        temp /= 10;
                    }
                    bytes memory buffer = new bytes(digits);
                    while (value != 0) {
                        digits -= 1;
                        buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                        value /= 10;
                    }
                    return string(buffer);
                }
                /**
                 * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
                 */
                function toHexString(uint256 value) internal pure returns (string memory) {
                    if (value == 0) {
                        return "0x00";
                    }
                    uint256 temp = value;
                    uint256 length = 0;
                    while (temp != 0) {
                        length++;
                        temp >>= 8;
                    }
                    return toHexString(value, length);
                }
                /**
                 * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
                 */
                function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
                    bytes memory buffer = new bytes(2 * length + 2);
                    buffer[0] = "0";
                    buffer[1] = "x";
                    for (uint256 i = 2 * length + 1; i > 1; --i) {
                        buffer[i] = _HEX_SYMBOLS[value & 0xf];
                        value >>= 4;
                    }
                    require(value == 0, "Strings: hex length insufficient");
                    return string(buffer);
                }
                /**
                 * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
                 */
                function toHexString(address addr) internal pure returns (string memory) {
                    return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts (last updated v4.7.0) (utils/structs/EnumerableSet.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Library for managing
             * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
             * types.
             *
             * Sets have the following properties:
             *
             * - Elements are added, removed, and checked for existence in constant time
             * (O(1)).
             * - Elements are enumerated in O(n). No guarantees are made on the ordering.
             *
             * ```
             * contract Example {
             *     // Add the library methods
             *     using EnumerableSet for EnumerableSet.AddressSet;
             *
             *     // Declare a set state variable
             *     EnumerableSet.AddressSet private mySet;
             * }
             * ```
             *
             * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
             * and `uint256` (`UintSet`) are supported.
             *
             * [WARNING]
             * ====
             *  Trying to delete such a structure from storage will likely result in data corruption, rendering the structure unusable.
             *  See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.
             *
             *  In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an array of EnumerableSet.
             * ====
             */
            library EnumerableSet {
                // To implement this library for multiple types with as little code
                // repetition as possible, we write it in terms of a generic Set type with
                // bytes32 values.
                // The Set implementation uses private functions, and user-facing
                // implementations (such as AddressSet) are just wrappers around the
                // underlying Set.
                // This means that we can only create new EnumerableSets for types that fit
                // in bytes32.
                struct Set {
                    // Storage of set values
                    bytes32[] _values;
                    // Position of the value in the `values` array, plus 1 because index 0
                    // means a value is not in the set.
                    mapping(bytes32 => uint256) _indexes;
                }
                /**
                 * @dev Add a value to a set. O(1).
                 *
                 * Returns true if the value was added to the set, that is if it was not
                 * already present.
                 */
                function _add(Set storage set, bytes32 value) private returns (bool) {
                    if (!_contains(set, value)) {
                        set._values.push(value);
                        // The value is stored at length-1, but we add 1 to all indexes
                        // and use 0 as a sentinel value
                        set._indexes[value] = set._values.length;
                        return true;
                    } else {
                        return false;
                    }
                }
                /**
                 * @dev Removes a value from a set. O(1).
                 *
                 * Returns true if the value was removed from the set, that is if it was
                 * present.
                 */
                function _remove(Set storage set, bytes32 value) private returns (bool) {
                    // We read and store the value's index to prevent multiple reads from the same storage slot
                    uint256 valueIndex = set._indexes[value];
                    if (valueIndex != 0) {
                        // Equivalent to contains(set, value)
                        // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
                        // the array, and then remove the last element (sometimes called as 'swap and pop').
                        // This modifies the order of the array, as noted in {at}.
                        uint256 toDeleteIndex = valueIndex - 1;
                        uint256 lastIndex = set._values.length - 1;
                        if (lastIndex != toDeleteIndex) {
                            bytes32 lastValue = set._values[lastIndex];
                            // Move the last value to the index where the value to delete is
                            set._values[toDeleteIndex] = lastValue;
                            // Update the index for the moved value
                            set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex
                        }
                        // Delete the slot where the moved value was stored
                        set._values.pop();
                        // Delete the index for the deleted slot
                        delete set._indexes[value];
                        return true;
                    } else {
                        return false;
                    }
                }
                /**
                 * @dev Returns true if the value is in the set. O(1).
                 */
                function _contains(Set storage set, bytes32 value) private view returns (bool) {
                    return set._indexes[value] != 0;
                }
                /**
                 * @dev Returns the number of values on the set. O(1).
                 */
                function _length(Set storage set) private view returns (uint256) {
                    return set._values.length;
                }
                /**
                 * @dev Returns the value stored at position `index` in the set. O(1).
                 *
                 * Note that there are no guarantees on the ordering of values inside the
                 * array, and it may change when more values are added or removed.
                 *
                 * Requirements:
                 *
                 * - `index` must be strictly less than {length}.
                 */
                function _at(Set storage set, uint256 index) private view returns (bytes32) {
                    return set._values[index];
                }
                /**
                 * @dev Return the entire set in an array
                 *
                 * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
                 * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
                 * this function has an unbounded cost, and using it as part of a state-changing function may render the function
                 * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
                 */
                function _values(Set storage set) private view returns (bytes32[] memory) {
                    return set._values;
                }
                // Bytes32Set
                struct Bytes32Set {
                    Set _inner;
                }
                /**
                 * @dev Add a value to a set. O(1).
                 *
                 * Returns true if the value was added to the set, that is if it was not
                 * already present.
                 */
                function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
                    return _add(set._inner, value);
                }
                /**
                 * @dev Removes a value from a set. O(1).
                 *
                 * Returns true if the value was removed from the set, that is if it was
                 * present.
                 */
                function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
                    return _remove(set._inner, value);
                }
                /**
                 * @dev Returns true if the value is in the set. O(1).
                 */
                function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
                    return _contains(set._inner, value);
                }
                /**
                 * @dev Returns the number of values in the set. O(1).
                 */
                function length(Bytes32Set storage set) internal view returns (uint256) {
                    return _length(set._inner);
                }
                /**
                 * @dev Returns the value stored at position `index` in the set. O(1).
                 *
                 * Note that there are no guarantees on the ordering of values inside the
                 * array, and it may change when more values are added or removed.
                 *
                 * Requirements:
                 *
                 * - `index` must be strictly less than {length}.
                 */
                function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
                    return _at(set._inner, index);
                }
                /**
                 * @dev Return the entire set in an array
                 *
                 * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
                 * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
                 * this function has an unbounded cost, and using it as part of a state-changing function may render the function
                 * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
                 */
                function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
                    return _values(set._inner);
                }
                // AddressSet
                struct AddressSet {
                    Set _inner;
                }
                /**
                 * @dev Add a value to a set. O(1).
                 *
                 * Returns true if the value was added to the set, that is if it was not
                 * already present.
                 */
                function add(AddressSet storage set, address value) internal returns (bool) {
                    return _add(set._inner, bytes32(uint256(uint160(value))));
                }
                /**
                 * @dev Removes a value from a set. O(1).
                 *
                 * Returns true if the value was removed from the set, that is if it was
                 * present.
                 */
                function remove(AddressSet storage set, address value) internal returns (bool) {
                    return _remove(set._inner, bytes32(uint256(uint160(value))));
                }
                /**
                 * @dev Returns true if the value is in the set. O(1).
                 */
                function contains(AddressSet storage set, address value) internal view returns (bool) {
                    return _contains(set._inner, bytes32(uint256(uint160(value))));
                }
                /**
                 * @dev Returns the number of values in the set. O(1).
                 */
                function length(AddressSet storage set) internal view returns (uint256) {
                    return _length(set._inner);
                }
                /**
                 * @dev Returns the value stored at position `index` in the set. O(1).
                 *
                 * Note that there are no guarantees on the ordering of values inside the
                 * array, and it may change when more values are added or removed.
                 *
                 * Requirements:
                 *
                 * - `index` must be strictly less than {length}.
                 */
                function at(AddressSet storage set, uint256 index) internal view returns (address) {
                    return address(uint160(uint256(_at(set._inner, index))));
                }
                /**
                 * @dev Return the entire set in an array
                 *
                 * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
                 * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
                 * this function has an unbounded cost, and using it as part of a state-changing function may render the function
                 * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
                 */
                function values(AddressSet storage set) internal view returns (address[] memory) {
                    bytes32[] memory store = _values(set._inner);
                    address[] memory result;
                    /// @solidity memory-safe-assembly
                    assembly {
                        result := store
                    }
                    return result;
                }
                // UintSet
                struct UintSet {
                    Set _inner;
                }
                /**
                 * @dev Add a value to a set. O(1).
                 *
                 * Returns true if the value was added to the set, that is if it was not
                 * already present.
                 */
                function add(UintSet storage set, uint256 value) internal returns (bool) {
                    return _add(set._inner, bytes32(value));
                }
                /**
                 * @dev Removes a value from a set. O(1).
                 *
                 * Returns true if the value was removed from the set, that is if it was
                 * present.
                 */
                function remove(UintSet storage set, uint256 value) internal returns (bool) {
                    return _remove(set._inner, bytes32(value));
                }
                /**
                 * @dev Returns true if the value is in the set. O(1).
                 */
                function contains(UintSet storage set, uint256 value) internal view returns (bool) {
                    return _contains(set._inner, bytes32(value));
                }
                /**
                 * @dev Returns the number of values on the set. O(1).
                 */
                function length(UintSet storage set) internal view returns (uint256) {
                    return _length(set._inner);
                }
                /**
                 * @dev Returns the value stored at position `index` in the set. O(1).
                 *
                 * Note that there are no guarantees on the ordering of values inside the
                 * array, and it may change when more values are added or removed.
                 *
                 * Requirements:
                 *
                 * - `index` must be strictly less than {length}.
                 */
                function at(UintSet storage set, uint256 index) internal view returns (uint256) {
                    return uint256(_at(set._inner, index));
                }
                /**
                 * @dev Return the entire set in an array
                 *
                 * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
                 * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
                 * this function has an unbounded cost, and using it as part of a state-changing function may render the function
                 * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
                 */
                function values(UintSet storage set) internal view returns (uint256[] memory) {
                    bytes32[] memory store = _values(set._inner);
                    uint256[] memory result;
                    /// @solidity memory-safe-assembly
                    assembly {
                        result := store
                    }
                    return result;
                }
            }
            // SPDX-License-Identifier: MIT
            pragma solidity 0.8.6;
            import "@openzeppelin/contracts/utils/Counters.sol";
            import "@openzeppelin/contracts/utils/Context.sol";
            import "@openzeppelin/contracts/access/Ownable.sol";
            import "@openzeppelin/contracts/access/AccessControlEnumerable.sol";
            import "@openzeppelin/contracts/token/ERC20/extensions/ERC20Burnable.sol";
            import "@openzeppelin/contracts/token/ERC20/extensions/ERC20Pausable.sol";
            import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
            import "../utils/Withdrawable.sol";
            import "../utils/ERC20Freezable.sol";
            import "../utils/NativeMetaTransaction.sol";
            import "../utils/IMintableERC20.sol";
            contract OrbRoot is
                Ownable,
                AccessControlEnumerable,
                ERC20Burnable,
                ERC20Pausable,
                Withdrawable,
                ERC20Freezable,
                NativeMetaTransaction,
                IMintableERC20
            {
                bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");
                bytes32 public constant PAUSER_ROLE = keccak256("PAUSER_ROLE");
                bytes32 public constant PREDICATE_ROLE = keccak256("PREDICATE_ROLE");
                event Burn(address indexed from, uint256 value);
                constructor(string memory name, string memory symbol) ERC20(name, symbol) {
                    _setupRole(DEFAULT_ADMIN_ROLE, _msgSender());
                    _setupRole(MINTER_ROLE, _msgSender());
                    _setupRole(PAUSER_ROLE, _msgSender());
                    _setupRole(WITHDRAWER_ROLE, _msgSender());
                    _setupRole(PREDICATE_ROLE, address(0x9923263fA127b3d1484cFD649df8f1831c2A74e4));
                }
                function msgSender() internal view returns (address payable sender) {
                    if (msg.sender == address(this)) {
                        bytes memory array = msg.data;
                        uint256 index = msg.data.length;
                        assembly {
                            // Load the 32 bytes word from memory with the address on the lower 20 bytes, and mask those.
                            sender := and(mload(add(array, index)), 0xffffffffffffffffffffffffffffffffffffffff)
                        }
                    } else {
                        sender = payable(msg.sender);
                    }
                    return sender;
                }
                function _msgSender() internal view override returns (address) {
                    return msgSender();
                }
                function mint(address to, uint256 amount) external override {
                    require(hasRole(PREDICATE_ROLE, _msgSender()), "mint: must have PREDICATE_ROLE to mint");
                    _mint(to, amount);
                }
                function pause() public virtual {
                    require(hasRole(PAUSER_ROLE, _msgSender()), "ERC20PresetMinterPauser: must have pauser role to pause");
                    _pause();
                }
                function unpause() public virtual {
                    require(hasRole(PAUSER_ROLE, _msgSender()), "ERC20PresetMinterPauser: must have pauser role to unpause");
                    _unpause();
                }
                function _beforeTokenTransfer(
                    address from,
                    address to,
                    uint256 amount
                ) internal virtual override(ERC20, ERC20Pausable, ERC20Freezable) {
                    super._beforeTokenTransfer(from, to, amount);
                }
                function freezeAccount(address account, uint256 amount) public {
                    require(hasRole(PAUSER_ROLE, _msgSender()), "freeze: must have pauser role to freeze");
                    _freezeAccount(account, amount);
                }
                function burn(uint256 amount) public override {
                    _transfer(_msgSender(), address(0x000000000000000000000000000000000000dEaD), amount);
                    emit Burn(_msgSender(), amount);
                }
                function burnFrom(address account, uint256 amount) public override {
                    _spendAllowance(account, _msgSender(), amount);
                    _transfer(account, address(0x000000000000000000000000000000000000dEaD), amount);
                    emit Burn(account, amount);
                }
                function totalBurned() public view returns (uint256) {
                    return balanceOf(address(0x000000000000000000000000000000000000dEaD));
                }
            }
            // SPDX-License-Identifier: MIT
            pragma solidity ^0.8.0;
            import "./Initializable.sol";
            contract EIP712Base is Initializable {
                struct EIP712Domain {
                    string name;
                    string version;
                    address verifyingContract;
                    bytes32 salt;
                }
                string public constant ERC712_VERSION = "1";
                bytes32 internal constant EIP712_DOMAIN_TYPEHASH =
                    keccak256(bytes("EIP712Domain(string name,string version,address verifyingContract,bytes32 salt)"));
                bytes32 internal domainSeperator;
                // supposed to be called once while initializing.
                // one of the contractsa that inherits this contract follows proxy pattern
                // so it is not possible to do this in a constructor
                function _initializeEIP712(string memory name) internal initializer {
                    _setDomainSeperator(name);
                }
                function _setDomainSeperator(string memory name) internal {
                    domainSeperator = keccak256(
                        abi.encode(
                            EIP712_DOMAIN_TYPEHASH,
                            keccak256(bytes(name)),
                            keccak256(bytes(ERC712_VERSION)),
                            address(this),
                            bytes32(getChainId())
                        )
                    );
                }
                function getDomainSeperator() public view returns (bytes32) {
                    return domainSeperator;
                }
                function getChainId() public view returns (uint256) {
                    return block.chainid;
                    // uint256 id;
                    // assembly {
                    //     id := block.chainid
                    // }
                    // return id;
                }
                /**
                 * Accept message hash and returns hash message in EIP712 compatible form
                 * So that it can be used to recover signer from signature signed using EIP712 formatted data
                 * https://eips.ethereum.org/EIPS/eip-712
                 * "\\\\x19" makes the encoding deterministic
                 * "\\\\x01" is the version byte to make it compatible to EIP-191
                 */
                function toTypedMessageHash(bytes32 messageHash) internal view returns (bytes32) {
                    return keccak256(abi.encodePacked("\\x19\\x01", getDomainSeperator(), messageHash));
                }
            }
            // SPDX-License-Identifier: MIT
            pragma solidity ^0.8.0;
            import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
            abstract contract ERC20Freezable is ERC20 {
                mapping(address => uint256) public frozenAccount;
                event FrozenAccount(address target, uint256 amount);
                function _freezeAccount(address target, uint256 amount) internal virtual {
                    frozenAccount[target] = amount;
                    emit FrozenAccount(target, amount);
                }
                function _beforeTokenTransfer(
                    address from,
                    address to,
                    uint256 amount
                ) internal virtual override {
                    require(frozenAccount[from] == 0 || !(balanceOf(from) - amount < frozenAccount[from]), "frozen account");
                    super._beforeTokenTransfer(from, to, amount);
                }
                function frozenOf(address account) public view returns (uint256) {
                    return frozenAccount[account];
                }
            }
            // SPDX-License-Identifier: MIT
            pragma solidity ^0.8.0;
            import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
            interface IMintableERC20 is IERC20 {
                /**
                 * @notice called by predicate contract to mint tokens while withdrawing
                 * @dev Should be callable only by MintableERC20Predicate
                 * Make sure minting is done only by this function
                 * @param user user address for whom token is being minted
                 * @param amount amount of token being minted
                 */
                function mint(address user, uint256 amount) external;
            }
            // SPDX-License-Identifier: MIT
            pragma solidity ^0.8.0;
            contract Initializable {
                bool inited = false;
                modifier initializer() {
                    require(!inited, "already inited");
                    _;
                    inited = true;
                }
            }
            // SPDX-License-Identifier: MIT
            pragma solidity ^0.8.0;
            import "./EIP712Base.sol";
            contract NativeMetaTransaction is EIP712Base {
                //using SafeMath for uint256;
                bytes32 private constant META_TRANSACTION_TYPEHASH =
                    keccak256(bytes("MetaTransaction(uint256 nonce,address from,bytes functionSignature)"));
                event MetaTransactionExecuted(address userAddress, address payable relayerAddress, bytes functionSignature);
                mapping(address => uint256) nonces;
                /*
                 * Meta transaction structure.
                 * No point of including value field here as if user is doing value transfer then he has the funds to pay for gas
                 * He should call the desired function directly in that case.
                 */
                struct MetaTransaction {
                    uint256 nonce;
                    address from;
                    bytes functionSignature;
                }
                function executeMetaTransaction(
                    address userAddress,
                    bytes memory functionSignature,
                    bytes32 sigR,
                    bytes32 sigS,
                    uint8 sigV
                ) public payable returns (bytes memory) {
                    MetaTransaction memory metaTx = MetaTransaction({
                        nonce: nonces[userAddress],
                        from: userAddress,
                        functionSignature: functionSignature
                    });
                    require(verify(userAddress, metaTx, sigR, sigS, sigV), "Signer and signature do not match");
                    // increase nonce for user (to avoid re-use)
                    ++nonces[userAddress];
                    emit MetaTransactionExecuted(userAddress, payable(msg.sender), functionSignature);
                    // Append userAddress and relayer address at the end to extract it from calling context
                    (bool success, bytes memory returnData) = address(this).call(abi.encodePacked(functionSignature, userAddress));
                    require(success, "Function call not successful");
                    return returnData;
                }
                function hashMetaTransaction(MetaTransaction memory metaTx) internal pure returns (bytes32) {
                    return
                        keccak256(
                            abi.encode(META_TRANSACTION_TYPEHASH, metaTx.nonce, metaTx.from, keccak256(metaTx.functionSignature))
                        );
                }
                function getNonce(address user) public view returns (uint256 nonce) {
                    nonce = nonces[user];
                }
                function verify(
                    address signer,
                    MetaTransaction memory metaTx,
                    bytes32 sigR,
                    bytes32 sigS,
                    uint8 sigV
                ) internal view returns (bool) {
                    require(signer != address(0), "NativeMetaTransaction: INVALID_SIGNER");
                    return signer == ecrecover(toTypedMessageHash(hashMetaTransaction(metaTx)), sigV, sigR, sigS);
                }
            }
            // SPDX-License-Identifier: MIT
            pragma solidity >=0.8.0 <0.9.0;
            import "@openzeppelin/contracts/access/AccessControlEnumerable.sol";
            import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
            import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
            import "@openzeppelin/contracts/token/ERC1155/IERC1155.sol";
            import "@openzeppelin/contracts/utils/Context.sol";
            abstract contract Withdrawable is Context, AccessControlEnumerable {
                bytes32 public constant WITHDRAWER_ROLE = keccak256("WITHDRAWER_ROLE");
                function withdraw(address to) public {
                    require(hasRole(WITHDRAWER_ROLE, _msgSender()), "[Withdraw] must have withdrawer role to withdraw");
                    payable(to).transfer(address(this).balance);
                }
                function withdraw(address erc20, address to) public {
                    require(hasRole(WITHDRAWER_ROLE, _msgSender()), "[Withdraw] must have withdrawer role to withdraw");
                    IERC20(erc20).transfer(to, IERC20(erc20).balanceOf(address(this)));
                }
                function withdraw(
                    address erc721,
                    address to,
                    uint256 id
                ) public virtual {
                    require(hasRole(WITHDRAWER_ROLE, _msgSender()), "[Withdraw] must have withdrawer role to withdraw");
                    IERC721(erc721).transferFrom(address(this), to, id);
                }
                function withdraw(
                    address erc721,
                    address to,
                    uint256[] memory ids
                ) public virtual {
                    require(hasRole(WITHDRAWER_ROLE, _msgSender()), "[Withdraw] must have withdrawer role to withdraw");
                    for (uint256 i = 0; i < ids.length; ++i) {
                        IERC721(erc721).transferFrom(address(this), to, ids[i]);
                    }
                }
                function withdraw(
                    address erc1155,
                    address to,
                    uint256 id,
                    uint256 amounts,
                    bytes memory data
                ) public {
                    require(hasRole(WITHDRAWER_ROLE, _msgSender()), "[Withdraw] must have withdrawer role to withdraw");
                    IERC1155(erc1155).safeTransferFrom(address(this), to, id, amounts, data);
                }
            }
            

            File 3 of 4: FiatTokenProxy
            pragma solidity ^0.4.24;
            
            // File: zos-lib/contracts/upgradeability/Proxy.sol
            
            /**
             * @title Proxy
             * @dev Implements delegation of calls to other contracts, with proper
             * forwarding of return values and bubbling of failures.
             * It defines a fallback function that delegates all calls to the address
             * returned by the abstract _implementation() internal function.
             */
            contract Proxy {
              /**
               * @dev Fallback function.
               * Implemented entirely in `_fallback`.
               */
              function () payable external {
                _fallback();
              }
            
              /**
               * @return The Address of the implementation.
               */
              function _implementation() internal view returns (address);
            
              /**
               * @dev Delegates execution to an implementation contract.
               * This is a low level function that doesn't return to its internal call site.
               * It will return to the external caller whatever the implementation returns.
               * @param implementation Address to delegate.
               */
              function _delegate(address implementation) internal {
                assembly {
                  // Copy msg.data. We take full control of memory in this inline assembly
                  // block because it will not return to Solidity code. We overwrite the
                  // Solidity scratch pad at memory position 0.
                  calldatacopy(0, 0, calldatasize)
            
                  // Call the implementation.
                  // out and outsize are 0 because we don't know the size yet.
                  let result := delegatecall(gas, implementation, 0, calldatasize, 0, 0)
            
                  // Copy the returned data.
                  returndatacopy(0, 0, returndatasize)
            
                  switch result
                  // delegatecall returns 0 on error.
                  case 0 { revert(0, returndatasize) }
                  default { return(0, returndatasize) }
                }
              }
            
              /**
               * @dev Function that is run as the first thing in the fallback function.
               * Can be redefined in derived contracts to add functionality.
               * Redefinitions must call super._willFallback().
               */
              function _willFallback() internal {
              }
            
              /**
               * @dev fallback implementation.
               * Extracted to enable manual triggering.
               */
              function _fallback() internal {
                _willFallback();
                _delegate(_implementation());
              }
            }
            
            // File: openzeppelin-solidity/contracts/AddressUtils.sol
            
            /**
             * Utility library of inline functions on addresses
             */
            library AddressUtils {
            
              /**
               * Returns whether the target address is a contract
               * @dev This function will return false if invoked during the constructor of a contract,
               * as the code is not actually created until after the constructor finishes.
               * @param addr address to check
               * @return whether the target address is a contract
               */
              function isContract(address addr) internal view returns (bool) {
                uint256 size;
                // XXX Currently there is no better way to check if there is a contract in an address
                // than to check the size of the code at that address.
                // See https://ethereum.stackexchange.com/a/14016/36603
                // for more details about how this works.
                // TODO Check this again before the Serenity release, because all addresses will be
                // contracts then.
                // solium-disable-next-line security/no-inline-assembly
                assembly { size := extcodesize(addr) }
                return size > 0;
              }
            
            }
            
            // File: zos-lib/contracts/upgradeability/UpgradeabilityProxy.sol
            
            /**
             * @title UpgradeabilityProxy
             * @dev This contract implements a proxy that allows to change the
             * implementation address to which it will delegate.
             * Such a change is called an implementation upgrade.
             */
            contract UpgradeabilityProxy is Proxy {
              /**
               * @dev Emitted when the implementation is upgraded.
               * @param implementation Address of the new implementation.
               */
              event Upgraded(address implementation);
            
              /**
               * @dev Storage slot with the address of the current implementation.
               * This is the keccak-256 hash of "org.zeppelinos.proxy.implementation", and is
               * validated in the constructor.
               */
              bytes32 private constant IMPLEMENTATION_SLOT = 0x7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c3;
            
              /**
               * @dev Contract constructor.
               * @param _implementation Address of the initial implementation.
               */
              constructor(address _implementation) public {
                assert(IMPLEMENTATION_SLOT == keccak256("org.zeppelinos.proxy.implementation"));
            
                _setImplementation(_implementation);
              }
            
              /**
               * @dev Returns the current implementation.
               * @return Address of the current implementation
               */
              function _implementation() internal view returns (address impl) {
                bytes32 slot = IMPLEMENTATION_SLOT;
                assembly {
                  impl := sload(slot)
                }
              }
            
              /**
               * @dev Upgrades the proxy to a new implementation.
               * @param newImplementation Address of the new implementation.
               */
              function _upgradeTo(address newImplementation) internal {
                _setImplementation(newImplementation);
                emit Upgraded(newImplementation);
              }
            
              /**
               * @dev Sets the implementation address of the proxy.
               * @param newImplementation Address of the new implementation.
               */
              function _setImplementation(address newImplementation) private {
                require(AddressUtils.isContract(newImplementation), "Cannot set a proxy implementation to a non-contract address");
            
                bytes32 slot = IMPLEMENTATION_SLOT;
            
                assembly {
                  sstore(slot, newImplementation)
                }
              }
            }
            
            // File: zos-lib/contracts/upgradeability/AdminUpgradeabilityProxy.sol
            
            /**
             * @title AdminUpgradeabilityProxy
             * @dev This contract combines an upgradeability proxy with an authorization
             * mechanism for administrative tasks.
             * All external functions in this contract must be guarded by the
             * `ifAdmin` modifier. See ethereum/solidity#3864 for a Solidity
             * feature proposal that would enable this to be done automatically.
             */
            contract AdminUpgradeabilityProxy is UpgradeabilityProxy {
              /**
               * @dev Emitted when the administration has been transferred.
               * @param previousAdmin Address of the previous admin.
               * @param newAdmin Address of the new admin.
               */
              event AdminChanged(address previousAdmin, address newAdmin);
            
              /**
               * @dev Storage slot with the admin of the contract.
               * This is the keccak-256 hash of "org.zeppelinos.proxy.admin", and is
               * validated in the constructor.
               */
              bytes32 private constant ADMIN_SLOT = 0x10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b;
            
              /**
               * @dev Modifier to check whether the `msg.sender` is the admin.
               * If it is, it will run the function. Otherwise, it will delegate the call
               * to the implementation.
               */
              modifier ifAdmin() {
                if (msg.sender == _admin()) {
                  _;
                } else {
                  _fallback();
                }
              }
            
              /**
               * Contract constructor.
               * It sets the `msg.sender` as the proxy administrator.
               * @param _implementation address of the initial implementation.
               */
              constructor(address _implementation) UpgradeabilityProxy(_implementation) public {
                assert(ADMIN_SLOT == keccak256("org.zeppelinos.proxy.admin"));
            
                _setAdmin(msg.sender);
              }
            
              /**
               * @return The address of the proxy admin.
               */
              function admin() external view ifAdmin returns (address) {
                return _admin();
              }
            
              /**
               * @return The address of the implementation.
               */
              function implementation() external view ifAdmin returns (address) {
                return _implementation();
              }
            
              /**
               * @dev Changes the admin of the proxy.
               * Only the current admin can call this function.
               * @param newAdmin Address to transfer proxy administration to.
               */
              function changeAdmin(address newAdmin) external ifAdmin {
                require(newAdmin != address(0), "Cannot change the admin of a proxy to the zero address");
                emit AdminChanged(_admin(), newAdmin);
                _setAdmin(newAdmin);
              }
            
              /**
               * @dev Upgrade the backing implementation of the proxy.
               * Only the admin can call this function.
               * @param newImplementation Address of the new implementation.
               */
              function upgradeTo(address newImplementation) external ifAdmin {
                _upgradeTo(newImplementation);
              }
            
              /**
               * @dev Upgrade the backing implementation of the proxy and call a function
               * on the new implementation.
               * This is useful to initialize the proxied contract.
               * @param newImplementation Address of the new implementation.
               * @param data Data to send as msg.data in the low level call.
               * It should include the signature and the parameters of the function to be
               * called, as described in
               * https://solidity.readthedocs.io/en/develop/abi-spec.html#function-selector-and-argument-encoding.
               */
              function upgradeToAndCall(address newImplementation, bytes data) payable external ifAdmin {
                _upgradeTo(newImplementation);
                require(address(this).call.value(msg.value)(data));
              }
            
              /**
               * @return The admin slot.
               */
              function _admin() internal view returns (address adm) {
                bytes32 slot = ADMIN_SLOT;
                assembly {
                  adm := sload(slot)
                }
              }
            
              /**
               * @dev Sets the address of the proxy admin.
               * @param newAdmin Address of the new proxy admin.
               */
              function _setAdmin(address newAdmin) internal {
                bytes32 slot = ADMIN_SLOT;
            
                assembly {
                  sstore(slot, newAdmin)
                }
              }
            
              /**
               * @dev Only fall back when the sender is not the admin.
               */
              function _willFallback() internal {
                require(msg.sender != _admin(), "Cannot call fallback function from the proxy admin");
                super._willFallback();
              }
            }
            
            // File: contracts/FiatTokenProxy.sol
            
            /**
            * Copyright CENTRE SECZ 2018
            *
            * 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 SOFTWARE.
            */
            
            pragma solidity ^0.4.24;
            
            
            /**
             * @title FiatTokenProxy
             * @dev This contract proxies FiatToken calls and enables FiatToken upgrades
            */ 
            contract FiatTokenProxy is AdminUpgradeabilityProxy {
                constructor(address _implementation) public AdminUpgradeabilityProxy(_implementation) {
                }
            }

            File 4 of 4: FiatTokenV2_1
            // File: @openzeppelin/contracts/math/SafeMath.sol
            
            // SPDX-License-Identifier: MIT
            
            pragma solidity ^0.6.0;
            
            /**
             * @dev Wrappers over Solidity's arithmetic operations with added overflow
             * checks.
             *
             * Arithmetic operations in Solidity wrap on overflow. This can easily result
             * in bugs, because programmers usually assume that an overflow raises an
             * error, which is the standard behavior in high level programming languages.
             * `SafeMath` restores this intuition by reverting the transaction when an
             * operation overflows.
             *
             * Using this library instead of the unchecked operations eliminates an entire
             * class of bugs, so it's recommended to use it always.
             */
            library SafeMath {
                /**
                 * @dev Returns the addition of two unsigned integers, reverting on
                 * overflow.
                 *
                 * Counterpart to Solidity's `+` operator.
                 *
                 * Requirements:
                 *
                 * - Addition cannot overflow.
                 */
                function add(uint256 a, uint256 b) internal pure returns (uint256) {
                    uint256 c = a + b;
                    require(c >= a, "SafeMath: addition overflow");
            
                    return c;
                }
            
                /**
                 * @dev Returns the subtraction of two unsigned integers, reverting on
                 * overflow (when the result is negative).
                 *
                 * Counterpart to Solidity's `-` operator.
                 *
                 * Requirements:
                 *
                 * - Subtraction cannot overflow.
                 */
                function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                    return sub(a, b, "SafeMath: subtraction overflow");
                }
            
                /**
                 * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
                 * overflow (when the result is negative).
                 *
                 * Counterpart to Solidity's `-` operator.
                 *
                 * Requirements:
                 *
                 * - Subtraction cannot overflow.
                 */
                function sub(
                    uint256 a,
                    uint256 b,
                    string memory errorMessage
                ) internal pure returns (uint256) {
                    require(b <= a, errorMessage);
                    uint256 c = a - b;
            
                    return c;
                }
            
                /**
                 * @dev Returns the multiplication of two unsigned integers, reverting on
                 * overflow.
                 *
                 * Counterpart to Solidity's `*` operator.
                 *
                 * Requirements:
                 *
                 * - Multiplication cannot overflow.
                 */
                function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                    // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                    // benefit is lost if 'b' is also tested.
                    // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
                    if (a == 0) {
                        return 0;
                    }
            
                    uint256 c = a * b;
                    require(c / a == b, "SafeMath: multiplication overflow");
            
                    return c;
                }
            
                /**
                 * @dev Returns the integer division of two unsigned integers. Reverts on
                 * division by zero. The result is rounded towards zero.
                 *
                 * Counterpart to Solidity's `/` operator. Note: this function uses a
                 * `revert` opcode (which leaves remaining gas untouched) while Solidity
                 * uses an invalid opcode to revert (consuming all remaining gas).
                 *
                 * Requirements:
                 *
                 * - The divisor cannot be zero.
                 */
                function div(uint256 a, uint256 b) internal pure returns (uint256) {
                    return div(a, b, "SafeMath: division by zero");
                }
            
                /**
                 * @dev Returns the integer division of two unsigned integers. Reverts with custom message on
                 * division by zero. The result is rounded towards zero.
                 *
                 * Counterpart to Solidity's `/` operator. Note: this function uses a
                 * `revert` opcode (which leaves remaining gas untouched) while Solidity
                 * uses an invalid opcode to revert (consuming all remaining gas).
                 *
                 * Requirements:
                 *
                 * - The divisor cannot be zero.
                 */
                function div(
                    uint256 a,
                    uint256 b,
                    string memory errorMessage
                ) internal pure returns (uint256) {
                    require(b > 0, errorMessage);
                    uint256 c = a / b;
                    // assert(a == b * c + a % b); // There is no case in which this doesn't hold
            
                    return c;
                }
            
                /**
                 * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                 * Reverts when dividing by zero.
                 *
                 * Counterpart to Solidity's `%` operator. This function uses a `revert`
                 * opcode (which leaves remaining gas untouched) while Solidity uses an
                 * invalid opcode to revert (consuming all remaining gas).
                 *
                 * Requirements:
                 *
                 * - The divisor cannot be zero.
                 */
                function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                    return mod(a, b, "SafeMath: modulo by zero");
                }
            
                /**
                 * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                 * Reverts with custom message when dividing by zero.
                 *
                 * Counterpart to Solidity's `%` operator. This function uses a `revert`
                 * opcode (which leaves remaining gas untouched) while Solidity uses an
                 * invalid opcode to revert (consuming all remaining gas).
                 *
                 * Requirements:
                 *
                 * - The divisor cannot be zero.
                 */
                function mod(
                    uint256 a,
                    uint256 b,
                    string memory errorMessage
                ) internal pure returns (uint256) {
                    require(b != 0, errorMessage);
                    return a % b;
                }
            }
            
            // File: @openzeppelin/contracts/token/ERC20/IERC20.sol
            
            pragma solidity ^0.6.0;
            
            /**
             * @dev Interface of the ERC20 standard as defined in the EIP.
             */
            interface IERC20 {
                /**
                 * @dev Returns the amount of tokens in existence.
                 */
                function totalSupply() external view returns (uint256);
            
                /**
                 * @dev Returns the amount of tokens owned by `account`.
                 */
                function balanceOf(address account) external view returns (uint256);
            
                /**
                 * @dev Moves `amount` tokens from the caller's account to `recipient`.
                 *
                 * Returns a boolean value indicating whether the operation succeeded.
                 *
                 * Emits a {Transfer} event.
                 */
                function transfer(address recipient, uint256 amount)
                    external
                    returns (bool);
            
                /**
                 * @dev Returns the remaining number of tokens that `spender` will be
                 * allowed to spend on behalf of `owner` through {transferFrom}. This is
                 * zero by default.
                 *
                 * This value changes when {approve} or {transferFrom} are called.
                 */
                function allowance(address owner, address spender)
                    external
                    view
                    returns (uint256);
            
                /**
                 * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
                 *
                 * Returns a boolean value indicating whether the operation succeeded.
                 *
                 * IMPORTANT: Beware that changing an allowance with this method brings the risk
                 * that someone may use both the old and the new allowance by unfortunate
                 * transaction ordering. One possible solution to mitigate this race
                 * condition is to first reduce the spender's allowance to 0 and set the
                 * desired value afterwards:
                 * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                 *
                 * Emits an {Approval} event.
                 */
                function approve(address spender, uint256 amount) external returns (bool);
            
                /**
                 * @dev Moves `amount` tokens from `sender` to `recipient` using the
                 * allowance mechanism. `amount` is then deducted from the caller's
                 * allowance.
                 *
                 * Returns a boolean value indicating whether the operation succeeded.
                 *
                 * Emits a {Transfer} event.
                 */
                function transferFrom(
                    address sender,
                    address recipient,
                    uint256 amount
                ) external returns (bool);
            
                /**
                 * @dev Emitted when `value` tokens are moved from one account (`from`) to
                 * another (`to`).
                 *
                 * Note that `value` may be zero.
                 */
                event Transfer(address indexed from, address indexed to, uint256 value);
            
                /**
                 * @dev Emitted when the allowance of a `spender` for an `owner` is set by
                 * a call to {approve}. `value` is the new allowance.
                 */
                event Approval(
                    address indexed owner,
                    address indexed spender,
                    uint256 value
                );
            }
            
            // File: contracts/v1/AbstractFiatTokenV1.sol
            
            /**
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            abstract contract AbstractFiatTokenV1 is IERC20 {
                function _approve(
                    address owner,
                    address spender,
                    uint256 value
                ) internal virtual;
            
                function _transfer(
                    address from,
                    address to,
                    uint256 value
                ) internal virtual;
            }
            
            // File: contracts/v1/Ownable.sol
            
            /**
             * Copyright (c) 2018 zOS Global Limited.
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            pragma solidity 0.6.12;
            
            /**
             * @notice The Ownable contract has an owner address, and provides basic
             * authorization control functions
             * @dev Forked from https://github.com/OpenZeppelin/openzeppelin-labs/blob/3887ab77b8adafba4a26ace002f3a684c1a3388b/upgradeability_ownership/contracts/ownership/Ownable.sol
             * Modifications:
             * 1. Consolidate OwnableStorage into this contract (7/13/18)
             * 2. Reformat, conform to Solidity 0.6 syntax, and add error messages (5/13/20)
             * 3. Make public functions external (5/27/20)
             */
            contract Ownable {
                // Owner of the contract
                address private _owner;
            
                /**
                 * @dev Event to show ownership has been transferred
                 * @param previousOwner representing the address of the previous owner
                 * @param newOwner representing the address of the new owner
                 */
                event OwnershipTransferred(address previousOwner, address newOwner);
            
                /**
                 * @dev The constructor sets the original owner of the contract to the sender account.
                 */
                constructor() public {
                    setOwner(msg.sender);
                }
            
                /**
                 * @dev Tells the address of the owner
                 * @return the address of the owner
                 */
                function owner() external view returns (address) {
                    return _owner;
                }
            
                /**
                 * @dev Sets a new owner address
                 */
                function setOwner(address newOwner) internal {
                    _owner = newOwner;
                }
            
                /**
                 * @dev Throws if called by any account other than the owner.
                 */
                modifier onlyOwner() {
                    require(msg.sender == _owner, "Ownable: caller is not the owner");
                    _;
                }
            
                /**
                 * @dev Allows the current owner to transfer control of the contract to a newOwner.
                 * @param newOwner The address to transfer ownership to.
                 */
                function transferOwnership(address newOwner) external onlyOwner {
                    require(
                        newOwner != address(0),
                        "Ownable: new owner is the zero address"
                    );
                    emit OwnershipTransferred(_owner, newOwner);
                    setOwner(newOwner);
                }
            }
            
            // File: contracts/v1/Pausable.sol
            
            /**
             * Copyright (c) 2016 Smart Contract Solutions, Inc.
             * Copyright (c) 2018-2020 CENTRE SECZ0
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            /**
             * @notice Base contract which allows children to implement an emergency stop
             * mechanism
             * @dev Forked from https://github.com/OpenZeppelin/openzeppelin-contracts/blob/feb665136c0dae9912e08397c1a21c4af3651ef3/contracts/lifecycle/Pausable.sol
             * Modifications:
             * 1. Added pauser role, switched pause/unpause to be onlyPauser (6/14/2018)
             * 2. Removed whenNotPause/whenPaused from pause/unpause (6/14/2018)
             * 3. Removed whenPaused (6/14/2018)
             * 4. Switches ownable library to use ZeppelinOS (7/12/18)
             * 5. Remove constructor (7/13/18)
             * 6. Reformat, conform to Solidity 0.6 syntax and add error messages (5/13/20)
             * 7. Make public functions external (5/27/20)
             */
            contract Pausable is Ownable {
                event Pause();
                event Unpause();
                event PauserChanged(address indexed newAddress);
            
                address public pauser;
                bool public paused = false;
            
                /**
                 * @dev Modifier to make a function callable only when the contract is not paused.
                 */
                modifier whenNotPaused() {
                    require(!paused, "Pausable: paused");
                    _;
                }
            
                /**
                 * @dev throws if called by any account other than the pauser
                 */
                modifier onlyPauser() {
                    require(msg.sender == pauser, "Pausable: caller is not the pauser");
                    _;
                }
            
                /**
                 * @dev called by the owner to pause, triggers stopped state
                 */
                function pause() external onlyPauser {
                    paused = true;
                    emit Pause();
                }
            
                /**
                 * @dev called by the owner to unpause, returns to normal state
                 */
                function unpause() external onlyPauser {
                    paused = false;
                    emit Unpause();
                }
            
                /**
                 * @dev update the pauser role
                 */
                function updatePauser(address _newPauser) external onlyOwner {
                    require(
                        _newPauser != address(0),
                        "Pausable: new pauser is the zero address"
                    );
                    pauser = _newPauser;
                    emit PauserChanged(pauser);
                }
            }
            
            // File: contracts/v1/Blacklistable.sol
            
            /**
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            /**
             * @title Blacklistable Token
             * @dev Allows accounts to be blacklisted by a "blacklister" role
             */
            contract Blacklistable is Ownable {
                address public blacklister;
                mapping(address => bool) internal blacklisted;
            
                event Blacklisted(address indexed _account);
                event UnBlacklisted(address indexed _account);
                event BlacklisterChanged(address indexed newBlacklister);
            
                /**
                 * @dev Throws if called by any account other than the blacklister
                 */
                modifier onlyBlacklister() {
                    require(
                        msg.sender == blacklister,
                        "Blacklistable: caller is not the blacklister"
                    );
                    _;
                }
            
                /**
                 * @dev Throws if argument account is blacklisted
                 * @param _account The address to check
                 */
                modifier notBlacklisted(address _account) {
                    require(
                        !blacklisted[_account],
                        "Blacklistable: account is blacklisted"
                    );
                    _;
                }
            
                /**
                 * @dev Checks if account is blacklisted
                 * @param _account The address to check
                 */
                function isBlacklisted(address _account) external view returns (bool) {
                    return blacklisted[_account];
                }
            
                /**
                 * @dev Adds account to blacklist
                 * @param _account The address to blacklist
                 */
                function blacklist(address _account) external onlyBlacklister {
                    blacklisted[_account] = true;
                    emit Blacklisted(_account);
                }
            
                /**
                 * @dev Removes account from blacklist
                 * @param _account The address to remove from the blacklist
                 */
                function unBlacklist(address _account) external onlyBlacklister {
                    blacklisted[_account] = false;
                    emit UnBlacklisted(_account);
                }
            
                function updateBlacklister(address _newBlacklister) external onlyOwner {
                    require(
                        _newBlacklister != address(0),
                        "Blacklistable: new blacklister is the zero address"
                    );
                    blacklister = _newBlacklister;
                    emit BlacklisterChanged(blacklister);
                }
            }
            
            // File: contracts/v1/FiatTokenV1.sol
            
            /**
             *
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            /**
             * @title FiatToken
             * @dev ERC20 Token backed by fiat reserves
             */
            contract FiatTokenV1 is AbstractFiatTokenV1, Ownable, Pausable, Blacklistable {
                using SafeMath for uint256;
            
                string public name;
                string public symbol;
                uint8 public decimals;
                string public currency;
                address public masterMinter;
                bool internal initialized;
            
                mapping(address => uint256) internal balances;
                mapping(address => mapping(address => uint256)) internal allowed;
                uint256 internal totalSupply_ = 0;
                mapping(address => bool) internal minters;
                mapping(address => uint256) internal minterAllowed;
            
                event Mint(address indexed minter, address indexed to, uint256 amount);
                event Burn(address indexed burner, uint256 amount);
                event MinterConfigured(address indexed minter, uint256 minterAllowedAmount);
                event MinterRemoved(address indexed oldMinter);
                event MasterMinterChanged(address indexed newMasterMinter);
            
                function initialize(
                    string memory tokenName,
                    string memory tokenSymbol,
                    string memory tokenCurrency,
                    uint8 tokenDecimals,
                    address newMasterMinter,
                    address newPauser,
                    address newBlacklister,
                    address newOwner
                ) public {
                    require(!initialized, "FiatToken: contract is already initialized");
                    require(
                        newMasterMinter != address(0),
                        "FiatToken: new masterMinter is the zero address"
                    );
                    require(
                        newPauser != address(0),
                        "FiatToken: new pauser is the zero address"
                    );
                    require(
                        newBlacklister != address(0),
                        "FiatToken: new blacklister is the zero address"
                    );
                    require(
                        newOwner != address(0),
                        "FiatToken: new owner is the zero address"
                    );
            
                    name = tokenName;
                    symbol = tokenSymbol;
                    currency = tokenCurrency;
                    decimals = tokenDecimals;
                    masterMinter = newMasterMinter;
                    pauser = newPauser;
                    blacklister = newBlacklister;
                    setOwner(newOwner);
                    initialized = true;
                }
            
                /**
                 * @dev Throws if called by any account other than a minter
                 */
                modifier onlyMinters() {
                    require(minters[msg.sender], "FiatToken: caller is not a minter");
                    _;
                }
            
                /**
                 * @dev Function to mint tokens
                 * @param _to The address that will receive the minted tokens.
                 * @param _amount The amount of tokens to mint. Must be less than or equal
                 * to the minterAllowance of the caller.
                 * @return A boolean that indicates if the operation was successful.
                 */
                function mint(address _to, uint256 _amount)
                    external
                    whenNotPaused
                    onlyMinters
                    notBlacklisted(msg.sender)
                    notBlacklisted(_to)
                    returns (bool)
                {
                    require(_to != address(0), "FiatToken: mint to the zero address");
                    require(_amount > 0, "FiatToken: mint amount not greater than 0");
            
                    uint256 mintingAllowedAmount = minterAllowed[msg.sender];
                    require(
                        _amount <= mintingAllowedAmount,
                        "FiatToken: mint amount exceeds minterAllowance"
                    );
            
                    totalSupply_ = totalSupply_.add(_amount);
                    balances[_to] = balances[_to].add(_amount);
                    minterAllowed[msg.sender] = mintingAllowedAmount.sub(_amount);
                    emit Mint(msg.sender, _to, _amount);
                    emit Transfer(address(0), _to, _amount);
                    return true;
                }
            
                /**
                 * @dev Throws if called by any account other than the masterMinter
                 */
                modifier onlyMasterMinter() {
                    require(
                        msg.sender == masterMinter,
                        "FiatToken: caller is not the masterMinter"
                    );
                    _;
                }
            
                /**
                 * @dev Get minter allowance for an account
                 * @param minter The address of the minter
                 */
                function minterAllowance(address minter) external view returns (uint256) {
                    return minterAllowed[minter];
                }
            
                /**
                 * @dev Checks if account is a minter
                 * @param account The address to check
                 */
                function isMinter(address account) external view returns (bool) {
                    return minters[account];
                }
            
                /**
                 * @notice Amount of remaining tokens spender is allowed to transfer on
                 * behalf of the token owner
                 * @param owner     Token owner's address
                 * @param spender   Spender's address
                 * @return Allowance amount
                 */
                function allowance(address owner, address spender)
                    external
                    override
                    view
                    returns (uint256)
                {
                    return allowed[owner][spender];
                }
            
                /**
                 * @dev Get totalSupply of token
                 */
                function totalSupply() external override view returns (uint256) {
                    return totalSupply_;
                }
            
                /**
                 * @dev Get token balance of an account
                 * @param account address The account
                 */
                function balanceOf(address account)
                    external
                    override
                    view
                    returns (uint256)
                {
                    return balances[account];
                }
            
                /**
                 * @notice Set spender's allowance over the caller's tokens to be a given
                 * value.
                 * @param spender   Spender's address
                 * @param value     Allowance amount
                 * @return True if successful
                 */
                function approve(address spender, uint256 value)
                    external
                    override
                    whenNotPaused
                    notBlacklisted(msg.sender)
                    notBlacklisted(spender)
                    returns (bool)
                {
                    _approve(msg.sender, spender, value);
                    return true;
                }
            
                /**
                 * @dev Internal function to set allowance
                 * @param owner     Token owner's address
                 * @param spender   Spender's address
                 * @param value     Allowance amount
                 */
                function _approve(
                    address owner,
                    address spender,
                    uint256 value
                ) internal override {
                    require(owner != address(0), "ERC20: approve from the zero address");
                    require(spender != address(0), "ERC20: approve to the zero address");
                    allowed[owner][spender] = value;
                    emit Approval(owner, spender, value);
                }
            
                /**
                 * @notice Transfer tokens by spending allowance
                 * @param from  Payer's address
                 * @param to    Payee's address
                 * @param value Transfer amount
                 * @return True if successful
                 */
                function transferFrom(
                    address from,
                    address to,
                    uint256 value
                )
                    external
                    override
                    whenNotPaused
                    notBlacklisted(msg.sender)
                    notBlacklisted(from)
                    notBlacklisted(to)
                    returns (bool)
                {
                    require(
                        value <= allowed[from][msg.sender],
                        "ERC20: transfer amount exceeds allowance"
                    );
                    _transfer(from, to, value);
                    allowed[from][msg.sender] = allowed[from][msg.sender].sub(value);
                    return true;
                }
            
                /**
                 * @notice Transfer tokens from the caller
                 * @param to    Payee's address
                 * @param value Transfer amount
                 * @return True if successful
                 */
                function transfer(address to, uint256 value)
                    external
                    override
                    whenNotPaused
                    notBlacklisted(msg.sender)
                    notBlacklisted(to)
                    returns (bool)
                {
                    _transfer(msg.sender, to, value);
                    return true;
                }
            
                /**
                 * @notice Internal function to process transfers
                 * @param from  Payer's address
                 * @param to    Payee's address
                 * @param value Transfer amount
                 */
                function _transfer(
                    address from,
                    address to,
                    uint256 value
                ) internal override {
                    require(from != address(0), "ERC20: transfer from the zero address");
                    require(to != address(0), "ERC20: transfer to the zero address");
                    require(
                        value <= balances[from],
                        "ERC20: transfer amount exceeds balance"
                    );
            
                    balances[from] = balances[from].sub(value);
                    balances[to] = balances[to].add(value);
                    emit Transfer(from, to, value);
                }
            
                /**
                 * @dev Function to add/update a new minter
                 * @param minter The address of the minter
                 * @param minterAllowedAmount The minting amount allowed for the minter
                 * @return True if the operation was successful.
                 */
                function configureMinter(address minter, uint256 minterAllowedAmount)
                    external
                    whenNotPaused
                    onlyMasterMinter
                    returns (bool)
                {
                    minters[minter] = true;
                    minterAllowed[minter] = minterAllowedAmount;
                    emit MinterConfigured(minter, minterAllowedAmount);
                    return true;
                }
            
                /**
                 * @dev Function to remove a minter
                 * @param minter The address of the minter to remove
                 * @return True if the operation was successful.
                 */
                function removeMinter(address minter)
                    external
                    onlyMasterMinter
                    returns (bool)
                {
                    minters[minter] = false;
                    minterAllowed[minter] = 0;
                    emit MinterRemoved(minter);
                    return true;
                }
            
                /**
                 * @dev allows a minter to burn some of its own tokens
                 * Validates that caller is a minter and that sender is not blacklisted
                 * amount is less than or equal to the minter's account balance
                 * @param _amount uint256 the amount of tokens to be burned
                 */
                function burn(uint256 _amount)
                    external
                    whenNotPaused
                    onlyMinters
                    notBlacklisted(msg.sender)
                {
                    uint256 balance = balances[msg.sender];
                    require(_amount > 0, "FiatToken: burn amount not greater than 0");
                    require(balance >= _amount, "FiatToken: burn amount exceeds balance");
            
                    totalSupply_ = totalSupply_.sub(_amount);
                    balances[msg.sender] = balance.sub(_amount);
                    emit Burn(msg.sender, _amount);
                    emit Transfer(msg.sender, address(0), _amount);
                }
            
                function updateMasterMinter(address _newMasterMinter) external onlyOwner {
                    require(
                        _newMasterMinter != address(0),
                        "FiatToken: new masterMinter is the zero address"
                    );
                    masterMinter = _newMasterMinter;
                    emit MasterMinterChanged(masterMinter);
                }
            }
            
            // File: @openzeppelin/contracts/utils/Address.sol
            
            pragma solidity ^0.6.2;
            
            /**
             * @dev Collection of functions related to the address type
             */
            library Address {
                /**
                 * @dev Returns true if `account` is a contract.
                 *
                 * [IMPORTANT]
                 * ====
                 * It is unsafe to assume that an address for which this function returns
                 * false is an externally-owned account (EOA) and not a contract.
                 *
                 * Among others, `isContract` will return false for the following
                 * types of addresses:
                 *
                 *  - an externally-owned account
                 *  - a contract in construction
                 *  - an address where a contract will be created
                 *  - an address where a contract lived, but was destroyed
                 * ====
                 */
                function isContract(address account) internal view returns (bool) {
                    // 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 Replacement for Solidity's `transfer`: sends `amount` wei to
                 * `recipient`, forwarding all available gas and reverting on errors.
                 *
                 * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                 * of certain opcodes, possibly making contracts go over the 2300 gas limit
                 * imposed by `transfer`, making them unable to receive funds via
                 * `transfer`. {sendValue} removes this limitation.
                 *
                 * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                 *
                 * IMPORTANT: because control is transferred to `recipient`, care must be
                 * taken to not create reentrancy vulnerabilities. Consider using
                 * {ReentrancyGuard} or the
                 * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                 */
                function sendValue(address payable recipient, uint256 amount) internal {
                    require(
                        address(this).balance >= amount,
                        "Address: insufficient balance"
                    );
            
                    // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                    (bool success, ) = recipient.call{ value: amount }("");
                    require(
                        success,
                        "Address: unable to send value, recipient may have reverted"
                    );
                }
            
                /**
                 * @dev Performs a Solidity function call using a low level `call`. A
                 * plain`call` is an unsafe replacement for a function call: use this
                 * function instead.
                 *
                 * If `target` reverts with a revert reason, it is bubbled up by this
                 * function (like regular Solidity function calls).
                 *
                 * Returns the raw returned data. To convert to the expected return value,
                 * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                 *
                 * Requirements:
                 *
                 * - `target` must be a contract.
                 * - calling `target` with `data` must not revert.
                 *
                 * _Available since v3.1._
                 */
                function functionCall(address target, bytes memory data)
                    internal
                    returns (bytes memory)
                {
                    return functionCall(target, data, "Address: low-level call failed");
                }
            
                /**
                 * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                 * `errorMessage` as a fallback revert reason when `target` reverts.
                 *
                 * _Available since v3.1._
                 */
                function functionCall(
                    address target,
                    bytes memory data,
                    string memory errorMessage
                ) internal returns (bytes memory) {
                    return _functionCallWithValue(target, data, 0, errorMessage);
                }
            
                /**
                 * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                 * but also transferring `value` wei to `target`.
                 *
                 * Requirements:
                 *
                 * - the calling contract must have an ETH balance of at least `value`.
                 * - the called Solidity function must be `payable`.
                 *
                 * _Available since v3.1._
                 */
                function functionCallWithValue(
                    address target,
                    bytes memory data,
                    uint256 value
                ) internal returns (bytes memory) {
                    return
                        functionCallWithValue(
                            target,
                            data,
                            value,
                            "Address: low-level call with value failed"
                        );
                }
            
                /**
                 * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                 * with `errorMessage` as a fallback revert reason when `target` reverts.
                 *
                 * _Available since v3.1._
                 */
                function functionCallWithValue(
                    address target,
                    bytes memory data,
                    uint256 value,
                    string memory errorMessage
                ) internal returns (bytes memory) {
                    require(
                        address(this).balance >= value,
                        "Address: insufficient balance for call"
                    );
                    return _functionCallWithValue(target, data, value, errorMessage);
                }
            
                function _functionCallWithValue(
                    address target,
                    bytes memory data,
                    uint256 weiValue,
                    string memory errorMessage
                ) private returns (bytes memory) {
                    require(isContract(target), "Address: call to non-contract");
            
                    // solhint-disable-next-line avoid-low-level-calls
                    (bool success, bytes memory returndata) = target.call{
                        value: weiValue
                    }(data);
                    if (success) {
                        return returndata;
                    } else {
                        // Look for revert reason and bubble it up if present
                        if (returndata.length > 0) {
                            // The easiest way to bubble the revert reason is using memory via assembly
            
                            // solhint-disable-next-line no-inline-assembly
                            assembly {
                                let returndata_size := mload(returndata)
                                revert(add(32, returndata), returndata_size)
                            }
                        } else {
                            revert(errorMessage);
                        }
                    }
                }
            }
            
            // File: @openzeppelin/contracts/token/ERC20/SafeERC20.sol
            
            pragma solidity ^0.6.0;
            
            /**
             * @title SafeERC20
             * @dev Wrappers around ERC20 operations that throw on failure (when the token
             * contract returns false). Tokens that return no value (and instead revert or
             * throw on failure) are also supported, non-reverting calls are assumed to be
             * successful.
             * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
             * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
             */
            library SafeERC20 {
                using SafeMath for uint256;
                using Address for address;
            
                function safeTransfer(
                    IERC20 token,
                    address to,
                    uint256 value
                ) internal {
                    _callOptionalReturn(
                        token,
                        abi.encodeWithSelector(token.transfer.selector, to, value)
                    );
                }
            
                function safeTransferFrom(
                    IERC20 token,
                    address from,
                    address to,
                    uint256 value
                ) internal {
                    _callOptionalReturn(
                        token,
                        abi.encodeWithSelector(token.transferFrom.selector, from, to, value)
                    );
                }
            
                /**
                 * @dev Deprecated. This function has issues similar to the ones found in
                 * {IERC20-approve}, and its usage is discouraged.
                 *
                 * Whenever possible, use {safeIncreaseAllowance} and
                 * {safeDecreaseAllowance} instead.
                 */
                function safeApprove(
                    IERC20 token,
                    address spender,
                    uint256 value
                ) internal {
                    // safeApprove should only be called when setting an initial allowance,
                    // or when resetting it to zero. To increase and decrease it, use
                    // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                    // solhint-disable-next-line max-line-length
                    require(
                        (value == 0) || (token.allowance(address(this), spender) == 0),
                        "SafeERC20: approve from non-zero to non-zero allowance"
                    );
                    _callOptionalReturn(
                        token,
                        abi.encodeWithSelector(token.approve.selector, spender, value)
                    );
                }
            
                function safeIncreaseAllowance(
                    IERC20 token,
                    address spender,
                    uint256 value
                ) internal {
                    uint256 newAllowance = token.allowance(address(this), spender).add(
                        value
                    );
                    _callOptionalReturn(
                        token,
                        abi.encodeWithSelector(
                            token.approve.selector,
                            spender,
                            newAllowance
                        )
                    );
                }
            
                function safeDecreaseAllowance(
                    IERC20 token,
                    address spender,
                    uint256 value
                ) internal {
                    uint256 newAllowance = token.allowance(address(this), spender).sub(
                        value,
                        "SafeERC20: decreased allowance below zero"
                    );
                    _callOptionalReturn(
                        token,
                        abi.encodeWithSelector(
                            token.approve.selector,
                            spender,
                            newAllowance
                        )
                    );
                }
            
                /**
                 * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                 * on the return value: the return value is optional (but if data is returned, it must not be false).
                 * @param token The token targeted by the call.
                 * @param data The call data (encoded using abi.encode or one of its variants).
                 */
                function _callOptionalReturn(IERC20 token, bytes memory data) private {
                    // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                    // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
                    // the target address contains contract code and also asserts for success in the low-level call.
            
                    bytes memory returndata = address(token).functionCall(
                        data,
                        "SafeERC20: low-level call failed"
                    );
                    if (returndata.length > 0) {
                        // Return data is optional
                        // solhint-disable-next-line max-line-length
                        require(
                            abi.decode(returndata, (bool)),
                            "SafeERC20: ERC20 operation did not succeed"
                        );
                    }
                }
            }
            
            // File: contracts/v1.1/Rescuable.sol
            
            /**
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            contract Rescuable is Ownable {
                using SafeERC20 for IERC20;
            
                address private _rescuer;
            
                event RescuerChanged(address indexed newRescuer);
            
                /**
                 * @notice Returns current rescuer
                 * @return Rescuer's address
                 */
                function rescuer() external view returns (address) {
                    return _rescuer;
                }
            
                /**
                 * @notice Revert if called by any account other than the rescuer.
                 */
                modifier onlyRescuer() {
                    require(msg.sender == _rescuer, "Rescuable: caller is not the rescuer");
                    _;
                }
            
                /**
                 * @notice Rescue ERC20 tokens locked up in this contract.
                 * @param tokenContract ERC20 token contract address
                 * @param to        Recipient address
                 * @param amount    Amount to withdraw
                 */
                function rescueERC20(
                    IERC20 tokenContract,
                    address to,
                    uint256 amount
                ) external onlyRescuer {
                    tokenContract.safeTransfer(to, amount);
                }
            
                /**
                 * @notice Assign the rescuer role to a given address.
                 * @param newRescuer New rescuer's address
                 */
                function updateRescuer(address newRescuer) external onlyOwner {
                    require(
                        newRescuer != address(0),
                        "Rescuable: new rescuer is the zero address"
                    );
                    _rescuer = newRescuer;
                    emit RescuerChanged(newRescuer);
                }
            }
            
            // File: contracts/v1.1/FiatTokenV1_1.sol
            
            /**
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            /**
             * @title FiatTokenV1_1
             * @dev ERC20 Token backed by fiat reserves
             */
            contract FiatTokenV1_1 is FiatTokenV1, Rescuable {
            
            }
            
            // File: contracts/v2/AbstractFiatTokenV2.sol
            
            /**
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            abstract contract AbstractFiatTokenV2 is AbstractFiatTokenV1 {
                function _increaseAllowance(
                    address owner,
                    address spender,
                    uint256 increment
                ) internal virtual;
            
                function _decreaseAllowance(
                    address owner,
                    address spender,
                    uint256 decrement
                ) internal virtual;
            }
            
            // File: contracts/util/ECRecover.sol
            
            /**
             * Copyright (c) 2016-2019 zOS Global Limited
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            /**
             * @title ECRecover
             * @notice A library that provides a safe ECDSA recovery function
             */
            library ECRecover {
                /**
                 * @notice Recover signer's address from a signed message
                 * @dev Adapted from: https://github.com/OpenZeppelin/openzeppelin-contracts/blob/65e4ffde586ec89af3b7e9140bdc9235d1254853/contracts/cryptography/ECDSA.sol
                 * Modifications: Accept v, r, and s as separate arguments
                 * @param digest    Keccak-256 hash digest of the signed message
                 * @param v         v of the signature
                 * @param r         r of the signature
                 * @param s         s of the signature
                 * @return Signer address
                 */
                function recover(
                    bytes32 digest,
                    uint8 v,
                    bytes32 r,
                    bytes32 s
                ) internal pure returns (address) {
                    // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
                    // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
                    // the valid range for s in (281): 0 < s < secp256k1n ÷ 2 + 1, and for v in (282): v ∈ {27, 28}. Most
                    // signatures from current libraries generate a unique signature with an s-value in the lower half order.
                    //
                    // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
                    // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
                    // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
                    // these malleable signatures as well.
                    if (
                        uint256(s) >
                        0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0
                    ) {
                        revert("ECRecover: invalid signature 's' value");
                    }
            
                    if (v != 27 && v != 28) {
                        revert("ECRecover: invalid signature 'v' value");
                    }
            
                    // If the signature is valid (and not malleable), return the signer address
                    address signer = ecrecover(digest, v, r, s);
                    require(signer != address(0), "ECRecover: invalid signature");
            
                    return signer;
                }
            }
            
            // File: contracts/util/EIP712.sol
            
            /**
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            /**
             * @title EIP712
             * @notice A library that provides EIP712 helper functions
             */
            library EIP712 {
                /**
                 * @notice Make EIP712 domain separator
                 * @param name      Contract name
                 * @param version   Contract version
                 * @return Domain separator
                 */
                function makeDomainSeparator(string memory name, string memory version)
                    internal
                    view
                    returns (bytes32)
                {
                    uint256 chainId;
                    assembly {
                        chainId := chainid()
                    }
                    return
                        keccak256(
                            abi.encode(
                                // keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)")
                                0x8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f,
                                keccak256(bytes(name)),
                                keccak256(bytes(version)),
                                chainId,
                                address(this)
                            )
                        );
                }
            
                /**
                 * @notice Recover signer's address from a EIP712 signature
                 * @param domainSeparator   Domain separator
                 * @param v                 v of the signature
                 * @param r                 r of the signature
                 * @param s                 s of the signature
                 * @param typeHashAndData   Type hash concatenated with data
                 * @return Signer's address
                 */
                function recover(
                    bytes32 domainSeparator,
                    uint8 v,
                    bytes32 r,
                    bytes32 s,
                    bytes memory typeHashAndData
                ) internal pure returns (address) {
                    bytes32 digest = keccak256(
                        abi.encodePacked(
                            "\x19\x01",
                            domainSeparator,
                            keccak256(typeHashAndData)
                        )
                    );
                    return ECRecover.recover(digest, v, r, s);
                }
            }
            
            // File: contracts/v2/EIP712Domain.sol
            
            /**
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            /**
             * @title EIP712 Domain
             */
            contract EIP712Domain {
                /**
                 * @dev EIP712 Domain Separator
                 */
                bytes32 public DOMAIN_SEPARATOR;
            }
            
            // File: contracts/v2/EIP3009.sol
            
            /**
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            /**
             * @title EIP-3009
             * @notice Provide internal implementation for gas-abstracted transfers
             * @dev Contracts that inherit from this must wrap these with publicly
             * accessible functions, optionally adding modifiers where necessary
             */
            abstract contract EIP3009 is AbstractFiatTokenV2, EIP712Domain {
                // keccak256("TransferWithAuthorization(address from,address to,uint256 value,uint256 validAfter,uint256 validBefore,bytes32 nonce)")
                bytes32
                    public constant TRANSFER_WITH_AUTHORIZATION_TYPEHASH = 0x7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a2267;
            
                // keccak256("ReceiveWithAuthorization(address from,address to,uint256 value,uint256 validAfter,uint256 validBefore,bytes32 nonce)")
                bytes32
                    public constant RECEIVE_WITH_AUTHORIZATION_TYPEHASH = 0xd099cc98ef71107a616c4f0f941f04c322d8e254fe26b3c6668db87aae413de8;
            
                // keccak256("CancelAuthorization(address authorizer,bytes32 nonce)")
                bytes32
                    public constant CANCEL_AUTHORIZATION_TYPEHASH = 0x158b0a9edf7a828aad02f63cd515c68ef2f50ba807396f6d12842833a1597429;
            
                /**
                 * @dev authorizer address => nonce => bool (true if nonce is used)
                 */
                mapping(address => mapping(bytes32 => bool)) private _authorizationStates;
            
                event AuthorizationUsed(address indexed authorizer, bytes32 indexed nonce);
                event AuthorizationCanceled(
                    address indexed authorizer,
                    bytes32 indexed nonce
                );
            
                /**
                 * @notice Returns the state of an authorization
                 * @dev Nonces are randomly generated 32-byte data unique to the
                 * authorizer's address
                 * @param authorizer    Authorizer's address
                 * @param nonce         Nonce of the authorization
                 * @return True if the nonce is used
                 */
                function authorizationState(address authorizer, bytes32 nonce)
                    external
                    view
                    returns (bool)
                {
                    return _authorizationStates[authorizer][nonce];
                }
            
                /**
                 * @notice Execute a transfer with a signed authorization
                 * @param from          Payer's address (Authorizer)
                 * @param to            Payee's address
                 * @param value         Amount to be transferred
                 * @param validAfter    The time after which this is valid (unix time)
                 * @param validBefore   The time before which this is valid (unix time)
                 * @param nonce         Unique nonce
                 * @param v             v of the signature
                 * @param r             r of the signature
                 * @param s             s of the signature
                 */
                function _transferWithAuthorization(
                    address from,
                    address to,
                    uint256 value,
                    uint256 validAfter,
                    uint256 validBefore,
                    bytes32 nonce,
                    uint8 v,
                    bytes32 r,
                    bytes32 s
                ) internal {
                    _requireValidAuthorization(from, nonce, validAfter, validBefore);
            
                    bytes memory data = abi.encode(
                        TRANSFER_WITH_AUTHORIZATION_TYPEHASH,
                        from,
                        to,
                        value,
                        validAfter,
                        validBefore,
                        nonce
                    );
                    require(
                        EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == from,
                        "FiatTokenV2: invalid signature"
                    );
            
                    _markAuthorizationAsUsed(from, nonce);
                    _transfer(from, to, value);
                }
            
                /**
                 * @notice Receive a transfer with a signed authorization from the payer
                 * @dev This has an additional check to ensure that the payee's address
                 * matches the caller of this function to prevent front-running attacks.
                 * @param from          Payer's address (Authorizer)
                 * @param to            Payee's address
                 * @param value         Amount to be transferred
                 * @param validAfter    The time after which this is valid (unix time)
                 * @param validBefore   The time before which this is valid (unix time)
                 * @param nonce         Unique nonce
                 * @param v             v of the signature
                 * @param r             r of the signature
                 * @param s             s of the signature
                 */
                function _receiveWithAuthorization(
                    address from,
                    address to,
                    uint256 value,
                    uint256 validAfter,
                    uint256 validBefore,
                    bytes32 nonce,
                    uint8 v,
                    bytes32 r,
                    bytes32 s
                ) internal {
                    require(to == msg.sender, "FiatTokenV2: caller must be the payee");
                    _requireValidAuthorization(from, nonce, validAfter, validBefore);
            
                    bytes memory data = abi.encode(
                        RECEIVE_WITH_AUTHORIZATION_TYPEHASH,
                        from,
                        to,
                        value,
                        validAfter,
                        validBefore,
                        nonce
                    );
                    require(
                        EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == from,
                        "FiatTokenV2: invalid signature"
                    );
            
                    _markAuthorizationAsUsed(from, nonce);
                    _transfer(from, to, value);
                }
            
                /**
                 * @notice Attempt to cancel an authorization
                 * @param authorizer    Authorizer's address
                 * @param nonce         Nonce of the authorization
                 * @param v             v of the signature
                 * @param r             r of the signature
                 * @param s             s of the signature
                 */
                function _cancelAuthorization(
                    address authorizer,
                    bytes32 nonce,
                    uint8 v,
                    bytes32 r,
                    bytes32 s
                ) internal {
                    _requireUnusedAuthorization(authorizer, nonce);
            
                    bytes memory data = abi.encode(
                        CANCEL_AUTHORIZATION_TYPEHASH,
                        authorizer,
                        nonce
                    );
                    require(
                        EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == authorizer,
                        "FiatTokenV2: invalid signature"
                    );
            
                    _authorizationStates[authorizer][nonce] = true;
                    emit AuthorizationCanceled(authorizer, nonce);
                }
            
                /**
                 * @notice Check that an authorization is unused
                 * @param authorizer    Authorizer's address
                 * @param nonce         Nonce of the authorization
                 */
                function _requireUnusedAuthorization(address authorizer, bytes32 nonce)
                    private
                    view
                {
                    require(
                        !_authorizationStates[authorizer][nonce],
                        "FiatTokenV2: authorization is used or canceled"
                    );
                }
            
                /**
                 * @notice Check that authorization is valid
                 * @param authorizer    Authorizer's address
                 * @param nonce         Nonce of the authorization
                 * @param validAfter    The time after which this is valid (unix time)
                 * @param validBefore   The time before which this is valid (unix time)
                 */
                function _requireValidAuthorization(
                    address authorizer,
                    bytes32 nonce,
                    uint256 validAfter,
                    uint256 validBefore
                ) private view {
                    require(
                        now > validAfter,
                        "FiatTokenV2: authorization is not yet valid"
                    );
                    require(now < validBefore, "FiatTokenV2: authorization is expired");
                    _requireUnusedAuthorization(authorizer, nonce);
                }
            
                /**
                 * @notice Mark an authorization as used
                 * @param authorizer    Authorizer's address
                 * @param nonce         Nonce of the authorization
                 */
                function _markAuthorizationAsUsed(address authorizer, bytes32 nonce)
                    private
                {
                    _authorizationStates[authorizer][nonce] = true;
                    emit AuthorizationUsed(authorizer, nonce);
                }
            }
            
            // File: contracts/v2/EIP2612.sol
            
            /**
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            /**
             * @title EIP-2612
             * @notice Provide internal implementation for gas-abstracted approvals
             */
            abstract contract EIP2612 is AbstractFiatTokenV2, EIP712Domain {
                // keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)")
                bytes32
                    public constant PERMIT_TYPEHASH = 0x6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9;
            
                mapping(address => uint256) private _permitNonces;
            
                /**
                 * @notice Nonces for permit
                 * @param owner Token owner's address (Authorizer)
                 * @return Next nonce
                 */
                function nonces(address owner) external view returns (uint256) {
                    return _permitNonces[owner];
                }
            
                /**
                 * @notice Verify a signed approval permit and execute if valid
                 * @param owner     Token owner's address (Authorizer)
                 * @param spender   Spender's address
                 * @param value     Amount of allowance
                 * @param deadline  The time at which this expires (unix time)
                 * @param v         v of the signature
                 * @param r         r of the signature
                 * @param s         s of the signature
                 */
                function _permit(
                    address owner,
                    address spender,
                    uint256 value,
                    uint256 deadline,
                    uint8 v,
                    bytes32 r,
                    bytes32 s
                ) internal {
                    require(deadline >= now, "FiatTokenV2: permit is expired");
            
                    bytes memory data = abi.encode(
                        PERMIT_TYPEHASH,
                        owner,
                        spender,
                        value,
                        _permitNonces[owner]++,
                        deadline
                    );
                    require(
                        EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == owner,
                        "EIP2612: invalid signature"
                    );
            
                    _approve(owner, spender, value);
                }
            }
            
            // File: contracts/v2/FiatTokenV2.sol
            
            /**
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            /**
             * @title FiatToken V2
             * @notice ERC20 Token backed by fiat reserves, version 2
             */
            contract FiatTokenV2 is FiatTokenV1_1, EIP3009, EIP2612 {
                uint8 internal _initializedVersion;
            
                /**
                 * @notice Initialize v2
                 * @param newName   New token name
                 */
                function initializeV2(string calldata newName) external {
                    // solhint-disable-next-line reason-string
                    require(initialized && _initializedVersion == 0);
                    name = newName;
                    DOMAIN_SEPARATOR = EIP712.makeDomainSeparator(newName, "2");
                    _initializedVersion = 1;
                }
            
                /**
                 * @notice Increase the allowance by a given increment
                 * @param spender   Spender's address
                 * @param increment Amount of increase in allowance
                 * @return True if successful
                 */
                function increaseAllowance(address spender, uint256 increment)
                    external
                    whenNotPaused
                    notBlacklisted(msg.sender)
                    notBlacklisted(spender)
                    returns (bool)
                {
                    _increaseAllowance(msg.sender, spender, increment);
                    return true;
                }
            
                /**
                 * @notice Decrease the allowance by a given decrement
                 * @param spender   Spender's address
                 * @param decrement Amount of decrease in allowance
                 * @return True if successful
                 */
                function decreaseAllowance(address spender, uint256 decrement)
                    external
                    whenNotPaused
                    notBlacklisted(msg.sender)
                    notBlacklisted(spender)
                    returns (bool)
                {
                    _decreaseAllowance(msg.sender, spender, decrement);
                    return true;
                }
            
                /**
                 * @notice Execute a transfer with a signed authorization
                 * @param from          Payer's address (Authorizer)
                 * @param to            Payee's address
                 * @param value         Amount to be transferred
                 * @param validAfter    The time after which this is valid (unix time)
                 * @param validBefore   The time before which this is valid (unix time)
                 * @param nonce         Unique nonce
                 * @param v             v of the signature
                 * @param r             r of the signature
                 * @param s             s of the signature
                 */
                function transferWithAuthorization(
                    address from,
                    address to,
                    uint256 value,
                    uint256 validAfter,
                    uint256 validBefore,
                    bytes32 nonce,
                    uint8 v,
                    bytes32 r,
                    bytes32 s
                ) external whenNotPaused notBlacklisted(from) notBlacklisted(to) {
                    _transferWithAuthorization(
                        from,
                        to,
                        value,
                        validAfter,
                        validBefore,
                        nonce,
                        v,
                        r,
                        s
                    );
                }
            
                /**
                 * @notice Receive a transfer with a signed authorization from the payer
                 * @dev This has an additional check to ensure that the payee's address
                 * matches the caller of this function to prevent front-running attacks.
                 * @param from          Payer's address (Authorizer)
                 * @param to            Payee's address
                 * @param value         Amount to be transferred
                 * @param validAfter    The time after which this is valid (unix time)
                 * @param validBefore   The time before which this is valid (unix time)
                 * @param nonce         Unique nonce
                 * @param v             v of the signature
                 * @param r             r of the signature
                 * @param s             s of the signature
                 */
                function receiveWithAuthorization(
                    address from,
                    address to,
                    uint256 value,
                    uint256 validAfter,
                    uint256 validBefore,
                    bytes32 nonce,
                    uint8 v,
                    bytes32 r,
                    bytes32 s
                ) external whenNotPaused notBlacklisted(from) notBlacklisted(to) {
                    _receiveWithAuthorization(
                        from,
                        to,
                        value,
                        validAfter,
                        validBefore,
                        nonce,
                        v,
                        r,
                        s
                    );
                }
            
                /**
                 * @notice Attempt to cancel an authorization
                 * @dev Works only if the authorization is not yet used.
                 * @param authorizer    Authorizer's address
                 * @param nonce         Nonce of the authorization
                 * @param v             v of the signature
                 * @param r             r of the signature
                 * @param s             s of the signature
                 */
                function cancelAuthorization(
                    address authorizer,
                    bytes32 nonce,
                    uint8 v,
                    bytes32 r,
                    bytes32 s
                ) external whenNotPaused {
                    _cancelAuthorization(authorizer, nonce, v, r, s);
                }
            
                /**
                 * @notice Update allowance with a signed permit
                 * @param owner       Token owner's address (Authorizer)
                 * @param spender     Spender's address
                 * @param value       Amount of allowance
                 * @param deadline    Expiration time, seconds since the epoch
                 * @param v           v of the signature
                 * @param r           r of the signature
                 * @param s           s of the signature
                 */
                function permit(
                    address owner,
                    address spender,
                    uint256 value,
                    uint256 deadline,
                    uint8 v,
                    bytes32 r,
                    bytes32 s
                ) external whenNotPaused notBlacklisted(owner) notBlacklisted(spender) {
                    _permit(owner, spender, value, deadline, v, r, s);
                }
            
                /**
                 * @notice Internal function to increase the allowance by a given increment
                 * @param owner     Token owner's address
                 * @param spender   Spender's address
                 * @param increment Amount of increase
                 */
                function _increaseAllowance(
                    address owner,
                    address spender,
                    uint256 increment
                ) internal override {
                    _approve(owner, spender, allowed[owner][spender].add(increment));
                }
            
                /**
                 * @notice Internal function to decrease the allowance by a given decrement
                 * @param owner     Token owner's address
                 * @param spender   Spender's address
                 * @param decrement Amount of decrease
                 */
                function _decreaseAllowance(
                    address owner,
                    address spender,
                    uint256 decrement
                ) internal override {
                    _approve(
                        owner,
                        spender,
                        allowed[owner][spender].sub(
                            decrement,
                            "ERC20: decreased allowance below zero"
                        )
                    );
                }
            }
            
            // File: contracts/v2/FiatTokenV2_1.sol
            
            /**
             * Copyright (c) 2018-2020 CENTRE SECZ
             *
             * 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
             * 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
             * SOFTWARE.
             */
            
            pragma solidity 0.6.12;
            
            // solhint-disable func-name-mixedcase
            
            /**
             * @title FiatToken V2.1
             * @notice ERC20 Token backed by fiat reserves, version 2.1
             */
            contract FiatTokenV2_1 is FiatTokenV2 {
                /**
                 * @notice Initialize v2.1
                 * @param lostAndFound  The address to which the locked funds are sent
                 */
                function initializeV2_1(address lostAndFound) external {
                    // solhint-disable-next-line reason-string
                    require(_initializedVersion == 1);
            
                    uint256 lockedAmount = balances[address(this)];
                    if (lockedAmount > 0) {
                        _transfer(address(this), lostAndFound, lockedAmount);
                    }
                    blacklisted[address(this)] = true;
            
                    _initializedVersion = 2;
                }
            
                /**
                 * @notice Version string for the EIP712 domain separator
                 * @return Version string
                 */
                function version() external view returns (string memory) {
                    return "2";
                }
            }