ETH Price: $2,477.56 (+1.67%)

Transaction Decoder

Block:
11387965 at Dec-04-2020 07:07:30 PM +UTC
Transaction Fee:
0.003580965 ETH $8.87
Gas Used:
238,731 Gas / 15 Gwei

Emitted Events:

95 AdminUpgradeabilityProxy.0xc749d6d5754644288f792c9c75b98447a8a079a3c43533fef92826e4aca9340e( 0xc749d6d5754644288f792c9c75b98447a8a079a3c43533fef92826e4aca9340e, 0000000000000000000000002a4d9aa94f7d5ee5651ebcf94d6e12cd34232433, 0000000000000000000000000000000000000000000000000000000000000217, 00000000000000000000000000000000000000000000000000000000000c4427, 00000000000000000000000000000000000000000000000000000000000c4427 )
96 AdminUpgradeabilityProxy.0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925( 0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925, 0x000000000000000000000000f616aa8c22f100fc8d479dcfc1bd905b4d6fa591, 0x0000000000000000000000000000000000000000000000000000000000000000, 0x0000000000000000000000000000000000000000000000000000000000000217 )
97 AdminUpgradeabilityProxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x000000000000000000000000f616aa8c22f100fc8d479dcfc1bd905b4d6fa591, 0x0000000000000000000000000000000000000000000000000000000000000000, 0x0000000000000000000000000000000000000000000000000000000000000217 )
98 AdminUpgradeabilityProxy.0x7762c6e1d885adfa2e8e2df74bc3809dd765f8c13b2661bc0351a8627446f283( 0x7762c6e1d885adfa2e8e2df74bc3809dd765f8c13b2661bc0351a8627446f283, 0000000000000000000000002a4d9aa94f7d5ee5651ebcf94d6e12cd34232433, 0000000000000000000000000000000000000000000000000000000000000217 )
99 AdminUpgradeabilityProxy.0xa298e22171cbda83bc05dd3c2b92572134fb802fb7b44006a51c3df81ddf0180( 0xa298e22171cbda83bc05dd3c2b92572134fb802fb7b44006a51c3df81ddf0180, 0x000000000000000000000000ce3bd76a757350c85839988079a2a0acf27ec8f4, 0x0000000000000000000000000000000000000000000000000000000000000068, 0000000000000000000000002a4d9aa94f7d5ee5651ebcf94d6e12cd34232433, 00000000000000000000000000000000000000000000000000000000000002ed, 00000000000000000000000000000000000000000000002a1129d09367200000, 0000000000000000000000000000000000000000000000000000000000000080, 0000000000000000000000000000000000000000000000000000000000000000 )
100 MiniMeToken.Transfer( _from=[Receiver] AdminUpgradeabilityProxy, _to=[Sender] 0xce3bd76a757350c85839988079a2a0acf27ec8f4, _amount=12494151124338624339 )
101 MiniMeToken.Transfer( _from=[Receiver] AdminUpgradeabilityProxy, _to=Proxy, _amount=797499007936507936 )
102 AdminUpgradeabilityProxy.0xe49649ad7d04a14b0d2a43dae89f207c0822143ff6f88a6480e88907e4e5c548( 0xe49649ad7d04a14b0d2a43dae89f207c0822143ff6f88a6480e88907e4e5c548, 0x000000000000000000000000ce3bd76a757350c85839988079a2a0acf27ec8f4, 000000000000000000000000000000000000000000000000b8756d5f85087773, 000000000000000000000000000000000000000000000000ad64244030404753, 0000000000000000000000000000000000000000000000000b11491f54c83020 )

Account State Difference:

  Address   Before After State Difference Code
0.063509065965850411 Eth0.067090030965850411 Eth0.003580965
0x2a4D9Aa9...D34232433
0x886058De...db590eA32
0xCe3Bd76a...cF27Ec8f4
302.972978978302623557 Eth
Nonce: 2822
302.969398013302623557 Eth
Nonce: 2823
0.003580965
0xf616AA8c...b4D6Fa591

Execution Trace

AdminUpgradeabilityProxy.28acaf09( )
  • EnokiGeyser.unstake( stakes=[104], data=0x ) => ( totalReward=13291650132275132275, userReward=12494151124338624339, devReward=797499007936507936 )
    • AdminUpgradeabilityProxy.9ce96f8b( )
      • MetadataResolver.getMushroomData( nftContract=0x2a4D9Aa94f7d5Ee5651EbcF94D6e12CD34232433, nftIndex=535, data=0x ) => ( [{name:species, type:uint256, order:1, indexed:false, value:3, valueString:3}, {name:strength, type:uint256, order:2, indexed:false, value:10000000000000000000, valueString:10000000000000000000}, {name:lifespan, type:uint256, order:3, indexed:false, value:803879, valueString:803879}] )
        • AdminUpgradeabilityProxy.9c42f023( )
          • MushroomAdapter.getMushroomData( index=535, data=0x ) => ( [{name:species, type:uint256, order:1, indexed:false, value:3, valueString:3}, {name:strength, type:uint256, order:2, indexed:false, value:10000000000000000000, valueString:10000000000000000000}, {name:lifespan, type:uint256, order:3, indexed:false, value:803879, valueString:803879}] )
            • AdminUpgradeabilityProxy.60e9ffe9( )
            • AdminUpgradeabilityProxy.14feff18( )
              • MetadataResolver.isBurnable( nftContract=0x2a4D9Aa94f7d5Ee5651EbcF94D6e12CD34232433, nftIndex=535 ) => ( True )
                • AdminUpgradeabilityProxy.c6f88d4a( )
                  • MushroomAdapter.isBurnable( index=535 ) => ( True )
                  • AdminUpgradeabilityProxy.42966c68( )
                    • MushroomNFT.burn( tokenId=535 )
                    • MiniMeToken.transfer( _to=0xCe3Bd76a757350c85839988079A2a0AcF27Ec8f4, _amount=12494151124338624339 ) => ( success=True )
                      • AppProxyUpgradeable.4a393149( )
                        • KernelProxy.be00bbd8( )
                          • Kernel.getApp( _namespace=F1F3EB40F5BC1AD1344716CED8B8A0431D840B5783AEA1FD01786BC26F35AC0F, _appId=6B20A3010614EEEBF2138CCEC99F028A61C811B3B1A3343B6FF635985C75C91F ) => ( 0xde3A93028F2283cc28756B3674BD657eaFB992f4 )
                          • TokenManager.onTransfer( _from=0xf616AA8c22F100fc8D479dCfc1BD905b4D6Fa591, _to=0xCe3Bd76a757350c85839988079A2a0AcF27Ec8f4, _amount=12494151124338624339 ) => ( True )
                            • MiniMeToken.balanceOf( _owner=0xCe3Bd76a757350c85839988079A2a0AcF27Ec8f4 ) => ( balance=521484611309523809524 )
                            • MiniMeToken.balanceOf( _owner=0xf616AA8c22F100fc8D479dCfc1BD905b4D6Fa591 ) => ( balance=468949917329478043013 )
                            • MiniMeToken.transfer( _to=0x4f8fDC5D03B21aE85c5E451efE454D6e550fF761, _amount=797499007936507936 ) => ( success=True )
                              • AppProxyUpgradeable.4a393149( )
                                • KernelProxy.be00bbd8( )
                                  • Kernel.getApp( _namespace=F1F3EB40F5BC1AD1344716CED8B8A0431D840B5783AEA1FD01786BC26F35AC0F, _appId=6B20A3010614EEEBF2138CCEC99F028A61C811B3B1A3343B6FF635985C75C91F ) => ( 0xde3A93028F2283cc28756B3674BD657eaFB992f4 )
                                  • TokenManager.onTransfer( _from=0xf616AA8c22F100fc8D479dCfc1BD905b4D6Fa591, _to=0x4f8fDC5D03B21aE85c5E451efE454D6e550fF761, _amount=797499007936507936 ) => ( True )
                                    • MiniMeToken.balanceOf( _owner=0x4f8fDC5D03B21aE85c5E451efE454D6e550fF761 ) => ( balance=344120147817460316721 )
                                    • MiniMeToken.balanceOf( _owner=0xf616AA8c22F100fc8D479dCfc1BD905b4D6Fa591 ) => ( balance=456455766205139418674 )
                                      File 1 of 14: AdminUpgradeabilityProxy
                                      // SPDX-License-Identifier: MIT
                                      
                                      pragma solidity ^0.6.2;
                                      
                                      /**
                                       * @dev Collection of functions related to the address type
                                       */
                                      library Address {
                                          /**
                                           * @dev Returns true if `account` is a contract.
                                           *
                                           * [IMPORTANT]
                                           * ====
                                           * It is unsafe to assume that an address for which this function returns
                                           * false is an externally-owned account (EOA) and not a contract.
                                           *
                                           * Among others, `isContract` will return false for the following
                                           * types of addresses:
                                           *
                                           *  - an externally-owned account
                                           *  - a contract in construction
                                           *  - an address where a contract will be created
                                           *  - an address where a contract lived, but was destroyed
                                           * ====
                                           */
                                          function isContract(address account) internal view returns (bool) {
                                              // This method relies on extcodesize, which returns 0 for contracts in
                                              // construction, since the code is only stored at the end of the
                                              // constructor execution.
                                      
                                              uint256 size;
                                              // solhint-disable-next-line no-inline-assembly
                                              assembly { size := extcodesize(account) }
                                              return size > 0;
                                          }
                                      
                                      }
                                      /**
                                       * @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.
                                       */
                                      abstract contract Proxy {
                                        /**
                                         * @dev Fallback function.
                                         * Implemented entirely in `_fallback`.
                                         */
                                        fallback () payable external {
                                          _fallback();
                                        }
                                      
                                        /**
                                         * @dev Receive function.
                                         * Implemented entirely in `_fallback`.
                                         */
                                        receive () payable external {
                                          _fallback();
                                        }
                                      
                                        /**
                                         * @return The Address of the implementation.
                                         */
                                        function _implementation() internal virtual 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 virtual {
                                        }
                                      
                                        /**
                                         * @dev fallback implementation.
                                         * Extracted to enable manual triggering.
                                         */
                                        function _fallback() internal {
                                          _willFallback();
                                          _delegate(_implementation());
                                        }
                                      }
                                      
                                      /**
                                       * @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 Contract constructor.
                                         * @param _logic Address of the initial implementation.
                                         * @param _data Data to send as msg.data to the implementation to initialize the proxied contract.
                                         * It should include the signature and the parameters of the function to be called, as described in
                                         * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         * This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.
                                         */
                                        constructor(address _logic, bytes memory _data) public payable {
                                          assert(IMPLEMENTATION_SLOT == bytes32(uint256(keccak256('eip1967.proxy.implementation')) - 1));
                                          _setImplementation(_logic);
                                          if(_data.length > 0) {
                                            (bool success,) = _logic.delegatecall(_data);
                                            require(success);
                                          }
                                        }  
                                      
                                        /**
                                         * @dev Emitted when the implementation is upgraded.
                                         * @param implementation Address of the new implementation.
                                         */
                                        event Upgraded(address indexed implementation);
                                      
                                        /**
                                         * @dev Storage slot with the address of the current implementation.
                                         * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
                                         * validated in the constructor.
                                         */
                                        bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                                      
                                        /**
                                         * @dev Returns the current implementation.
                                         * @return impl Address of the current implementation
                                         */
                                        function _implementation() internal override 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) internal {
                                          require(Address.isContract(newImplementation), "Cannot set a proxy implementation to a non-contract address");
                                      
                                          bytes32 slot = IMPLEMENTATION_SLOT;
                                      
                                          assembly {
                                            sstore(slot, newImplementation)
                                          }
                                        }
                                      }
                                      
                                      /**
                                       * @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 {
                                        /**
                                         * Contract constructor.
                                         * @param _logic address of the initial implementation.
                                         * @param _admin Address of the proxy administrator.
                                         * @param _data Data to send as msg.data to the implementation to initialize the proxied contract.
                                         * It should include the signature and the parameters of the function to be called, as described in
                                         * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         * This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.
                                         */
                                        constructor(address _logic, address _admin, bytes memory _data) UpgradeabilityProxy(_logic, _data) public payable {
                                          assert(ADMIN_SLOT == bytes32(uint256(keccak256('eip1967.proxy.admin')) - 1));
                                          _setAdmin(_admin);
                                        }
                                      
                                        /**
                                         * @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 "eip1967.proxy.admin" subtracted by 1, and is
                                         * validated in the constructor.
                                         */
                                      
                                        bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                                      
                                        /**
                                         * @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();
                                          }
                                        }
                                      
                                        /**
                                         * @return The address of the proxy admin.
                                         */
                                        function admin() external ifAdmin returns (address) {
                                          return _admin();
                                        }
                                      
                                        /**
                                         * @return The address of the implementation.
                                         */
                                        function implementation() external 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/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         */
                                        function upgradeToAndCall(address newImplementation, bytes calldata data) payable external ifAdmin {
                                          _upgradeTo(newImplementation);
                                          (bool success,) = newImplementation.delegatecall(data);
                                          require(success);
                                        }
                                      
                                        /**
                                         * @return adm 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 override virtual {
                                          require(msg.sender != _admin(), "Cannot call fallback function from the proxy admin");
                                          super._willFallback();
                                        }
                                      }

                                      File 2 of 14: AdminUpgradeabilityProxy
                                      // SPDX-License-Identifier: MIT
                                      
                                      pragma solidity ^0.6.2;
                                      
                                      /**
                                       * @dev Collection of functions related to the address type
                                       */
                                      library Address {
                                          /**
                                           * @dev Returns true if `account` is a contract.
                                           *
                                           * [IMPORTANT]
                                           * ====
                                           * It is unsafe to assume that an address for which this function returns
                                           * false is an externally-owned account (EOA) and not a contract.
                                           *
                                           * Among others, `isContract` will return false for the following
                                           * types of addresses:
                                           *
                                           *  - an externally-owned account
                                           *  - a contract in construction
                                           *  - an address where a contract will be created
                                           *  - an address where a contract lived, but was destroyed
                                           * ====
                                           */
                                          function isContract(address account) internal view returns (bool) {
                                              // This method relies on extcodesize, which returns 0 for contracts in
                                              // construction, since the code is only stored at the end of the
                                              // constructor execution.
                                      
                                              uint256 size;
                                              // solhint-disable-next-line no-inline-assembly
                                              assembly { size := extcodesize(account) }
                                              return size > 0;
                                          }
                                      
                                      }
                                      /**
                                       * @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.
                                       */
                                      abstract contract Proxy {
                                        /**
                                         * @dev Fallback function.
                                         * Implemented entirely in `_fallback`.
                                         */
                                        fallback () payable external {
                                          _fallback();
                                        }
                                      
                                        /**
                                         * @dev Receive function.
                                         * Implemented entirely in `_fallback`.
                                         */
                                        receive () payable external {
                                          _fallback();
                                        }
                                      
                                        /**
                                         * @return The Address of the implementation.
                                         */
                                        function _implementation() internal virtual 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 virtual {
                                        }
                                      
                                        /**
                                         * @dev fallback implementation.
                                         * Extracted to enable manual triggering.
                                         */
                                        function _fallback() internal {
                                          _willFallback();
                                          _delegate(_implementation());
                                        }
                                      }
                                      
                                      /**
                                       * @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 Contract constructor.
                                         * @param _logic Address of the initial implementation.
                                         * @param _data Data to send as msg.data to the implementation to initialize the proxied contract.
                                         * It should include the signature and the parameters of the function to be called, as described in
                                         * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         * This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.
                                         */
                                        constructor(address _logic, bytes memory _data) public payable {
                                          assert(IMPLEMENTATION_SLOT == bytes32(uint256(keccak256('eip1967.proxy.implementation')) - 1));
                                          _setImplementation(_logic);
                                          if(_data.length > 0) {
                                            (bool success,) = _logic.delegatecall(_data);
                                            require(success);
                                          }
                                        }  
                                      
                                        /**
                                         * @dev Emitted when the implementation is upgraded.
                                         * @param implementation Address of the new implementation.
                                         */
                                        event Upgraded(address indexed implementation);
                                      
                                        /**
                                         * @dev Storage slot with the address of the current implementation.
                                         * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
                                         * validated in the constructor.
                                         */
                                        bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                                      
                                        /**
                                         * @dev Returns the current implementation.
                                         * @return impl Address of the current implementation
                                         */
                                        function _implementation() internal override 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) internal {
                                          require(Address.isContract(newImplementation), "Cannot set a proxy implementation to a non-contract address");
                                      
                                          bytes32 slot = IMPLEMENTATION_SLOT;
                                      
                                          assembly {
                                            sstore(slot, newImplementation)
                                          }
                                        }
                                      }
                                      
                                      /**
                                       * @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 {
                                        /**
                                         * Contract constructor.
                                         * @param _logic address of the initial implementation.
                                         * @param _admin Address of the proxy administrator.
                                         * @param _data Data to send as msg.data to the implementation to initialize the proxied contract.
                                         * It should include the signature and the parameters of the function to be called, as described in
                                         * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         * This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.
                                         */
                                        constructor(address _logic, address _admin, bytes memory _data) UpgradeabilityProxy(_logic, _data) public payable {
                                          assert(ADMIN_SLOT == bytes32(uint256(keccak256('eip1967.proxy.admin')) - 1));
                                          _setAdmin(_admin);
                                        }
                                      
                                        /**
                                         * @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 "eip1967.proxy.admin" subtracted by 1, and is
                                         * validated in the constructor.
                                         */
                                      
                                        bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                                      
                                        /**
                                         * @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();
                                          }
                                        }
                                      
                                        /**
                                         * @return The address of the proxy admin.
                                         */
                                        function admin() external ifAdmin returns (address) {
                                          return _admin();
                                        }
                                      
                                        /**
                                         * @return The address of the implementation.
                                         */
                                        function implementation() external 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/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         */
                                        function upgradeToAndCall(address newImplementation, bytes calldata data) payable external ifAdmin {
                                          _upgradeTo(newImplementation);
                                          (bool success,) = newImplementation.delegatecall(data);
                                          require(success);
                                        }
                                      
                                        /**
                                         * @return adm 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 override virtual {
                                          require(msg.sender != _admin(), "Cannot call fallback function from the proxy admin");
                                          super._willFallback();
                                        }
                                      }

                                      File 3 of 14: MiniMeToken
                                      pragma solidity ^0.4.24;
                                      // File: @aragon/apps-shared-minime/contracts/ITokenController.sol
                                      /// @dev The token controller contract must implement these functions
                                      
                                      
                                      interface ITokenController {
                                          /// @notice Called when `_owner` sends ether to the MiniMe Token contract
                                          /// @param _owner The address that sent the ether to create tokens
                                          /// @return True if the ether is accepted, false if it throws
                                          function proxyPayment(address _owner) external payable returns(bool);
                                      
                                          /// @notice Notifies the controller about a token transfer allowing the
                                          ///  controller to react if desired
                                          /// @param _from The origin of the transfer
                                          /// @param _to The destination of the transfer
                                          /// @param _amount The amount of the transfer
                                          /// @return False if the controller does not authorize the transfer
                                          function onTransfer(address _from, address _to, uint _amount) external returns(bool);
                                      
                                          /// @notice Notifies the controller about an approval allowing the
                                          ///  controller to react if desired
                                          /// @param _owner The address that calls `approve()`
                                          /// @param _spender The spender in the `approve()` call
                                          /// @param _amount The amount in the `approve()` call
                                          /// @return False if the controller does not authorize the approval
                                          function onApprove(address _owner, address _spender, uint _amount) external returns(bool);
                                      }
                                      // File: @aragon/apps-shared-minime/contracts/MiniMeToken.sol
                                      /*
                                          Copyright 2016, Jordi Baylina
                                          This program is free software: you can redistribute it and/or modify
                                          it under the terms of the GNU General Public License as published by
                                          the Free Software Foundation, either version 3 of the License, or
                                          (at your option) any later version.
                                          This program is distributed in the hope that it will be useful,
                                          but WITHOUT ANY WARRANTY; without even the implied warranty of
                                          MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                                          GNU General Public License for more details.
                                          You should have received a copy of the GNU General Public License
                                          along with this program.  If not, see <http://www.gnu.org/licenses/>.
                                       */
                                      
                                      /// @title MiniMeToken Contract
                                      /// @author Jordi Baylina
                                      /// @dev This token contract's goal is to make it easy for anyone to clone this
                                      ///  token using the token distribution at a given block, this will allow DAO's
                                      ///  and DApps to upgrade their features in a decentralized manner without
                                      ///  affecting the original token
                                      /// @dev It is ERC20 compliant, but still needs to under go further testing.
                                      
                                      
                                      contract Controlled {
                                          /// @notice The address of the controller is the only address that can call
                                          ///  a function with this modifier
                                          modifier onlyController {
                                              require(msg.sender == controller);
                                              _;
                                          }
                                      
                                          address public controller;
                                      
                                          function Controlled()  public { controller = msg.sender;}
                                      
                                          /// @notice Changes the controller of the contract
                                          /// @param _newController The new controller of the contract
                                          function changeController(address _newController) onlyController  public {
                                              controller = _newController;
                                          }
                                      }
                                      
                                      contract ApproveAndCallFallBack {
                                          function receiveApproval(
                                              address from,
                                              uint256 _amount,
                                              address _token,
                                              bytes _data
                                          ) public;
                                      }
                                      
                                      /// @dev The actual token contract, the default controller is the msg.sender
                                      ///  that deploys the contract, so usually this token will be deployed by a
                                      ///  token controller contract, which Giveth will call a "Campaign"
                                      contract MiniMeToken is Controlled {
                                      
                                          string public name;                //The Token's name: e.g. DigixDAO Tokens
                                          uint8 public decimals;             //Number of decimals of the smallest unit
                                          string public symbol;              //An identifier: e.g. REP
                                          string public version = "MMT_0.1"; //An arbitrary versioning scheme
                                      
                                      
                                          /// @dev `Checkpoint` is the structure that attaches a block number to a
                                          ///  given value, the block number attached is the one that last changed the
                                          ///  value
                                          struct Checkpoint {
                                      
                                              // `fromBlock` is the block number that the value was generated from
                                              uint128 fromBlock;
                                      
                                              // `value` is the amount of tokens at a specific block number
                                              uint128 value;
                                          }
                                      
                                          // `parentToken` is the Token address that was cloned to produce this token;
                                          //  it will be 0x0 for a token that was not cloned
                                          MiniMeToken public parentToken;
                                      
                                          // `parentSnapShotBlock` is the block number from the Parent Token that was
                                          //  used to determine the initial distribution of the Clone Token
                                          uint public parentSnapShotBlock;
                                      
                                          // `creationBlock` is the block number that the Clone Token was created
                                          uint public creationBlock;
                                      
                                          // `balances` is the map that tracks the balance of each address, in this
                                          //  contract when the balance changes the block number that the change
                                          //  occurred is also included in the map
                                          mapping (address => Checkpoint[]) balances;
                                      
                                          // `allowed` tracks any extra transfer rights as in all ERC20 tokens
                                          mapping (address => mapping (address => uint256)) allowed;
                                      
                                          // Tracks the history of the `totalSupply` of the token
                                          Checkpoint[] totalSupplyHistory;
                                      
                                          // Flag that determines if the token is transferable or not.
                                          bool public transfersEnabled;
                                      
                                          // The factory used to create new clone tokens
                                          MiniMeTokenFactory public tokenFactory;
                                      
                                      ////////////////
                                      // Constructor
                                      ////////////////
                                      
                                          /// @notice Constructor to create a MiniMeToken
                                          /// @param _tokenFactory The address of the MiniMeTokenFactory contract that
                                          ///  will create the Clone token contracts, the token factory needs to be
                                          ///  deployed first
                                          /// @param _parentToken Address of the parent token, set to 0x0 if it is a
                                          ///  new token
                                          /// @param _parentSnapShotBlock Block of the parent token that will
                                          ///  determine the initial distribution of the clone token, set to 0 if it
                                          ///  is a new token
                                          /// @param _tokenName Name of the new token
                                          /// @param _decimalUnits Number of decimals of the new token
                                          /// @param _tokenSymbol Token Symbol for the new token
                                          /// @param _transfersEnabled If true, tokens will be able to be transferred
                                          function MiniMeToken(
                                              MiniMeTokenFactory _tokenFactory,
                                              MiniMeToken _parentToken,
                                              uint _parentSnapShotBlock,
                                              string _tokenName,
                                              uint8 _decimalUnits,
                                              string _tokenSymbol,
                                              bool _transfersEnabled
                                          )  public
                                          {
                                              tokenFactory = _tokenFactory;
                                              name = _tokenName;                                 // Set the name
                                              decimals = _decimalUnits;                          // Set the decimals
                                              symbol = _tokenSymbol;                             // Set the symbol
                                              parentToken = _parentToken;
                                              parentSnapShotBlock = _parentSnapShotBlock;
                                              transfersEnabled = _transfersEnabled;
                                              creationBlock = block.number;
                                          }
                                      
                                      
                                      ///////////////////
                                      // ERC20 Methods
                                      ///////////////////
                                      
                                          /// @notice Send `_amount` tokens to `_to` from `msg.sender`
                                          /// @param _to The address of the recipient
                                          /// @param _amount The amount of tokens to be transferred
                                          /// @return Whether the transfer was successful or not
                                          function transfer(address _to, uint256 _amount) public returns (bool success) {
                                              require(transfersEnabled);
                                              return doTransfer(msg.sender, _to, _amount);
                                          }
                                      
                                          /// @notice Send `_amount` tokens to `_to` from `_from` on the condition it
                                          ///  is approved by `_from`
                                          /// @param _from The address holding the tokens being transferred
                                          /// @param _to The address of the recipient
                                          /// @param _amount The amount of tokens to be transferred
                                          /// @return True if the transfer was successful
                                          function transferFrom(address _from, address _to, uint256 _amount) public returns (bool success) {
                                      
                                              // The controller of this contract can move tokens around at will,
                                              //  this is important to recognize! Confirm that you trust the
                                              //  controller of this contract, which in most situations should be
                                              //  another open source smart contract or 0x0
                                              if (msg.sender != controller) {
                                                  require(transfersEnabled);
                                      
                                                  // The standard ERC 20 transferFrom functionality
                                                  if (allowed[_from][msg.sender] < _amount)
                                                      return false;
                                                  allowed[_from][msg.sender] -= _amount;
                                              }
                                              return doTransfer(_from, _to, _amount);
                                          }
                                      
                                          /// @dev This is the actual transfer function in the token contract, it can
                                          ///  only be called by other functions in this contract.
                                          /// @param _from The address holding the tokens being transferred
                                          /// @param _to The address of the recipient
                                          /// @param _amount The amount of tokens to be transferred
                                          /// @return True if the transfer was successful
                                          function doTransfer(address _from, address _to, uint _amount) internal returns(bool) {
                                              if (_amount == 0) {
                                                  return true;
                                              }
                                              require(parentSnapShotBlock < block.number);
                                              // Do not allow transfer to 0x0 or the token contract itself
                                              require((_to != 0) && (_to != address(this)));
                                              // If the amount being transfered is more than the balance of the
                                              //  account the transfer returns false
                                              var previousBalanceFrom = balanceOfAt(_from, block.number);
                                              if (previousBalanceFrom < _amount) {
                                                  return false;
                                              }
                                              // Alerts the token controller of the transfer
                                              if (isContract(controller)) {
                                                  // Adding the ` == true` makes the linter shut up so...
                                                  require(ITokenController(controller).onTransfer(_from, _to, _amount) == true);
                                              }
                                              // First update the balance array with the new value for the address
                                              //  sending the tokens
                                              updateValueAtNow(balances[_from], previousBalanceFrom - _amount);
                                              // Then update the balance array with the new value for the address
                                              //  receiving the tokens
                                              var previousBalanceTo = balanceOfAt(_to, block.number);
                                              require(previousBalanceTo + _amount >= previousBalanceTo); // Check for overflow
                                              updateValueAtNow(balances[_to], previousBalanceTo + _amount);
                                              // An event to make the transfer easy to find on the blockchain
                                              Transfer(_from, _to, _amount);
                                              return true;
                                          }
                                      
                                          /// @param _owner The address that's balance is being requested
                                          /// @return The balance of `_owner` at the current block
                                          function balanceOf(address _owner) public constant returns (uint256 balance) {
                                              return balanceOfAt(_owner, block.number);
                                          }
                                      
                                          /// @notice `msg.sender` approves `_spender` to spend `_amount` tokens on
                                          ///  its behalf. This is a modified version of the ERC20 approve function
                                          ///  to be a little bit safer
                                          /// @param _spender The address of the account able to transfer the tokens
                                          /// @param _amount The amount of tokens to be approved for transfer
                                          /// @return True if the approval was successful
                                          function approve(address _spender, uint256 _amount) public returns (bool success) {
                                              require(transfersEnabled);
                                      
                                              // To change the approve amount you first have to reduce the addresses`
                                              //  allowance to zero by calling `approve(_spender,0)` if it is not
                                              //  already 0 to mitigate the race condition described here:
                                              //  https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                                              require((_amount == 0) || (allowed[msg.sender][_spender] == 0));
                                      
                                              // Alerts the token controller of the approve function call
                                              if (isContract(controller)) {
                                                  // Adding the ` == true` makes the linter shut up so...
                                                  require(ITokenController(controller).onApprove(msg.sender, _spender, _amount) == true);
                                              }
                                      
                                              allowed[msg.sender][_spender] = _amount;
                                              Approval(msg.sender, _spender, _amount);
                                              return true;
                                          }
                                      
                                          /// @dev This function makes it easy to read the `allowed[]` map
                                          /// @param _owner The address of the account that owns the token
                                          /// @param _spender The address of the account able to transfer the tokens
                                          /// @return Amount of remaining tokens of _owner that _spender is allowed
                                          ///  to spend
                                          function allowance(address _owner, address _spender) public constant returns (uint256 remaining) {
                                              return allowed[_owner][_spender];
                                          }
                                      
                                          /// @notice `msg.sender` approves `_spender` to send `_amount` tokens on
                                          ///  its behalf, and then a function is triggered in the contract that is
                                          ///  being approved, `_spender`. This allows users to use their tokens to
                                          ///  interact with contracts in one function call instead of two
                                          /// @param _spender The address of the contract able to transfer the tokens
                                          /// @param _amount The amount of tokens to be approved for transfer
                                          /// @return True if the function call was successful
                                          function approveAndCall(ApproveAndCallFallBack _spender, uint256 _amount, bytes _extraData) public returns (bool success) {
                                              require(approve(_spender, _amount));
                                      
                                              _spender.receiveApproval(
                                                  msg.sender,
                                                  _amount,
                                                  this,
                                                  _extraData
                                              );
                                      
                                              return true;
                                          }
                                      
                                          /// @dev This function makes it easy to get the total number of tokens
                                          /// @return The total number of tokens
                                          function totalSupply() public constant returns (uint) {
                                              return totalSupplyAt(block.number);
                                          }
                                      
                                      
                                      ////////////////
                                      // Query balance and totalSupply in History
                                      ////////////////
                                      
                                          /// @dev Queries the balance of `_owner` at a specific `_blockNumber`
                                          /// @param _owner The address from which the balance will be retrieved
                                          /// @param _blockNumber The block number when the balance is queried
                                          /// @return The balance at `_blockNumber`
                                          function balanceOfAt(address _owner, uint _blockNumber) public constant returns (uint) {
                                      
                                              // These next few lines are used when the balance of the token is
                                              //  requested before a check point was ever created for this token, it
                                              //  requires that the `parentToken.balanceOfAt` be queried at the
                                              //  genesis block for that token as this contains initial balance of
                                              //  this token
                                              if ((balances[_owner].length == 0) || (balances[_owner][0].fromBlock > _blockNumber)) {
                                                  if (address(parentToken) != 0) {
                                                      return parentToken.balanceOfAt(_owner, min(_blockNumber, parentSnapShotBlock));
                                                  } else {
                                                      // Has no parent
                                                      return 0;
                                                  }
                                      
                                              // This will return the expected balance during normal situations
                                              } else {
                                                  return getValueAt(balances[_owner], _blockNumber);
                                              }
                                          }
                                      
                                          /// @notice Total amount of tokens at a specific `_blockNumber`.
                                          /// @param _blockNumber The block number when the totalSupply is queried
                                          /// @return The total amount of tokens at `_blockNumber`
                                          function totalSupplyAt(uint _blockNumber) public constant returns(uint) {
                                      
                                              // These next few lines are used when the totalSupply of the token is
                                              //  requested before a check point was ever created for this token, it
                                              //  requires that the `parentToken.totalSupplyAt` be queried at the
                                              //  genesis block for this token as that contains totalSupply of this
                                              //  token at this block number.
                                              if ((totalSupplyHistory.length == 0) || (totalSupplyHistory[0].fromBlock > _blockNumber)) {
                                                  if (address(parentToken) != 0) {
                                                      return parentToken.totalSupplyAt(min(_blockNumber, parentSnapShotBlock));
                                                  } else {
                                                      return 0;
                                                  }
                                      
                                              // This will return the expected totalSupply during normal situations
                                              } else {
                                                  return getValueAt(totalSupplyHistory, _blockNumber);
                                              }
                                          }
                                      
                                      ////////////////
                                      // Clone Token Method
                                      ////////////////
                                      
                                          /// @notice Creates a new clone token with the initial distribution being
                                          ///  this token at `_snapshotBlock`
                                          /// @param _cloneTokenName Name of the clone token
                                          /// @param _cloneDecimalUnits Number of decimals of the smallest unit
                                          /// @param _cloneTokenSymbol Symbol of the clone token
                                          /// @param _snapshotBlock Block when the distribution of the parent token is
                                          ///  copied to set the initial distribution of the new clone token;
                                          ///  if the block is zero than the actual block, the current block is used
                                          /// @param _transfersEnabled True if transfers are allowed in the clone
                                          /// @return The address of the new MiniMeToken Contract
                                          function createCloneToken(
                                              string _cloneTokenName,
                                              uint8 _cloneDecimalUnits,
                                              string _cloneTokenSymbol,
                                              uint _snapshotBlock,
                                              bool _transfersEnabled
                                          ) public returns(MiniMeToken)
                                          {
                                              uint256 snapshot = _snapshotBlock == 0 ? block.number - 1 : _snapshotBlock;
                                      
                                              MiniMeToken cloneToken = tokenFactory.createCloneToken(
                                                  this,
                                                  snapshot,
                                                  _cloneTokenName,
                                                  _cloneDecimalUnits,
                                                  _cloneTokenSymbol,
                                                  _transfersEnabled
                                              );
                                      
                                              cloneToken.changeController(msg.sender);
                                      
                                              // An event to make the token easy to find on the blockchain
                                              NewCloneToken(address(cloneToken), snapshot);
                                              return cloneToken;
                                          }
                                      
                                      ////////////////
                                      // Generate and destroy tokens
                                      ////////////////
                                      
                                          /// @notice Generates `_amount` tokens that are assigned to `_owner`
                                          /// @param _owner The address that will be assigned the new tokens
                                          /// @param _amount The quantity of tokens generated
                                          /// @return True if the tokens are generated correctly
                                          function generateTokens(address _owner, uint _amount) onlyController public returns (bool) {
                                              uint curTotalSupply = totalSupply();
                                              require(curTotalSupply + _amount >= curTotalSupply); // Check for overflow
                                              uint previousBalanceTo = balanceOf(_owner);
                                              require(previousBalanceTo + _amount >= previousBalanceTo); // Check for overflow
                                              updateValueAtNow(totalSupplyHistory, curTotalSupply + _amount);
                                              updateValueAtNow(balances[_owner], previousBalanceTo + _amount);
                                              Transfer(0, _owner, _amount);
                                              return true;
                                          }
                                      
                                      
                                          /// @notice Burns `_amount` tokens from `_owner`
                                          /// @param _owner The address that will lose the tokens
                                          /// @param _amount The quantity of tokens to burn
                                          /// @return True if the tokens are burned correctly
                                          function destroyTokens(address _owner, uint _amount) onlyController public returns (bool) {
                                              uint curTotalSupply = totalSupply();
                                              require(curTotalSupply >= _amount);
                                              uint previousBalanceFrom = balanceOf(_owner);
                                              require(previousBalanceFrom >= _amount);
                                              updateValueAtNow(totalSupplyHistory, curTotalSupply - _amount);
                                              updateValueAtNow(balances[_owner], previousBalanceFrom - _amount);
                                              Transfer(_owner, 0, _amount);
                                              return true;
                                          }
                                      
                                      ////////////////
                                      // Enable tokens transfers
                                      ////////////////
                                      
                                      
                                          /// @notice Enables token holders to transfer their tokens freely if true
                                          /// @param _transfersEnabled True if transfers are allowed in the clone
                                          function enableTransfers(bool _transfersEnabled) onlyController public {
                                              transfersEnabled = _transfersEnabled;
                                          }
                                      
                                      ////////////////
                                      // Internal helper functions to query and set a value in a snapshot array
                                      ////////////////
                                      
                                          /// @dev `getValueAt` retrieves the number of tokens at a given block number
                                          /// @param checkpoints The history of values being queried
                                          /// @param _block The block number to retrieve the value at
                                          /// @return The number of tokens being queried
                                          function getValueAt(Checkpoint[] storage checkpoints, uint _block) constant internal returns (uint) {
                                              if (checkpoints.length == 0)
                                                  return 0;
                                      
                                              // Shortcut for the actual value
                                              if (_block >= checkpoints[checkpoints.length-1].fromBlock)
                                                  return checkpoints[checkpoints.length-1].value;
                                              if (_block < checkpoints[0].fromBlock)
                                                  return 0;
                                      
                                              // Binary search of the value in the array
                                              uint min = 0;
                                              uint max = checkpoints.length-1;
                                              while (max > min) {
                                                  uint mid = (max + min + 1) / 2;
                                                  if (checkpoints[mid].fromBlock<=_block) {
                                                      min = mid;
                                                  } else {
                                                      max = mid-1;
                                                  }
                                              }
                                              return checkpoints[min].value;
                                          }
                                      
                                          /// @dev `updateValueAtNow` used to update the `balances` map and the
                                          ///  `totalSupplyHistory`
                                          /// @param checkpoints The history of data being updated
                                          /// @param _value The new number of tokens
                                          function updateValueAtNow(Checkpoint[] storage checkpoints, uint _value) internal {
                                              if ((checkpoints.length == 0) || (checkpoints[checkpoints.length - 1].fromBlock < block.number)) {
                                                  Checkpoint storage newCheckPoint = checkpoints[checkpoints.length++];
                                                  newCheckPoint.fromBlock = uint128(block.number);
                                                  newCheckPoint.value = uint128(_value);
                                              } else {
                                                  Checkpoint storage oldCheckPoint = checkpoints[checkpoints.length - 1];
                                                  oldCheckPoint.value = uint128(_value);
                                              }
                                          }
                                      
                                          /// @dev Internal function to determine if an address is a contract
                                          /// @param _addr The address being queried
                                          /// @return True if `_addr` is a contract
                                          function isContract(address _addr) constant internal returns(bool) {
                                              uint size;
                                              if (_addr == 0)
                                                  return false;
                                      
                                              assembly {
                                                  size := extcodesize(_addr)
                                              }
                                      
                                              return size>0;
                                          }
                                      
                                          /// @dev Helper function to return a min betwen the two uints
                                          function min(uint a, uint b) pure internal returns (uint) {
                                              return a < b ? a : b;
                                          }
                                      
                                          /// @notice The fallback function: If the contract's controller has not been
                                          ///  set to 0, then the `proxyPayment` method is called which relays the
                                          ///  ether and creates tokens as described in the token controller contract
                                          function () external payable {
                                              require(isContract(controller));
                                              // Adding the ` == true` makes the linter shut up so...
                                              require(ITokenController(controller).proxyPayment.value(msg.value)(msg.sender) == true);
                                          }
                                      
                                      //////////
                                      // Safety Methods
                                      //////////
                                      
                                          /// @notice This method can be used by the controller to extract mistakenly
                                          ///  sent tokens to this contract.
                                          /// @param _token The address of the token contract that you want to recover
                                          ///  set to 0 in case you want to extract ether.
                                          function claimTokens(address _token) onlyController public {
                                              if (_token == 0x0) {
                                                  controller.transfer(this.balance);
                                                  return;
                                              }
                                      
                                              MiniMeToken token = MiniMeToken(_token);
                                              uint balance = token.balanceOf(this);
                                              token.transfer(controller, balance);
                                              ClaimedTokens(_token, controller, balance);
                                          }
                                      
                                      ////////////////
                                      // Events
                                      ////////////////
                                          event ClaimedTokens(address indexed _token, address indexed _controller, uint _amount);
                                          event Transfer(address indexed _from, address indexed _to, uint256 _amount);
                                          event NewCloneToken(address indexed _cloneToken, uint _snapshotBlock);
                                          event Approval(
                                              address indexed _owner,
                                              address indexed _spender,
                                              uint256 _amount
                                              );
                                      
                                      }
                                      
                                      
                                      ////////////////
                                      // MiniMeTokenFactory
                                      ////////////////
                                      
                                      /// @dev This contract is used to generate clone contracts from a contract.
                                      ///  In solidity this is the way to create a contract from a contract of the
                                      ///  same class
                                      contract MiniMeTokenFactory {
                                      
                                          /// @notice Update the DApp by creating a new token with new functionalities
                                          ///  the msg.sender becomes the controller of this clone token
                                          /// @param _parentToken Address of the token being cloned
                                          /// @param _snapshotBlock Block of the parent token that will
                                          ///  determine the initial distribution of the clone token
                                          /// @param _tokenName Name of the new token
                                          /// @param _decimalUnits Number of decimals of the new token
                                          /// @param _tokenSymbol Token Symbol for the new token
                                          /// @param _transfersEnabled If true, tokens will be able to be transferred
                                          /// @return The address of the new token contract
                                          function createCloneToken(
                                              MiniMeToken _parentToken,
                                              uint _snapshotBlock,
                                              string _tokenName,
                                              uint8 _decimalUnits,
                                              string _tokenSymbol,
                                              bool _transfersEnabled
                                          ) public returns (MiniMeToken)
                                          {
                                              MiniMeToken newToken = new MiniMeToken(
                                                  this,
                                                  _parentToken,
                                                  _snapshotBlock,
                                                  _tokenName,
                                                  _decimalUnits,
                                                  _tokenSymbol,
                                                  _transfersEnabled
                                              );
                                      
                                              newToken.changeController(msg.sender);
                                              return newToken;
                                          }
                                      }

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

                                      File 5 of 14: EnokiGeyser
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      /*
                                          Approve and Ban Contracts to interact with pools.
                                          (All contracts are approved by default, unless banned)
                                      */
                                      contract BannedContractList is Initializable, OwnableUpgradeSafe {
                                          mapping(address => bool) banned;
                                          function initialize() public initializer {
                                              __Ownable_init();
                                          }
                                          function isApproved(address toCheck) external view returns (bool) {
                                              return !banned[toCheck];
                                          }
                                          function isBanned(address toCheck) external view returns (bool) {
                                              return banned[toCheck];
                                          }
                                          function approveContract(address toApprove) external onlyOwner {
                                              banned[toApprove] = false;
                                          }
                                          function banContract(address toBan) external onlyOwner {
                                              banned[toBan] = true;
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../GSN/Context.sol";
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Contract module which provides a basic access control mechanism, where
                                       * there is an account (an owner) that can be granted exclusive access to
                                       * specific functions.
                                       *
                                       * By default, the owner account will be the one that deploys the contract. This
                                       * can later be changed with {transferOwnership}.
                                       *
                                       * This module is used through inheritance. It will make available the modifier
                                       * `onlyOwner`, which can be applied to your functions to restrict their use to
                                       * the owner.
                                       */
                                      contract OwnableUpgradeSafe is Initializable, ContextUpgradeSafe {
                                          address private _owner;
                                          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                                          /**
                                           * @dev Initializes the contract setting the deployer as the initial owner.
                                           */
                                          function __Ownable_init() internal initializer {
                                              __Context_init_unchained();
                                              __Ownable_init_unchained();
                                          }
                                          function __Ownable_init_unchained() internal initializer {
                                              address msgSender = _msgSender();
                                              _owner = msgSender;
                                              emit OwnershipTransferred(address(0), msgSender);
                                          }
                                          /**
                                           * @dev Returns the address of the current owner.
                                           */
                                          function owner() public view returns (address) {
                                              return _owner;
                                          }
                                          /**
                                           * @dev Throws if called by any account other than the owner.
                                           */
                                          modifier onlyOwner() {
                                              require(_owner == _msgSender(), "Ownable: caller is not the owner");
                                              _;
                                          }
                                          /**
                                           * @dev Leaves the contract without owner. It will not be possible to call
                                           * `onlyOwner` functions anymore. Can only be called by the current owner.
                                           *
                                           * NOTE: Renouncing ownership will leave the contract without an owner,
                                           * thereby removing any functionality that is only available to the owner.
                                           */
                                          function renounceOwnership() public virtual onlyOwner {
                                              emit OwnershipTransferred(_owner, address(0));
                                              _owner = address(0);
                                          }
                                          /**
                                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                                           * Can only be called by the current owner.
                                           */
                                          function transferOwnership(address newOwner) public virtual onlyOwner {
                                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                                              emit OwnershipTransferred(_owner, newOwner);
                                              _owner = newOwner;
                                          }
                                          uint256[49] private __gap;
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../Initializable.sol";
                                      /*
                                       * @dev Provides information about the current execution context, including the
                                       * sender of the transaction and its data. While these are generally available
                                       * via msg.sender and msg.data, they should not be accessed in such a direct
                                       * manner, since when dealing with GSN meta-transactions the account sending and
                                       * paying for execution may not be the actual sender (as far as an application
                                       * is concerned).
                                       *
                                       * This contract is only required for intermediate, library-like contracts.
                                       */
                                      contract ContextUpgradeSafe is Initializable {
                                          // Empty internal constructor, to prevent people from mistakenly deploying
                                          // an instance of this contract, which should be used via inheritance.
                                          function __Context_init() internal initializer {
                                              __Context_init_unchained();
                                          }
                                          function __Context_init_unchained() internal initializer {
                                          }
                                          function _msgSender() internal view virtual returns (address payable) {
                                              return msg.sender;
                                          }
                                          function _msgData() internal view virtual returns (bytes memory) {
                                              this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                                              return msg.data;
                                          }
                                          uint256[50] private __gap;
                                      }
                                      pragma solidity >=0.4.24 <0.7.0;
                                      /**
                                       * @title Initializable
                                       *
                                       * @dev Helper contract to support initializer functions. To use it, replace
                                       * the constructor with a function that has the `initializer` modifier.
                                       * WARNING: Unlike constructors, initializer functions must be manually
                                       * invoked. This applies both to deploying an Initializable contract, as well
                                       * as extending an Initializable contract via inheritance.
                                       * WARNING: When used with inheritance, manual care must be taken to not invoke
                                       * a parent initializer twice, or ensure that all initializers are idempotent,
                                       * because this is not dealt with automatically as with constructors.
                                       */
                                      contract Initializable {
                                        /**
                                         * @dev Indicates that the contract has been initialized.
                                         */
                                        bool private initialized;
                                        /**
                                         * @dev Indicates that the contract is in the process of being initialized.
                                         */
                                        bool private initializing;
                                        /**
                                         * @dev Modifier to use in the initializer function of a contract.
                                         */
                                        modifier initializer() {
                                          require(initializing || isConstructor() || !initialized, "Contract instance has already been initialized");
                                          bool isTopLevelCall = !initializing;
                                          if (isTopLevelCall) {
                                            initializing = true;
                                            initialized = true;
                                          }
                                          _;
                                          if (isTopLevelCall) {
                                            initializing = false;
                                          }
                                        }
                                        /// @dev Returns true if and only if the function is running in the constructor
                                        function isConstructor() private view returns (bool) {
                                          // extcodesize checks the size of the code stored in an address, and
                                          // address returns the current address. Since the code is still not
                                          // deployed when running a constructor, any checks on its code size will
                                          // yield zero, making it an effective way to detect if a contract is
                                          // under construction or not.
                                          address self = address(this);
                                          uint256 cs;
                                          assembly { cs := extcodesize(self) }
                                          return cs == 0;
                                        }
                                        // Reserved storage space to allow for layout changes in the future.
                                        uint256[50] private ______gap;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "./BannedContractList.sol";
                                      /*
                                          Prevent smart contracts from calling functions unless approved by the specified whitelist.
                                      */
                                      contract Defensible {
                                       // Only smart contracts will be affected by this modifier
                                        modifier defend(BannedContractList bannedContractList) {
                                          require(
                                            (msg.sender == tx.origin) || bannedContractList.isApproved(msg.sender),
                                            "This smart contract has not been approved"
                                          );
                                          _;
                                        }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      /* 
                                          - Stake up to X mushrooms per user (dao can change)
                                          - Reward mushroom yield rate for lifespan
                                          - When dead, burn mushroom erc721
                                          - Distribute 5% of ENOKI rewards to Chefs
                                      */
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      // import "@openzeppelin/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/ReentrancyGuard.sol";
                                      import "./TokenPool.sol";
                                      import "./Defensible.sol";
                                      import "./MushroomNFT.sol";
                                      import "./MushroomLib.sol";
                                      import "./metadata/MetadataResolver.sol";
                                      /**
                                       * @title Enoki Geyser
                                       * @dev A smart-contract based mechanism to distribute tokens over time, inspired loosely by
                                       *      Compound and Uniswap.
                                       *
                                       *      Distribution tokens are added to a locked pool in the contract and become unlocked over time
                                       *      according to a once-configurable unlock schedule. Once unlocked, they are available to be
                                       *      claimed by users.
                                       *
                                       *      A user may deposit tokens to accrue ownership share over the unlocked pool. This owner share
                                       *      is a function of the number of tokens deposited as well as the length of time deposited.
                                       *      Specifically, a user's share of the currently-unlocked pool equals their "deposit-seconds"
                                       *      divided by the global "deposit-seconds". This aligns the new token distribution with long
                                       *      term supporters of the project, addressing one of the major drawbacks of simple airdrops.
                                       *
                                       *      More background and motivation available at:
                                       *      https://github.com/ampleforth/RFCs/blob/master/RFCs/rfc-1.md
                                       */
                                      contract EnokiGeyser is Initializable, OwnableUpgradeSafe, AccessControlUpgradeSafe, ReentrancyGuardUpgradeSafe, Defensible {
                                          using SafeMath for uint256;
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          event Staked(address indexed user, address nftContract, uint256 nftId, uint256 total, bytes data);
                                          event Unstaked(address indexed user, address nftContract, uint256 nftId, uint256 total, uint256 indexed stakeIndex, bytes data);
                                          event TokensClaimed(address indexed user, uint256 amount, uint256 userReward, uint256 devReward);
                                          event TokensLocked(uint256 amount, uint256 total);
                                          event TokensLockedAirdrop(uint256 amount, uint256 total);
                                          event LifespanUsed(address nftContract, uint256 nftIndex, uint256 lifespanUsed, uint256 lifespan);
                                          event NewLifespan(address nftContract, uint256 nftIndex, uint256 lifespan);
                                          // amount: Unlocked tokens, total: Total locked tokens
                                          event TokensUnlocked(uint256 amount, uint256 total);
                                          event MaxStakesPerAddressSet(uint256 maxStakesPerAddress);
                                          event MetadataResolverSet(address metadataResolver);
                                          event BurnedMushroom(address nftContract, uint256 nftIndex);
                                          TokenPool public _unlockedPool;
                                          TokenPool public _lockedPool;
                                          MetadataResolver public metadataResolver;
                                          //
                                          // Time-bonus params
                                          //
                                          uint256 public constant BONUS_DECIMALS = 2;
                                          uint256 public startBonus = 0;
                                          uint256 public bonusPeriodSec = 0;
                                          uint256 public maxStakesPerAddress = 0;
                                          //
                                          // Global accounting state
                                          //
                                          uint256 public totalLockedShares = 0;
                                          uint256 public totalStakingShares = 0;
                                          uint256 public totalStrengthStaked = 0;
                                          uint256 private _totalStakingShareSeconds = 0;
                                          uint256 private _lastAccountingTimestampSec = now;
                                          uint256 private _maxUnlockSchedules = 0;
                                          uint256 private _initialSharesPerToken = 0;
                                          //
                                          // Dev reward state
                                          //
                                          uint256 public constant MAX_PERCENTAGE = 100;
                                          uint256 public devRewardPercentage = 0; //0% - 100%
                                          address public devRewardAddress;
                                          address public admin;
                                          BannedContractList public bannedContractList;
                                          //
                                          // User accounting state
                                          //
                                          // Represents a single stake for a user. A user may have multiple.
                                          struct Stake {
                                              address nftContract;
                                              uint256 nftIndex;
                                              uint256 strength;
                                              uint256 stakedAt;
                                          }
                                          // Caches aggregated values from the User->Stake[] map to save computation.
                                          // If lastAccountingTimestampSec is 0, there's no entry for that user.
                                          struct UserTotals {
                                              uint256 userStrengthStaked;
                                              uint256 stakingShareSeconds;
                                              uint256 lastAccountingTimestampSec;
                                          }
                                          // Aggregated staking values per user
                                          mapping(address => UserTotals) private _userTotals;
                                          // The collection of stakes for each user. Ordered by timestamp, earliest to latest.
                                          mapping(address => Stake[]) private _userStakes;
                                          //
                                          // Locked/Unlocked Accounting state
                                          //
                                          struct UnlockSchedule {
                                              uint256 initialLockedShares;
                                              uint256 unlockedShares;
                                              uint256 lastUnlockTimestampSec;
                                              uint256 endAtSec;
                                              uint256 durationSec;
                                          }
                                          UnlockSchedule[] public unlockSchedules;
                                          bool public initializeComplete;
                                          uint256 public constant SECONDS_PER_WEEK = 604800;
                                          uint256 public usedAirdropPool;
                                          uint256 public maxAirdropPool;
                                          address internal constant INITIALIZER_ADDRESS = 0xe9673e2806305557Daa67E3207c123Af9F95F9d2;
                                          IERC20 public enokiToken;
                                          uint256 public stakingEnabledTime;
                                          /**
                                           * @param enokiToken_ The token users receive as they unstake.
                                           * @param maxStakesPerAddress_ Maximum number of NFTs stakeable by a given account.
                                           * @param devRewardAddress_ Recipient address of dev rewards.
                                           * @param devRewardPercentage_ Pecentage of rewards claimed to be distributed for dev address.
                                           */
                                          function initialize(
                                              IERC20 enokiToken_,
                                              uint256 maxStakesPerAddress_,
                                              address devRewardAddress_,
                                              uint256 devRewardPercentage_,
                                              address bannedContractList_,
                                              uint256 stakingEnabledTime_,
                                              uint256 maxAirdropPool_,
                                              address resolver_
                                          ) public {
                                              require(msg.sender == INITIALIZER_ADDRESS, "Only deployer can reinitialize");
                                              require(admin == address(0), "Admin has already been initialized");
                                              require(initializeComplete == false, "Initialization already complete");
                                              // The dev reward must be some fraction of the max. (i.e. <= 100%)
                                              require(devRewardPercentage_ <= MAX_PERCENTAGE, "EnokiGeyser: dev reward too high");
                                              enokiToken = enokiToken_;
                                              maxStakesPerAddress = maxStakesPerAddress_;
                                              emit MaxStakesPerAddressSet(maxStakesPerAddress);
                                              devRewardPercentage = devRewardPercentage_;
                                              devRewardAddress = devRewardAddress_;
                                              stakingEnabledTime = stakingEnabledTime_;
                                              maxAirdropPool = maxAirdropPool_;
                                              metadataResolver = MetadataResolver(resolver_);
                                              emit MetadataResolverSet(address(metadataResolver));
                                              _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                                              bannedContractList = BannedContractList(bannedContractList_);
                                              initializeComplete = true;
                                          }
                                          modifier onlyAdmin() {
                                              require(hasRole(DEFAULT_ADMIN_ROLE, msg.sender), "EnokiGeyser: Only Admin");
                                              _;
                                          }
                                          /* ========== ADMIN FUNCTIONALITY ========== */
                                          // Only effects future stakes
                                          function setMaxStakesPerAddress(uint256 maxStakes) public onlyAdmin {
                                              maxStakesPerAddress = maxStakes;
                                              emit MaxStakesPerAddressSet(maxStakesPerAddress);
                                          }
                                          function setMetadataResolver(address resolver_) public onlyAdmin {
                                              metadataResolver = MetadataResolver(resolver_);
                                              emit MetadataResolverSet(address(metadataResolver));
                                          }
                                          /**
                                           * @return The token users receive as they unstake.
                                           */
                                          function getDistributionToken() public view returns (IERC20) {
                                              return enokiToken;
                                          }
                                          function getNumStakes(address user) external view returns (uint256) {
                                              return _userStakes[user].length;
                                          }
                                          function getStakes(address user) external view returns (Stake[] memory) {
                                              uint256 numStakes = _userStakes[user].length;
                                              Stake[] memory stakes = new Stake[](numStakes);
                                              for (uint256 i = 0; i < _userStakes[user].length; i++) {
                                                  stakes[i] = _userStakes[user][i];
                                              }
                                              return stakes;
                                          }
                                          function getStake(address user, uint256 stakeIndex) external view returns (Stake memory stake) {
                                              Stake storage _userStake = _userStakes[user][stakeIndex];
                                              stake = _userStake;
                                          }
                                          /**
                                           * @dev Transfers amount of deposit tokens from the user.
                                           * @param data Not used.
                                           */
                                          function stake(
                                              address nftContract,
                                              uint256 nftIndex,
                                              bytes calldata data
                                          ) external defend(bannedContractList) {
                                              require(now > stakingEnabledTime, "staking-too-early");
                                              require(metadataResolver.isStakeable(nftContract, nftIndex), "EnokiGeyser: nft not stakeable");
                                              _stakeFor(msg.sender, msg.sender, nftContract, nftIndex);
                                          }
                                          // /**
                                          //  * @dev Transfers amount of deposit tokens from the user.
                                          //  * @param data Not used.
                                          //  */
                                          // function stakeBulk(
                                          //     address[] memory nftContracts,
                                          //     uint256[] memory nftIndicies,
                                          //     bytes calldata data
                                          // ) external defend(bannedContractList) {
                                          //     require(now > stakingEnabledTime, "staking-too-early");
                                          //     require(nftContracts.length == nftIndicies.length, "args length mismatch");
                                          //     for (uint256 i = 0; i < nftContracts.length; i++) {
                                          //         require(metadataResolver.isStakeable(nftContracts[i], nftIndicies[i]), "EnokiGeyser: nft not stakeable");
                                          //         _stakeFor(msg.sender, msg.sender, nftContracts[i], nftIndicies[i]);
                                          //     }
                                          // }
                                          /**
                                           * @dev Private implementation of staking methods.
                                           * @param staker User address who deposits tokens to stake.
                                           * @param beneficiary User address who gains credit for this stake operation.
                                           */
                                          function _stakeFor(
                                              address staker,
                                              address beneficiary,
                                              address nftContract,
                                              uint256 nftIndex
                                          ) private {
                                              require(beneficiary != address(0), "EnokiGeyser: beneficiary is zero address");
                                              require(metadataResolver.isStakeable(nftContract, nftIndex), "EnokiGeyser: Nft specified not stakeable");
                                              // Shares is determined by NFT mushroom rate
                                              MushroomLib.MushroomData memory metadata = metadataResolver.getMushroomData(nftContract, nftIndex, "");
                                              // 1. User Accounting
                                              UserTotals storage totals = _userTotals[beneficiary];
                                              Stake memory newStake = Stake(nftContract, nftIndex, metadata.strength, now);
                                              _userStakes[beneficiary].push(newStake);
                                              require(_userStakes[beneficiary].length <= maxStakesPerAddress, "EnokiGeyser: Stake would exceed maximum stakes for address");
                                              totals.userStrengthStaked = totals.userStrengthStaked.add(metadata.strength);
                                              totalStrengthStaked = totalStrengthStaked.add(metadata.strength);
                                              IERC721(nftContract).transferFrom(staker, address(this), nftIndex);
                                              emit Staked(beneficiary, nftContract, nftIndex, totalStakedFor(beneficiary), "");
                                          }
                                          /**
                                           * @dev Unstakes a certain amount of previously deposited tokens. User also receives their
                                           * alotted number of distribution tokens.
                                           * @param stakes Mushrooms to unstake.
                                           * @param data Not used.
                                           */
                                          function unstake(uint256[] calldata stakes, bytes calldata data)
                                              external
                                              returns (
                                                  uint256 totalReward,
                                                  uint256 userReward,
                                                  uint256 devReward
                                              )
                                          {
                                              require(stakes.length == 1, "Can only unstake one nft at once");
                                              return _unstake(stakes[0]);
                                          }
                                          function _unstake(uint256 stakeIndex)
                                              private
                                              returns (
                                                  uint256 totalReward,
                                                  uint256 userReward,
                                                  uint256 devReward
                                              )
                                          {
                                              // 1. User Accounting
                                              UserTotals storage totals = _userTotals[msg.sender];
                                              Stake[] storage accountStakes = _userStakes[msg.sender];
                                              // Redeem from most recent stake and go backwards in time.
                                              uint256 rewardAmount = 0;
                                              Stake storage currentStake = accountStakes[stakeIndex];
                                              MushroomLib.MushroomData memory metadata = metadataResolver.getMushroomData(currentStake.nftContract, currentStake.nftIndex, "");
                                              uint256 lifespanUsed = now.sub(currentStake.stakedAt);
                                              bool deadMushroom = false;
                                              // Effective lifespan used is capped at mushroom lifespan
                                              if (lifespanUsed >= metadata.lifespan) {
                                                  lifespanUsed = metadata.lifespan;
                                                  deadMushroom = true;
                                              }
                                              emit LifespanUsed(currentStake.nftContract, currentStake.nftIndex, lifespanUsed, metadata.lifespan);
                                              rewardAmount = computeNewReward(rewardAmount, metadata.strength, lifespanUsed);
                                              // Update global aomunt staked
                                              totalStrengthStaked = totalStrengthStaked.sub(metadata.strength);
                                              totals.userStrengthStaked = totals.userStrengthStaked.sub(metadata.strength);
                                              // Burn dead mushrooms, if they can be burnt. Otherwise, they can still be withdrawn with 0 lifespan.
                                              if (deadMushroom && metadataResolver.isBurnable(currentStake.nftContract, currentStake.nftIndex)) {
                                                  MushroomNFT(currentStake.nftContract).burn(currentStake.nftIndex);
                                                  emit BurnedMushroom(currentStake.nftContract, currentStake.nftIndex);
                                              } else {
                                                  // If still alive, reduce lifespan of mushroom and return to user. If not burnable, return with 0 lifespan.
                                                  metadataResolver.setMushroomLifespan(currentStake.nftContract, currentStake.nftIndex, metadata.lifespan.sub(lifespanUsed), "");
                                                  IERC721(currentStake.nftContract).transferFrom(address(this), msg.sender, currentStake.nftIndex);
                                                  // TODO: Test
                                                  MushroomLib.MushroomData memory metadata2 = metadataResolver.getMushroomData(currentStake.nftContract, currentStake.nftIndex, "");
                                                  emit NewLifespan(currentStake.nftContract, currentStake.nftIndex, metadata2.lifespan);
                                              }
                                              uint256 finalStakeIndex = accountStakes.length - 1;
                                              // Delete current stake
                                              if (stakeIndex == finalStakeIndex) {
                                                  accountStakes.pop(); // Remove if end
                                              } else {
                                                  // Move last stake to it's spot
                                                  accountStakes[stakeIndex] = accountStakes[finalStakeIndex];
                                                  // Pop last stake, which is now duplicated
                                                  accountStakes.pop();
                                              }
                                              emit Unstaked(msg.sender, currentStake.nftContract, currentStake.nftIndex, totalStakedFor(msg.sender), stakeIndex, "");
                                              // Already set in updateAccounting
                                              // _lastAccountingTimestampSec = now;
                                              // interactions
                                              totalReward = rewardAmount;
                                              (userReward, devReward) = computeDevReward(totalReward);
                                              if (userReward > 0) {
                                                  require(enokiToken.transfer(msg.sender, userReward), "EnokiGeyser: transfer to user out of unlocked pool failed");
                                              }
                                              if (devReward > 0) {
                                                  require(enokiToken.transfer(devRewardAddress, devReward), "EnokiGeyser: transfer to dev out of unlocked pool failed");
                                              }
                                              emit TokensClaimed(msg.sender, rewardAmount, userReward, devReward);
                                              require(totalStakingShares == 0 || totalStaked() > 0, "EnokiGeyser: Error unstaking. Staking shares exist, but no staking tokens do");
                                          }
                                          function computeNewReward(
                                              uint256 currentReward,
                                              uint256 strength,
                                              uint256 timeStaked
                                          ) private view returns (uint256) {
                                              uint256 newReward = strength.mul(timeStaked).div(SECONDS_PER_WEEK);
                                              return currentReward.add(newReward);
                                          }
                                          function updateStake(
                                              address staker,
                                              uint256 stakeIndex,
                                              address nftContract,
                                              uint256 nftIndex,
                                              uint256 strength,
                                              uint256 stakedAt
                                          ) external onlyAdmin {
                                              _userStakes[staker][stakeIndex] = Stake(nftContract, nftIndex, strength, stakedAt);
                                          }
                                          /**
                                           * @dev Determines split of specified reward amount between user and dev.
                                           * @param totalReward Amount of reward to split.
                                           * @return userReward Reward amounts for user and dev.
                                           * @return devReward Reward amounts for user and dev.
                                           */
                                          function computeDevReward(uint256 totalReward) public view returns (uint256 userReward, uint256 devReward) {
                                              if (devRewardPercentage == 0) {
                                                  userReward = totalReward;
                                                  devReward = 0;
                                              } else if (devRewardPercentage == MAX_PERCENTAGE) {
                                                  userReward = 0;
                                                  devReward = totalReward;
                                              } else {
                                                  devReward = totalReward.mul(devRewardPercentage).div(MAX_PERCENTAGE);
                                                  userReward = totalReward.sub(devReward); // Extra dust due to truncated rounding goes to user
                                              }
                                          }
                                          /**
                                           * @param addr The user to look up staking information for.
                                           * @return The number of staking tokens deposited for addr.
                                           */
                                          function totalStakedFor(address addr) public view returns (uint256) {
                                              return _userTotals[addr].userStrengthStaked;
                                          }
                                          /**
                                           * @return The total number of deposit tokens staked globally, by all users.
                                           */
                                          function totalStaked() public view returns (uint256) {
                                              return totalStrengthStaked;
                                          }
                                          /**
                                           * @return Total number of locked distribution tokens.
                                           */
                                          function totalLocked() public view returns (uint256) {
                                              return enokiToken.balanceOf(address(this));
                                          }
                                          /**
                                           * @dev This funcion allows the contract owner to add more locked distribution tokens, along
                                           *      with the associated "unlock schedule". These locked tokens immediately begin unlocking
                                           *      linearly over the duraction of durationSec timeframe.
                                           * @param amount Number of distribution tokens to lock. These are transferred from the caller.
                                           * @param durationSec Length of time to linear unlock the tokens.
                                           */
                                          function lockTokens(uint256 amount, uint256 durationSec) external onlyOwner {
                                              require(enokiToken.transferFrom(msg.sender, address(this), amount), "EnokiGeyser: transfer failed");
                                              emit TokensLocked(amount, totalLocked());
                                          }
                                          function lockTokensAirdrop(address airdrop, uint256 amount) external onlyAdmin {
                                              require(usedAirdropPool.add(amount) <= maxAirdropPool, "Exceeds maximum airdrop tokens");
                                              usedAirdropPool = usedAirdropPool.add(amount);
                                              require(enokiToken.transferFrom(owner(), address(airdrop), amount), "EnokiGeyser: transfer into airdrop pool failed");
                                              emit TokensLockedAirdrop(amount, totalLocked());
                                          }
                                      }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);
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../utils/EnumerableSet.sol";
                                      import "../utils/Address.sol";
                                      import "../GSN/Context.sol";
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Contract module that allows children to implement role-based access
                                       * control mechanisms.
                                       *
                                       * 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, _msgSender()));
                                       *     ...
                                       * }
                                       * ```
                                       *
                                       * 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}.
                                       */
                                      abstract contract AccessControlUpgradeSafe is Initializable, ContextUpgradeSafe {
                                          function __AccessControl_init() internal initializer {
                                              __Context_init_unchained();
                                              __AccessControl_init_unchained();
                                          }
                                          function __AccessControl_init_unchained() internal initializer {
                                          }
                                          using EnumerableSet for EnumerableSet.AddressSet;
                                          using Address for address;
                                          struct RoleData {
                                              EnumerableSet.AddressSet members;
                                              bytes32 adminRole;
                                          }
                                          mapping (bytes32 => RoleData) private _roles;
                                          bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
                                          /**
                                           * @dev Emitted when `account` is granted `role`.
                                           *
                                           * `sender` is the account that originated the contract call, an admin role
                                           * bearer except when using {_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) public view returns (bool) {
                                              return _roles[role].members.contains(account);
                                          }
                                          /**
                                           * @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 returns (uint256) {
                                              return _roles[role].members.length();
                                          }
                                          /**
                                           * @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 returns (address) {
                                              return _roles[role].members.at(index);
                                          }
                                          /**
                                           * @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 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.
                                           */
                                          function grantRole(bytes32 role, address account) public virtual {
                                              require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to grant");
                                              _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.
                                           */
                                          function revokeRole(bytes32 role, address account) public virtual {
                                              require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to revoke");
                                              _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 granted `role`, emits a {RoleRevoked}
                                           * event.
                                           *
                                           * Requirements:
                                           *
                                           * - the caller must be `account`.
                                           */
                                          function renounceRole(bytes32 role, address account) public virtual {
                                              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.
                                           *
                                           * [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}.
                                           * ====
                                           */
                                          function _setupRole(bytes32 role, address account) internal virtual {
                                              _grantRole(role, account);
                                          }
                                          /**
                                           * @dev Sets `adminRole` as ``role``'s admin role.
                                           */
                                          function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
                                              _roles[role].adminRole = adminRole;
                                          }
                                          function _grantRole(bytes32 role, address account) private {
                                              if (_roles[role].members.add(account)) {
                                                  emit RoleGranted(role, account, _msgSender());
                                              }
                                          }
                                          function _revokeRole(bytes32 role, address account) private {
                                              if (_roles[role].members.remove(account)) {
                                                  emit RoleRevoked(role, account, _msgSender());
                                              }
                                          }
                                          uint256[49] private __gap;
                                      }
                                      pragma solidity ^0.6.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.0.0, only sets of type `address` (`AddressSet`) and `uint256`
                                       * (`UintSet`) are supported.
                                       */
                                      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;
                                                  // When the value to delete is the last one, the swap operation is unnecessary. However, since this occurs
                                                  // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                                                  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] = toDeleteIndex + 1; // All indexes are 1-based
                                                  // 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) {
                                              require(set._values.length > index, "EnumerableSet: index out of bounds");
                                              return set._values[index];
                                          }
                                          // 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(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(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(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(uint256(_at(set._inner, index)));
                                          }
                                          // 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));
                                          }
                                      }
                                      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");
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Contract module that helps prevent reentrant calls to a function.
                                       *
                                       * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
                                       * available, which can be applied to functions to make sure there are no nested
                                       * (reentrant) calls to them.
                                       *
                                       * Note that because there is a single `nonReentrant` guard, functions marked as
                                       * `nonReentrant` may not call one another. This can be worked around by making
                                       * those functions `private`, and then adding `external` `nonReentrant` entry
                                       * points to them.
                                       *
                                       * TIP: If you would like to learn more about reentrancy and alternative ways
                                       * to protect against it, check out our blog post
                                       * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
                                       */
                                      contract ReentrancyGuardUpgradeSafe is Initializable {
                                          bool private _notEntered;
                                          function __ReentrancyGuard_init() internal initializer {
                                              __ReentrancyGuard_init_unchained();
                                          }
                                          function __ReentrancyGuard_init_unchained() internal initializer {
                                              // Storing an initial non-zero value makes deployment a bit more
                                              // expensive, but in exchange the refund on every call to nonReentrant
                                              // will be lower in amount. Since refunds are capped to a percetange of
                                              // the total transaction's gas, it is best to keep them low in cases
                                              // like this one, to increase the likelihood of the full refund coming
                                              // into effect.
                                              _notEntered = true;
                                          }
                                          /**
                                           * @dev Prevents a contract from calling itself, directly or indirectly.
                                           * Calling a `nonReentrant` function from another `nonReentrant`
                                           * function is not supported. It is possible to prevent this from happening
                                           * by making the `nonReentrant` function external, and make it call a
                                           * `private` function that does the actual work.
                                           */
                                          modifier nonReentrant() {
                                              // On the first call to nonReentrant, _notEntered will be true
                                              require(_notEntered, "ReentrancyGuard: reentrant call");
                                              // Any calls to nonReentrant after this point will fail
                                              _notEntered = false;
                                              _;
                                              // By storing the original value once again, a refund is triggered (see
                                              // https://eips.ethereum.org/EIPS/eip-2200)
                                              _notEntered = true;
                                          }
                                          uint256[49] private __gap;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      /**
                                       * @title A simple holder of tokens.
                                       * This is a simple contract to hold tokens. It's useful in the case where a separate contract
                                       * needs to hold multiple distinct pools of the same token.
                                       */
                                      contract TokenPool is Initializable, OwnableUpgradeSafe {
                                          IERC20 public token;
                                          function initialize(IERC20 _token) public initializer {
                                              __Ownable_init();
                                              token = _token;
                                          }
                                          function balance() public view returns (uint256) {
                                              return token.balanceOf(address(this));
                                          }
                                          function transfer(address to, uint256 value) external onlyOwner returns (bool) {
                                              return token.transfer(to, value);
                                          }
                                          function rescueFunds(address tokenToRescue, address to, uint256 amount) external onlyOwner returns (bool) {
                                              require(address(token) != tokenToRescue, 'TokenPool: Cannot claim token held by the contract');
                                              return IERC20(tokenToRescue).transfer(to, amount);
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "./ERC721.sol";
                                      import "./MushroomLib.sol";
                                      /*
                                          Minting and burning permissions are managed by the Owner
                                      */
                                      contract MushroomNFT is ERC721UpgradeSafe, OwnableUpgradeSafe, AccessControlUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          mapping (uint256 => MushroomLib.MushroomData) public mushroomData; // NFT Id -> Metadata
                                          mapping (uint256 => MushroomLib.MushroomType) public mushroomTypes; // Species Id -> Metadata
                                          mapping (uint256 => bool) public mushroomTypeExists; // Species Id -> Exists
                                          mapping (uint256 => string) public mushroomMetadataUri; // Species Id -> URI
                                          bytes32 public constant LIFESPAN_MODIFIER_ROLE = keccak256("LIFESPAN_MODIFIER_ROLE");
                                          bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");
                                          function initialize() public initializer {
                                              __Ownable_init_unchained();
                                              __AccessControl_init_unchained();
                                              __ERC721_init("Enoki Mushrooms", "Enoki Mushrooms");
                                              _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                                          }
                                          /* ========== VIEWS ========== */
                                          // Mushrooms inherit their strength from their species
                                          function getMushroomData(uint256 tokenId) public view returns (MushroomLib.MushroomData memory) {
                                              MushroomLib.MushroomData memory data = mushroomData[tokenId];
                                              return data;
                                          }
                                          function getSpecies(uint256 speciesId) public view returns (MushroomLib.MushroomType memory) {
                                              return mushroomTypes[speciesId];
                                          }
                                          function getRemainingMintableForSpecies(uint256 speciesId) public view returns (uint256) {
                                              MushroomLib.MushroomType storage species = mushroomTypes[speciesId];
                                              return species.cap.sub(species.minted);
                                          }
                                          /// @notice Return token URI for mushroom
                                          /// @notice URI is determined by species and can be modifed by the owner
                                          function tokenURI(uint256 tokenId) public view override returns (string memory) {
                                              MushroomLib.MushroomData storage data = mushroomData[tokenId];
                                              return mushroomMetadataUri[data.species];
                                          }  
                                          /* ========== ROLE MANAGEMENT ========== */
                                          // TODO: Ensure we can transfer admin role privledges
                                          modifier onlyLifespanModifier() {
                                              require(hasRole(LIFESPAN_MODIFIER_ROLE, msg.sender), "MushroomNFT: Only approved lifespan modifier");
                                              _;
                                          }
                                          modifier onlyMinter() {
                                              require(hasRole(MINTER_ROLE, msg.sender), "MushroomNFT: Only approved mushroom minter");
                                              _;
                                          }
                                          /* ========== RESTRICTED FUNCTIONS ========== */
                                          /**
                                           * @dev The burner must be the owner of the token, or approved. The EnokiGeyser owns tokens when it burns them.
                                           */
                                          function burn(uint256 tokenId) public {
                                              //solhint-disable-next-line max-line-length
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721Burnable: caller is not owner nor approved");
                                              _burn(tokenId);
                                              _clearMushroomData(tokenId);
                                          }
                                          function mint(address recipient, uint256 tokenId, uint256 speciesId, uint256 lifespan) public onlyMinter {
                                              _mintWithMetadata(recipient, tokenId, speciesId, lifespan);
                                          }
                                          function setMushroomLifespan(uint256 index, uint256 lifespan) public onlyLifespanModifier {
                                              mushroomData[index].lifespan = lifespan;
                                          }
                                          function setSpeciesUri(uint256 speciesId, string memory URI) public onlyOwner {
                                              mushroomMetadataUri[speciesId] = URI;
                                          }
                                          function _mintWithMetadata(address recipient, uint256 tokenId, uint256 speciesId, uint256 lifespan) internal {
                                              require(mushroomTypeExists[speciesId], "MushroomNFT: mushroom species specified does not exist");
                                              MushroomLib.MushroomType storage species = mushroomTypes[speciesId];
                                              require(species.minted < species.cap, "MushroomNFT: minting cap reached for species");
                                              species.minted = species.minted.add(1);
                                              mushroomData[tokenId] = MushroomLib.MushroomData(speciesId, species.strength, lifespan);
                                              _safeMint(recipient, tokenId);
                                          }
                                          // TODO: We don't really have to do this as a newly minted mushroom will set the data
                                          function _clearMushroomData(uint256 tokenId) internal {
                                              MushroomLib.MushroomData storage data = mushroomData[tokenId];
                                              MushroomLib.MushroomType storage species = mushroomTypes[data.species];   
                                              mushroomData[tokenId].species = 0;
                                              mushroomData[tokenId].strength = 0;
                                              mushroomData[tokenId].lifespan = 0;
                                              species.minted = species.minted.sub(1);
                                          }
                                          function setMushroomType(uint256 speciesId, MushroomLib.MushroomType memory mType) public onlyOwner {
                                              if (!mushroomTypeExists[speciesId]) {
                                                  mushroomTypeExists[speciesId] = true;
                                              }
                                              mushroomTypes[speciesId] = mType;
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/GSN/Context.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Metadata.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Enumerable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Receiver.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/introspection/ERC165.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/Address.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/EnumerableSet.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/EnumerableMap.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/Strings.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/Initializable.sol";
                                      /**
                                       * @title ERC721 Non-Fungible Token Standard basic implementation
                                       * @dev see https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      contract ERC721UpgradeSafe is Initializable, ContextUpgradeSafe, ERC165UpgradeSafe, IERC721, IERC721Metadata, IERC721Enumerable {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          using EnumerableSet for EnumerableSet.UintSet;
                                          using EnumerableMap for EnumerableMap.UintToAddressMap;
                                          using Strings for uint256;
                                          // Equals to `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
                                          // which can be also obtained as `IERC721Receiver(0).onERC721Received.selector`
                                          bytes4 private constant _ERC721_RECEIVED = 0x150b7a02;
                                          // Mapping from holder address to their (enumerable) set of owned tokens
                                          mapping (address => EnumerableSet.UintSet) private _holderTokens;
                                          // Enumerable mapping from token ids to their owners
                                          EnumerableMap.UintToAddressMap private _tokenOwners;
                                          // Mapping from token ID to approved address
                                          mapping (uint256 => address) private _tokenApprovals;
                                          // Mapping from owner to operator approvals
                                          mapping (address => mapping (address => bool)) private _operatorApprovals;
                                          // Token name
                                          string private _name;
                                          // Token symbol
                                          string private _symbol;
                                          // Optional mapping for token URIs
                                          mapping(uint256 => string) private _tokenURIs;
                                          // Base URI
                                          string private _baseURI;
                                          /*
                                           *     bytes4(keccak256('balanceOf(address)')) == 0x70a08231
                                           *     bytes4(keccak256('ownerOf(uint256)')) == 0x6352211e
                                           *     bytes4(keccak256('approve(address,uint256)')) == 0x095ea7b3
                                           *     bytes4(keccak256('getApproved(uint256)')) == 0x081812fc
                                           *     bytes4(keccak256('setApprovalForAll(address,bool)')) == 0xa22cb465
                                           *     bytes4(keccak256('isApprovedForAll(address,address)')) == 0xe985e9c5
                                           *     bytes4(keccak256('transferFrom(address,address,uint256)')) == 0x23b872dd
                                           *     bytes4(keccak256('safeTransferFrom(address,address,uint256)')) == 0x42842e0e
                                           *     bytes4(keccak256('safeTransferFrom(address,address,uint256,bytes)')) == 0xb88d4fde
                                           *
                                           *     => 0x70a08231 ^ 0x6352211e ^ 0x095ea7b3 ^ 0x081812fc ^
                                           *        0xa22cb465 ^ 0xe985e9c ^ 0x23b872dd ^ 0x42842e0e ^ 0xb88d4fde == 0x80ac58cd
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721 = 0x80ac58cd;
                                          /*
                                           *     bytes4(keccak256('name()')) == 0x06fdde03
                                           *     bytes4(keccak256('symbol()')) == 0x95d89b41
                                           *     bytes4(keccak256('tokenURI(uint256)')) == 0xc87b56dd
                                           *
                                           *     => 0x06fdde03 ^ 0x95d89b41 ^ 0xc87b56dd == 0x5b5e139f
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721_METADATA = 0x5b5e139f;
                                          /*
                                           *     bytes4(keccak256('totalSupply()')) == 0x18160ddd
                                           *     bytes4(keccak256('tokenOfOwnerByIndex(address,uint256)')) == 0x2f745c59
                                           *     bytes4(keccak256('tokenByIndex(uint256)')) == 0x4f6ccce7
                                           *
                                           *     => 0x18160ddd ^ 0x2f745c59 ^ 0x4f6ccce7 == 0x780e9d63
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721_ENUMERABLE = 0x780e9d63;
                                          function __ERC721_init(string memory name, string memory symbol) internal initializer {
                                              __Context_init_unchained();
                                              __ERC165_init_unchained();
                                              __ERC721_init_unchained(name, symbol);
                                          }
                                          function __ERC721_init_unchained(string memory name, string memory symbol) internal initializer {
                                              _name = name;
                                              _symbol = symbol;
                                              // register the supported interfaces to conform to ERC721 via ERC165
                                              _registerInterface(_INTERFACE_ID_ERC721);
                                              _registerInterface(_INTERFACE_ID_ERC721_METADATA);
                                              _registerInterface(_INTERFACE_ID_ERC721_ENUMERABLE);
                                          }
                                          /**
                                           * @dev Gets the balance of the specified address.
                                           * @param owner address to query the balance of
                                           * @return uint256 representing the amount owned by the passed address
                                           */
                                          function balanceOf(address owner) public view override returns (uint256) {
                                              require(owner != address(0), "ERC721: balance query for the zero address");
                                              return _holderTokens[owner].length();
                                          }
                                          /**
                                           * @dev Gets the owner of the specified token ID.
                                           * @param tokenId uint256 ID of the token to query the owner of
                                           * @return address currently marked as the owner of the given token ID
                                           */
                                          function ownerOf(uint256 tokenId) public view override returns (address) {
                                              return _tokenOwners.get(tokenId, "ERC721: owner query for nonexistent token");
                                          }
                                          /**
                                           * @dev Gets the token name.
                                           * @return string representing the token name
                                           */
                                          function name() public view override returns (string memory) {
                                              return _name;
                                          }
                                          /**
                                           * @dev Gets the token symbol.
                                           * @return string representing the token symbol
                                           */
                                          function symbol() public view override returns (string memory) {
                                              return _symbol;
                                          }
                                          /**
                                           * @dev Returns the URI for a given token ID. May return an empty string.
                                           *
                                           * If a base URI is set (via {_setBaseURI}), it is added as a prefix to the
                                           * token's own URI (via {_setTokenURI}).
                                           *
                                           * If there is a base URI but no token URI, the token's ID will be used as
                                           * its URI when appending it to the base URI. This pattern for autogenerated
                                           * token URIs can lead to large gas savings.
                                           *
                                           * .Examples
                                           * |===
                                           * |`_setBaseURI()` |`_setTokenURI()` |`tokenURI()`
                                           * | ""
                                           * | ""
                                           * | ""
                                           * | ""
                                           * | "token.uri/123"
                                           * | "token.uri/123"
                                           * | "token.uri/"
                                           * | "123"
                                           * | "token.uri/123"
                                           * | "token.uri/"
                                           * | ""
                                           * | "token.uri/<tokenId>"
                                           * |===
                                           *
                                           * Requirements:
                                           *
                                           * - `tokenId` must exist.
                                           */
                                          function tokenURI(uint256 tokenId) public view override virtual returns (string memory) {
                                              require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
                                              string memory _tokenURI = _tokenURIs[tokenId];
                                              // If there is no base URI, return the token URI.
                                              if (bytes(_baseURI).length == 0) {
                                                  return _tokenURI;
                                              }
                                              // If both are set, concatenate the baseURI and tokenURI (via abi.encodePacked).
                                              if (bytes(_tokenURI).length > 0) {
                                                  return string(abi.encodePacked(_baseURI, _tokenURI));
                                              }
                                              // If there is a baseURI but no tokenURI, concatenate the tokenID to the baseURI.
                                              return string(abi.encodePacked(_baseURI, tokenId.toString()));
                                          }
                                          /**
                                          * @dev Returns the base URI set via {_setBaseURI}. This will be
                                          * automatically added as a prefix in {tokenURI} to each token's URI, or
                                          * to the token ID if no specific URI is set for that token ID.
                                          */
                                          function baseURI() public view returns (string memory) {
                                              return _baseURI;
                                          }
                                          /**
                                           * @dev Gets the token ID at a given index of the tokens list of the requested owner.
                                           * @param owner address owning the tokens list to be accessed
                                           * @param index uint256 representing the index to be accessed of the requested tokens list
                                           * @return uint256 token ID at the given index of the tokens list owned by the requested address
                                           */
                                          function tokenOfOwnerByIndex(address owner, uint256 index) public view override returns (uint256) {
                                              return _holderTokens[owner].at(index);
                                          }
                                          /**
                                           * @dev Gets the total amount of tokens stored by the contract.
                                           * @return uint256 representing the total amount of tokens
                                           */
                                          function totalSupply() public view override returns (uint256) {
                                              // _tokenOwners are indexed by tokenIds, so .length() returns the number of tokenIds
                                              return _tokenOwners.length();
                                          }
                                          /**
                                           * @dev Gets the token ID at a given index of all the tokens in this contract
                                           * Reverts if the index is greater or equal to the total number of tokens.
                                           * @param index uint256 representing the index to be accessed of the tokens list
                                           * @return uint256 token ID at the given index of the tokens list
                                           */
                                          function tokenByIndex(uint256 index) public view override returns (uint256) {
                                              (uint256 tokenId, ) = _tokenOwners.at(index);
                                              return tokenId;
                                          }
                                          /**
                                           * @dev Approves another address to transfer the given token ID
                                           * The zero address indicates there is no approved address.
                                           * There can only be one approved address per token at a given time.
                                           * Can only be called by the token owner or an approved operator.
                                           * @param to address to be approved for the given token ID
                                           * @param tokenId uint256 ID of the token to be approved
                                           */
                                          function approve(address to, uint256 tokenId) public virtual override {
                                              address owner = ownerOf(tokenId);
                                              require(to != owner, "ERC721: approval to current owner");
                                              require(_msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                                                  "ERC721: approve caller is not owner nor approved for all"
                                              );
                                              _approve(to, tokenId);
                                          }
                                          /**
                                           * @dev Gets the approved address for a token ID, or zero if no address set
                                           * Reverts if the token ID does not exist.
                                           * @param tokenId uint256 ID of the token to query the approval of
                                           * @return address currently approved for the given token ID
                                           */
                                          function getApproved(uint256 tokenId) public view override returns (address) {
                                              require(_exists(tokenId), "ERC721: approved query for nonexistent token");
                                              return _tokenApprovals[tokenId];
                                          }
                                          /**
                                           * @dev Sets or unsets the approval of a given operator
                                           * An operator is allowed to transfer all tokens of the sender on their behalf.
                                           * @param operator operator address to set the approval
                                           * @param approved representing the status of the approval to be set
                                           */
                                          function setApprovalForAll(address operator, bool approved) public virtual override {
                                              require(operator != _msgSender(), "ERC721: approve to caller");
                                              _operatorApprovals[_msgSender()][operator] = approved;
                                              emit ApprovalForAll(_msgSender(), operator, approved);
                                          }
                                          /**
                                           * @dev Tells whether an operator is approved by a given owner.
                                           * @param owner owner address which you want to query the approval of
                                           * @param operator operator address which you want to query the approval of
                                           * @return bool whether the given operator is approved by the given owner
                                           */
                                          function isApprovedForAll(address owner, address operator) public view override returns (bool) {
                                              return _operatorApprovals[owner][operator];
                                          }
                                          /**
                                           * @dev Transfers the ownership of a given token ID to another address.
                                           * Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
                                           * Requires the msg.sender to be the owner, approved, or operator.
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function transferFrom(address from, address to, uint256 tokenId) public virtual override {
                                              //solhint-disable-next-line max-line-length
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                                              _transfer(from, to, tokenId);
                                          }
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement {IERC721Receiver-onERC721Received},
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the msg.sender to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId) public virtual override {
                                              safeTransferFrom(from, to, tokenId, "");
                                          }
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement {IERC721Receiver-onERC721Received},
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the _msgSender() to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory _data) public virtual override {
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                                              _safeTransfer(from, to, tokenId, _data);
                                          }
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the msg.sender to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function _safeTransfer(address from, address to, uint256 tokenId, bytes memory _data) internal virtual {
                                              _transfer(from, to, tokenId);
                                              require(_checkOnERC721Received(from, to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
                                          }
                                          /**
                                           * @dev Returns whether the specified token exists.
                                           * @param tokenId uint256 ID of the token to query the existence of
                                           * @return bool whether the token exists
                                           */
                                          function _exists(uint256 tokenId) internal view returns (bool) {
                                              return _tokenOwners.contains(tokenId);
                                          }
                                          /**
                                           * @dev Returns whether the given spender can transfer a given token ID.
                                           * @param spender address of the spender to query
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @return bool whether the msg.sender is approved for the given token ID,
                                           * is an operator of the owner, or is the owner of the token
                                           */
                                          function _isApprovedOrOwner(address spender, uint256 tokenId) internal view returns (bool) {
                                              require(_exists(tokenId), "ERC721: operator query for nonexistent token");
                                              address owner = ownerOf(tokenId);
                                              return (spender == owner || getApproved(tokenId) == spender || isApprovedForAll(owner, spender));
                                          }
                                          /**
                                           * @dev Internal function to safely mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           */
                                          function _safeMint(address to, uint256 tokenId) internal virtual {
                                              _safeMint(to, tokenId, "");
                                          }
                                          /**
                                           * @dev Internal function to safely mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function _safeMint(address to, uint256 tokenId, bytes memory _data) internal virtual {
                                              _mint(to, tokenId);
                                              require(_checkOnERC721Received(address(0), to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
                                          }
                                          /**
                                           * @dev Internal function to mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           */
                                          function _mint(address to, uint256 tokenId) internal virtual {
                                              require(to != address(0), "ERC721: mint to the zero address");
                                              require(!_exists(tokenId), "ERC721: token already minted");
                                              _beforeTokenTransfer(address(0), to, tokenId);
                                              _holderTokens[to].add(tokenId);
                                              _tokenOwners.set(tokenId, to);
                                              emit Transfer(address(0), to, tokenId);
                                          }
                                          /**
                                           * @dev Internal function to burn a specific token.
                                           * Reverts if the token does not exist.
                                           * @param tokenId uint256 ID of the token being burned
                                           */
                                          function _burn(uint256 tokenId) internal virtual {
                                              address owner = ownerOf(tokenId);
                                              _beforeTokenTransfer(owner, address(0), tokenId);
                                              // Clear approvals
                                              _approve(address(0), tokenId);
                                              // Clear metadata (if any)
                                              if (bytes(_tokenURIs[tokenId]).length != 0) {
                                                  delete _tokenURIs[tokenId];
                                              }
                                              _holderTokens[owner].remove(tokenId);
                                              _tokenOwners.remove(tokenId);
                                              emit Transfer(owner, address(0), tokenId);
                                          }
                                          /**
                                           * @dev Internal function to transfer ownership of a given token ID to another address.
                                           * As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function _transfer(address from, address to, uint256 tokenId) internal virtual {
                                              require(ownerOf(tokenId) == from, "ERC721: transfer of token that is not own");
                                              require(to != address(0), "ERC721: transfer to the zero address");
                                              _beforeTokenTransfer(from, to, tokenId);
                                              // Clear approvals from the previous owner
                                              _approve(address(0), tokenId);
                                              _holderTokens[from].remove(tokenId);
                                              _holderTokens[to].add(tokenId);
                                              _tokenOwners.set(tokenId, to);
                                              emit Transfer(from, to, tokenId);
                                          }
                                          /**
                                           * @dev Internal function to set the token URI for a given token.
                                           *
                                           * Reverts if the token ID does not exist.
                                           *
                                           * TIP: If all token IDs share a prefix (for example, if your URIs look like
                                           * `https://api.myproject.com/token/<id>`), use {_setBaseURI} to store
                                           * it and save gas.
                                           */
                                          function _setTokenURI(uint256 tokenId, string memory _tokenURI) internal virtual {
                                              require(_exists(tokenId), "ERC721Metadata: URI set of nonexistent token");
                                              _tokenURIs[tokenId] = _tokenURI;
                                          }
                                          /**
                                           * @dev Internal function to set the base URI for all token IDs. It is
                                           * automatically added as a prefix to the value returned in {tokenURI},
                                           * or to the token ID if {tokenURI} is empty.
                                           */
                                          function _setBaseURI(string memory baseURI_) internal virtual {
                                              _baseURI = baseURI_;
                                          }
                                          /**
                                           * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
                                           * The call is not executed if the target address is not a contract.
                                           *
                                           * @param from address representing the previous owner of the given token ID
                                           * @param to target address that will receive the tokens
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes optional data to send along with the call
                                           * @return bool whether the call correctly returned the expected magic value
                                           */
                                          function _checkOnERC721Received(address from, address to, uint256 tokenId, bytes memory _data)
                                              private returns (bool)
                                          {
                                              if (!to.isContract()) {
                                                  return true;
                                              }
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, bytes memory returndata) = to.call(abi.encodeWithSelector(
                                                  IERC721Receiver(to).onERC721Received.selector,
                                                  _msgSender(),
                                                  from,
                                                  tokenId,
                                                  _data
                                              ));
                                              if (!success) {
                                                  if (returndata.length > 0) {
                                                      // solhint-disable-next-line no-inline-assembly
                                                      assembly {
                                                          let returndata_size := mload(returndata)
                                                          revert(add(32, returndata), returndata_size)
                                                      }
                                                  } else {
                                                      revert("ERC721: transfer to non ERC721Receiver implementer");
                                                  }
                                              } else {
                                                  bytes4 retval = abi.decode(returndata, (bytes4));
                                                  return (retval == _ERC721_RECEIVED);
                                              }
                                          }
                                          function _approve(address to, uint256 tokenId) private {
                                              _tokenApprovals[tokenId] = to;
                                              emit Approval(ownerOf(tokenId), to, tokenId);
                                          }
                                          /**
                                           * @dev Hook that is called before any token transfer. This includes minting
                                           * and burning.
                                           *
                                           * Calling conditions:
                                           *
                                           * - when `from` and `to` are both non-zero, ``from``'s `tokenId` will be
                                           * transferred to `to`.
                                           * - when `from` is zero, `tokenId` will be minted for `to`.
                                           * - when `to` is zero, ``from``'s `tokenId` 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 tokenId) internal virtual { }
                                          uint256[41] private __gap;
                                      }
                                      pragma solidity ^0.6.2;
                                      import "../../introspection/IERC165.sol";
                                      /**
                                       * @dev Required interface of an ERC721 compliant contract.
                                       */
                                      interface IERC721 is IERC165 {
                                          event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
                                          event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
                                          event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
                                          /**
                                           * @dev Returns the number of NFTs in ``owner``'s account.
                                           */
                                          function balanceOf(address owner) external view returns (uint256 balance);
                                          /**
                                           * @dev Returns the owner of the NFT specified by `tokenId`.
                                           */
                                          function ownerOf(uint256 tokenId) external view returns (address owner);
                                          /**
                                           * @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to
                                           * another (`to`).
                                           *
                                           *
                                           *
                                           * Requirements:
                                           * - `from`, `to` cannot be zero.
                                           * - `tokenId` must be owned by `from`.
                                           * - If the caller is not `from`, it must be have been allowed to move this
                                           * NFT by either {approve} or {setApprovalForAll}.
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId) external;
                                          /**
                                           * @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to
                                           * another (`to`).
                                           *
                                           * Requirements:
                                           * - If the caller is not `from`, it must be approved to move this NFT by
                                           * either {approve} or {setApprovalForAll}.
                                           */
                                          function transferFrom(address from, address to, uint256 tokenId) external;
                                          function approve(address to, uint256 tokenId) external;
                                          function getApproved(uint256 tokenId) external view returns (address operator);
                                          function setApprovalForAll(address operator, bool _approved) external;
                                          function isApprovedForAll(address owner, address operator) external view returns (bool);
                                          function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;
                                      }
                                      pragma solidity ^0.6.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);
                                      }
                                      pragma solidity ^0.6.2;
                                      import "./IERC721.sol";
                                      /**
                                       * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
                                       * @dev See https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      interface IERC721Metadata is IERC721 {
                                          function name() external view returns (string memory);
                                          function symbol() external view returns (string memory);
                                          function tokenURI(uint256 tokenId) external view returns (string memory);
                                      }
                                      pragma solidity ^0.6.2;
                                      import "./IERC721.sol";
                                      /**
                                       * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
                                       * @dev See https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      interface IERC721Enumerable is IERC721 {
                                          function totalSupply() external view returns (uint256);
                                          function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256 tokenId);
                                          function tokenByIndex(uint256 index) external view returns (uint256);
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @title ERC721 token receiver interface
                                       * @dev Interface for any contract that wants to support safeTransfers
                                       * from ERC721 asset contracts.
                                       */
                                      interface IERC721Receiver {
                                          /**
                                           * @notice Handle the receipt of an NFT
                                           * @dev The ERC721 smart contract calls this function on the recipient
                                           * after a {IERC721-safeTransferFrom}. This function MUST return the function selector,
                                           * otherwise the caller will revert the transaction. The selector to be
                                           * returned can be obtained as `this.onERC721Received.selector`. This
                                           * function MAY throw to revert and reject the transfer.
                                           * Note: the ERC721 contract address is always the message sender.
                                           * @param operator The address which called `safeTransferFrom` function
                                           * @param from The address which previously owned the token
                                           * @param tokenId The NFT identifier which is being transferred
                                           * @param data Additional data with no specified format
                                           * @return bytes4 `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
                                           */
                                          function onERC721Received(address operator, address from, uint256 tokenId, bytes calldata data)
                                          external returns (bytes4);
                                      }
                                      pragma solidity ^0.6.0;
                                      import "./IERC165.sol";
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Implementation of the {IERC165} interface.
                                       *
                                       * Contracts may inherit from this and call {_registerInterface} to declare
                                       * their support of an interface.
                                       */
                                      contract ERC165UpgradeSafe is Initializable, IERC165 {
                                          /*
                                           * bytes4(keccak256('supportsInterface(bytes4)')) == 0x01ffc9a7
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC165 = 0x01ffc9a7;
                                          /**
                                           * @dev Mapping of interface ids to whether or not it's supported.
                                           */
                                          mapping(bytes4 => bool) private _supportedInterfaces;
                                          function __ERC165_init() internal initializer {
                                              __ERC165_init_unchained();
                                          }
                                          function __ERC165_init_unchained() internal initializer {
                                              // Derived contracts need only register support for their own interfaces,
                                              // we register support for ERC165 itself here
                                              _registerInterface(_INTERFACE_ID_ERC165);
                                          }
                                          /**
                                           * @dev See {IERC165-supportsInterface}.
                                           *
                                           * Time complexity O(1), guaranteed to always use less than 30 000 gas.
                                           */
                                          function supportsInterface(bytes4 interfaceId) public view override returns (bool) {
                                              return _supportedInterfaces[interfaceId];
                                          }
                                          /**
                                           * @dev Registers the contract as an implementer of the interface defined by
                                           * `interfaceId`. Support of the actual ERC165 interface is automatic and
                                           * registering its interface id is not required.
                                           *
                                           * See {IERC165-supportsInterface}.
                                           *
                                           * Requirements:
                                           *
                                           * - `interfaceId` cannot be the ERC165 invalid interface (`0xffffffff`).
                                           */
                                          function _registerInterface(bytes4 interfaceId) internal virtual {
                                              require(interfaceId != 0xffffffff, "ERC165: invalid interface id");
                                              _supportedInterfaces[interfaceId] = true;
                                          }
                                          uint256[49] private __gap;
                                      }
                                      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) {
                                              // Solidity only automatically asserts when dividing by 0
                                              require(b > 0, errorMessage);
                                              uint256 c = a / b;
                                              // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return mod(a, b, "SafeMath: modulo by zero");
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts with custom message when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b != 0, errorMessage);
                                              return a % b;
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Library for managing an enumerable variant of Solidity's
                                       * https://solidity.readthedocs.io/en/latest/types.html#mapping-types[`mapping`]
                                       * type.
                                       *
                                       * Maps have the following properties:
                                       *
                                       * - Entries are added, removed, and checked for existence in constant time
                                       * (O(1)).
                                       * - Entries are enumerated in O(n). No guarantees are made on the ordering.
                                       *
                                       * ```
                                       * contract Example {
                                       *     // Add the library methods
                                       *     using EnumerableMap for EnumerableMap.UintToAddressMap;
                                       *
                                       *     // Declare a set state variable
                                       *     EnumerableMap.UintToAddressMap private myMap;
                                       * }
                                       * ```
                                       *
                                       * As of v3.0.0, only maps of type `uint256 -> address` (`UintToAddressMap`) are
                                       * supported.
                                       */
                                      library EnumerableMap {
                                          // To implement this library for multiple types with as little code
                                          // repetition as possible, we write it in terms of a generic Map type with
                                          // bytes32 keys and values.
                                          // The Map implementation uses private functions, and user-facing
                                          // implementations (such as Uint256ToAddressMap) are just wrappers around
                                          // the underlying Map.
                                          // This means that we can only create new EnumerableMaps for types that fit
                                          // in bytes32.
                                          struct MapEntry {
                                              bytes32 _key;
                                              bytes32 _value;
                                          }
                                          struct Map {
                                              // Storage of map keys and values
                                              MapEntry[] _entries;
                                              // Position of the entry defined by a key in the `entries` array, plus 1
                                              // because index 0 means a key is not in the map.
                                              mapping (bytes32 => uint256) _indexes;
                                          }
                                          /**
                                           * @dev Adds a key-value pair to a map, or updates the value for an existing
                                           * key. O(1).
                                           *
                                           * Returns true if the key was added to the map, that is if it was not
                                           * already present.
                                           */
                                          function _set(Map storage map, bytes32 key, bytes32 value) private returns (bool) {
                                              // We read and store the key's index to prevent multiple reads from the same storage slot
                                              uint256 keyIndex = map._indexes[key];
                                              if (keyIndex == 0) { // Equivalent to !contains(map, key)
                                                  map._entries.push(MapEntry({ _key: key, _value: value }));
                                                  // The entry is stored at length-1, but we add 1 to all indexes
                                                  // and use 0 as a sentinel value
                                                  map._indexes[key] = map._entries.length;
                                                  return true;
                                              } else {
                                                  map._entries[keyIndex - 1]._value = value;
                                                  return false;
                                              }
                                          }
                                          /**
                                           * @dev Removes a key-value pair from a map. O(1).
                                           *
                                           * Returns true if the key was removed from the map, that is if it was present.
                                           */
                                          function _remove(Map storage map, bytes32 key) private returns (bool) {
                                              // We read and store the key's index to prevent multiple reads from the same storage slot
                                              uint256 keyIndex = map._indexes[key];
                                              if (keyIndex != 0) { // Equivalent to contains(map, key)
                                                  // To delete a key-value pair from the _entries array in O(1), we swap the entry to delete with the last one
                                                  // in the array, and then remove the last entry (sometimes called as 'swap and pop').
                                                  // This modifies the order of the array, as noted in {at}.
                                                  uint256 toDeleteIndex = keyIndex - 1;
                                                  uint256 lastIndex = map._entries.length - 1;
                                                  // When the entry to delete is the last one, the swap operation is unnecessary. However, since this occurs
                                                  // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                                                  MapEntry storage lastEntry = map._entries[lastIndex];
                                                  // Move the last entry to the index where the entry to delete is
                                                  map._entries[toDeleteIndex] = lastEntry;
                                                  // Update the index for the moved entry
                                                  map._indexes[lastEntry._key] = toDeleteIndex + 1; // All indexes are 1-based
                                                  // Delete the slot where the moved entry was stored
                                                  map._entries.pop();
                                                  // Delete the index for the deleted slot
                                                  delete map._indexes[key];
                                                  return true;
                                              } else {
                                                  return false;
                                              }
                                          }
                                          /**
                                           * @dev Returns true if the key is in the map. O(1).
                                           */
                                          function _contains(Map storage map, bytes32 key) private view returns (bool) {
                                              return map._indexes[key] != 0;
                                          }
                                          /**
                                           * @dev Returns the number of key-value pairs in the map. O(1).
                                           */
                                          function _length(Map storage map) private view returns (uint256) {
                                              return map._entries.length;
                                          }
                                         /**
                                          * @dev Returns the key-value pair stored at position `index` in the map. O(1).
                                          *
                                          * Note that there are no guarantees on the ordering of entries inside the
                                          * array, and it may change when more entries are added or removed.
                                          *
                                          * Requirements:
                                          *
                                          * - `index` must be strictly less than {length}.
                                          */
                                          function _at(Map storage map, uint256 index) private view returns (bytes32, bytes32) {
                                              require(map._entries.length > index, "EnumerableMap: index out of bounds");
                                              MapEntry storage entry = map._entries[index];
                                              return (entry._key, entry._value);
                                          }
                                          /**
                                           * @dev Returns the value associated with `key`.  O(1).
                                           *
                                           * Requirements:
                                           *
                                           * - `key` must be in the map.
                                           */
                                          function _get(Map storage map, bytes32 key) private view returns (bytes32) {
                                              return _get(map, key, "EnumerableMap: nonexistent key");
                                          }
                                          /**
                                           * @dev Same as {_get}, with a custom error message when `key` is not in the map.
                                           */
                                          function _get(Map storage map, bytes32 key, string memory errorMessage) private view returns (bytes32) {
                                              uint256 keyIndex = map._indexes[key];
                                              require(keyIndex != 0, errorMessage); // Equivalent to contains(map, key)
                                              return map._entries[keyIndex - 1]._value; // All indexes are 1-based
                                          }
                                          // UintToAddressMap
                                          struct UintToAddressMap {
                                              Map _inner;
                                          }
                                          /**
                                           * @dev Adds a key-value pair to a map, or updates the value for an existing
                                           * key. O(1).
                                           *
                                           * Returns true if the key was added to the map, that is if it was not
                                           * already present.
                                           */
                                          function set(UintToAddressMap storage map, uint256 key, address value) internal returns (bool) {
                                              return _set(map._inner, bytes32(key), bytes32(uint256(value)));
                                          }
                                          /**
                                           * @dev Removes a value from a set. O(1).
                                           *
                                           * Returns true if the key was removed from the map, that is if it was present.
                                           */
                                          function remove(UintToAddressMap storage map, uint256 key) internal returns (bool) {
                                              return _remove(map._inner, bytes32(key));
                                          }
                                          /**
                                           * @dev Returns true if the key is in the map. O(1).
                                           */
                                          function contains(UintToAddressMap storage map, uint256 key) internal view returns (bool) {
                                              return _contains(map._inner, bytes32(key));
                                          }
                                          /**
                                           * @dev Returns the number of elements in the map. O(1).
                                           */
                                          function length(UintToAddressMap storage map) internal view returns (uint256) {
                                              return _length(map._inner);
                                          }
                                         /**
                                          * @dev Returns the element 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(UintToAddressMap storage map, uint256 index) internal view returns (uint256, address) {
                                              (bytes32 key, bytes32 value) = _at(map._inner, index);
                                              return (uint256(key), address(uint256(value)));
                                          }
                                          /**
                                           * @dev Returns the value associated with `key`.  O(1).
                                           *
                                           * Requirements:
                                           *
                                           * - `key` must be in the map.
                                           */
                                          function get(UintToAddressMap storage map, uint256 key) internal view returns (address) {
                                              return address(uint256(_get(map._inner, bytes32(key))));
                                          }
                                          /**
                                           * @dev Same as {get}, with a custom error message when `key` is not in the map.
                                           */
                                          function get(UintToAddressMap storage map, uint256 key, string memory errorMessage) internal view returns (address) {
                                              return address(uint256(_get(map._inner, bytes32(key), errorMessage)));
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev String operations.
                                       */
                                      library Strings {
                                          /**
                                           * @dev Converts a `uint256` to its ASCII `string` 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);
                                              uint256 index = digits - 1;
                                              temp = value;
                                              while (temp != 0) {
                                                  buffer[index--] = byte(uint8(48 + temp % 10));
                                                  temp /= 10;
                                              }
                                              return string(buffer);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      library MushroomLib {
                                          struct MushroomData {
                                              uint256 species;
                                              uint256 strength;
                                              uint256 lifespan;
                                          }
                                          struct MushroomType {
                                              uint256 id;
                                              uint256 strength;
                                              uint256 minLifespan;
                                              uint256 maxLifespan;
                                              uint256 minted;
                                              uint256 cap;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "./adapters/MetadataAdapter.sol";
                                      import "../MushroomLib.sol";
                                      /*
                                          A hub of adapters managing lifespan metadata for arbitrary NFTs
                                          Each adapter has it's own custom logic for that NFT
                                          Lifespan modification requesters have rights to manage lifespan metadata of NFTs via the adapters
                                          Admin(s) can manage the set of resolvers
                                      */
                                      contract MetadataResolver is AccessControlUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          mapping(address => address) public metadataAdapters;
                                          modifier onlyAdmin() {
                                              require(hasRole(DEFAULT_ADMIN_ROLE, msg.sender), "onlyAdmin");
                                              _;
                                          }
                                          modifier onlyLifespanModifier() {
                                              require(hasRole(LIFESPAN_MODIFY_REQUEST_ROLE, msg.sender), "onlyLifespanModifier");
                                              _;
                                          }
                                          bytes32 public constant LIFESPAN_MODIFY_REQUEST_ROLE = keccak256("LIFESPAN_MODIFY_REQUEST_ROLE");
                                          event ResolverSet(address nft, address resolver);
                                          modifier onlyWithMetadataAdapter(address nftContract) {
                                              require(metadataAdapters[nftContract] != address(0), "MetadataRegistry: No resolver set for nft");
                                              _;
                                          }
                                          function hasMetadataAdapter(address nftContract) external view returns (bool) {
                                              return metadataAdapters[nftContract] != address(0);
                                          }
                                          function getMetadataAdapter(address nftContract) external view returns (address) {
                                              return metadataAdapters[nftContract];
                                          }
                                          function isStakeable(address nftContract, uint256 nftIndex) external view returns (bool) {
                                              if (metadataAdapters[nftContract] == address(0)) {
                                                  return false;
                                              }
                                              
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              return resolver.isStakeable(nftIndex);
                                          }
                                          function initialize(address initialLifespanModifier_) public initializer {
                                              _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                                              _setupRole(LIFESPAN_MODIFY_REQUEST_ROLE, initialLifespanModifier_);
                                          }
                                          function getMushroomData(
                                              address nftContract,
                                              uint256 nftIndex,
                                              bytes calldata data
                                          ) external view onlyWithMetadataAdapter(nftContract) returns (MushroomLib.MushroomData memory) {
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              MushroomLib.MushroomData memory mushroomData = resolver.getMushroomData(nftIndex, data);
                                              return mushroomData;
                                          }
                                          function isBurnable(address nftContract, uint256 nftIndex) external view onlyWithMetadataAdapter(nftContract) returns (bool) {
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              return resolver.isBurnable(nftIndex);
                                          }
                                          function setMushroomLifespan(
                                              address nftContract,
                                              uint256 nftIndex,
                                              uint256 lifespan,
                                              bytes calldata data
                                          ) external onlyWithMetadataAdapter(nftContract) onlyLifespanModifier {
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              resolver.setMushroomLifespan(nftIndex, lifespan, data);
                                          }
                                          function setResolver(address nftContract, address resolver) public onlyAdmin {
                                              metadataAdapters[nftContract] = resolver;
                                              emit ResolverSet(nftContract, resolver);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "../../MushroomLib.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      /*
                                          Reads mushroom NFT metadata for a given NFT contract
                                          Also forwards requests from the MetadataResolver to set lifespan
                                      */
                                      abstract contract MetadataAdapter is AccessControlUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          bytes32 public constant LIFESPAN_MODIFY_REQUEST_ROLE = keccak256("LIFESPAN_MODIFY_REQUEST_ROLE");
                                          modifier onlyLifespanModifier() {
                                              require(hasRole(LIFESPAN_MODIFY_REQUEST_ROLE, msg.sender), "onlyLifespanModifier");
                                              _;
                                          }
                                          function getMushroomData(uint256 index, bytes calldata data) external virtual view returns (MushroomLib.MushroomData memory);
                                          function setMushroomLifespan(uint256 index, uint256 lifespan, bytes calldata data) external virtual;
                                          function isBurnable(uint256 index) external view virtual returns (bool);
                                          function isStakeable(uint256 index) external view virtual returns (bool);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      /* 
                                          - Stake up to X mushrooms per user (dao can change)
                                          - Reward mushroom yield rate for lifespan
                                          - When dead, burn mushroom erc721
                                          - Distribute 5% of ENOKI rewards to Chefs
                                      */
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      // import "@openzeppelin/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/ReentrancyGuard.sol";
                                      import "./TokenPool.sol";
                                      import "./Defensible.sol";
                                      import "./MushroomNFT.sol";
                                      import "./MushroomLib.sol";
                                      import "./metadata/MetadataResolver.sol";
                                      /**
                                       * @title Enoki Geyser
                                       * @dev A smart-contract based mechanism to distribute tokens over time, inspired loosely by
                                       *      Compound and Uniswap.
                                       *
                                       *      Distribution tokens are added to a locked pool in the contract and become unlocked over time
                                       *      according to a once-configurable unlock schedule. Once unlocked, they are available to be
                                       *      claimed by users.
                                       *
                                       *      A user may deposit tokens to accrue ownership share over the unlocked pool. This owner share
                                       *      is a function of the number of tokens deposited as well as the length of time deposited.
                                       *      Specifically, a user's share of the currently-unlocked pool equals their "deposit-seconds"
                                       *      divided by the global "deposit-seconds". This aligns the new token distribution with long
                                       *      term supporters of the project, addressing one of the major drawbacks of simple airdrops.
                                       *
                                       *      More background and motivation available at:
                                       *      https://github.com/ampleforth/RFCs/blob/master/RFCs/rfc-1.md
                                       */
                                      contract EnokiGeyser is Initializable, OwnableUpgradeSafe, AccessControlUpgradeSafe, ReentrancyGuardUpgradeSafe, Defensible {
                                          using SafeMath for uint256;
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          event Staked(address indexed user, address nftContract, uint256 nftId, uint256 total, bytes data);
                                          event Unstaked(address indexed user, address nftContract, uint256 nftId, uint256 total, uint256 indexed stakeIndex, bytes data);
                                          event TokensClaimed(address indexed user, uint256 amount, uint256 userReward, uint256 devReward);
                                          event TokensLocked(uint256 amount, uint256 total);
                                          event TokensLockedAirdrop(uint256 amount, uint256 total);
                                          event LifespanUsed(address nftContract, uint256 nftIndex, uint256 lifespanUsed, uint256 lifespan);
                                          event NewLifespan(address nftContract, uint256 nftIndex, uint256 lifespan);
                                          // amount: Unlocked tokens, total: Total locked tokens
                                          event TokensUnlocked(uint256 amount, uint256 total);
                                          event MaxStakesPerAddressSet(uint256 maxStakesPerAddress);
                                          event MetadataResolverSet(address metadataResolver);
                                          event BurnedMushroom(address nftContract, uint256 nftIndex);
                                          TokenPool public _unlockedPool;
                                          TokenPool public _lockedPool;
                                          MetadataResolver public metadataResolver;
                                          //
                                          // Time-bonus params
                                          //
                                          uint256 public constant BONUS_DECIMALS = 2;
                                          uint256 public startBonus = 0;
                                          uint256 public bonusPeriodSec = 0;
                                          uint256 public maxStakesPerAddress = 0;
                                          //
                                          // Global accounting state
                                          //
                                          uint256 public totalLockedShares = 0;
                                          uint256 public totalStakingShares = 0;
                                          uint256 public totalStrengthStaked = 0;
                                          uint256 private _totalStakingShareSeconds = 0;
                                          uint256 private _lastAccountingTimestampSec = now;
                                          uint256 private _maxUnlockSchedules = 0;
                                          uint256 private _initialSharesPerToken = 0;
                                          //
                                          // Dev reward state
                                          //
                                          uint256 public constant MAX_PERCENTAGE = 100;
                                          uint256 public devRewardPercentage = 0; //0% - 100%
                                          address public devRewardAddress;
                                          address public admin;
                                          BannedContractList public bannedContractList;
                                          //
                                          // User accounting state
                                          //
                                          // Represents a single stake for a user. A user may have multiple.
                                          struct Stake {
                                              address nftContract;
                                              uint256 nftIndex;
                                              uint256 strength;
                                              uint256 stakedAt;
                                          }
                                          // Caches aggregated values from the User->Stake[] map to save computation.
                                          // If lastAccountingTimestampSec is 0, there's no entry for that user.
                                          struct UserTotals {
                                              uint256 userStrengthStaked;
                                              uint256 stakingShareSeconds;
                                              uint256 lastAccountingTimestampSec;
                                          }
                                          // Aggregated staking values per user
                                          mapping(address => UserTotals) private _userTotals;
                                          // The collection of stakes for each user. Ordered by timestamp, earliest to latest.
                                          mapping(address => Stake[]) private _userStakes;
                                          //
                                          // Locked/Unlocked Accounting state
                                          //
                                          struct UnlockSchedule {
                                              uint256 initialLockedShares;
                                              uint256 unlockedShares;
                                              uint256 lastUnlockTimestampSec;
                                              uint256 endAtSec;
                                              uint256 durationSec;
                                          }
                                          UnlockSchedule[] public unlockSchedules;
                                          bool public initializeComplete;
                                          uint256 public constant SECONDS_PER_WEEK = 604800;
                                          uint256 public usedAirdropPool;
                                          uint256 public maxAirdropPool;
                                          address internal constant INITIALIZER_ADDRESS = 0xe9673e2806305557Daa67E3207c123Af9F95F9d2;
                                          IERC20 public enokiToken;
                                          uint256 public stakingEnabledTime;
                                          /**
                                           * @param enokiToken_ The token users receive as they unstake.
                                           * @param maxStakesPerAddress_ Maximum number of NFTs stakeable by a given account.
                                           * @param devRewardAddress_ Recipient address of dev rewards.
                                           * @param devRewardPercentage_ Pecentage of rewards claimed to be distributed for dev address.
                                           */
                                          function initialize(
                                              IERC20 enokiToken_,
                                              uint256 maxStakesPerAddress_,
                                              address devRewardAddress_,
                                              uint256 devRewardPercentage_,
                                              address bannedContractList_,
                                              uint256 stakingEnabledTime_,
                                              uint256 maxAirdropPool_,
                                              address resolver_
                                          ) public {
                                              require(msg.sender == INITIALIZER_ADDRESS, "Only deployer can reinitialize");
                                              require(admin == address(0), "Admin has already been initialized");
                                              require(initializeComplete == false, "Initialization already complete");
                                              // The dev reward must be some fraction of the max. (i.e. <= 100%)
                                              require(devRewardPercentage_ <= MAX_PERCENTAGE, "EnokiGeyser: dev reward too high");
                                              enokiToken = enokiToken_;
                                              maxStakesPerAddress = maxStakesPerAddress_;
                                              emit MaxStakesPerAddressSet(maxStakesPerAddress);
                                              devRewardPercentage = devRewardPercentage_;
                                              devRewardAddress = devRewardAddress_;
                                              stakingEnabledTime = stakingEnabledTime_;
                                              maxAirdropPool = maxAirdropPool_;
                                              metadataResolver = MetadataResolver(resolver_);
                                              emit MetadataResolverSet(address(metadataResolver));
                                              _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                                              bannedContractList = BannedContractList(bannedContractList_);
                                              initializeComplete = true;
                                          }
                                          modifier onlyAdmin() {
                                              require(hasRole(DEFAULT_ADMIN_ROLE, msg.sender), "EnokiGeyser: Only Admin");
                                              _;
                                          }
                                          /* ========== ADMIN FUNCTIONALITY ========== */
                                          // Only effects future stakes
                                          function setMaxStakesPerAddress(uint256 maxStakes) public onlyAdmin {
                                              maxStakesPerAddress = maxStakes;
                                              emit MaxStakesPerAddressSet(maxStakesPerAddress);
                                          }
                                          function setMetadataResolver(address resolver_) public onlyAdmin {
                                              metadataResolver = MetadataResolver(resolver_);
                                              emit MetadataResolverSet(address(metadataResolver));
                                          }
                                          /**
                                           * @return The token users receive as they unstake.
                                           */
                                          function getDistributionToken() public view returns (IERC20) {
                                              return enokiToken;
                                          }
                                          function getNumStakes(address user) external view returns (uint256) {
                                              return _userStakes[user].length;
                                          }
                                          function getStakes(address user) external view returns (Stake[] memory) {
                                              uint256 numStakes = _userStakes[user].length;
                                              Stake[] memory stakes = new Stake[](numStakes);
                                              for (uint256 i = 0; i < _userStakes[user].length; i++) {
                                                  stakes[i] = _userStakes[user][i];
                                              }
                                              return stakes;
                                          }
                                          function getStake(address user, uint256 stakeIndex) external view returns (Stake memory stake) {
                                              Stake storage _userStake = _userStakes[user][stakeIndex];
                                              stake = _userStake;
                                          }
                                          /**
                                           * @dev Transfers amount of deposit tokens from the user.
                                           * @param data Not used.
                                           */
                                          function stake(
                                              address nftContract,
                                              uint256 nftIndex,
                                              bytes calldata data
                                          ) external defend(bannedContractList) {
                                              require(now > stakingEnabledTime, "staking-too-early");
                                              require(metadataResolver.isStakeable(nftContract, nftIndex), "EnokiGeyser: nft not stakeable");
                                              _stakeFor(msg.sender, msg.sender, nftContract, nftIndex);
                                          }
                                          // /**
                                          //  * @dev Transfers amount of deposit tokens from the user.
                                          //  * @param data Not used.
                                          //  */
                                          // function stakeBulk(
                                          //     address[] memory nftContracts,
                                          //     uint256[] memory nftIndicies,
                                          //     bytes calldata data
                                          // ) external defend(bannedContractList) {
                                          //     require(now > stakingEnabledTime, "staking-too-early");
                                          //     require(nftContracts.length == nftIndicies.length, "args length mismatch");
                                          //     for (uint256 i = 0; i < nftContracts.length; i++) {
                                          //         require(metadataResolver.isStakeable(nftContracts[i], nftIndicies[i]), "EnokiGeyser: nft not stakeable");
                                          //         _stakeFor(msg.sender, msg.sender, nftContracts[i], nftIndicies[i]);
                                          //     }
                                          // }
                                          /**
                                           * @dev Private implementation of staking methods.
                                           * @param staker User address who deposits tokens to stake.
                                           * @param beneficiary User address who gains credit for this stake operation.
                                           */
                                          function _stakeFor(
                                              address staker,
                                              address beneficiary,
                                              address nftContract,
                                              uint256 nftIndex
                                          ) private {
                                              require(beneficiary != address(0), "EnokiGeyser: beneficiary is zero address");
                                              require(metadataResolver.isStakeable(nftContract, nftIndex), "EnokiGeyser: Nft specified not stakeable");
                                              // Shares is determined by NFT mushroom rate
                                              MushroomLib.MushroomData memory metadata = metadataResolver.getMushroomData(nftContract, nftIndex, "");
                                              // 1. User Accounting
                                              UserTotals storage totals = _userTotals[beneficiary];
                                              Stake memory newStake = Stake(nftContract, nftIndex, metadata.strength, now);
                                              _userStakes[beneficiary].push(newStake);
                                              require(_userStakes[beneficiary].length <= maxStakesPerAddress, "EnokiGeyser: Stake would exceed maximum stakes for address");
                                              totals.userStrengthStaked = totals.userStrengthStaked.add(metadata.strength);
                                              totalStrengthStaked = totalStrengthStaked.add(metadata.strength);
                                              IERC721(nftContract).transferFrom(staker, address(this), nftIndex);
                                              emit Staked(beneficiary, nftContract, nftIndex, totalStakedFor(beneficiary), "");
                                          }
                                          /**
                                           * @dev Unstakes a certain amount of previously deposited tokens. User also receives their
                                           * alotted number of distribution tokens.
                                           * @param stakes Mushrooms to unstake.
                                           * @param data Not used.
                                           */
                                          function unstake(uint256[] calldata stakes, bytes calldata data)
                                              external
                                              returns (
                                                  uint256 totalReward,
                                                  uint256 userReward,
                                                  uint256 devReward
                                              )
                                          {
                                              require(stakes.length == 1, "Can only unstake one nft at once");
                                              return _unstake(stakes[0]);
                                          }
                                          function _unstake(uint256 stakeIndex)
                                              private
                                              returns (
                                                  uint256 totalReward,
                                                  uint256 userReward,
                                                  uint256 devReward
                                              )
                                          {
                                              // 1. User Accounting
                                              UserTotals storage totals = _userTotals[msg.sender];
                                              Stake[] storage accountStakes = _userStakes[msg.sender];
                                              // Redeem from most recent stake and go backwards in time.
                                              uint256 rewardAmount = 0;
                                              Stake storage currentStake = accountStakes[stakeIndex];
                                              MushroomLib.MushroomData memory metadata = metadataResolver.getMushroomData(currentStake.nftContract, currentStake.nftIndex, "");
                                              uint256 lifespanUsed = now.sub(currentStake.stakedAt);
                                              bool deadMushroom = false;
                                              // Effective lifespan used is capped at mushroom lifespan
                                              if (lifespanUsed >= metadata.lifespan) {
                                                  lifespanUsed = metadata.lifespan;
                                                  deadMushroom = true;
                                              }
                                              emit LifespanUsed(currentStake.nftContract, currentStake.nftIndex, lifespanUsed, metadata.lifespan);
                                              rewardAmount = computeNewReward(rewardAmount, metadata.strength, lifespanUsed);
                                              // Update global aomunt staked
                                              totalStrengthStaked = totalStrengthStaked.sub(metadata.strength);
                                              totals.userStrengthStaked = totals.userStrengthStaked.sub(metadata.strength);
                                              // Burn dead mushrooms, if they can be burnt. Otherwise, they can still be withdrawn with 0 lifespan.
                                              if (deadMushroom && metadataResolver.isBurnable(currentStake.nftContract, currentStake.nftIndex)) {
                                                  MushroomNFT(currentStake.nftContract).burn(currentStake.nftIndex);
                                                  emit BurnedMushroom(currentStake.nftContract, currentStake.nftIndex);
                                              } else {
                                                  // If still alive, reduce lifespan of mushroom and return to user. If not burnable, return with 0 lifespan.
                                                  metadataResolver.setMushroomLifespan(currentStake.nftContract, currentStake.nftIndex, metadata.lifespan.sub(lifespanUsed), "");
                                                  IERC721(currentStake.nftContract).transferFrom(address(this), msg.sender, currentStake.nftIndex);
                                                  // TODO: Test
                                                  MushroomLib.MushroomData memory metadata2 = metadataResolver.getMushroomData(currentStake.nftContract, currentStake.nftIndex, "");
                                                  emit NewLifespan(currentStake.nftContract, currentStake.nftIndex, metadata2.lifespan);
                                              }
                                              uint256 finalStakeIndex = accountStakes.length - 1;
                                              // Delete current stake
                                              if (stakeIndex == finalStakeIndex) {
                                                  accountStakes.pop(); // Remove if end
                                              } else {
                                                  // Move last stake to it's spot
                                                  accountStakes[stakeIndex] = accountStakes[finalStakeIndex];
                                                  // Pop last stake, which is now duplicated
                                                  accountStakes.pop();
                                              }
                                              emit Unstaked(msg.sender, currentStake.nftContract, currentStake.nftIndex, totalStakedFor(msg.sender), stakeIndex, "");
                                              // Already set in updateAccounting
                                              // _lastAccountingTimestampSec = now;
                                              // interactions
                                              totalReward = rewardAmount;
                                              (userReward, devReward) = computeDevReward(totalReward);
                                              if (userReward > 0) {
                                                  require(enokiToken.transfer(msg.sender, userReward), "EnokiGeyser: transfer to user out of unlocked pool failed");
                                              }
                                              if (devReward > 0) {
                                                  require(enokiToken.transfer(devRewardAddress, devReward), "EnokiGeyser: transfer to dev out of unlocked pool failed");
                                              }
                                              emit TokensClaimed(msg.sender, rewardAmount, userReward, devReward);
                                              require(totalStakingShares == 0 || totalStaked() > 0, "EnokiGeyser: Error unstaking. Staking shares exist, but no staking tokens do");
                                          }
                                          function computeNewReward(
                                              uint256 currentReward,
                                              uint256 strength,
                                              uint256 timeStaked
                                          ) private view returns (uint256) {
                                              uint256 newReward = strength.mul(timeStaked).div(SECONDS_PER_WEEK);
                                              return currentReward.add(newReward);
                                          }
                                          function updateStake(
                                              address staker,
                                              uint256 stakeIndex,
                                              address nftContract,
                                              uint256 nftIndex,
                                              uint256 strength,
                                              uint256 stakedAt
                                          ) external onlyAdmin {
                                              _userStakes[staker][stakeIndex] = Stake(nftContract, nftIndex, strength, stakedAt);
                                          }
                                          /**
                                           * @dev Determines split of specified reward amount between user and dev.
                                           * @param totalReward Amount of reward to split.
                                           * @return userReward Reward amounts for user and dev.
                                           * @return devReward Reward amounts for user and dev.
                                           */
                                          function computeDevReward(uint256 totalReward) public view returns (uint256 userReward, uint256 devReward) {
                                              if (devRewardPercentage == 0) {
                                                  userReward = totalReward;
                                                  devReward = 0;
                                              } else if (devRewardPercentage == MAX_PERCENTAGE) {
                                                  userReward = 0;
                                                  devReward = totalReward;
                                              } else {
                                                  devReward = totalReward.mul(devRewardPercentage).div(MAX_PERCENTAGE);
                                                  userReward = totalReward.sub(devReward); // Extra dust due to truncated rounding goes to user
                                              }
                                          }
                                          /**
                                           * @param addr The user to look up staking information for.
                                           * @return The number of staking tokens deposited for addr.
                                           */
                                          function totalStakedFor(address addr) public view returns (uint256) {
                                              return _userTotals[addr].userStrengthStaked;
                                          }
                                          /**
                                           * @return The total number of deposit tokens staked globally, by all users.
                                           */
                                          function totalStaked() public view returns (uint256) {
                                              return totalStrengthStaked;
                                          }
                                          /**
                                           * @return Total number of locked distribution tokens.
                                           */
                                          function totalLocked() public view returns (uint256) {
                                              return enokiToken.balanceOf(address(this));
                                          }
                                          /**
                                           * @dev This funcion allows the contract owner to add more locked distribution tokens, along
                                           *      with the associated "unlock schedule". These locked tokens immediately begin unlocking
                                           *      linearly over the duraction of durationSec timeframe.
                                           * @param amount Number of distribution tokens to lock. These are transferred from the caller.
                                           * @param durationSec Length of time to linear unlock the tokens.
                                           */
                                          function lockTokens(uint256 amount, uint256 durationSec) external onlyOwner {
                                              require(enokiToken.transferFrom(msg.sender, address(this), amount), "EnokiGeyser: transfer failed");
                                              emit TokensLocked(amount, totalLocked());
                                          }
                                          function lockTokensAirdrop(address airdrop, uint256 amount) external onlyAdmin {
                                              require(usedAirdropPool.add(amount) <= maxAirdropPool, "Exceeds maximum airdrop tokens");
                                              usedAirdropPool = usedAirdropPool.add(amount);
                                              require(enokiToken.transfer(address(airdrop), amount), "EnokiGeyser: transfer into airdrop pool failed");
                                              emit TokensLockedAirdrop(amount, totalLocked());
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      /**
                                       * @title EthVesting
                                       * @dev A eth holder contract that can release its eth balance gradually like a
                                       * typical vesting scheme, with a cliff and vesting period.
                                       */
                                      contract EthVesting {
                                          // The vesting schedule is time-based (i.e. using block timestamps as opposed to e.g. block numbers), and is
                                          // therefore sensitive to timestamp manipulation (which is something miners can do, to a certain degree). Therefore,
                                          // it is recommended to avoid using short time durations (less than a minute). Typical vesting schemes, with a
                                          // cliff period of a year and a duration of four years, are safe to use.
                                          // solhint-disable not-rely-on-time
                                          using SafeMath for uint256;
                                          event EthReleased(uint256 amount);
                                          event EthReleasedBackup(uint256 amount);
                                          event PaymentReceived(address from, uint256 amount);
                                          // beneficiary of tokens after they are released
                                          address payable private _beneficiary;
                                          address payable private _backupBeneficiary;
                                          // Durations and timestamps are expressed in UNIX time, the same units as block.timestamp.
                                          uint256 private _cliff;
                                          uint256 private _start;
                                          uint256 private _duration;
                                          uint256 private _backupReleaseGracePeriod;
                                          uint256 private _released;
                                          /**
                                           * @dev Creates a vesting contract that vests its balance of any ERC20 token to the
                                           * beneficiary, gradually in a linear fashion until start + duration. By then all
                                           * of the balance will have vested.
                                           * @param beneficiary address of the beneficiary to whom vested tokens are transferred
                                           * @param cliffDuration duration in seconds of the cliff in which tokens will begin to vest
                                           * @param start the time (as Unix time) at which point vesting starts
                                           * @param duration duration in seconds of the period in which the tokens will vest
                                           * @param backupReleaseGracePeriod the period after the duration in completed before the backup beneficiary can withdraw
                                           */
                                          constructor (address payable beneficiary, address payable backupBeneficiary, uint256 start, uint256 cliffDuration, uint256 duration, uint256 backupReleaseGracePeriod) public {
                                              require(beneficiary != address(0), "EthVesting: beneficiary is the zero address");
                                              // solhint-disable-next-line max-line-length
                                              require(cliffDuration <= duration, "EthVesting: cliff is longer than duration");
                                              require(duration > 0, "EthVesting: duration is 0");
                                              // solhint-disable-next-line max-line-length
                                              require(start.add(duration) > block.timestamp, "EthVesting: final time is before current time");
                                              _beneficiary = beneficiary;
                                              _backupBeneficiary = backupBeneficiary;
                                              _duration = duration;
                                              _cliff = start.add(cliffDuration);
                                              _start = start;
                                              _backupReleaseGracePeriod = backupReleaseGracePeriod;
                                          }
                                          /**
                                           * @return the beneficiary of the ether.
                                           */
                                          function beneficiary() public view returns (address) {
                                              return _beneficiary;
                                          }
                                          /**
                                           * @return the backup beneficiary of the ether.
                                           */
                                          function backupBeneficiary() public view returns (address) {
                                              return _backupBeneficiary;
                                          }
                                          /**
                                           * @return the period after the duration in completed before the backup beneficiary can withdraw.
                                           */
                                          function backupReleaseGracePeriod() public view returns (uint256) {
                                              return _backupReleaseGracePeriod;
                                          }
                                          /**
                                           * @return the cliff time of the eth vesting.
                                           */
                                          function cliff() public view returns (uint256) {
                                              return _cliff;
                                          }
                                          /**
                                           * @return the start time of the eth vesting.
                                           */
                                          function start() public view returns (uint256) {
                                              return _start;
                                          }
                                          /**
                                           * @return the duration of the eth vesting.
                                           */
                                          function duration() public view returns (uint256) {
                                              return _duration;
                                          }
                                          /**
                                           * @return the amount of the token released.
                                           */
                                          function released() public view returns (uint256) {
                                              return _released;
                                          }
                                          /**
                                           * @notice Transfers vested tokens to beneficiary.
                                           */
                                          function release() public {
                                              uint256 unreleased = _releasableAmount();
                                              require(unreleased > 0, "EthVesting: no eth is due");
                                              _released = _released.add(unreleased);
                                              _beneficiary.transfer(unreleased);
                                              emit EthReleased(unreleased);
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested but hasn't been released yet.
                                           */
                                          function _releasableAmount() private view returns (uint256) {
                                              return _vestedAmount().sub(_released);
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested.
                                           */
                                          function _vestedAmount() private view returns (uint256) {
                                              uint256 currentBalance = address(this).balance;
                                              uint256 totalBalance = currentBalance.add(_released);
                                              if (block.timestamp < _cliff) {
                                                  return 0;
                                              } else if (block.timestamp >= _start.add(_duration)) {
                                                  return totalBalance;
                                              } else {
                                                  return totalBalance.mul(block.timestamp.sub(_start)).div(_duration);
                                              }
                                          }
                                          /**
                                           * @dev After the vesting period is complete, allows for withdrawal by backup beneficiary if funds are unclaimed after the post-duration grace period
                                           */
                                          function backupRelease() public {
                                              require(block.timestamp >= _start.add(_duration).add(_backupReleaseGracePeriod));
                                              _backupBeneficiary.transfer(address(this).balance);
                                              emit EthReleasedBackup(address(this).balance);
                                          }
                                          // Allow Recieve Ether
                                          receive () external payable virtual {
                                              emit PaymentReceived(msg.sender, msg.value);
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Wrappers over Solidity's arithmetic operations with added overflow
                                       * checks.
                                       *
                                       * Arithmetic operations in Solidity wrap on overflow. This can easily result
                                       * in bugs, because programmers usually assume that an overflow raises an
                                       * error, which is the standard behavior in high level programming languages.
                                       * `SafeMath` restores this intuition by reverting the transaction when an
                                       * operation overflows.
                                       *
                                       * Using this library instead of the unchecked operations eliminates an entire
                                       * class of bugs, so it's recommended to use it always.
                                       */
                                      library SafeMath {
                                          /**
                                           * @dev Returns the addition of two unsigned integers, reverting on
                                           * overflow.
                                           *
                                           * Counterpart to Solidity's `+` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Addition cannot overflow.
                                           */
                                          function add(uint256 a, uint256 b) internal pure returns (uint256) {
                                              uint256 c = a + b;
                                              require(c >= a, "SafeMath: addition overflow");
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the subtraction of two unsigned integers, reverting on
                                           * overflow (when the result is negative).
                                           *
                                           * Counterpart to Solidity's `-` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Subtraction cannot overflow.
                                           */
                                          function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return sub(a, b, "SafeMath: subtraction overflow");
                                          }
                                          /**
                                           * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
                                           * overflow (when the result is negative).
                                           *
                                           * Counterpart to Solidity's `-` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Subtraction cannot overflow.
                                           */
                                          function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b <= a, errorMessage);
                                              uint256 c = a - b;
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the multiplication of two unsigned integers, reverting on
                                           * overflow.
                                           *
                                           * Counterpart to Solidity's `*` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Multiplication cannot overflow.
                                           */
                                          function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                                              // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                                              // benefit is lost if 'b' is also tested.
                                              // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
                                              if (a == 0) {
                                                  return 0;
                                              }
                                              uint256 c = a * b;
                                              require(c / a == b, "SafeMath: multiplication overflow");
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the integer division of two unsigned integers. Reverts on
                                           * division by zero. The result is rounded towards zero.
                                           *
                                           * Counterpart to Solidity's `/` operator. Note: this function uses a
                                           * `revert` opcode (which leaves remaining gas untouched) while Solidity
                                           * uses an invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function div(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return div(a, b, "SafeMath: division by zero");
                                          }
                                          /**
                                           * @dev Returns the integer division of two unsigned integers. Reverts with custom message on
                                           * division by zero. The result is rounded towards zero.
                                           *
                                           * Counterpart to Solidity's `/` operator. Note: this function uses a
                                           * `revert` opcode (which leaves remaining gas untouched) while Solidity
                                           * uses an invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b > 0, errorMessage);
                                              uint256 c = a / b;
                                              // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return mod(a, b, "SafeMath: modulo by zero");
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts with custom message when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b != 0, errorMessage);
                                              return a % b;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      import "./EnokiGeyser.sol";
                                      contract GeyserEscrow is Ownable {
                                          EnokiGeyser public geyser;
                                          constructor(EnokiGeyser geyser_) public {
                                              geyser = geyser_;
                                          }
                                          function lockTokens(
                                              uint256 amount,
                                              uint256 durationSec
                                          ) external onlyOwner {
                                              IERC20 distributionToken = geyser.getDistributionToken();
                                              distributionToken.approve(address(geyser), amount);
                                              geyser.lockTokens(amount, durationSec);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "../GSN/Context.sol";
                                      /**
                                       * @dev Contract module which provides a basic access control mechanism, where
                                       * there is an account (an owner) that can be granted exclusive access to
                                       * specific functions.
                                       *
                                       * By default, the owner account will be the one that deploys the contract. This
                                       * can later be changed with {transferOwnership}.
                                       *
                                       * This module is used through inheritance. It will make available the modifier
                                       * `onlyOwner`, which can be applied to your functions to restrict their use to
                                       * the owner.
                                       */
                                      contract Ownable is Context {
                                          address private _owner;
                                          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                                          /**
                                           * @dev Initializes the contract setting the deployer as the initial owner.
                                           */
                                          constructor () internal {
                                              address msgSender = _msgSender();
                                              _owner = msgSender;
                                              emit OwnershipTransferred(address(0), msgSender);
                                          }
                                          /**
                                           * @dev Returns the address of the current owner.
                                           */
                                          function owner() public view returns (address) {
                                              return _owner;
                                          }
                                          /**
                                           * @dev Throws if called by any account other than the owner.
                                           */
                                          modifier onlyOwner() {
                                              require(_owner == _msgSender(), "Ownable: caller is not the owner");
                                              _;
                                          }
                                          /**
                                           * @dev Leaves the contract without owner. It will not be possible to call
                                           * `onlyOwner` functions anymore. Can only be called by the current owner.
                                           *
                                           * NOTE: Renouncing ownership will leave the contract without an owner,
                                           * thereby removing any functionality that is only available to the owner.
                                           */
                                          function renounceOwnership() public virtual onlyOwner {
                                              emit OwnershipTransferred(_owner, address(0));
                                              _owner = address(0);
                                          }
                                          /**
                                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                                           * Can only be called by the current owner.
                                           */
                                          function transferOwnership(address newOwner) public virtual onlyOwner {
                                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                                              emit OwnershipTransferred(_owner, newOwner);
                                              _owner = newOwner;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /*
                                       * @dev Provides information about the current execution context, including the
                                       * sender of the transaction and its data. While these are generally available
                                       * via msg.sender and msg.data, they should not be accessed in such a direct
                                       * manner, since when dealing with GSN meta-transactions the account sending and
                                       * paying for execution may not be the actual sender (as far as an application
                                       * is concerned).
                                       *
                                       * This contract is only required for intermediate, library-like contracts.
                                       */
                                      abstract contract Context {
                                          function _msgSender() internal view virtual returns (address payable) {
                                              return msg.sender;
                                          }
                                          function _msgData() internal view virtual returns (bytes memory) {
                                              this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                                              return msg.data;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity >=0.5.0;
                                      // Allows anyone to claim a token if they exist in a merkle root.
                                      interface IMerkleDistributor {
                                          // Returns the address of the token distributed by this contract.
                                          function token() external view returns (address);
                                          // Returns the merkle root of the merkle tree containing account balances available to claim.
                                          function merkleRoot() external view returns (bytes32);
                                          // Returns true if the index has been marked claimed.
                                          function isClaimed(uint256 index) external view returns (bool);
                                          // Claim the given amount of the token to the given address. Reverts if the inputs are invalid.
                                          function claim(uint256 index, address account, uint256 amount, bytes32[] calldata merkleProof, uint256 tipBips) external;
                                          // This event is triggered whenever a call to #claim succeeds.
                                          event Claimed(uint256 index, address account, uint256 amount);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface IMiniMe {
                                          /* ========== STANDARD ERC20 ========== */
                                          function totalSupply() external view returns (uint256);
                                          function balanceOf(address account) external view returns (uint256);
                                          function transfer(address recipient, uint256 amount) external returns (bool);
                                          function allowance(address owner, address spender) external view returns (uint256);
                                          function approve(address spender, uint256 amount) external returns (bool);
                                          function transferFrom(
                                              address sender,
                                              address recipient,
                                              uint256 amount
                                          ) external returns (bool);
                                          event Transfer(address indexed from, address indexed to, uint256 value);
                                          event Approval(address indexed owner, address indexed spender, uint256 value);
                                          /* ========== MINIME EXTENSIONS ========== */
                                          function balanceOfAt(address account, uint256 blockNumber) external view returns (uint256);
                                          function totalSupplyAt(uint256 blockNumber) external view returns (uint256);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface IMission  {
                                          function sendSpores(address recipient, uint256 amount) external;
                                          function approvePool(address pool) external;
                                          function revokePool(address pool) external;
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      interface IMushroomFactory  {
                                          function costPerMushroom() external returns (uint256);
                                          function getRemainingMintableForMySpecies(uint256 numMushrooms) external view returns (uint256);
                                          function growMushrooms(address recipient, uint256 numMushrooms) external;
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "../MushroomLib.sol";
                                      abstract contract IMushroomMetadata {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          function hasMetadataAdapter(address nftContract) external virtual view returns (bool);
                                          function getMushroomData(
                                              address nftContract,
                                              uint256 nftIndex,
                                              bytes calldata data
                                          ) external virtual view returns (MushroomLib.MushroomData memory);
                                          function setMushroomLifespan(
                                              address nftContract,
                                              uint256 nftIndex,
                                              uint256 lifespan,
                                              bytes calldata data
                                          ) external virtual;
                                          function setResolver(address nftContract, address resolver) public virtual;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface IRateVoteable {
                                          function changeRate(uint256 percentage) external;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface ISporeToken {
                                          /* ========== STANDARD ERC20 ========== */
                                          function totalSupply() external view returns (uint256);
                                          function balanceOf(address account) external view returns (uint256);
                                          function transfer(address recipient, uint256 amount) external returns (bool);
                                          function allowance(address owner, address spender) external view returns (uint256);
                                          function approve(address spender, uint256 amount) external returns (bool);
                                          function transferFrom(
                                              address sender,
                                              address recipient,
                                              uint256 amount
                                          ) external returns (bool);
                                          event Transfer(address indexed from, address indexed to, uint256 value);
                                          event Approval(address indexed owner, address indexed spender, uint256 value);
                                          /* ========== EXTENSIONS ========== */
                                          function burn(uint256 amount) external;
                                          function mint(address to, uint256 amount) external;
                                          function addInitialLiquidityTransferRights(address account) external;
                                          function enableTransfers() external;
                                          function addMinter(address account) external;
                                          function removeMinter(address account) external;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      abstract contract ITokenPool {
                                          function token() external virtual view returns (IERC20);
                                          function balance() external virtual view returns (uint256);
                                          function transfer(address to, uint256 value) external virtual returns (bool);
                                          function rescueFunds(address tokenToRescue, address to, uint256 amount) external virtual returns (bool);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity =0.6.11;
                                      import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts/cryptography/MerkleProof.sol";
                                      import "./interfaces/IMerkleDistributor.sol";
                                      contract MerkleDistributor is IMerkleDistributor {
                                          address public immutable override token;
                                          bytes32 public immutable override merkleRoot;
                                          address public immutable dao;
                                          uint256 public immutable daoReleaseTime;
                                          // This is a packed array of booleans.
                                          mapping(uint256 => uint256) private claimedBitMap;
                                          address deployer;
                                          constructor(
                                              address token_,
                                              bytes32 merkleRoot_,
                                              address dao_,
                                              uint256 releaseTime_,
                                              address deployer_
                                          ) public {
                                              token = token_;
                                              merkleRoot = merkleRoot_;
                                              deployer = deployer_;
                                              dao = dao_;
                                              daoReleaseTime = releaseTime_;
                                          }
                                          function isClaimed(uint256 index) public override view returns (bool) {
                                              uint256 claimedWordIndex = index / 256;
                                              uint256 claimedBitIndex = index % 256;
                                              uint256 claimedWord = claimedBitMap[claimedWordIndex];
                                              uint256 mask = (1 << claimedBitIndex);
                                              return claimedWord & mask == mask;
                                          }
                                          function _setClaimed(uint256 index) private {
                                              uint256 claimedWordIndex = index / 256;
                                              uint256 claimedBitIndex = index % 256;
                                              claimedBitMap[claimedWordIndex] =
                                                  claimedBitMap[claimedWordIndex] |
                                                  (1 << claimedBitIndex);
                                          }
                                          function claim(
                                              uint256 index,
                                              address account,
                                              uint256 amount,
                                              bytes32[] calldata merkleProof,
                                              uint256 tipBips
                                          ) external override {
                                              require(tipBips <= 10000);
                                              require(!isClaimed(index), "MerkleDistributor: Drop already claimed.");
                                              // Verify the merkle proof.
                                              bytes32 node = keccak256(abi.encodePacked(index, account, amount));
                                              require(
                                                  MerkleProof.verify(merkleProof, merkleRoot, node),
                                                  "MerkleDistributor: Invalid proof."
                                              );
                                              // Mark it claimed and send the token.
                                              _setClaimed(index);
                                              uint256 tip = account == msg.sender ? (amount * tipBips) / 10000 : 0;
                                              require(
                                                  IERC20(token).transfer(account, amount - tip),
                                                  "MerkleDistributor: Transfer failed."
                                              );
                                              if (tip > 0) require(IERC20(token).transfer(deployer, tip));
                                              emit Claimed(index, account, amount);
                                          }
                                          function unclaimedToDao() external {
                                              require(msg.sender == deployer, "!deployer");
                                              require(now >= daoReleaseTime, "before unclaimed release time");
                                              IERC20 enoki = IERC20(token);
                                              uint256 remainingUnclaimed = enoki.balanceOf(address(this));
                                              enoki.transfer(dao, remainingUnclaimed);
                                          }
                                          function collectDust(address _token, uint256 _amount) external {
                                              require(msg.sender == deployer, "!deployer");
                                              require(_token != token, "!token");
                                              if (_token == address(0)) {
                                                  // token address(0) = ETH
                                                  payable(deployer).transfer(_amount);
                                              } else {
                                                  IERC20(_token).transfer(deployer, _amount);
                                              }
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Interface of the ERC20 standard as defined in the EIP.
                                       */
                                      interface IERC20 {
                                          /**
                                           * @dev Returns the amount of tokens in existence.
                                           */
                                          function totalSupply() external view returns (uint256);
                                          /**
                                           * @dev Returns the amount of tokens owned by `account`.
                                           */
                                          function balanceOf(address account) external view returns (uint256);
                                          /**
                                           * @dev Moves `amount` tokens from the caller's account to `recipient`.
                                           *
                                           * Returns a boolean value indicating whether the operation succeeded.
                                           *
                                           * Emits a {Transfer} event.
                                           */
                                          function transfer(address recipient, uint256 amount) external returns (bool);
                                          /**
                                           * @dev Returns the remaining number of tokens that `spender` will be
                                           * allowed to spend on behalf of `owner` through {transferFrom}. This is
                                           * zero by default.
                                           *
                                           * This value changes when {approve} or {transferFrom} are called.
                                           */
                                          function allowance(address owner, address spender) external view returns (uint256);
                                          /**
                                           * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
                                           *
                                           * Returns a boolean value indicating whether the operation succeeded.
                                           *
                                           * IMPORTANT: Beware that changing an allowance with this method brings the risk
                                           * that someone may use both the old and the new allowance by unfortunate
                                           * transaction ordering. One possible solution to mitigate this race
                                           * condition is to first reduce the spender's allowance to 0 and set the
                                           * desired value afterwards:
                                           * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                                           *
                                           * Emits an {Approval} event.
                                           */
                                          function approve(address spender, uint256 amount) external returns (bool);
                                          /**
                                           * @dev Moves `amount` tokens from `sender` to `recipient` using the
                                           * allowance mechanism. `amount` is then deducted from the caller's
                                           * allowance.
                                           *
                                           * Returns a boolean value indicating whether the operation succeeded.
                                           *
                                           * Emits a {Transfer} event.
                                           */
                                          function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
                                          /**
                                           * @dev Emitted when `value` tokens are moved from one account (`from`) to
                                           * another (`to`).
                                           *
                                           * Note that `value` may be zero.
                                           */
                                          event Transfer(address indexed from, address indexed to, uint256 value);
                                          /**
                                           * @dev Emitted when the allowance of a `spender` for an `owner` is set by
                                           * a call to {approve}. `value` is the new allowance.
                                           */
                                          event Approval(address indexed owner, address indexed spender, uint256 value);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev These functions deal with verification of Merkle trees (hash trees),
                                       */
                                      library MerkleProof {
                                          /**
                                           * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
                                           * defined by `root`. For this, a `proof` must be provided, containing
                                           * sibling hashes on the branch from the leaf to the root of the tree. Each
                                           * pair of leaves and each pair of pre-images are assumed to be sorted.
                                           */
                                          function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
                                              bytes32 computedHash = leaf;
                                              for (uint256 i = 0; i < proof.length; i++) {
                                                  bytes32 proofElement = proof[i];
                                                  if (computedHash <= proofElement) {
                                                      // Hash(current computed hash + current element of the proof)
                                                      computedHash = keccak256(abi.encodePacked(computedHash, proofElement));
                                                  } else {
                                                      // Hash(current element of the proof + current computed hash)
                                                      computedHash = keccak256(abi.encodePacked(proofElement, computedHash));
                                                  }
                                              }
                                              // Check if the computed hash (root) is equal to the provided root
                                              return computedHash == root;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "../../MushroomNFT.sol";
                                      import "../../MushroomLib.sol";
                                      import "./MetadataAdapter.sol";
                                      /*
                                          Reads mushroom NFT metadata directly from the Mushroom NFT contract
                                          Also forwards requests from the MetadataResolver to a given forwarder, that cannot be modified
                                      */
                                      contract MushroomAdapter is Initializable, MetadataAdapter {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          MushroomNFT public mushroomNft;
                                          function initialize(address nftContract_, address forwardActionsFrom_) public initializer {
                                              mushroomNft = MushroomNFT(nftContract_);
                                              _setupRole(LIFESPAN_MODIFY_REQUEST_ROLE, forwardActionsFrom_);
                                          }
                                          function getMushroomData(uint256 index, bytes calldata data) external override view returns (MushroomLib.MushroomData memory) {
                                              MushroomLib.MushroomData memory mData = mushroomNft.getMushroomData(index);
                                              return mData;
                                          }
                                          // Mushrooms can always be staked
                                          function isStakeable(uint256 nftIndex) external override view returns (bool) {
                                              return true;
                                          }
                                          // All Mushrooms are burnable
                                          function isBurnable(uint256 index) external override view returns (bool) {
                                              return true;
                                          }
                                          function setMushroomLifespan(
                                              uint256 index,
                                              uint256 lifespan,
                                              bytes calldata data
                                          ) external override onlyLifespanModifier {
                                              mushroomNft.setMushroomLifespan(index, lifespan);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
                                      /*
                                          A pool of spores that can be takens by Spore pools according to their spore rate
                                      */
                                      contract Mission is Initializable, OwnableUpgradeSafe {
                                          IERC20 public sporeToken;
                                          mapping (address => bool) public approved;
                                          event SporesHarvested(address pool, uint256 amount);
                                          modifier onlyApprovedPool() {
                                              require(approved[msg.sender], "Mission: Only approved pools");
                                              _;
                                          }
                                          function initialize(IERC20 sporeToken_) public initializer {
                                              __Ownable_init();
                                              sporeToken = sporeToken_;
                                          }
                                          function sendSpores(address recipient, uint256 amount) public onlyApprovedPool {
                                              sporeToken.transfer(recipient, amount);
                                              emit SporesHarvested(msg.sender, amount);
                                          }
                                          function approvePool(address pool) public onlyOwner {
                                              approved[pool] = true;
                                          }
                                          function revokePool(address pool) public onlyOwner {
                                              approved[pool] = false;
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "./MushroomNFT.sol";
                                      import "./MushroomLib.sol";
                                      /*
                                          MushroomFactories manage the mushroom generation logic for pools
                                          Each pool will have it's own factory to generate mushrooms according
                                          to its' powers.
                                          The mushroomFactory should be administered by the pool, which grants the ability to grow mushrooms
                                      */
                                      contract MushroomFactory is Initializable, OwnableUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          using SafeMath for uint256;
                                          event MushroomGrown(address recipient, uint256 id, uint256 species, uint256 lifespan);
                                          IERC20 public sporeToken;
                                          MushroomNFT public mushroomNft;
                                          uint256 public costPerMushroom;
                                          uint256 public mySpecies;
                                          uint256 public spawnCount;
                                          function initialize(
                                              IERC20 sporeToken_,
                                              MushroomNFT mushroomNft_,
                                              address sporePool_,
                                              uint256 costPerMushroom_,
                                              uint256 mySpecies_
                                          ) public initializer {
                                              __Ownable_init();
                                              sporeToken = sporeToken_;
                                              mushroomNft = mushroomNft_;
                                              costPerMushroom = costPerMushroom_;
                                              mySpecies = mySpecies_;
                                              transferOwnership(sporePool_);
                                          }
                                          /*
                                              Each mushroom will have a randomly generated lifespan within it's range. To prevent mushrooms harvested at the same block from having the same properties, a spawnCount seed is added to the block timestamp before hashing the timestamp to generate the lifespan for each individual mushroom.
                                              Note that block.timestamp is somewhat manipulatable by Miners. If a Miner was a massive ENOKI fan and only harvested when the mined a block they could give themselves mushrooms with longer lifespan than the average. However, the lifespan is still constained by the max lifespan. 
                                          */
                                          function _generateMushroomLifespan(uint256 minLifespan, uint256 maxLifespan) internal returns (uint256) {
                                              uint256 range = maxLifespan.sub(minLifespan);
                                              uint256 fromMin = uint256(keccak256(abi.encodePacked(block.timestamp.add(spawnCount)))) % range;
                                              spawnCount = spawnCount.add(1);
                                              return minLifespan.add(fromMin);
                                          }
                                          function getRemainingMintableForMySpecies() public view returns (uint256) {
                                              return mushroomNft.getRemainingMintableForSpecies(mySpecies);
                                          }
                                          // Each mushroom costs 1/10th of the spore rate in spores.
                                          function growMushrooms(address recipient, uint256 numMushrooms) public onlyOwner {
                                              MushroomLib.MushroomType memory species = mushroomNft.getSpecies(mySpecies);
                                              require(getRemainingMintableForMySpecies() >= numMushrooms, "MushroomFactory: Mushrooms to grow exceeds species cap");
                                              for (uint256 i = 0; i < numMushrooms; i++) {
                                                  uint256 nextId = mushroomNft.totalSupply().add(1);
                                                  uint256 lifespan = _generateMushroomLifespan(species.minLifespan, species.maxLifespan);
                                                  mushroomNft.mint(recipient, nextId, mySpecies, lifespan);
                                                  emit MushroomGrown(recipient, nextId, mySpecies, lifespan);
                                              }
                                          }
                                      }pragma solidity ^0.6.0;
                                      import "./IERC20.sol";
                                      import "../../math/SafeMath.sol";
                                      import "../../utils/Address.sol";
                                      /**
                                       * @title SafeERC20
                                       * @dev Wrappers around ERC20 operations that throw on failure (when the token
                                       * contract returns false). Tokens that return no value (and instead revert or
                                       * throw on failure) are also supported, non-reverting calls are assumed to be
                                       * successful.
                                       * To use this library you can add a `using SafeERC20 for ERC20;` statement to your contract,
                                       * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
                                       */
                                      library SafeERC20 {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          function safeTransfer(IERC20 token, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
                                          }
                                          function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
                                          }
                                          function safeApprove(IERC20 token, address spender, uint256 value) internal {
                                              // safeApprove should only be called when setting an initial allowance,
                                              // or when resetting it to zero. To increase and decrease it, use
                                              // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                                              // solhint-disable-next-line max-line-length
                                              require((value == 0) || (token.allowance(address(this), spender) == 0),
                                                  "SafeERC20: approve from non-zero to non-zero allowance"
                                              );
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
                                          }
                                          function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).add(value);
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          /**
                                           * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                                           * on the return value: the return value is optional (but if data is returned, it must not be false).
                                           * @param token The token targeted by the call.
                                           * @param data The call data (encoded using abi.encode or one of its variants).
                                           */
                                          function _callOptionalReturn(IERC20 token, bytes memory data) private {
                                              // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                                              // we're implementing it ourselves.
                                              // A Solidity high level call has three parts:
                                              //  1. The target address is checked to verify it contains contract code
                                              //  2. The call itself is made, and success asserted
                                              //  3. The return value is decoded, which in turn checks the size of the returned data.
                                              // solhint-disable-next-line max-line-length
                                              require(address(token).isContract(), "SafeERC20: call to non-contract");
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, bytes memory returndata) = address(token).call(data);
                                              require(success, "SafeERC20: low-level call failed");
                                              if (returndata.length > 0) { // Return data is optional
                                                  // solhint-disable-next-line max-line-length
                                                  require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                                              }
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/GSN/Context.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      /**
                                       * @title PaymentSplitter
                                       * @dev This contract allows to split Ether payments among a group of accounts. The sender does not need to be aware
                                       * that the Ether will be split in this way, since it is handled transparently by the contract.
                                       *
                                       * The split can be in equal parts or in any other arbitrary proportion. The way this is specified is by assigning each
                                       * account to a number of shares. Of all the Ether that this contract receives, each account will then be able to claim
                                       * an amount proportional to the percentage of total shares they were assigned.
                                       *
                                       * `PaymentSplitter` follows a _pull payment_ model. This means that payments are not automatically forwarded to the
                                       * accounts but kept in this contract, and the actual transfer is triggered as a separate step by calling the {release}
                                       * function.
                                       */
                                      contract PaymentSplitter is Context {
                                          using SafeMath for uint256;
                                          event PayeeAdded(address account, uint256 shares);
                                          event PaymentReleased(address to, uint256 amount);
                                          event PaymentReceived(address from, uint256 amount);
                                          uint256 private _totalShares;
                                          uint256 private _totalReleased;
                                          mapping(address => uint256) private _shares;
                                          mapping(address => uint256) private _released;
                                          address[] private _payees;
                                          /**
                                           * @dev Creates an instance of `PaymentSplitter` where each account in `payees` is assigned the number of shares at
                                           * the matching position in the `shares` array.
                                           *
                                           * All addresses in `payees` must be non-zero. Both arrays must have the same non-zero length, and there must be no
                                           * duplicates in `payees`.
                                           */
                                          constructor (address[] memory payees, uint256[] memory shares) public payable {
                                              // solhint-disable-next-line max-line-length
                                              require(payees.length == shares.length, "PaymentSplitter: payees and shares length mismatch");
                                              require(payees.length > 0, "PaymentSplitter: no payees");
                                              for (uint256 i = 0; i < payees.length; i++) {
                                                  _addPayee(payees[i], shares[i]);
                                              }
                                          }
                                          /**
                                           * @dev The Ether received will be logged with {PaymentReceived} events. Note that these events are not fully
                                           * reliable: it's possible for a contract to receive Ether without triggering this function. This only affects the
                                           * reliability of the events, and not the actual splitting of Ether.
                                           *
                                           * To learn more about this see the Solidity documentation for
                                           * https://solidity.readthedocs.io/en/latest/contracts.html#fallback-function[fallback
                                           * functions].
                                           */
                                          receive () external payable virtual {
                                              emit PaymentReceived(_msgSender(), msg.value);
                                          }
                                          /**
                                           * @dev Getter for the total shares held by payees.
                                           */
                                          function totalShares() public view returns (uint256) {
                                              return _totalShares;
                                          }
                                          /**
                                           * @dev Getter for the total amount of Ether already released.
                                           */
                                          function totalReleased() public view returns (uint256) {
                                              return _totalReleased;
                                          }
                                          /**
                                           * @dev Getter for the amount of shares held by an account.
                                           */
                                          function shares(address account) public view returns (uint256) {
                                              return _shares[account];
                                          }
                                          /**
                                           * @dev Getter for the amount of Ether already released to a payee.
                                           */
                                          function released(address account) public view returns (uint256) {
                                              return _released[account];
                                          }
                                          /**
                                           * @dev Getter for the address of the payee number `index`.
                                           */
                                          function payee(uint256 index) public view returns (address) {
                                              return _payees[index];
                                          }
                                          /**
                                           * @dev Triggers a transfer to `account` of the amount of Ether they are owed, according to their percentage of the
                                           * total shares and their previous withdrawals.
                                           */
                                          function release(address payable account) public virtual {
                                              require(_shares[account] > 0, "PaymentSplitter: account has no shares");
                                              uint256 totalReceived = address(this).balance.add(_totalReleased);
                                              uint256 payment = totalReceived.mul(_shares[account]).div(_totalShares).sub(_released[account]);
                                              require(payment != 0, "PaymentSplitter: account is not due payment");
                                              _released[account] = _released[account].add(payment);
                                              _totalReleased = _totalReleased.add(payment);
                                              account.transfer(payment);
                                              emit PaymentReleased(account, payment);
                                          }
                                          /**
                                           * @dev Add a new payee to the contract.
                                           * @param account The address of the payee to add.
                                           * @param shares_ The number of shares owned by the payee.
                                           */
                                          function _addPayee(address account, uint256 shares_) private {
                                              require(account != address(0), "PaymentSplitter: account is the zero address");
                                              require(shares_ > 0, "PaymentSplitter: shares are 0");
                                              require(_shares[account] == 0, "PaymentSplitter: account already has shares");
                                              _payees.push(account);
                                              _shares[account] = shares_;
                                              _totalShares = _totalShares.add(shares_);
                                              emit PayeeAdded(account, shares_);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/Math.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/ReentrancyGuard.sol";
                                      import "./Defensible.sol";
                                      import "./interfaces/IMiniMe.sol";
                                      import "./interfaces/ISporeToken.sol";
                                      import "./interfaces/IRateVoteable.sol";
                                      import "./BannedContractList.sol";
                                      /*
                                          Can be paused by the owner
                                          The mushroomFactory must be set by the owner before mushrooms can be harvested (optionally), and can be modified to use new mushroom spawning logic
                                      */
                                      contract RateVote is ReentrancyGuardUpgradeSafe, Defensible {
                                          using SafeMath for uint256;
                                          /* ========== STATE VARIABLES ========== */
                                          uint256 public constant MAX_PERCENTAGE = 100;
                                          uint256 public votingEnabledTime;
                                          mapping(address => uint256) lastVoted;
                                          struct VoteEpoch {
                                              uint256 startTime;
                                              uint256 activeEpoch;
                                              uint256 increaseVoteWeight;
                                              uint256 decreaseVoteWeight;
                                          }
                                          VoteEpoch public voteEpoch;
                                          uint256 public voteDuration;
                                          IMiniMe public enokiToken;
                                          IRateVoteable public pool;
                                          BannedContractList public bannedContractList;
                                          // In percentage: mul(X).div(100)
                                          uint256 public decreaseRateMultiplier;
                                          uint256 public increaseRateMultiplier;
                                          /* ========== CONSTRUCTOR ========== */
                                          function initialize(
                                              address _pool,
                                              address _enokiToken,
                                              uint256 _voteDuration,
                                              uint256 _votingEnabledTime,
                                              address _bannedContractList
                                          ) public virtual initializer {
                                              __ReentrancyGuard_init();
                                              pool = IRateVoteable(_pool);
                                              decreaseRateMultiplier = 50;
                                              increaseRateMultiplier = 150;
                                              votingEnabledTime = _votingEnabledTime;
                                              voteDuration = _voteDuration;
                                              enokiToken = IMiniMe(_enokiToken);
                                              voteEpoch = VoteEpoch({
                                                  startTime: votingEnabledTime, 
                                                  activeEpoch: 0, 
                                                  increaseVoteWeight: 0, 
                                                  decreaseVoteWeight: 0
                                              });
                                              bannedContractList = BannedContractList(_bannedContractList);
                                          }
                                          /*
                                              Votes with a given nonce invalidate other votes with the same nonce
                                              This ensures only one rate vote can pass for a given time period
                                          */
                                          function getVoteEpoch() external view returns (VoteEpoch memory) {
                                              return voteEpoch;
                                          }
                                          /* === Actions === */
                                          /// @notice Any user can vote once in a given voting epoch, with their balance at the start of the epoch
                                          function vote(uint256 voteId) external nonReentrant defend(bannedContractList) {
                                              require(now > votingEnabledTime, "Too early");
                                              require(now <= voteEpoch.startTime.add(voteDuration), "Vote has ended");
                                              require(lastVoted[msg.sender] < voteEpoch.activeEpoch, "Already voted");
                                              uint256 userWeight = enokiToken.balanceOfAt(msg.sender, voteEpoch.startTime);
                                              if (voteId == 0) {
                                                  // Decrease rate
                                                  voteEpoch.decreaseVoteWeight = voteEpoch.decreaseVoteWeight.add(userWeight);
                                              } else if (voteId == 1) {
                                                  // Increase rate
                                                  voteEpoch.increaseVoteWeight = voteEpoch.increaseVoteWeight.add(userWeight);
                                              } else {
                                                  revert("Invalid voteId");
                                              }
                                              lastVoted[msg.sender] = voteEpoch.activeEpoch;
                                              emit Vote(msg.sender, voteEpoch.activeEpoch, userWeight, voteId);
                                          }
                                          /// @notice Once a vote has exceeded the duration, it can be resolved, implementing the decision and starting the next vote    
                                          function resolveVote() external nonReentrant defend(bannedContractList) {
                                              require(now >= voteEpoch.startTime.add(voteDuration), "Vote still active");
                                              uint256 decision = 0;
                                              if (voteEpoch.decreaseVoteWeight > voteEpoch.increaseVoteWeight) {
                                                  // Decrease wins
                                                  pool.changeRate(decreaseRateMultiplier);
                                              } else if (voteEpoch.increaseVoteWeight > voteEpoch.decreaseVoteWeight) {
                                                  // Increase wins
                                                  pool.changeRate(increaseRateMultiplier);
                                                  decision = 1;
                                              } else {
                                                  //else Tie, no rate change
                                                  decision = 2;
                                              }
                                              emit VoteResolved(voteEpoch.activeEpoch, decision);
                                              voteEpoch.activeEpoch = voteEpoch.activeEpoch.add(1);
                                              voteEpoch.decreaseVoteWeight = 0;
                                              voteEpoch.increaseVoteWeight = 0;
                                              voteEpoch.startTime = now;
                                              emit VoteStarted(voteEpoch.activeEpoch, voteEpoch.startTime, voteEpoch.startTime.add(voteDuration));
                                          }
                                          /* ===Events=== */
                                          event Vote(address indexed user, uint256 indexed epoch, uint256 weight, uint256 indexed vote);
                                          event VoteResolved(uint256 indexed epoch, uint256 indexed decision);
                                          event VoteStarted(uint256 indexed epoch, uint256 startTime, uint256 endTime);
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Standard math utilities missing in the Solidity language.
                                       */
                                      library Math {
                                          /**
                                           * @dev Returns the largest of two numbers.
                                           */
                                          function max(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a >= b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the smallest of two numbers.
                                           */
                                          function min(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a < b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the average of two numbers. The result is rounded towards
                                           * zero.
                                           */
                                          function average(uint256 a, uint256 b) internal pure returns (uint256) {
                                              // (a + b) / 2 can overflow, so we distribute
                                              return (a / 2) + (b / 2) + ((a % 2 + b % 2) / 2);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/Math.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/ReentrancyGuard.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/Pausable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "./Defensible.sol";
                                      import "./interfaces/IMushroomFactory.sol";
                                      import "./interfaces/IMission.sol";
                                      import "./interfaces/IMiniMe.sol";
                                      import "./interfaces/ISporeToken.sol";
                                      import "./BannedContractList.sol";
                                      /*
                                          Staking can be paused by the owner (withdrawing & harvesting cannot be paused)
                                          
                                          The mushroomFactory must be set by the owner before mushrooms can be harvested (optionally)
                                          It and can be modified, to use new mushroom spawning logic
                                          The rateVote contract has control over the spore emission rate. 
                                          It can be modified, to change the voting logic around rate changes.
                                      */
                                      contract SporePool is OwnableUpgradeSafe, ReentrancyGuardUpgradeSafe, PausableUpgradeSafe, Defensible {
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          /* ========== STATE VARIABLES ========== */
                                          ISporeToken public sporeToken;
                                          IERC20 public stakingToken;
                                          uint256 public sporesPerSecond = 0;
                                          uint256 public lastUpdateTime;
                                          uint256 public rewardPerTokenStored;
                                          uint256 public constant MAX_PERCENTAGE = 100;
                                          uint256 public devRewardPercentage;
                                          address public devRewardAddress;
                                          mapping(address => uint256) public userRewardPerTokenPaid;
                                          mapping(address => uint256) public rewards;
                                          uint256 internal _totalSupply;
                                          mapping(address => uint256) internal _balances;
                                          IMushroomFactory public mushroomFactory;
                                          IMission public mission;
                                          BannedContractList public bannedContractList;
                                          uint256 public stakingEnabledTime;
                                          address public rateVote;
                                          IMiniMe public enokiToken;
                                          address public enokiDaoAgent;
                                          
                                          /* ========== CONSTRUCTOR ========== */
                                          function initialize(
                                              address _sporeToken,
                                              address _stakingToken,
                                              address _mission,
                                              address _bannedContractList,
                                              address _devRewardAddress,
                                              address _enokiDaoAgent,
                                              uint256[3] memory uintParams
                                          ) public virtual initializer {
                                              __Context_init_unchained();
                                              __Pausable_init_unchained();
                                              __ReentrancyGuard_init_unchained();
                                              __Ownable_init_unchained();
                                              sporeToken = ISporeToken(_sporeToken);
                                              stakingToken = IERC20(_stakingToken);
                                              mission = IMission(_mission);
                                              bannedContractList = BannedContractList(_bannedContractList);
                                              /*
                                                  [0] uint256 _devRewardPercentage,
                                                  [1] uint256 stakingEnabledTime_,
                                                  [2] uint256 initialRewardRate_,
                                              */
                                              devRewardPercentage = uintParams[0];
                                              devRewardAddress = _devRewardAddress;
                                              stakingEnabledTime = uintParams[1];
                                              sporesPerSecond = uintParams[2];
                                              enokiDaoAgent = _enokiDaoAgent;
                                              emit SporeRateChange(sporesPerSecond);
                                          }
                                          /* ========== VIEWS ========== */
                                          function totalSupply() external view returns (uint256) {
                                              return _totalSupply;
                                          }
                                          function balanceOf(address account) external view returns (uint256) {
                                              return _balances[account];
                                          }
                                          // Rewards are turned off at the mission level
                                          function lastTimeRewardApplicable() public view returns (uint256) {
                                              return block.timestamp;
                                          }
                                          function rewardPerToken() public view returns (uint256) {
                                              if (_totalSupply == 0) {
                                                  return rewardPerTokenStored;
                                              }
                                              // Time difference * sporesPerSecond
                                              return rewardPerTokenStored.add(lastTimeRewardApplicable().sub(lastUpdateTime).mul(sporesPerSecond).mul(1e18).div(_totalSupply));
                                          }
                                          function earned(address account) public view returns (uint256) {
                                              return _balances[account].mul(rewardPerToken().sub(userRewardPerTokenPaid[account])).div(1e18).add(rewards[account]);
                                          }
                                          /* ========== MUTATIVE FUNCTIONS ========== */
                                          function stake(uint256 amount) external virtual nonReentrant defend(bannedContractList) whenNotPaused updateReward(msg.sender) {
                                              require(amount > 0, "Cannot stake 0");
                                              require(now > stakingEnabledTime, "Cannot stake before staking enabled");
                                              _totalSupply = _totalSupply.add(amount);
                                              _balances[msg.sender] = _balances[msg.sender].add(amount);
                                              stakingToken.safeTransferFrom(msg.sender, address(this), amount);
                                              emit Staked(msg.sender, amount);
                                          }
                                          // Withdrawing does not harvest, the rewards must be harvested separately
                                          function withdraw(uint256 amount) public virtual updateReward(msg.sender) {
                                              require(amount > 0, "Cannot withdraw 0");
                                              _totalSupply = _totalSupply.sub(amount);
                                              _balances[msg.sender] = _balances[msg.sender].sub(amount);
                                              stakingToken.safeTransfer(msg.sender, amount);
                                              emit Withdrawn(msg.sender, amount);
                                          }
                                          function harvest(uint256 mushroomsToGrow)
                                              public
                                              nonReentrant
                                              updateReward(msg.sender)
                                              returns (
                                                  uint256 toDev,
                                                  uint256 toDao,
                                                  uint256 remainingReward
                                              )
                                          {
                                              uint256 reward = rewards[msg.sender];
                                              if (reward > 0) {
                                                  remainingReward = reward;
                                                  toDev = 0;
                                                  toDao = 0;
                                                  rewards[msg.sender] = 0;
                                                  // Burn some rewards for mushrooms if desired
                                                  if (mushroomsToGrow > 0) {
                                                      uint256 totalCost = mushroomFactory.costPerMushroom().mul(mushroomsToGrow);
                                                      require(reward >= totalCost, "Not enough rewards to grow the number of mushrooms specified");
                                                      toDev = totalCost.mul(devRewardPercentage).div(MAX_PERCENTAGE);
                                                      if (toDev > 0) {
                                                          mission.sendSpores(devRewardAddress, toDev);
                                                          emit DevRewardPaid(devRewardAddress, toDev);
                                                      }
                                                      toDao = totalCost.sub(toDev);
                                                      mission.sendSpores(enokiDaoAgent, toDao);
                                                      emit DaoRewardPaid(enokiDaoAgent, toDao);
                                                      remainingReward = reward.sub(totalCost);
                                                      mushroomFactory.growMushrooms(msg.sender, mushroomsToGrow);
                                                      emit MushroomsGrown(msg.sender, mushroomsToGrow);
                                                  }
                                                  if (remainingReward > 0) {
                                                      mission.sendSpores(msg.sender, remainingReward);
                                                      emit RewardPaid(msg.sender, remainingReward);
                                                  }
                                              }
                                          }
                                          // Withdraw, forfietting all rewards
                                          function emergencyWithdraw() external nonReentrant {
                                              withdraw(_balances[msg.sender]);
                                          }
                                          /* ========== RESTRICTED FUNCTIONS ========== */
                                          // Added to support recovering LP Rewards from other systems such as BAL to be distributed to holders
                                          function recoverERC20(address tokenAddress, uint256 tokenAmount) external onlyOwner {
                                              // Cannot recover the staking token or the rewards token
                                              require(tokenAddress != address(stakingToken) && tokenAddress != address(sporeToken), "Cannot withdraw the staking or rewards tokens");
                                              //TODO: Add safeTransfer
                                              IERC20(tokenAddress).transfer(owner(), tokenAmount);
                                              emit Recovered(tokenAddress, tokenAmount);
                                          }
                                          function setMushroomFactory(address mushroomFactory_) external onlyOwner {
                                              mushroomFactory = IMushroomFactory(mushroomFactory_);
                                          }
                                          function pauseStaking() external onlyOwner {
                                              _pause();
                                          }
                                          function unpauseStaking() external onlyOwner {
                                              _unpause();
                                          }
                                          function setRateVote(address _rateVote) external onlyOwner {
                                              rateVote = _rateVote;
                                          }
                                          function changeRate(uint256 percentage) external onlyRateVote {
                                              sporesPerSecond = sporesPerSecond.mul(percentage).div(MAX_PERCENTAGE);
                                              emit SporeRateChange(sporesPerSecond);
                                          }
                                          /* ========== MODIFIERS ========== */
                                          modifier updateReward(address account) {
                                              rewardPerTokenStored = rewardPerToken();
                                              lastUpdateTime = lastTimeRewardApplicable();
                                              if (account != address(0)) {
                                                  rewards[account] = earned(account);
                                                  userRewardPerTokenPaid[account] = rewardPerTokenStored;
                                              }
                                              _;
                                          }
                                          modifier onlyRateVote() {
                                              require(msg.sender == rateVote, "onlyRateVote");
                                              _;
                                          }
                                          /* ========== EVENTS ========== */
                                          event RewardAdded(uint256 reward);
                                          event Staked(address indexed user, uint256 amount);
                                          event Withdrawn(address indexed user, uint256 amount);
                                          event RewardPaid(address indexed user, uint256 reward);
                                          event DevRewardPaid(address indexed user, uint256 reward);
                                          event DaoRewardPaid(address indexed user, uint256 reward);
                                          event MushroomsGrown(address indexed user, uint256 number);
                                          event Recovered(address token, uint256 amount);
                                          event SporeRateChange(uint256 newRate);
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../GSN/Context.sol";
                                      import "../Initializable.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.
                                       */
                                      contract PausableUpgradeSafe is Initializable, ContextUpgradeSafe {
                                          /**
                                           * @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.
                                           */
                                          function __Pausable_init() internal initializer {
                                              __Context_init_unchained();
                                              __Pausable_init_unchained();
                                          }
                                          function __Pausable_init_unchained() internal initializer {
                                              _paused = false;
                                          }
                                          /**
                                           * @dev Returns true if the contract is paused, and false otherwise.
                                           */
                                          function paused() public view returns (bool) {
                                              return _paused;
                                          }
                                          /**
                                           * @dev Modifier to make a function callable only when the contract is not paused.
                                           */
                                          modifier whenNotPaused() {
                                              require(!_paused, "Pausable: paused");
                                              _;
                                          }
                                          /**
                                           * @dev Modifier to make a function callable only when the contract is paused.
                                           */
                                          modifier whenPaused() {
                                              require(_paused, "Pausable: not paused");
                                              _;
                                          }
                                          /**
                                           * @dev Triggers stopped state.
                                           */
                                          function _pause() internal virtual whenNotPaused {
                                              _paused = true;
                                              emit Paused(_msgSender());
                                          }
                                          /**
                                           * @dev Returns to normal state.
                                           */
                                          function _unpause() internal virtual whenPaused {
                                              _paused = false;
                                              emit Unpaused(_msgSender());
                                          }
                                          uint256[49] private __gap;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "./SporePool.sol";
                                      /*
                                          ETH Variant of SporePool
                                      */
                                      contract SporePoolEth is SporePool {
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          /* ========== CONSTRUCTOR ========== */
                                          function initialize(
                                              address _sporeToken,
                                              address _stakingToken,
                                              address _mission,
                                              address _bannedContractList,
                                              address _devRewardAddress,
                                              address _enokiDaoAgent,
                                              uint256[3] memory uintParams
                                          ) public override initializer {
                                              __Context_init_unchained();
                                              __Pausable_init_unchained();
                                              __ReentrancyGuard_init_unchained();
                                              __Ownable_init_unchained();
                                              sporeToken = ISporeToken(_sporeToken);
                                              mission = IMission(_mission);
                                              bannedContractList = BannedContractList(_bannedContractList);
                                              /*
                                                  [0] uint256 _devRewardPercentage,
                                                  [1] uint256 stakingEnabledTime_,
                                                  [2] uint256 initialRewardRate_,
                                              */
                                              devRewardPercentage = uintParams[0];
                                              devRewardAddress = _devRewardAddress;
                                              stakingEnabledTime = uintParams[1];
                                              sporesPerSecond = uintParams[2];
                                              enokiDaoAgent = _enokiDaoAgent;
                                              emit SporeRateChange(sporesPerSecond);
                                          }
                                          /* ========== MUTATIVE FUNCTIONS ========== */
                                          function stake(uint256 amount) external override nonReentrant defend(bannedContractList) whenNotPaused updateReward(msg.sender) {
                                              revert("Use stakeEth function for ETH variant");
                                          }
                                          function stakeEth(uint256 amount) external payable nonReentrant defend(bannedContractList) whenNotPaused updateReward(msg.sender) {
                                              require(amount > 0, "Cannot stake 0");
                                              require(msg.value == amount, "Incorrect ETH transfer amount");
                                              require(now > stakingEnabledTime, "Cannot stake before staking enabled");
                                              _totalSupply = _totalSupply.add(amount);
                                              _balances[msg.sender] = _balances[msg.sender].add(amount);
                                              emit Staked(msg.sender, amount);
                                          }
                                          function withdraw(uint256 amount) public override updateReward(msg.sender) {
                                              require(amount > 0, "Cannot withdraw 0");
                                              _totalSupply = _totalSupply.sub(amount);
                                              _balances[msg.sender] = _balances[msg.sender].sub(amount);
                                              msg.sender.transfer(amount);
                                              emit Withdrawn(msg.sender, amount);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts/math/Math.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
                                      import "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
                                      import "./SporeToken.sol";
                                      contract SporePresale is Ownable {
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          mapping(address => bool) public whitelist;
                                          mapping(address => uint256) public ethSupply;
                                          uint256 public whitelistCount;
                                          address payable devAddress;
                                          uint256 public sporePrice = 25;
                                          uint256 public buyLimit = 3 * 1e18;
                                          bool public presaleStart = false;
                                          bool public onlyWhitelist = true;
                                          uint256 public presaleLastSupply = 15000 * 1e18;
                                          SporeToken public spore;
                                          event BuySporeSuccess(address account, uint256 ethAmount, uint256 sporeAmount);
                                          constructor(address payable devAddress_, SporeToken sporeToken_) public {
                                              devAddress = devAddress_;
                                              spore = sporeToken_;
                                          }
                                          function addToWhitelist(address[] memory accounts) public onlyOwner {
                                              for (uint256 i = 0; i < accounts.length; i++) {
                                                  address account = accounts[i];
                                                  require(whitelist[account] == false, "This account is already in whitelist.");
                                                  whitelist[account] = true;
                                                  whitelistCount = whitelistCount + 1;
                                              }
                                          }
                                          function removeFromWhitelist(address[] memory accounts) public onlyOwner {
                                              for (uint256 i = 0; i < accounts.length; i++) {
                                                  address account = accounts[i];
                                                  require(whitelist[account], "This account is not in whitelist.");
                                                  whitelist[account] = false;
                                                  whitelistCount = whitelistCount - 1;
                                              }
                                          }
                                          function getDevAddress() public view returns (address) {
                                              return address(devAddress);
                                          }
                                          function setDevAddress(address payable account) public onlyOwner {
                                              devAddress = account;
                                          }
                                          function startPresale() public onlyOwner {
                                              presaleStart = true;
                                          }
                                          function stopPresale() public onlyOwner {
                                              presaleStart = false;
                                          }
                                          function setSporePrice(uint256 newPrice) public onlyOwner {
                                              sporePrice = newPrice;
                                          }
                                          function setBuyLimit(uint256 newLimit) public onlyOwner {
                                              buyLimit = newLimit;
                                          }
                                          function changeToNotOnlyWhitelist() public onlyOwner {
                                              onlyWhitelist = false;
                                          }
                                          modifier needHaveLastSupply() {
                                              require(presaleLastSupply >= 0, "Oh you are so late.");
                                              _;
                                          }
                                          modifier presaleHasStarted() {
                                              require(presaleStart, "Presale has not been started.");
                                              _;
                                          }
                                          receive() external payable presaleHasStarted needHaveLastSupply {
                                              if (onlyWhitelist) {
                                                  require(whitelist[msg.sender], "This time is only for people who are in whitelist.");
                                              }
                                              uint256 ethTotalAmount = ethSupply[msg.sender].add(msg.value);
                                              require(ethTotalAmount <= buyLimit, "Everyone should buy less than 3 eth.");
                                              uint256 sporeAmount = msg.value.mul(sporePrice);
                                              require(sporeAmount <= presaleLastSupply, "insufficient presale supply");
                                              presaleLastSupply = presaleLastSupply.sub(sporeAmount);
                                              spore.mint(msg.sender, sporeAmount);
                                              ethSupply[msg.sender] = ethTotalAmount;
                                              devAddress.transfer(msg.value);
                                              emit BuySporeSuccess(msg.sender, msg.value, sporeAmount);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Standard math utilities missing in the Solidity language.
                                       */
                                      library Math {
                                          /**
                                           * @dev Returns the largest of two numbers.
                                           */
                                          function max(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a >= b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the smallest of two numbers.
                                           */
                                          function min(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a < b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the average of two numbers. The result is rounded towards
                                           * zero.
                                           */
                                          function average(uint256 a, uint256 b) internal pure returns (uint256) {
                                              // (a + b) / 2 can overflow, so we distribute
                                              return (a / 2) + (b / 2) + ((a % 2 + b % 2) / 2);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "../../GSN/Context.sol";
                                      import "./IERC20.sol";
                                      import "../../math/SafeMath.sol";
                                      import "../../utils/Address.sol";
                                      /**
                                       * @dev Implementation of the {IERC20} interface.
                                       *
                                       * This implementation is agnostic to the way tokens are created. This means
                                       * that a supply mechanism has to be added in a derived contract using {_mint}.
                                       * For a generic mechanism see {ERC20PresetMinterPauser}.
                                       *
                                       * TIP: For a detailed writeup see our guide
                                       * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How
                                       * to implement supply mechanisms].
                                       *
                                       * We have followed general OpenZeppelin guidelines: functions revert instead
                                       * of returning `false` on failure. This behavior is nonetheless conventional
                                       * and does not conflict with the expectations of ERC20 applications.
                                       *
                                       * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
                                       * This allows applications to reconstruct the allowance for all accounts just
                                       * by listening to said events. Other implementations of the EIP may not emit
                                       * these events, as it isn't required by the specification.
                                       *
                                       * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
                                       * functions have been added to mitigate the well-known issues around setting
                                       * allowances. See {IERC20-approve}.
                                       */
                                      contract ERC20 is Context, IERC20 {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          mapping (address => uint256) private _balances;
                                          mapping (address => mapping (address => uint256)) private _allowances;
                                          uint256 private _totalSupply;
                                          string private _name;
                                          string private _symbol;
                                          uint8 private _decimals;
                                          /**
                                           * @dev Sets the values for {name} and {symbol}, initializes {decimals} with
                                           * a default value of 18.
                                           *
                                           * To select a different value for {decimals}, use {_setupDecimals}.
                                           *
                                           * All three of these values are immutable: they can only be set once during
                                           * construction.
                                           */
                                          constructor (string memory name, string memory symbol) public {
                                              _name = name;
                                              _symbol = symbol;
                                              _decimals = 18;
                                          }
                                          /**
                                           * @dev Returns the name of the token.
                                           */
                                          function name() public view returns (string memory) {
                                              return _name;
                                          }
                                          /**
                                           * @dev Returns the symbol of the token, usually a shorter version of the
                                           * name.
                                           */
                                          function symbol() public view returns (string memory) {
                                              return _symbol;
                                          }
                                          /**
                                           * @dev Returns the number of decimals used to get its user representation.
                                           * For example, if `decimals` equals `2`, a balance of `505` tokens should
                                           * be displayed to a user as `5,05` (`505 / 10 ** 2`).
                                           *
                                           * Tokens usually opt for a value of 18, imitating the relationship between
                                           * Ether and Wei. This is the value {ERC20} uses, unless {_setupDecimals} is
                                           * called.
                                           *
                                           * NOTE: This information is only used for _display_ purposes: it in
                                           * no way affects any of the arithmetic of the contract, including
                                           * {IERC20-balanceOf} and {IERC20-transfer}.
                                           */
                                          function decimals() public view returns (uint8) {
                                              return _decimals;
                                          }
                                          /**
                                           * @dev See {IERC20-totalSupply}.
                                           */
                                          function totalSupply() public view override returns (uint256) {
                                              return _totalSupply;
                                          }
                                          /**
                                           * @dev See {IERC20-balanceOf}.
                                           */
                                          function balanceOf(address account) public view override returns (uint256) {
                                              return _balances[account];
                                          }
                                          /**
                                           * @dev See {IERC20-transfer}.
                                           *
                                           * Requirements:
                                           *
                                           * - `recipient` cannot be the zero address.
                                           * - the caller must have a balance of at least `amount`.
                                           */
                                          function transfer(address recipient, uint256 amount) public virtual override returns (bool) {
                                              _transfer(_msgSender(), recipient, amount);
                                              return true;
                                          }
                                          /**
                                           * @dev See {IERC20-allowance}.
                                           */
                                          function allowance(address owner, address spender) public view virtual override returns (uint256) {
                                              return _allowances[owner][spender];
                                          }
                                          /**
                                           * @dev See {IERC20-approve}.
                                           *
                                           * Requirements:
                                           *
                                           * - `spender` cannot be the zero address.
                                           */
                                          function approve(address spender, uint256 amount) public virtual override returns (bool) {
                                              _approve(_msgSender(), spender, amount);
                                              return true;
                                          }
                                          /**
                                           * @dev See {IERC20-transferFrom}.
                                           *
                                           * Emits an {Approval} event indicating the updated allowance. This is not
                                           * required by the EIP. See the note at the beginning of {ERC20};
                                           *
                                           * Requirements:
                                           * - `sender` and `recipient` cannot be the zero address.
                                           * - `sender` must have a balance of at least `amount`.
                                           * - the caller must have allowance for ``sender``'s tokens of at least
                                           * `amount`.
                                           */
                                          function transferFrom(address sender, address recipient, uint256 amount) public virtual override returns (bool) {
                                              _transfer(sender, recipient, amount);
                                              _approve(sender, _msgSender(), _allowances[sender][_msgSender()].sub(amount, "ERC20: transfer amount exceeds allowance"));
                                              return true;
                                          }
                                          /**
                                           * @dev Atomically increases the allowance granted to `spender` by the caller.
                                           *
                                           * This is an alternative to {approve} that can be used as a mitigation for
                                           * problems described in {IERC20-approve}.
                                           *
                                           * Emits an {Approval} event indicating the updated allowance.
                                           *
                                           * Requirements:
                                           *
                                           * - `spender` cannot be the zero address.
                                           */
                                          function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
                                              _approve(_msgSender(), spender, _allowances[_msgSender()][spender].add(addedValue));
                                              return true;
                                          }
                                          /**
                                           * @dev Atomically decreases the allowance granted to `spender` by the caller.
                                           *
                                           * This is an alternative to {approve} that can be used as a mitigation for
                                           * problems described in {IERC20-approve}.
                                           *
                                           * Emits an {Approval} event indicating the updated allowance.
                                           *
                                           * Requirements:
                                           *
                                           * - `spender` cannot be the zero address.
                                           * - `spender` must have allowance for the caller of at least
                                           * `subtractedValue`.
                                           */
                                          function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
                                              _approve(_msgSender(), spender, _allowances[_msgSender()][spender].sub(subtractedValue, "ERC20: decreased allowance below zero"));
                                              return true;
                                          }
                                          /**
                                           * @dev Moves tokens `amount` from `sender` to `recipient`.
                                           *
                                           * This is internal function is equivalent to {transfer}, and can be used to
                                           * e.g. implement automatic token fees, slashing mechanisms, etc.
                                           *
                                           * Emits a {Transfer} event.
                                           *
                                           * Requirements:
                                           *
                                           * - `sender` cannot be the zero address.
                                           * - `recipient` cannot be the zero address.
                                           * - `sender` must have a balance of at least `amount`.
                                           */
                                          function _transfer(address sender, address recipient, uint256 amount) internal virtual {
                                              require(sender != address(0), "ERC20: transfer from the zero address");
                                              require(recipient != address(0), "ERC20: transfer to the zero address");
                                              _beforeTokenTransfer(sender, recipient, amount);
                                              _balances[sender] = _balances[sender].sub(amount, "ERC20: transfer amount exceeds balance");
                                              _balances[recipient] = _balances[recipient].add(amount);
                                              emit Transfer(sender, recipient, amount);
                                          }
                                          /** @dev Creates `amount` tokens and assigns them to `account`, increasing
                                           * the total supply.
                                           *
                                           * Emits a {Transfer} event with `from` set to the zero address.
                                           *
                                           * Requirements
                                           *
                                           * - `to` cannot be the zero address.
                                           */
                                          function _mint(address account, uint256 amount) internal virtual {
                                              require(account != address(0), "ERC20: mint to the zero address");
                                              _beforeTokenTransfer(address(0), account, amount);
                                              _totalSupply = _totalSupply.add(amount);
                                              _balances[account] = _balances[account].add(amount);
                                              emit Transfer(address(0), account, amount);
                                          }
                                          /**
                                           * @dev Destroys `amount` tokens from `account`, reducing the
                                           * total supply.
                                           *
                                           * Emits a {Transfer} event with `to` set to the zero address.
                                           *
                                           * Requirements
                                           *
                                           * - `account` cannot be the zero address.
                                           * - `account` must have at least `amount` tokens.
                                           */
                                          function _burn(address account, uint256 amount) internal virtual {
                                              require(account != address(0), "ERC20: burn from the zero address");
                                              _beforeTokenTransfer(account, address(0), amount);
                                              _balances[account] = _balances[account].sub(amount, "ERC20: burn amount exceeds balance");
                                              _totalSupply = _totalSupply.sub(amount);
                                              emit Transfer(account, address(0), amount);
                                          }
                                          /**
                                           * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.
                                           *
                                           * This 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 Sets {decimals} to a value other than the default one of 18.
                                           *
                                           * WARNING: This function should only be called from the constructor. Most
                                           * applications that interact with token contracts will not expect
                                           * {decimals} to ever change, and may work incorrectly if it does.
                                           */
                                          function _setupDecimals(uint8 decimals_) internal {
                                              _decimals = decimals_;
                                          }
                                          /**
                                           * @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 to 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 { }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.2;
                                      /**
                                       * @dev Collection of functions related to the address type
                                       */
                                      library Address {
                                          /**
                                           * @dev Returns true if `account` is a contract.
                                           *
                                           * [IMPORTANT]
                                           * ====
                                           * It is unsafe to assume that an address for which this function returns
                                           * false is an externally-owned account (EOA) and not a contract.
                                           *
                                           * Among others, `isContract` will return false for the following
                                           * types of addresses:
                                           *
                                           *  - an externally-owned account
                                           *  - a contract in construction
                                           *  - an address where a contract will be created
                                           *  - an address where a contract lived, but was destroyed
                                           * ====
                                           */
                                          function isContract(address account) internal view returns (bool) {
                                              // This method relies in extcodesize, which returns 0 for contracts in
                                              // construction, since the code is only stored at the end of the
                                              // constructor execution.
                                              uint256 size;
                                              // solhint-disable-next-line no-inline-assembly
                                              assembly { size := extcodesize(account) }
                                              return size > 0;
                                          }
                                          /**
                                           * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                                           * `recipient`, forwarding all available gas and reverting on errors.
                                           *
                                           * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                                           * of certain opcodes, possibly making contracts go over the 2300 gas limit
                                           * imposed by `transfer`, making them unable to receive funds via
                                           * `transfer`. {sendValue} removes this limitation.
                                           *
                                           * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                                           *
                                           * IMPORTANT: because control is transferred to `recipient`, care must be
                                           * taken to not create reentrancy vulnerabilities. Consider using
                                           * {ReentrancyGuard} or the
                                           * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                                           */
                                          function sendValue(address payable recipient, uint256 amount) internal {
                                              require(address(this).balance >= amount, "Address: insufficient balance");
                                              // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                                              (bool success, ) = recipient.call{ value: amount }("");
                                              require(success, "Address: unable to send value, recipient may have reverted");
                                          }
                                          /**
                                           * @dev Performs a Solidity function call using a low level `call`. A
                                           * plain`call` is an unsafe replacement for a function call: use this
                                           * function instead.
                                           *
                                           * If `target` reverts with a revert reason, it is bubbled up by this
                                           * function (like regular Solidity function calls).
                                           *
                                           * Returns the raw returned data. To convert to the expected return value,
                                           * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                                           *
                                           * Requirements:
                                           *
                                           * - `target` must be a contract.
                                           * - calling `target` with `data` must not revert.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                                            return functionCall(target, data, "Address: low-level call failed");
                                          }
                                          /**
                                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                                           * `errorMessage` as a fallback revert reason when `target` reverts.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                                              return _functionCallWithValue(target, data, 0, errorMessage);
                                          }
                                          /**
                                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                                           * but also transferring `value` wei to `target`.
                                           *
                                           * Requirements:
                                           *
                                           * - the calling contract must have an ETH balance of at least `value`.
                                           * - the called Solidity function must be `payable`.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                                              return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                                          }
                                          /**
                                           * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                                           * with `errorMessage` as a fallback revert reason when `target` reverts.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
                                              require(address(this).balance >= value, "Address: insufficient balance for call");
                                              return _functionCallWithValue(target, data, value, errorMessage);
                                          }
                                          function _functionCallWithValue(address target, bytes memory data, uint256 weiValue, string memory errorMessage) private returns (bytes memory) {
                                              require(isContract(target), "Address: call to non-contract");
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, bytes memory returndata) = target.call{ value: weiValue }(data);
                                              if (success) {
                                                  return returndata;
                                              } else {
                                                  // Look for revert reason and bubble it up if present
                                                  if (returndata.length > 0) {
                                                      // The easiest way to bubble the revert reason is using memory via assembly
                                                      // solhint-disable-next-line no-inline-assembly
                                                      assembly {
                                                          let returndata_size := mload(returndata)
                                                          revert(add(32, returndata), returndata_size)
                                                      }
                                                  } else {
                                                      revert(errorMessage);
                                                  }
                                              }
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "./IERC20.sol";
                                      import "../../math/SafeMath.sol";
                                      import "../../utils/Address.sol";
                                      /**
                                       * @title SafeERC20
                                       * @dev Wrappers around ERC20 operations that throw on failure (when the token
                                       * contract returns false). Tokens that return no value (and instead revert or
                                       * throw on failure) are also supported, non-reverting calls are assumed to be
                                       * successful.
                                       * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
                                       * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
                                       */
                                      library SafeERC20 {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          function safeTransfer(IERC20 token, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
                                          }
                                          function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
                                          }
                                          /**
                                           * @dev Deprecated. This function has issues similar to the ones found in
                                           * {IERC20-approve}, and its usage is discouraged.
                                           *
                                           * Whenever possible, use {safeIncreaseAllowance} and
                                           * {safeDecreaseAllowance} instead.
                                           */
                                          function safeApprove(IERC20 token, address spender, uint256 value) internal {
                                              // safeApprove should only be called when setting an initial allowance,
                                              // or when resetting it to zero. To increase and decrease it, use
                                              // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                                              // solhint-disable-next-line max-line-length
                                              require((value == 0) || (token.allowance(address(this), spender) == 0),
                                                  "SafeERC20: approve from non-zero to non-zero allowance"
                                              );
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
                                          }
                                          function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).add(value);
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          /**
                                           * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                                           * on the return value: the return value is optional (but if data is returned, it must not be false).
                                           * @param token The token targeted by the call.
                                           * @param data The call data (encoded using abi.encode or one of its variants).
                                           */
                                          function _callOptionalReturn(IERC20 token, bytes memory data) private {
                                              // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                                              // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
                                              // the target address contains contract code and also asserts for success in the low-level call.
                                              bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
                                              if (returndata.length > 0) { // Return data is optional
                                                  // solhint-disable-next-line max-line-length
                                                  require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                                              }
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
                                      import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      contract SporeToken is ERC20("SporeFinance", "SPORE"), Ownable {
                                          using SafeMath for uint256;
                                          /* ========== STATE VARIABLES ========== */
                                          mapping(address => bool) public minters;
                                          address public initialLiquidityManager;
                                          bool internal _transfersEnabled;
                                          mapping(address => bool) internal _canTransferInitialLiquidity;
                                          /* ========== CONSTRUCTOR ========== */
                                          constructor(address initialLiquidityManager_) public {
                                              _transfersEnabled = false;
                                              minters[msg.sender] = true;
                                              initialLiquidityManager = initialLiquidityManager_;
                                              _canTransferInitialLiquidity[msg.sender] = true;
                                          }
                                          /* ========== MUTATIVE FUNCTIONS ========== */
                                          /// @notice Transfer is enabled as normal except during an initial phase
                                          function transfer(address recipient, uint256 amount) public override returns (bool) {
                                              require(_transfersEnabled || _canTransferInitialLiquidity[msg.sender], "SporeToken: transfers not enabled");
                                              return super.transfer(recipient, amount);
                                          }
                                          /// @notice TransferFrom is enabled as normal except during an initial phase
                                          function transferFrom(
                                              address sender,
                                              address recipient,
                                              uint256 amount
                                          ) public override returns (bool) {
                                              require(_transfersEnabled || _canTransferInitialLiquidity[msg.sender], "SporeToken: transfers not enabled");
                                              return super.transferFrom(sender, recipient, amount);
                                          }
                                          /// @notice Any account is entitled to burn their own tokens
                                          function burn(uint256 amount) public {
                                              require(amount > 0);
                                              require(balanceOf(msg.sender) >= amount);
                                              _burn(msg.sender, amount);
                                          }
                                          /* ========== RESTRICTED FUNCTIONS ========== */
                                          function mint(address to, uint256 amount) public onlyMinter {
                                              _mint(to, amount);
                                          }
                                          function addInitialLiquidityTransferRights(address account) public onlyInitialLiquidityManager {
                                              require(!_transfersEnabled, "SporeToken: cannot add initial liquidity transfer rights after global transfers enabled");
                                              _canTransferInitialLiquidity[account] = true;
                                          }
                                          /// @notice One time acion to enable global transfers after the initial liquidity is supplied.
                                          function enableTransfers() public onlyInitialLiquidityManager {
                                              _transfersEnabled = true;
                                          }
                                          function addMinter(address account) public onlyOwner {
                                              minters[account] = true;
                                          }
                                          function removeMinter(address account) public onlyOwner {
                                              minters[account] = false;
                                          }
                                          modifier onlyMinter() {
                                              require(minters[msg.sender], "Restricted to minters.");
                                              _;
                                          }
                                          modifier onlyInitialLiquidityManager() {
                                              require(initialLiquidityManager == msg.sender, "Restricted to initial liquidity manager.");
                                              _;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "../MushroomNFT.sol";
                                      import "../MushroomLib.sol";
                                      /*
                                          MushroomFactories manage the mushroom generation logic for pools
                                          Each pool will have it's own factory to generate mushrooms according
                                          to its' powers.
                                          The mushroomFactory should be administered by the pool, which grants the ability to grow mushrooms
                                      */
                                      contract MushroomLifespanMock is Initializable, OwnableUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          using SafeMath for uint256;
                                          uint256 public spawnCount;
                                          event MushroomGrown(address recipient, uint256 id, uint256 species, uint256 lifespan);
                                          function generateMushroomLifespan(uint256 minLifespan, uint256 maxLifespan) public returns (uint256) {
                                              uint256 range = maxLifespan.sub(minLifespan);
                                              uint256 fromMin = uint256(keccak256(abi.encodePacked(block.timestamp.add(spawnCount)))) % range;
                                              spawnCount = spawnCount.add(1);
                                              return minLifespan.add(fromMin);
                                          }
                                          function getRemainingMintableForMySpecies(MushroomNFT mushroomNft, uint256 speciesId) public view returns (uint256) {
                                              return mushroomNft.getRemainingMintableForSpecies(speciesId);
                                          }
                                          // Each mushroom costs 1/10th of the spore rate in spores.
                                          function growMushrooms(MushroomNFT mushroomNft, uint256 speciesId, address recipient, uint256 numMushrooms) public {
                                              MushroomLib.MushroomType memory species = mushroomNft.getSpecies(speciesId);
                                              require(getRemainingMintableForMySpecies(mushroomNft, speciesId) >= numMushrooms, "MushroomFactory: Mushrooms to grow exceeds species cap");
                                              for (uint256 i = 0; i < numMushrooms; i++) {
                                                  uint256 nextId = mushroomNft.totalSupply().add(1);
                                                  uint256 lifespan = generateMushroomLifespan(species.minLifespan, species.maxLifespan);
                                                  mushroomNft.mint(recipient, nextId, speciesId, lifespan);
                                                  emit MushroomGrown(recipient, nextId, speciesId, lifespan);
                                              }
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      /**
                                       * @title TokenVesting
                                       * @dev A token holder contract that can release its token balance gradually like a
                                       * typical vesting scheme, with a cliff and vesting period. Optionally revocable by the
                                       * owner.
                                       */
                                      contract TokenVesting is Ownable {
                                          // The vesting schedule is time-based (i.e. using block timestamps as opposed to e.g. block numbers), and is
                                          // therefore sensitive to timestamp manipulation (which is something miners can do, to a certain degree). Therefore,
                                          // it is recommended to avoid using short time durations (less than a minute). Typical vesting schemes, with a
                                          // cliff period of a year and a duration of four years, are safe to use.
                                          // solhint-disable not-rely-on-time
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          event TokensReleased(address token, uint256 amount);
                                          event TokenVestingRevoked(address token);
                                          // beneficiary of tokens after they are released
                                          address private _beneficiary;
                                          // Durations and timestamps are expressed in UNIX time, the same units as block.timestamp.
                                          uint256 private _cliff;
                                          uint256 private _start;
                                          uint256 private _duration;
                                          bool private _revocable;
                                          mapping (address => uint256) private _released;
                                          mapping (address => bool) private _revoked;
                                          /**
                                           * @dev Creates a vesting contract that vests its balance of any ERC20 token to the
                                           * beneficiary, gradually in a linear fashion until start + duration. By then all
                                           * of the balance will have vested.
                                           * @param beneficiary address of the beneficiary to whom vested tokens are transferred
                                           * @param cliffDuration duration in seconds of the cliff in which tokens will begin to vest
                                           * @param start the time (as Unix time) at which point vesting starts
                                           * @param duration duration in seconds of the period in which the tokens will vest
                                           * @param revocable whether the vesting is revocable or not
                                           */
                                          constructor (address beneficiary, uint256 start, uint256 cliffDuration, uint256 duration, bool revocable) public {
                                              require(beneficiary != address(0), "TokenVesting: beneficiary is the zero address");
                                              // solhint-disable-next-line max-line-length
                                              require(cliffDuration <= duration, "TokenVesting: cliff is longer than duration");
                                              require(duration > 0, "TokenVesting: duration is 0");
                                              // solhint-disable-next-line max-line-length
                                              require(start.add(duration) > block.timestamp, "TokenVesting: final time is before current time");
                                              _beneficiary = beneficiary;
                                              _revocable = revocable;
                                              _duration = duration;
                                              _cliff = start.add(cliffDuration);
                                              _start = start;
                                          }
                                          /**
                                           * @return the beneficiary of the tokens.
                                           */
                                          function beneficiary() public view returns (address) {
                                              return _beneficiary;
                                          }
                                          /**
                                           * @return the cliff time of the token vesting.
                                           */
                                          function cliff() public view returns (uint256) {
                                              return _cliff;
                                          }
                                          /**
                                           * @return the start time of the token vesting.
                                           */
                                          function start() public view returns (uint256) {
                                              return _start;
                                          }
                                          /**
                                           * @return the duration of the token vesting.
                                           */
                                          function duration() public view returns (uint256) {
                                              return _duration;
                                          }
                                          /**
                                           * @return true if the vesting is revocable.
                                           */
                                          function revocable() public view returns (bool) {
                                              return _revocable;
                                          }
                                          /**
                                           * @return the amount of the token released.
                                           */
                                          function released(address token) public view returns (uint256) {
                                              return _released[token];
                                          }
                                          /**
                                           * @return true if the token is revoked.
                                           */
                                          function revoked(address token) public view returns (bool) {
                                              return _revoked[token];
                                          }
                                          /**
                                           * @notice Transfers vested tokens to beneficiary.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function release(IERC20 token) public {
                                              uint256 unreleased = _releasableAmount(token);
                                              require(unreleased > 0, "TokenVesting: no tokens are due");
                                              _released[address(token)] = _released[address(token)].add(unreleased);
                                              token.safeTransfer(_beneficiary, unreleased);
                                              emit TokensReleased(address(token), unreleased);
                                          }
                                          /**
                                           * @notice Allows the owner to revoke the vesting. Tokens already vested
                                           * remain in the contract, the rest are returned to the owner.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function revoke(IERC20 token) public onlyOwner {
                                              require(_revocable, "TokenVesting: cannot revoke");
                                              require(!_revoked[address(token)], "TokenVesting: token already revoked");
                                              uint256 balance = token.balanceOf(address(this));
                                              uint256 unreleased = _releasableAmount(token);
                                              uint256 refund = balance.sub(unreleased);
                                              _revoked[address(token)] = true;
                                              token.safeTransfer(owner(), refund);
                                              emit TokenVestingRevoked(address(token));
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested but hasn't been released yet.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function _releasableAmount(IERC20 token) private view returns (uint256) {
                                              return _vestedAmount(token).sub(_released[address(token)]);
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function _vestedAmount(IERC20 token) private view returns (uint256) {
                                              uint256 currentBalance = token.balanceOf(address(this));
                                              uint256 totalBalance = currentBalance.add(_released[address(token)]);
                                              if (block.timestamp < _cliff) {
                                                  return 0;
                                              } else if (block.timestamp >= _start.add(_duration) || _revoked[address(token)]) {
                                                  return totalBalance;
                                              } else {
                                                  return totalBalance.mul(block.timestamp.sub(_start)).div(_duration);
                                              }
                                          }
                                      }

                                      File 6 of 14: AdminUpgradeabilityProxy
                                      // SPDX-License-Identifier: MIT
                                      
                                      pragma solidity ^0.6.2;
                                      
                                      /**
                                       * @dev Collection of functions related to the address type
                                       */
                                      library Address {
                                          /**
                                           * @dev Returns true if `account` is a contract.
                                           *
                                           * [IMPORTANT]
                                           * ====
                                           * It is unsafe to assume that an address for which this function returns
                                           * false is an externally-owned account (EOA) and not a contract.
                                           *
                                           * Among others, `isContract` will return false for the following
                                           * types of addresses:
                                           *
                                           *  - an externally-owned account
                                           *  - a contract in construction
                                           *  - an address where a contract will be created
                                           *  - an address where a contract lived, but was destroyed
                                           * ====
                                           */
                                          function isContract(address account) internal view returns (bool) {
                                              // This method relies on extcodesize, which returns 0 for contracts in
                                              // construction, since the code is only stored at the end of the
                                              // constructor execution.
                                      
                                              uint256 size;
                                              // solhint-disable-next-line no-inline-assembly
                                              assembly { size := extcodesize(account) }
                                              return size > 0;
                                          }
                                      
                                      }
                                      /**
                                       * @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.
                                       */
                                      abstract contract Proxy {
                                        /**
                                         * @dev Fallback function.
                                         * Implemented entirely in `_fallback`.
                                         */
                                        fallback () payable external {
                                          _fallback();
                                        }
                                      
                                        /**
                                         * @dev Receive function.
                                         * Implemented entirely in `_fallback`.
                                         */
                                        receive () payable external {
                                          _fallback();
                                        }
                                      
                                        /**
                                         * @return The Address of the implementation.
                                         */
                                        function _implementation() internal virtual 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 virtual {
                                        }
                                      
                                        /**
                                         * @dev fallback implementation.
                                         * Extracted to enable manual triggering.
                                         */
                                        function _fallback() internal {
                                          _willFallback();
                                          _delegate(_implementation());
                                        }
                                      }
                                      
                                      /**
                                       * @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 Contract constructor.
                                         * @param _logic Address of the initial implementation.
                                         * @param _data Data to send as msg.data to the implementation to initialize the proxied contract.
                                         * It should include the signature and the parameters of the function to be called, as described in
                                         * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         * This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.
                                         */
                                        constructor(address _logic, bytes memory _data) public payable {
                                          assert(IMPLEMENTATION_SLOT == bytes32(uint256(keccak256('eip1967.proxy.implementation')) - 1));
                                          _setImplementation(_logic);
                                          if(_data.length > 0) {
                                            (bool success,) = _logic.delegatecall(_data);
                                            require(success);
                                          }
                                        }  
                                      
                                        /**
                                         * @dev Emitted when the implementation is upgraded.
                                         * @param implementation Address of the new implementation.
                                         */
                                        event Upgraded(address indexed implementation);
                                      
                                        /**
                                         * @dev Storage slot with the address of the current implementation.
                                         * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
                                         * validated in the constructor.
                                         */
                                        bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                                      
                                        /**
                                         * @dev Returns the current implementation.
                                         * @return impl Address of the current implementation
                                         */
                                        function _implementation() internal override 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) internal {
                                          require(Address.isContract(newImplementation), "Cannot set a proxy implementation to a non-contract address");
                                      
                                          bytes32 slot = IMPLEMENTATION_SLOT;
                                      
                                          assembly {
                                            sstore(slot, newImplementation)
                                          }
                                        }
                                      }
                                      
                                      /**
                                       * @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 {
                                        /**
                                         * Contract constructor.
                                         * @param _logic address of the initial implementation.
                                         * @param _admin Address of the proxy administrator.
                                         * @param _data Data to send as msg.data to the implementation to initialize the proxied contract.
                                         * It should include the signature and the parameters of the function to be called, as described in
                                         * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         * This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.
                                         */
                                        constructor(address _logic, address _admin, bytes memory _data) UpgradeabilityProxy(_logic, _data) public payable {
                                          assert(ADMIN_SLOT == bytes32(uint256(keccak256('eip1967.proxy.admin')) - 1));
                                          _setAdmin(_admin);
                                        }
                                      
                                        /**
                                         * @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 "eip1967.proxy.admin" subtracted by 1, and is
                                         * validated in the constructor.
                                         */
                                      
                                        bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                                      
                                        /**
                                         * @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();
                                          }
                                        }
                                      
                                        /**
                                         * @return The address of the proxy admin.
                                         */
                                        function admin() external ifAdmin returns (address) {
                                          return _admin();
                                        }
                                      
                                        /**
                                         * @return The address of the implementation.
                                         */
                                        function implementation() external 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/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         */
                                        function upgradeToAndCall(address newImplementation, bytes calldata data) payable external ifAdmin {
                                          _upgradeTo(newImplementation);
                                          (bool success,) = newImplementation.delegatecall(data);
                                          require(success);
                                        }
                                      
                                        /**
                                         * @return adm 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 override virtual {
                                          require(msg.sender != _admin(), "Cannot call fallback function from the proxy admin");
                                          super._willFallback();
                                        }
                                      }

                                      File 7 of 14: MetadataResolver
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      /*
                                          Approve and Ban Contracts to interact with pools.
                                          (All contracts are approved by default, unless banned)
                                      */
                                      contract BannedContractList is Initializable, OwnableUpgradeSafe {
                                          mapping(address => bool) banned;
                                          function initialize() public initializer {
                                              __Ownable_init();
                                          }
                                          function isApproved(address toCheck) external view returns (bool) {
                                              return !banned[toCheck];
                                          }
                                          function isBanned(address toCheck) external view returns (bool) {
                                              return banned[toCheck];
                                          }
                                          function approveContract(address toApprove) external onlyOwner {
                                              banned[toApprove] = false;
                                          }
                                          function banContract(address toBan) external onlyOwner {
                                              banned[toBan] = true;
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../GSN/Context.sol";
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Contract module which provides a basic access control mechanism, where
                                       * there is an account (an owner) that can be granted exclusive access to
                                       * specific functions.
                                       *
                                       * By default, the owner account will be the one that deploys the contract. This
                                       * can later be changed with {transferOwnership}.
                                       *
                                       * This module is used through inheritance. It will make available the modifier
                                       * `onlyOwner`, which can be applied to your functions to restrict their use to
                                       * the owner.
                                       */
                                      contract OwnableUpgradeSafe is Initializable, ContextUpgradeSafe {
                                          address private _owner;
                                          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                                          /**
                                           * @dev Initializes the contract setting the deployer as the initial owner.
                                           */
                                          function __Ownable_init() internal initializer {
                                              __Context_init_unchained();
                                              __Ownable_init_unchained();
                                          }
                                          function __Ownable_init_unchained() internal initializer {
                                              address msgSender = _msgSender();
                                              _owner = msgSender;
                                              emit OwnershipTransferred(address(0), msgSender);
                                          }
                                          /**
                                           * @dev Returns the address of the current owner.
                                           */
                                          function owner() public view returns (address) {
                                              return _owner;
                                          }
                                          /**
                                           * @dev Throws if called by any account other than the owner.
                                           */
                                          modifier onlyOwner() {
                                              require(_owner == _msgSender(), "Ownable: caller is not the owner");
                                              _;
                                          }
                                          /**
                                           * @dev Leaves the contract without owner. It will not be possible to call
                                           * `onlyOwner` functions anymore. Can only be called by the current owner.
                                           *
                                           * NOTE: Renouncing ownership will leave the contract without an owner,
                                           * thereby removing any functionality that is only available to the owner.
                                           */
                                          function renounceOwnership() public virtual onlyOwner {
                                              emit OwnershipTransferred(_owner, address(0));
                                              _owner = address(0);
                                          }
                                          /**
                                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                                           * Can only be called by the current owner.
                                           */
                                          function transferOwnership(address newOwner) public virtual onlyOwner {
                                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                                              emit OwnershipTransferred(_owner, newOwner);
                                              _owner = newOwner;
                                          }
                                          uint256[49] private __gap;
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../Initializable.sol";
                                      /*
                                       * @dev Provides information about the current execution context, including the
                                       * sender of the transaction and its data. While these are generally available
                                       * via msg.sender and msg.data, they should not be accessed in such a direct
                                       * manner, since when dealing with GSN meta-transactions the account sending and
                                       * paying for execution may not be the actual sender (as far as an application
                                       * is concerned).
                                       *
                                       * This contract is only required for intermediate, library-like contracts.
                                       */
                                      contract ContextUpgradeSafe is Initializable {
                                          // Empty internal constructor, to prevent people from mistakenly deploying
                                          // an instance of this contract, which should be used via inheritance.
                                          function __Context_init() internal initializer {
                                              __Context_init_unchained();
                                          }
                                          function __Context_init_unchained() internal initializer {
                                          }
                                          function _msgSender() internal view virtual returns (address payable) {
                                              return msg.sender;
                                          }
                                          function _msgData() internal view virtual returns (bytes memory) {
                                              this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                                              return msg.data;
                                          }
                                          uint256[50] private __gap;
                                      }
                                      pragma solidity >=0.4.24 <0.7.0;
                                      /**
                                       * @title Initializable
                                       *
                                       * @dev Helper contract to support initializer functions. To use it, replace
                                       * the constructor with a function that has the `initializer` modifier.
                                       * WARNING: Unlike constructors, initializer functions must be manually
                                       * invoked. This applies both to deploying an Initializable contract, as well
                                       * as extending an Initializable contract via inheritance.
                                       * WARNING: When used with inheritance, manual care must be taken to not invoke
                                       * a parent initializer twice, or ensure that all initializers are idempotent,
                                       * because this is not dealt with automatically as with constructors.
                                       */
                                      contract Initializable {
                                        /**
                                         * @dev Indicates that the contract has been initialized.
                                         */
                                        bool private initialized;
                                        /**
                                         * @dev Indicates that the contract is in the process of being initialized.
                                         */
                                        bool private initializing;
                                        /**
                                         * @dev Modifier to use in the initializer function of a contract.
                                         */
                                        modifier initializer() {
                                          require(initializing || isConstructor() || !initialized, "Contract instance has already been initialized");
                                          bool isTopLevelCall = !initializing;
                                          if (isTopLevelCall) {
                                            initializing = true;
                                            initialized = true;
                                          }
                                          _;
                                          if (isTopLevelCall) {
                                            initializing = false;
                                          }
                                        }
                                        /// @dev Returns true if and only if the function is running in the constructor
                                        function isConstructor() private view returns (bool) {
                                          // extcodesize checks the size of the code stored in an address, and
                                          // address returns the current address. Since the code is still not
                                          // deployed when running a constructor, any checks on its code size will
                                          // yield zero, making it an effective way to detect if a contract is
                                          // under construction or not.
                                          address self = address(this);
                                          uint256 cs;
                                          assembly { cs := extcodesize(self) }
                                          return cs == 0;
                                        }
                                        // Reserved storage space to allow for layout changes in the future.
                                        uint256[50] private ______gap;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "./BannedContractList.sol";
                                      /*
                                          Prevent smart contracts from calling functions unless approved by the specified whitelist.
                                      */
                                      contract Defensible {
                                       // Only smart contracts will be affected by this modifier
                                        modifier defend(BannedContractList bannedContractList) {
                                          require(
                                            (msg.sender == tx.origin) || bannedContractList.isApproved(msg.sender),
                                            "This smart contract has not been approved"
                                          );
                                          _;
                                        }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      /* 
                                          - Stake up to X mushrooms per user (dao can change)
                                          - Reward mushroom yield rate for lifespan
                                          - When dead, burn mushroom erc721
                                          - Distribute 5% of ENOKI rewards to Chefs
                                      */
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      // import "@openzeppelin/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/ReentrancyGuard.sol";
                                      import "./TokenPool.sol";
                                      import "./Defensible.sol";
                                      import "./MushroomNFT.sol";
                                      import "./MushroomLib.sol";
                                      import "./metadata/MetadataResolver.sol";
                                      /**
                                       * @title Enoki Geyser
                                       * @dev A smart-contract based mechanism to distribute tokens over time, inspired loosely by
                                       *      Compound and Uniswap.
                                       *
                                       *      Distribution tokens are added to a locked pool in the contract and become unlocked over time
                                       *      according to a once-configurable unlock schedule. Once unlocked, they are available to be
                                       *      claimed by users.
                                       *
                                       *      A user may deposit tokens to accrue ownership share over the unlocked pool. This owner share
                                       *      is a function of the number of tokens deposited as well as the length of time deposited.
                                       *      Specifically, a user's share of the currently-unlocked pool equals their "deposit-seconds"
                                       *      divided by the global "deposit-seconds". This aligns the new token distribution with long
                                       *      term supporters of the project, addressing one of the major drawbacks of simple airdrops.
                                       *
                                       *      More background and motivation available at:
                                       *      https://github.com/ampleforth/RFCs/blob/master/RFCs/rfc-1.md
                                       */
                                      contract EnokiGeyser is Initializable, OwnableUpgradeSafe, AccessControlUpgradeSafe, ReentrancyGuardUpgradeSafe, Defensible {
                                          using SafeMath for uint256;
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          event Staked(address indexed user, address nftContract, uint256 nftId, uint256 total, bytes data);
                                          event Unstaked(address indexed user, address nftContract, uint256 nftId, uint256 total, bytes data);
                                          event TokensClaimed(address indexed user, uint256 amount, uint256 userReward, uint256 devReward);
                                          event TokensLocked(uint256 amount, uint256 total);
                                          event TokensLockedAirdrop(address airdrop, uint256 amount, uint256 total);
                                          event LifespanUsed(address nftContract, uint256 nftIndex, uint256 lifespanUsed, uint256 lifespan);
                                          event NewLifespan(address nftContract, uint256 nftIndex, uint256 lifespan);
                                          // amount: Unlocked tokens, total: Total locked tokens
                                          event TokensUnlocked(uint256 amount, uint256 total);
                                          event MaxStakesPerAddressSet(uint256 maxStakesPerAddress);
                                          event MetadataResolverSet(address metadataResolver);
                                          event BurnedMushroom(address nftContract, uint256 nftIndex);
                                          TokenPool public _unlockedPool;
                                          TokenPool public _lockedPool;
                                          MetadataResolver public metadataResolver;
                                          //
                                          // Time-bonus params
                                          //
                                          uint256 public constant BONUS_DECIMALS = 2;
                                          uint256 public startBonus = 0;
                                          uint256 public bonusPeriodSec = 0;
                                          uint256 public maxStakesPerAddress = 0;
                                          //
                                          // Global accounting state
                                          //
                                          uint256 public totalLockedShares = 0;
                                          uint256 public totalStakingShares = 0;
                                          uint256 public totalStrengthStaked = 0;
                                          uint256 private _totalStakingShareSeconds = 0;
                                          uint256 private _lastAccountingTimestampSec = now;
                                          uint256 private _maxUnlockSchedules = 0;
                                          uint256 private _initialSharesPerToken = 0;
                                          //
                                          // Dev reward state
                                          //
                                          uint256 public constant MAX_PERCENTAGE = 100;
                                          uint256 public devRewardPercentage = 0; //0% - 100%
                                          address public devRewardAddress;
                                          address public admin;
                                          BannedContractList public bannedContractList;
                                          //
                                          // User accounting state
                                          //
                                          // Represents a single stake for a user. A user may have multiple.
                                          struct Stake {
                                              address nftContract;
                                              uint256 nftIndex;
                                              uint256 strength;
                                              uint256 stakedAt;
                                          }
                                          // Caches aggregated values from the User->Stake[] map to save computation.
                                          // If lastAccountingTimestampSec is 0, there's no entry for that user.
                                          struct UserTotals {
                                              uint256 userStrengthStaked;
                                              uint256 stakingShareSeconds;
                                              uint256 lastAccountingTimestampSec;
                                          }
                                          // Aggregated staking values per user
                                          mapping(address => UserTotals) private _userTotals;
                                          // The collection of stakes for each user. Ordered by timestamp, earliest to latest.
                                          mapping(address => Stake[]) private _userStakes;
                                          //
                                          // Locked/Unlocked Accounting state
                                          //
                                          struct UnlockSchedule {
                                              uint256 initialLockedShares;
                                              uint256 unlockedShares;
                                              uint256 lastUnlockTimestampSec;
                                              uint256 endAtSec;
                                              uint256 durationSec;
                                          }
                                          UnlockSchedule[] public unlockSchedules;
                                          bool public initializeComplete;
                                          uint256 public constant SECONDS_PER_WEEK = 604800;
                                          uint256 public usedAirdropPool;
                                          uint256 public maxAirdropPool;
                                          address internal constant INITIALIZER_ADDRESS = 0xe9673e2806305557Daa67E3207c123Af9F95F9d2;
                                          IERC20 public enokiToken;
                                          uint256 public stakingEnabledTime;
                                          /**
                                           * @param enokiToken_ The token users receive as they unstake.
                                           * @param maxStakesPerAddress_ Maximum number of NFTs stakeable by a given account.
                                           * @param devRewardAddress_ Recipient address of dev rewards.
                                           * @param devRewardPercentage_ Pecentage of rewards claimed to be distributed for dev address.
                                           */
                                          function initialize(
                                              IERC20 enokiToken_,
                                              uint256 maxStakesPerAddress_,
                                              address devRewardAddress_,
                                              uint256 devRewardPercentage_,
                                              address bannedContractList_,
                                              uint256 stakingEnabledTime_,
                                              uint256 maxAirdropPool_,
                                              address resolver_
                                          ) public {
                                              require(msg.sender == INITIALIZER_ADDRESS, "Only deployer can reinitialize");
                                              require(admin == address(0), "Admin has already been initialized");
                                              require(initializeComplete == false, "Initialization already complete");
                                              // The dev reward must be some fraction of the max. (i.e. <= 100%)
                                              require(devRewardPercentage_ <= MAX_PERCENTAGE, "EnokiGeyser: dev reward too high");
                                              enokiToken = enokiToken_;
                                              maxStakesPerAddress = maxStakesPerAddress_;
                                              emit MaxStakesPerAddressSet(maxStakesPerAddress);
                                              devRewardPercentage = devRewardPercentage_;
                                              devRewardAddress = devRewardAddress_;
                                              stakingEnabledTime = stakingEnabledTime_;
                                              maxAirdropPool = maxAirdropPool_;
                                              metadataResolver = MetadataResolver(resolver_);
                                              emit MetadataResolverSet(address(metadataResolver));
                                              _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                                              bannedContractList = BannedContractList(bannedContractList_);
                                              initializeComplete = true;
                                          }
                                          modifier onlyAdmin() {
                                              require(hasRole(DEFAULT_ADMIN_ROLE, msg.sender), "EnokiGeyser: Only Admin");
                                              _;
                                          }
                                          /* ========== ADMIN FUNCTIONALITY ========== */
                                          // Only effects future stakes
                                          function setMaxStakesPerAddress(uint256 maxStakes) public onlyAdmin {
                                              maxStakesPerAddress = maxStakes;
                                              emit MaxStakesPerAddressSet(maxStakesPerAddress);
                                          }
                                          function setMetadataResolver(address resolver_) public onlyAdmin {
                                              metadataResolver = MetadataResolver(resolver_);
                                              emit MetadataResolverSet(address(metadataResolver));
                                          }
                                          /**
                                           * @return The token users receive as they unstake.
                                           */
                                          function getDistributionToken() public view returns (IERC20) {
                                              return enokiToken;
                                          }
                                          function getNumStakes(address user) external view returns (uint256) {
                                              return _userStakes[user].length;
                                          }
                                          function getStakes(address user) external view returns (Stake[] memory) {
                                              uint256 numStakes = _userStakes[user].length;
                                              Stake[] memory stakes = new Stake[](numStakes);
                                              for (uint256 i = 0; i < _userStakes[user].length; i++) {
                                                  stakes[i] = _userStakes[user][i];
                                              }
                                              return stakes;
                                          }
                                          function getStake(address user, uint256 stakeIndex) external view returns (Stake memory stake) {
                                              Stake storage _userStake = _userStakes[user][stakeIndex];
                                              stake = _userStake;
                                          }
                                          /**
                                           * @dev Transfers amount of deposit tokens from the user.
                                           * @param data Not used.
                                           */
                                          function stake(
                                              address nftContract,
                                              uint256 nftIndex,
                                              bytes calldata data
                                          ) external defend(bannedContractList) {
                                              require(now > stakingEnabledTime, "staking-too-early");
                                              require(metadataResolver.isStakeable(nftContract, nftIndex), "EnokiGeyser: nft not stakeable");
                                              _stakeFor(msg.sender, msg.sender, nftContract, nftIndex);
                                          }
                                          // /**
                                          //  * @dev Transfers amount of deposit tokens from the user.
                                          //  * @param data Not used.
                                          //  */
                                          // function stakeBulk(
                                          //     address[] memory nftContracts,
                                          //     uint256[] memory nftIndicies,
                                          //     bytes calldata data
                                          // ) external defend(bannedContractList) {
                                          //     require(now > stakingEnabledTime, "staking-too-early");
                                          //     require(nftContracts.length == nftIndicies.length, "args length mismatch");
                                          //     for (uint256 i = 0; i < nftContracts.length; i++) {
                                          //         require(metadataResolver.isStakeable(nftContracts[i], nftIndicies[i]), "EnokiGeyser: nft not stakeable");
                                          //         _stakeFor(msg.sender, msg.sender, nftContracts[i], nftIndicies[i]);
                                          //     }
                                          // }
                                          /**
                                           * @dev Private implementation of staking methods.
                                           * @param staker User address who deposits tokens to stake.
                                           * @param beneficiary User address who gains credit for this stake operation.
                                           */
                                          function _stakeFor(
                                              address staker,
                                              address beneficiary,
                                              address nftContract,
                                              uint256 nftIndex
                                          ) private {
                                              require(beneficiary != address(0), "EnokiGeyser: beneficiary is zero address");
                                              require(metadataResolver.isStakeable(nftContract, nftIndex), "EnokiGeyser: Nft specified not stakeable");
                                              // Shares is determined by NFT mushroom rate
                                              MushroomLib.MushroomData memory metadata = metadataResolver.getMushroomData(nftContract, nftIndex, "");
                                              // 1. User Accounting
                                              UserTotals storage totals = _userTotals[beneficiary];
                                              Stake memory newStake = Stake(nftContract, nftIndex, metadata.strength, now);
                                              _userStakes[beneficiary].push(newStake);
                                              require(_userStakes[beneficiary].length <= maxStakesPerAddress, "EnokiGeyser: Stake would exceed maximum stakes for address");
                                              totals.userStrengthStaked = totals.userStrengthStaked.add(metadata.strength);
                                              totalStrengthStaked = totalStrengthStaked.add(metadata.strength);
                                              IERC721(nftContract).transferFrom(staker, address(this), nftIndex);
                                              emit Staked(beneficiary, nftContract, nftIndex, totalStakedFor(beneficiary), "");
                                          }
                                          /**
                                           * @dev Unstakes a certain amount of previously deposited tokens. User also receives their
                                           * alotted number of distribution tokens.
                                           * @param stakes Mushrooms to unstake.
                                           * @param data Not used.
                                           */
                                          function unstake(uint256[] calldata stakes, bytes calldata data)
                                              external
                                              returns (
                                                  uint256 totalReward,
                                                  uint256 userReward,
                                                  uint256 devReward
                                              )
                                          {
                                              _unstake(stakes);
                                          }
                                          /**
                                           * @dev Unstakes a certain amount of previously deposited tokens. User also receives their
                                           * alotted number of distribution tokens.
                                           * @param stakes Mushrooms to unstake.
                                           */
                                          function _unstake(uint256[] memory stakes)
                                              private
                                              returns (
                                                  uint256 totalReward,
                                                  uint256 userReward,
                                                  uint256 devReward
                                              )
                                          {
                                              // 1. User Accounting
                                              UserTotals storage totals = _userTotals[msg.sender];
                                              Stake[] storage accountStakes = _userStakes[msg.sender];
                                              // Redeem from most recent stake and go backwards in time.
                                              uint256 rewardAmount = 0;
                                              for (uint256 i = 0; i < stakes.length; i++) {
                                                  Stake storage currentStake = accountStakes[stakes[i]];
                                                  MushroomLib.MushroomData memory metadata = metadataResolver.getMushroomData(currentStake.nftContract, currentStake.nftIndex, "");
                                                  uint256 lifespanUsed = now.sub(currentStake.stakedAt);
                                                  bool deadMushroom = false;
                                                  // Effective lifespan used is capped at mushroom lifespan
                                                  if (lifespanUsed >= metadata.lifespan) {
                                                      lifespanUsed = metadata.lifespan;
                                                      deadMushroom = true;
                                                  }
                                                  emit LifespanUsed(currentStake.nftContract, currentStake.nftIndex, lifespanUsed, metadata.lifespan);
                                                  rewardAmount = computeNewReward(rewardAmount, metadata.strength, lifespanUsed);
                                                  // Update global aomunt staked
                                                  totalStrengthStaked = totalStrengthStaked.sub(metadata.strength);
                                                  totals.userStrengthStaked = totals.userStrengthStaked.sub(metadata.strength);
                                                  // Burn dead mushrooms, if they can be burnt. Otherwise, they can still be withdrawn with 0 lifespan.
                                                  if (deadMushroom && metadataResolver.isBurnable(currentStake.nftContract, currentStake.nftIndex)) {
                                                      MushroomNFT(currentStake.nftContract).burn(currentStake.nftIndex);
                                                      emit BurnedMushroom(currentStake.nftContract, currentStake.nftIndex);
                                                  } else {
                                                      // If still alive, reduce lifespan of mushroom and return to user. If not burnable, return with 0 lifespan.
                                                      metadataResolver.setMushroomLifespan(currentStake.nftContract, currentStake.nftIndex, metadata.lifespan.sub(lifespanUsed), "");
                                                      IERC721(currentStake.nftContract).transferFrom(address(this), msg.sender, currentStake.nftIndex);
                                                      // TODO: Test
                                                      MushroomLib.MushroomData memory metadata2 = metadataResolver.getMushroomData(currentStake.nftContract, currentStake.nftIndex, "");
                                                      emit NewLifespan(currentStake.nftContract, currentStake.nftIndex, metadata2.lifespan);
                                                  }
                                                  accountStakes.pop();
                                                  emit Unstaked(msg.sender, currentStake.nftContract, currentStake.nftIndex, totalStakedFor(msg.sender), "");
                                              }
                                              // Already set in updateAccounting
                                              // _lastAccountingTimestampSec = now;
                                              // interactions
                                              totalReward= rewardAmount;
                                              (userReward, devReward) = computeDevReward(totalReward);
                                              if (userReward > 0) {
                                                  require(enokiToken.transfer(msg.sender, userReward), "EnokiGeyser: transfer to user out of unlocked pool failed");
                                              }
                                              if (devReward > 0) {
                                                  require(enokiToken.transfer(devRewardAddress, devReward), "EnokiGeyser: transfer to dev out of unlocked pool failed");
                                              }
                                              emit TokensClaimed(msg.sender, rewardAmount, userReward, devReward);
                                              require(totalStakingShares == 0 || totalStaked() > 0, "EnokiGeyser: Error unstaking. Staking shares exist, but no staking tokens do");
                                          }
                                          function computeNewReward(
                                              uint256 currentReward,
                                              uint256 strength,
                                              uint256 timeStaked
                                          ) private view returns (uint256) {
                                              uint256 newReward = strength.mul(timeStaked).div(SECONDS_PER_WEEK);
                                              return currentReward.add(newReward);
                                          }
                                          /**
                                           * @dev Determines split of specified reward amount between user and dev.
                                           * @param totalReward Amount of reward to split.
                                           * @return userReward Reward amounts for user and dev.
                                           * @return devReward Reward amounts for user and dev.
                                           */
                                          function computeDevReward(uint256 totalReward) public view returns (uint256 userReward, uint256 devReward) {
                                              if (devRewardPercentage == 0) {
                                                  userReward = totalReward;
                                                  devReward = 0;
                                              } else if (devRewardPercentage == MAX_PERCENTAGE) {
                                                  userReward = 0;
                                                  devReward = totalReward;
                                              } else {
                                                  devReward = totalReward.mul(devRewardPercentage).div(MAX_PERCENTAGE);
                                                  userReward = totalReward.sub(devReward); // Extra dust due to truncated rounding goes to user
                                              }
                                          }
                                          /**
                                           * @param addr The user to look up staking information for.
                                           * @return The number of staking tokens deposited for addr.
                                           */
                                          function totalStakedFor(address addr) public view returns (uint256) {
                                              return _userTotals[addr].userStrengthStaked;
                                          }
                                          /**
                                           * @return The total number of deposit tokens staked globally, by all users.
                                           */
                                          function totalStaked() public view returns (uint256) {
                                              return totalStrengthStaked;
                                          }
                                          /**
                                           * @return Total number of locked distribution tokens.
                                           */
                                          function totalLocked() public view returns (uint256) {
                                              return enokiToken.balanceOf(address(this));
                                          }
                                          /**
                                           * @dev This funcion allows the contract owner to add more locked distribution tokens, along
                                           *      with the associated "unlock schedule". These locked tokens immediately begin unlocking
                                           *      linearly over the duraction of durationSec timeframe.
                                           * @param amount Number of distribution tokens to lock. These are transferred from the caller.
                                           * @param durationSec Length of time to linear unlock the tokens.
                                           */
                                          function lockTokens(uint256 amount, uint256 durationSec) external onlyOwner {
                                              require(enokiToken.transferFrom(msg.sender, address(this), amount), "EnokiGeyser: transfer failed");
                                              emit TokensLocked(amount, totalLocked());
                                          }
                                          function lockTokensAirdrop(address airdrop, uint256 amount) external onlyAdmin {
                                              require(usedAirdropPool.add(amount) <= maxAirdropPool, "Exceeds maximum airdrop tokens");
                                              usedAirdropPool = usedAirdropPool.add(amount);
                                              
                                              require(enokiToken.transfer(address(airdrop), amount), "EnokiGeyser: transfer into airdrop pool failed");
                                              
                                              emit TokensLockedAirdrop(airdrop, amount, totalLocked());
                                          }
                                      }
                                      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);
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../utils/EnumerableSet.sol";
                                      import "../utils/Address.sol";
                                      import "../GSN/Context.sol";
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Contract module that allows children to implement role-based access
                                       * control mechanisms.
                                       *
                                       * 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, _msgSender()));
                                       *     ...
                                       * }
                                       * ```
                                       *
                                       * 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}.
                                       */
                                      abstract contract AccessControlUpgradeSafe is Initializable, ContextUpgradeSafe {
                                          function __AccessControl_init() internal initializer {
                                              __Context_init_unchained();
                                              __AccessControl_init_unchained();
                                          }
                                          function __AccessControl_init_unchained() internal initializer {
                                          }
                                          using EnumerableSet for EnumerableSet.AddressSet;
                                          using Address for address;
                                          struct RoleData {
                                              EnumerableSet.AddressSet members;
                                              bytes32 adminRole;
                                          }
                                          mapping (bytes32 => RoleData) private _roles;
                                          bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
                                          /**
                                           * @dev Emitted when `account` is granted `role`.
                                           *
                                           * `sender` is the account that originated the contract call, an admin role
                                           * bearer except when using {_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) public view returns (bool) {
                                              return _roles[role].members.contains(account);
                                          }
                                          /**
                                           * @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 returns (uint256) {
                                              return _roles[role].members.length();
                                          }
                                          /**
                                           * @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 returns (address) {
                                              return _roles[role].members.at(index);
                                          }
                                          /**
                                           * @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 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.
                                           */
                                          function grantRole(bytes32 role, address account) public virtual {
                                              require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to grant");
                                              _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.
                                           */
                                          function revokeRole(bytes32 role, address account) public virtual {
                                              require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to revoke");
                                              _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 granted `role`, emits a {RoleRevoked}
                                           * event.
                                           *
                                           * Requirements:
                                           *
                                           * - the caller must be `account`.
                                           */
                                          function renounceRole(bytes32 role, address account) public virtual {
                                              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.
                                           *
                                           * [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}.
                                           * ====
                                           */
                                          function _setupRole(bytes32 role, address account) internal virtual {
                                              _grantRole(role, account);
                                          }
                                          /**
                                           * @dev Sets `adminRole` as ``role``'s admin role.
                                           */
                                          function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
                                              _roles[role].adminRole = adminRole;
                                          }
                                          function _grantRole(bytes32 role, address account) private {
                                              if (_roles[role].members.add(account)) {
                                                  emit RoleGranted(role, account, _msgSender());
                                              }
                                          }
                                          function _revokeRole(bytes32 role, address account) private {
                                              if (_roles[role].members.remove(account)) {
                                                  emit RoleRevoked(role, account, _msgSender());
                                              }
                                          }
                                          uint256[49] private __gap;
                                      }
                                      pragma solidity ^0.6.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.0.0, only sets of type `address` (`AddressSet`) and `uint256`
                                       * (`UintSet`) are supported.
                                       */
                                      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;
                                                  // When the value to delete is the last one, the swap operation is unnecessary. However, since this occurs
                                                  // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                                                  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] = toDeleteIndex + 1; // All indexes are 1-based
                                                  // 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) {
                                              require(set._values.length > index, "EnumerableSet: index out of bounds");
                                              return set._values[index];
                                          }
                                          // 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(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(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(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(uint256(_at(set._inner, index)));
                                          }
                                          // 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));
                                          }
                                      }
                                      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");
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Contract module that helps prevent reentrant calls to a function.
                                       *
                                       * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
                                       * available, which can be applied to functions to make sure there are no nested
                                       * (reentrant) calls to them.
                                       *
                                       * Note that because there is a single `nonReentrant` guard, functions marked as
                                       * `nonReentrant` may not call one another. This can be worked around by making
                                       * those functions `private`, and then adding `external` `nonReentrant` entry
                                       * points to them.
                                       *
                                       * TIP: If you would like to learn more about reentrancy and alternative ways
                                       * to protect against it, check out our blog post
                                       * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
                                       */
                                      contract ReentrancyGuardUpgradeSafe is Initializable {
                                          bool private _notEntered;
                                          function __ReentrancyGuard_init() internal initializer {
                                              __ReentrancyGuard_init_unchained();
                                          }
                                          function __ReentrancyGuard_init_unchained() internal initializer {
                                              // Storing an initial non-zero value makes deployment a bit more
                                              // expensive, but in exchange the refund on every call to nonReentrant
                                              // will be lower in amount. Since refunds are capped to a percetange of
                                              // the total transaction's gas, it is best to keep them low in cases
                                              // like this one, to increase the likelihood of the full refund coming
                                              // into effect.
                                              _notEntered = true;
                                          }
                                          /**
                                           * @dev Prevents a contract from calling itself, directly or indirectly.
                                           * Calling a `nonReentrant` function from another `nonReentrant`
                                           * function is not supported. It is possible to prevent this from happening
                                           * by making the `nonReentrant` function external, and make it call a
                                           * `private` function that does the actual work.
                                           */
                                          modifier nonReentrant() {
                                              // On the first call to nonReentrant, _notEntered will be true
                                              require(_notEntered, "ReentrancyGuard: reentrant call");
                                              // Any calls to nonReentrant after this point will fail
                                              _notEntered = false;
                                              _;
                                              // By storing the original value once again, a refund is triggered (see
                                              // https://eips.ethereum.org/EIPS/eip-2200)
                                              _notEntered = true;
                                          }
                                          uint256[49] private __gap;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      /**
                                       * @title A simple holder of tokens.
                                       * This is a simple contract to hold tokens. It's useful in the case where a separate contract
                                       * needs to hold multiple distinct pools of the same token.
                                       */
                                      contract TokenPool is Initializable, OwnableUpgradeSafe {
                                          IERC20 public token;
                                          function initialize(IERC20 _token) public initializer {
                                              __Ownable_init();
                                              token = _token;
                                          }
                                          function balance() public view returns (uint256) {
                                              return token.balanceOf(address(this));
                                          }
                                          function transfer(address to, uint256 value) external onlyOwner returns (bool) {
                                              return token.transfer(to, value);
                                          }
                                          function rescueFunds(address tokenToRescue, address to, uint256 amount) external onlyOwner returns (bool) {
                                              require(address(token) != tokenToRescue, 'TokenPool: Cannot claim token held by the contract');
                                              return IERC20(tokenToRescue).transfer(to, amount);
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "./ERC721.sol";
                                      import "./MushroomLib.sol";
                                      /*
                                          Minting and burning permissions are managed by the Owner
                                      */
                                      contract MushroomNFT is ERC721UpgradeSafe, OwnableUpgradeSafe, AccessControlUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          mapping (uint256 => MushroomLib.MushroomData) public mushroomData; // NFT Id -> Metadata
                                          mapping (uint256 => MushroomLib.MushroomType) public mushroomTypes; // Species Id -> Metadata
                                          mapping (uint256 => bool) public mushroomTypeExists; // Species Id -> Exists
                                          mapping (uint256 => string) public mushroomMetadataUri; // Species Id -> URI
                                          bytes32 public constant LIFESPAN_MODIFIER_ROLE = keccak256("LIFESPAN_MODIFIER_ROLE");
                                          bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");
                                          function initialize() public initializer {
                                              __Ownable_init_unchained();
                                              __AccessControl_init_unchained();
                                              __ERC721_init("Enoki Mushrooms", "Enoki Mushrooms");
                                              _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                                          }
                                          /* ========== VIEWS ========== */
                                          // Mushrooms inherit their strength from their species
                                          function getMushroomData(uint256 tokenId) public view returns (MushroomLib.MushroomData memory) {
                                              MushroomLib.MushroomData memory data = mushroomData[tokenId];
                                              return data;
                                          }
                                          function getSpecies(uint256 speciesId) public view returns (MushroomLib.MushroomType memory) {
                                              return mushroomTypes[speciesId];
                                          }
                                          function getRemainingMintableForSpecies(uint256 speciesId) public view returns (uint256) {
                                              MushroomLib.MushroomType storage species = mushroomTypes[speciesId];
                                              return species.cap.sub(species.minted);
                                          }
                                          /// @notice Return token URI for mushroom
                                          /// @notice URI is determined by species and can be modifed by the owner
                                          function tokenURI(uint256 tokenId) public view override returns (string memory) {
                                              MushroomLib.MushroomData storage data = mushroomData[tokenId];
                                              return mushroomMetadataUri[data.species];
                                          }  
                                          /* ========== ROLE MANAGEMENT ========== */
                                          // TODO: Ensure we can transfer admin role privledges
                                          modifier onlyLifespanModifier() {
                                              require(hasRole(LIFESPAN_MODIFIER_ROLE, msg.sender), "MushroomNFT: Only approved lifespan modifier");
                                              _;
                                          }
                                          modifier onlyMinter() {
                                              require(hasRole(MINTER_ROLE, msg.sender), "MushroomNFT: Only approved mushroom minter");
                                              _;
                                          }
                                          /* ========== RESTRICTED FUNCTIONS ========== */
                                          /**
                                           * @dev The burner must be the owner of the token, or approved. The EnokiGeyser owns tokens when it burns them.
                                           */
                                          function burn(uint256 tokenId) public {
                                              //solhint-disable-next-line max-line-length
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721Burnable: caller is not owner nor approved");
                                              _burn(tokenId);
                                              _clearMushroomData(tokenId);
                                          }
                                          function mint(address recipient, uint256 tokenId, uint256 speciesId, uint256 lifespan) public onlyMinter {
                                              _mintWithMetadata(recipient, tokenId, speciesId, lifespan);
                                          }
                                          function setMushroomLifespan(uint256 index, uint256 lifespan) public onlyLifespanModifier {
                                              mushroomData[index].lifespan = lifespan;
                                          }
                                          function setSpeciesUri(uint256 speciesId, string memory URI) public onlyOwner {
                                              mushroomMetadataUri[speciesId] = URI;
                                          }
                                          function _mintWithMetadata(address recipient, uint256 tokenId, uint256 speciesId, uint256 lifespan) internal {
                                              require(mushroomTypeExists[speciesId], "MushroomNFT: mushroom species specified does not exist");
                                              MushroomLib.MushroomType storage species = mushroomTypes[speciesId];
                                              require(species.minted < species.cap, "MushroomNFT: minting cap reached for species");
                                              species.minted = species.minted.add(1);
                                              mushroomData[tokenId] = MushroomLib.MushroomData(speciesId, species.strength, lifespan);
                                              _safeMint(recipient, tokenId);
                                          }
                                          // TODO: We don't really have to do this as a newly minted mushroom will set the data
                                          function _clearMushroomData(uint256 tokenId) internal {
                                              MushroomLib.MushroomData storage data = mushroomData[tokenId];
                                              MushroomLib.MushroomType storage species = mushroomTypes[data.species];   
                                              mushroomData[tokenId].species = 0;
                                              mushroomData[tokenId].strength = 0;
                                              mushroomData[tokenId].lifespan = 0;
                                              species.minted = species.minted.sub(1);
                                          }
                                          function setMushroomType(uint256 speciesId, MushroomLib.MushroomType memory mType) public onlyOwner {
                                              if (!mushroomTypeExists[speciesId]) {
                                                  mushroomTypeExists[speciesId] = true;
                                              }
                                              mushroomTypes[speciesId] = mType;
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/GSN/Context.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Metadata.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Enumerable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Receiver.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/introspection/ERC165.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/Address.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/EnumerableSet.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/EnumerableMap.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/Strings.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/Initializable.sol";
                                      /**
                                       * @title ERC721 Non-Fungible Token Standard basic implementation
                                       * @dev see https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      contract ERC721UpgradeSafe is Initializable, ContextUpgradeSafe, ERC165UpgradeSafe, IERC721, IERC721Metadata, IERC721Enumerable {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          using EnumerableSet for EnumerableSet.UintSet;
                                          using EnumerableMap for EnumerableMap.UintToAddressMap;
                                          using Strings for uint256;
                                          // Equals to `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
                                          // which can be also obtained as `IERC721Receiver(0).onERC721Received.selector`
                                          bytes4 private constant _ERC721_RECEIVED = 0x150b7a02;
                                          // Mapping from holder address to their (enumerable) set of owned tokens
                                          mapping (address => EnumerableSet.UintSet) private _holderTokens;
                                          // Enumerable mapping from token ids to their owners
                                          EnumerableMap.UintToAddressMap private _tokenOwners;
                                          // Mapping from token ID to approved address
                                          mapping (uint256 => address) private _tokenApprovals;
                                          // Mapping from owner to operator approvals
                                          mapping (address => mapping (address => bool)) private _operatorApprovals;
                                          // Token name
                                          string private _name;
                                          // Token symbol
                                          string private _symbol;
                                          // Optional mapping for token URIs
                                          mapping(uint256 => string) private _tokenURIs;
                                          // Base URI
                                          string private _baseURI;
                                          /*
                                           *     bytes4(keccak256('balanceOf(address)')) == 0x70a08231
                                           *     bytes4(keccak256('ownerOf(uint256)')) == 0x6352211e
                                           *     bytes4(keccak256('approve(address,uint256)')) == 0x095ea7b3
                                           *     bytes4(keccak256('getApproved(uint256)')) == 0x081812fc
                                           *     bytes4(keccak256('setApprovalForAll(address,bool)')) == 0xa22cb465
                                           *     bytes4(keccak256('isApprovedForAll(address,address)')) == 0xe985e9c5
                                           *     bytes4(keccak256('transferFrom(address,address,uint256)')) == 0x23b872dd
                                           *     bytes4(keccak256('safeTransferFrom(address,address,uint256)')) == 0x42842e0e
                                           *     bytes4(keccak256('safeTransferFrom(address,address,uint256,bytes)')) == 0xb88d4fde
                                           *
                                           *     => 0x70a08231 ^ 0x6352211e ^ 0x095ea7b3 ^ 0x081812fc ^
                                           *        0xa22cb465 ^ 0xe985e9c ^ 0x23b872dd ^ 0x42842e0e ^ 0xb88d4fde == 0x80ac58cd
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721 = 0x80ac58cd;
                                          /*
                                           *     bytes4(keccak256('name()')) == 0x06fdde03
                                           *     bytes4(keccak256('symbol()')) == 0x95d89b41
                                           *     bytes4(keccak256('tokenURI(uint256)')) == 0xc87b56dd
                                           *
                                           *     => 0x06fdde03 ^ 0x95d89b41 ^ 0xc87b56dd == 0x5b5e139f
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721_METADATA = 0x5b5e139f;
                                          /*
                                           *     bytes4(keccak256('totalSupply()')) == 0x18160ddd
                                           *     bytes4(keccak256('tokenOfOwnerByIndex(address,uint256)')) == 0x2f745c59
                                           *     bytes4(keccak256('tokenByIndex(uint256)')) == 0x4f6ccce7
                                           *
                                           *     => 0x18160ddd ^ 0x2f745c59 ^ 0x4f6ccce7 == 0x780e9d63
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721_ENUMERABLE = 0x780e9d63;
                                          function __ERC721_init(string memory name, string memory symbol) internal initializer {
                                              __Context_init_unchained();
                                              __ERC165_init_unchained();
                                              __ERC721_init_unchained(name, symbol);
                                          }
                                          function __ERC721_init_unchained(string memory name, string memory symbol) internal initializer {
                                              _name = name;
                                              _symbol = symbol;
                                              // register the supported interfaces to conform to ERC721 via ERC165
                                              _registerInterface(_INTERFACE_ID_ERC721);
                                              _registerInterface(_INTERFACE_ID_ERC721_METADATA);
                                              _registerInterface(_INTERFACE_ID_ERC721_ENUMERABLE);
                                          }
                                          /**
                                           * @dev Gets the balance of the specified address.
                                           * @param owner address to query the balance of
                                           * @return uint256 representing the amount owned by the passed address
                                           */
                                          function balanceOf(address owner) public view override returns (uint256) {
                                              require(owner != address(0), "ERC721: balance query for the zero address");
                                              return _holderTokens[owner].length();
                                          }
                                          /**
                                           * @dev Gets the owner of the specified token ID.
                                           * @param tokenId uint256 ID of the token to query the owner of
                                           * @return address currently marked as the owner of the given token ID
                                           */
                                          function ownerOf(uint256 tokenId) public view override returns (address) {
                                              return _tokenOwners.get(tokenId, "ERC721: owner query for nonexistent token");
                                          }
                                          /**
                                           * @dev Gets the token name.
                                           * @return string representing the token name
                                           */
                                          function name() public view override returns (string memory) {
                                              return _name;
                                          }
                                          /**
                                           * @dev Gets the token symbol.
                                           * @return string representing the token symbol
                                           */
                                          function symbol() public view override returns (string memory) {
                                              return _symbol;
                                          }
                                          /**
                                           * @dev Returns the URI for a given token ID. May return an empty string.
                                           *
                                           * If a base URI is set (via {_setBaseURI}), it is added as a prefix to the
                                           * token's own URI (via {_setTokenURI}).
                                           *
                                           * If there is a base URI but no token URI, the token's ID will be used as
                                           * its URI when appending it to the base URI. This pattern for autogenerated
                                           * token URIs can lead to large gas savings.
                                           *
                                           * .Examples
                                           * |===
                                           * |`_setBaseURI()` |`_setTokenURI()` |`tokenURI()`
                                           * | ""
                                           * | ""
                                           * | ""
                                           * | ""
                                           * | "token.uri/123"
                                           * | "token.uri/123"
                                           * | "token.uri/"
                                           * | "123"
                                           * | "token.uri/123"
                                           * | "token.uri/"
                                           * | ""
                                           * | "token.uri/<tokenId>"
                                           * |===
                                           *
                                           * Requirements:
                                           *
                                           * - `tokenId` must exist.
                                           */
                                          function tokenURI(uint256 tokenId) public view override virtual returns (string memory) {
                                              require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
                                              string memory _tokenURI = _tokenURIs[tokenId];
                                              // If there is no base URI, return the token URI.
                                              if (bytes(_baseURI).length == 0) {
                                                  return _tokenURI;
                                              }
                                              // If both are set, concatenate the baseURI and tokenURI (via abi.encodePacked).
                                              if (bytes(_tokenURI).length > 0) {
                                                  return string(abi.encodePacked(_baseURI, _tokenURI));
                                              }
                                              // If there is a baseURI but no tokenURI, concatenate the tokenID to the baseURI.
                                              return string(abi.encodePacked(_baseURI, tokenId.toString()));
                                          }
                                          /**
                                          * @dev Returns the base URI set via {_setBaseURI}. This will be
                                          * automatically added as a prefix in {tokenURI} to each token's URI, or
                                          * to the token ID if no specific URI is set for that token ID.
                                          */
                                          function baseURI() public view returns (string memory) {
                                              return _baseURI;
                                          }
                                          /**
                                           * @dev Gets the token ID at a given index of the tokens list of the requested owner.
                                           * @param owner address owning the tokens list to be accessed
                                           * @param index uint256 representing the index to be accessed of the requested tokens list
                                           * @return uint256 token ID at the given index of the tokens list owned by the requested address
                                           */
                                          function tokenOfOwnerByIndex(address owner, uint256 index) public view override returns (uint256) {
                                              return _holderTokens[owner].at(index);
                                          }
                                          /**
                                           * @dev Gets the total amount of tokens stored by the contract.
                                           * @return uint256 representing the total amount of tokens
                                           */
                                          function totalSupply() public view override returns (uint256) {
                                              // _tokenOwners are indexed by tokenIds, so .length() returns the number of tokenIds
                                              return _tokenOwners.length();
                                          }
                                          /**
                                           * @dev Gets the token ID at a given index of all the tokens in this contract
                                           * Reverts if the index is greater or equal to the total number of tokens.
                                           * @param index uint256 representing the index to be accessed of the tokens list
                                           * @return uint256 token ID at the given index of the tokens list
                                           */
                                          function tokenByIndex(uint256 index) public view override returns (uint256) {
                                              (uint256 tokenId, ) = _tokenOwners.at(index);
                                              return tokenId;
                                          }
                                          /**
                                           * @dev Approves another address to transfer the given token ID
                                           * The zero address indicates there is no approved address.
                                           * There can only be one approved address per token at a given time.
                                           * Can only be called by the token owner or an approved operator.
                                           * @param to address to be approved for the given token ID
                                           * @param tokenId uint256 ID of the token to be approved
                                           */
                                          function approve(address to, uint256 tokenId) public virtual override {
                                              address owner = ownerOf(tokenId);
                                              require(to != owner, "ERC721: approval to current owner");
                                              require(_msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                                                  "ERC721: approve caller is not owner nor approved for all"
                                              );
                                              _approve(to, tokenId);
                                          }
                                          /**
                                           * @dev Gets the approved address for a token ID, or zero if no address set
                                           * Reverts if the token ID does not exist.
                                           * @param tokenId uint256 ID of the token to query the approval of
                                           * @return address currently approved for the given token ID
                                           */
                                          function getApproved(uint256 tokenId) public view override returns (address) {
                                              require(_exists(tokenId), "ERC721: approved query for nonexistent token");
                                              return _tokenApprovals[tokenId];
                                          }
                                          /**
                                           * @dev Sets or unsets the approval of a given operator
                                           * An operator is allowed to transfer all tokens of the sender on their behalf.
                                           * @param operator operator address to set the approval
                                           * @param approved representing the status of the approval to be set
                                           */
                                          function setApprovalForAll(address operator, bool approved) public virtual override {
                                              require(operator != _msgSender(), "ERC721: approve to caller");
                                              _operatorApprovals[_msgSender()][operator] = approved;
                                              emit ApprovalForAll(_msgSender(), operator, approved);
                                          }
                                          /**
                                           * @dev Tells whether an operator is approved by a given owner.
                                           * @param owner owner address which you want to query the approval of
                                           * @param operator operator address which you want to query the approval of
                                           * @return bool whether the given operator is approved by the given owner
                                           */
                                          function isApprovedForAll(address owner, address operator) public view override returns (bool) {
                                              return _operatorApprovals[owner][operator];
                                          }
                                          /**
                                           * @dev Transfers the ownership of a given token ID to another address.
                                           * Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
                                           * Requires the msg.sender to be the owner, approved, or operator.
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function transferFrom(address from, address to, uint256 tokenId) public virtual override {
                                              //solhint-disable-next-line max-line-length
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                                              _transfer(from, to, tokenId);
                                          }
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement {IERC721Receiver-onERC721Received},
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the msg.sender to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId) public virtual override {
                                              safeTransferFrom(from, to, tokenId, "");
                                          }
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement {IERC721Receiver-onERC721Received},
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the _msgSender() to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory _data) public virtual override {
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                                              _safeTransfer(from, to, tokenId, _data);
                                          }
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the msg.sender to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function _safeTransfer(address from, address to, uint256 tokenId, bytes memory _data) internal virtual {
                                              _transfer(from, to, tokenId);
                                              require(_checkOnERC721Received(from, to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
                                          }
                                          /**
                                           * @dev Returns whether the specified token exists.
                                           * @param tokenId uint256 ID of the token to query the existence of
                                           * @return bool whether the token exists
                                           */
                                          function _exists(uint256 tokenId) internal view returns (bool) {
                                              return _tokenOwners.contains(tokenId);
                                          }
                                          /**
                                           * @dev Returns whether the given spender can transfer a given token ID.
                                           * @param spender address of the spender to query
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @return bool whether the msg.sender is approved for the given token ID,
                                           * is an operator of the owner, or is the owner of the token
                                           */
                                          function _isApprovedOrOwner(address spender, uint256 tokenId) internal view returns (bool) {
                                              require(_exists(tokenId), "ERC721: operator query for nonexistent token");
                                              address owner = ownerOf(tokenId);
                                              return (spender == owner || getApproved(tokenId) == spender || isApprovedForAll(owner, spender));
                                          }
                                          /**
                                           * @dev Internal function to safely mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           */
                                          function _safeMint(address to, uint256 tokenId) internal virtual {
                                              _safeMint(to, tokenId, "");
                                          }
                                          /**
                                           * @dev Internal function to safely mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function _safeMint(address to, uint256 tokenId, bytes memory _data) internal virtual {
                                              _mint(to, tokenId);
                                              require(_checkOnERC721Received(address(0), to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
                                          }
                                          /**
                                           * @dev Internal function to mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           */
                                          function _mint(address to, uint256 tokenId) internal virtual {
                                              require(to != address(0), "ERC721: mint to the zero address");
                                              require(!_exists(tokenId), "ERC721: token already minted");
                                              _beforeTokenTransfer(address(0), to, tokenId);
                                              _holderTokens[to].add(tokenId);
                                              _tokenOwners.set(tokenId, to);
                                              emit Transfer(address(0), to, tokenId);
                                          }
                                          /**
                                           * @dev Internal function to burn a specific token.
                                           * Reverts if the token does not exist.
                                           * @param tokenId uint256 ID of the token being burned
                                           */
                                          function _burn(uint256 tokenId) internal virtual {
                                              address owner = ownerOf(tokenId);
                                              _beforeTokenTransfer(owner, address(0), tokenId);
                                              // Clear approvals
                                              _approve(address(0), tokenId);
                                              // Clear metadata (if any)
                                              if (bytes(_tokenURIs[tokenId]).length != 0) {
                                                  delete _tokenURIs[tokenId];
                                              }
                                              _holderTokens[owner].remove(tokenId);
                                              _tokenOwners.remove(tokenId);
                                              emit Transfer(owner, address(0), tokenId);
                                          }
                                          /**
                                           * @dev Internal function to transfer ownership of a given token ID to another address.
                                           * As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function _transfer(address from, address to, uint256 tokenId) internal virtual {
                                              require(ownerOf(tokenId) == from, "ERC721: transfer of token that is not own");
                                              require(to != address(0), "ERC721: transfer to the zero address");
                                              _beforeTokenTransfer(from, to, tokenId);
                                              // Clear approvals from the previous owner
                                              _approve(address(0), tokenId);
                                              _holderTokens[from].remove(tokenId);
                                              _holderTokens[to].add(tokenId);
                                              _tokenOwners.set(tokenId, to);
                                              emit Transfer(from, to, tokenId);
                                          }
                                          /**
                                           * @dev Internal function to set the token URI for a given token.
                                           *
                                           * Reverts if the token ID does not exist.
                                           *
                                           * TIP: If all token IDs share a prefix (for example, if your URIs look like
                                           * `https://api.myproject.com/token/<id>`), use {_setBaseURI} to store
                                           * it and save gas.
                                           */
                                          function _setTokenURI(uint256 tokenId, string memory _tokenURI) internal virtual {
                                              require(_exists(tokenId), "ERC721Metadata: URI set of nonexistent token");
                                              _tokenURIs[tokenId] = _tokenURI;
                                          }
                                          /**
                                           * @dev Internal function to set the base URI for all token IDs. It is
                                           * automatically added as a prefix to the value returned in {tokenURI},
                                           * or to the token ID if {tokenURI} is empty.
                                           */
                                          function _setBaseURI(string memory baseURI_) internal virtual {
                                              _baseURI = baseURI_;
                                          }
                                          /**
                                           * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
                                           * The call is not executed if the target address is not a contract.
                                           *
                                           * @param from address representing the previous owner of the given token ID
                                           * @param to target address that will receive the tokens
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes optional data to send along with the call
                                           * @return bool whether the call correctly returned the expected magic value
                                           */
                                          function _checkOnERC721Received(address from, address to, uint256 tokenId, bytes memory _data)
                                              private returns (bool)
                                          {
                                              if (!to.isContract()) {
                                                  return true;
                                              }
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, bytes memory returndata) = to.call(abi.encodeWithSelector(
                                                  IERC721Receiver(to).onERC721Received.selector,
                                                  _msgSender(),
                                                  from,
                                                  tokenId,
                                                  _data
                                              ));
                                              if (!success) {
                                                  if (returndata.length > 0) {
                                                      // solhint-disable-next-line no-inline-assembly
                                                      assembly {
                                                          let returndata_size := mload(returndata)
                                                          revert(add(32, returndata), returndata_size)
                                                      }
                                                  } else {
                                                      revert("ERC721: transfer to non ERC721Receiver implementer");
                                                  }
                                              } else {
                                                  bytes4 retval = abi.decode(returndata, (bytes4));
                                                  return (retval == _ERC721_RECEIVED);
                                              }
                                          }
                                          function _approve(address to, uint256 tokenId) private {
                                              _tokenApprovals[tokenId] = to;
                                              emit Approval(ownerOf(tokenId), to, tokenId);
                                          }
                                          /**
                                           * @dev Hook that is called before any token transfer. This includes minting
                                           * and burning.
                                           *
                                           * Calling conditions:
                                           *
                                           * - when `from` and `to` are both non-zero, ``from``'s `tokenId` will be
                                           * transferred to `to`.
                                           * - when `from` is zero, `tokenId` will be minted for `to`.
                                           * - when `to` is zero, ``from``'s `tokenId` 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 tokenId) internal virtual { }
                                          uint256[41] private __gap;
                                      }
                                      pragma solidity ^0.6.2;
                                      import "../../introspection/IERC165.sol";
                                      /**
                                       * @dev Required interface of an ERC721 compliant contract.
                                       */
                                      interface IERC721 is IERC165 {
                                          event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
                                          event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
                                          event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
                                          /**
                                           * @dev Returns the number of NFTs in ``owner``'s account.
                                           */
                                          function balanceOf(address owner) external view returns (uint256 balance);
                                          /**
                                           * @dev Returns the owner of the NFT specified by `tokenId`.
                                           */
                                          function ownerOf(uint256 tokenId) external view returns (address owner);
                                          /**
                                           * @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to
                                           * another (`to`).
                                           *
                                           *
                                           *
                                           * Requirements:
                                           * - `from`, `to` cannot be zero.
                                           * - `tokenId` must be owned by `from`.
                                           * - If the caller is not `from`, it must be have been allowed to move this
                                           * NFT by either {approve} or {setApprovalForAll}.
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId) external;
                                          /**
                                           * @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to
                                           * another (`to`).
                                           *
                                           * Requirements:
                                           * - If the caller is not `from`, it must be approved to move this NFT by
                                           * either {approve} or {setApprovalForAll}.
                                           */
                                          function transferFrom(address from, address to, uint256 tokenId) external;
                                          function approve(address to, uint256 tokenId) external;
                                          function getApproved(uint256 tokenId) external view returns (address operator);
                                          function setApprovalForAll(address operator, bool _approved) external;
                                          function isApprovedForAll(address owner, address operator) external view returns (bool);
                                          function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;
                                      }
                                      pragma solidity ^0.6.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);
                                      }
                                      pragma solidity ^0.6.2;
                                      import "./IERC721.sol";
                                      /**
                                       * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
                                       * @dev See https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      interface IERC721Metadata is IERC721 {
                                          function name() external view returns (string memory);
                                          function symbol() external view returns (string memory);
                                          function tokenURI(uint256 tokenId) external view returns (string memory);
                                      }
                                      pragma solidity ^0.6.2;
                                      import "./IERC721.sol";
                                      /**
                                       * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
                                       * @dev See https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      interface IERC721Enumerable is IERC721 {
                                          function totalSupply() external view returns (uint256);
                                          function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256 tokenId);
                                          function tokenByIndex(uint256 index) external view returns (uint256);
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @title ERC721 token receiver interface
                                       * @dev Interface for any contract that wants to support safeTransfers
                                       * from ERC721 asset contracts.
                                       */
                                      interface IERC721Receiver {
                                          /**
                                           * @notice Handle the receipt of an NFT
                                           * @dev The ERC721 smart contract calls this function on the recipient
                                           * after a {IERC721-safeTransferFrom}. This function MUST return the function selector,
                                           * otherwise the caller will revert the transaction. The selector to be
                                           * returned can be obtained as `this.onERC721Received.selector`. This
                                           * function MAY throw to revert and reject the transfer.
                                           * Note: the ERC721 contract address is always the message sender.
                                           * @param operator The address which called `safeTransferFrom` function
                                           * @param from The address which previously owned the token
                                           * @param tokenId The NFT identifier which is being transferred
                                           * @param data Additional data with no specified format
                                           * @return bytes4 `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
                                           */
                                          function onERC721Received(address operator, address from, uint256 tokenId, bytes calldata data)
                                          external returns (bytes4);
                                      }
                                      pragma solidity ^0.6.0;
                                      import "./IERC165.sol";
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Implementation of the {IERC165} interface.
                                       *
                                       * Contracts may inherit from this and call {_registerInterface} to declare
                                       * their support of an interface.
                                       */
                                      contract ERC165UpgradeSafe is Initializable, IERC165 {
                                          /*
                                           * bytes4(keccak256('supportsInterface(bytes4)')) == 0x01ffc9a7
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC165 = 0x01ffc9a7;
                                          /**
                                           * @dev Mapping of interface ids to whether or not it's supported.
                                           */
                                          mapping(bytes4 => bool) private _supportedInterfaces;
                                          function __ERC165_init() internal initializer {
                                              __ERC165_init_unchained();
                                          }
                                          function __ERC165_init_unchained() internal initializer {
                                              // Derived contracts need only register support for their own interfaces,
                                              // we register support for ERC165 itself here
                                              _registerInterface(_INTERFACE_ID_ERC165);
                                          }
                                          /**
                                           * @dev See {IERC165-supportsInterface}.
                                           *
                                           * Time complexity O(1), guaranteed to always use less than 30 000 gas.
                                           */
                                          function supportsInterface(bytes4 interfaceId) public view override returns (bool) {
                                              return _supportedInterfaces[interfaceId];
                                          }
                                          /**
                                           * @dev Registers the contract as an implementer of the interface defined by
                                           * `interfaceId`. Support of the actual ERC165 interface is automatic and
                                           * registering its interface id is not required.
                                           *
                                           * See {IERC165-supportsInterface}.
                                           *
                                           * Requirements:
                                           *
                                           * - `interfaceId` cannot be the ERC165 invalid interface (`0xffffffff`).
                                           */
                                          function _registerInterface(bytes4 interfaceId) internal virtual {
                                              require(interfaceId != 0xffffffff, "ERC165: invalid interface id");
                                              _supportedInterfaces[interfaceId] = true;
                                          }
                                          uint256[49] private __gap;
                                      }
                                      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) {
                                              // Solidity only automatically asserts when dividing by 0
                                              require(b > 0, errorMessage);
                                              uint256 c = a / b;
                                              // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return mod(a, b, "SafeMath: modulo by zero");
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts with custom message when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b != 0, errorMessage);
                                              return a % b;
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Library for managing an enumerable variant of Solidity's
                                       * https://solidity.readthedocs.io/en/latest/types.html#mapping-types[`mapping`]
                                       * type.
                                       *
                                       * Maps have the following properties:
                                       *
                                       * - Entries are added, removed, and checked for existence in constant time
                                       * (O(1)).
                                       * - Entries are enumerated in O(n). No guarantees are made on the ordering.
                                       *
                                       * ```
                                       * contract Example {
                                       *     // Add the library methods
                                       *     using EnumerableMap for EnumerableMap.UintToAddressMap;
                                       *
                                       *     // Declare a set state variable
                                       *     EnumerableMap.UintToAddressMap private myMap;
                                       * }
                                       * ```
                                       *
                                       * As of v3.0.0, only maps of type `uint256 -> address` (`UintToAddressMap`) are
                                       * supported.
                                       */
                                      library EnumerableMap {
                                          // To implement this library for multiple types with as little code
                                          // repetition as possible, we write it in terms of a generic Map type with
                                          // bytes32 keys and values.
                                          // The Map implementation uses private functions, and user-facing
                                          // implementations (such as Uint256ToAddressMap) are just wrappers around
                                          // the underlying Map.
                                          // This means that we can only create new EnumerableMaps for types that fit
                                          // in bytes32.
                                          struct MapEntry {
                                              bytes32 _key;
                                              bytes32 _value;
                                          }
                                          struct Map {
                                              // Storage of map keys and values
                                              MapEntry[] _entries;
                                              // Position of the entry defined by a key in the `entries` array, plus 1
                                              // because index 0 means a key is not in the map.
                                              mapping (bytes32 => uint256) _indexes;
                                          }
                                          /**
                                           * @dev Adds a key-value pair to a map, or updates the value for an existing
                                           * key. O(1).
                                           *
                                           * Returns true if the key was added to the map, that is if it was not
                                           * already present.
                                           */
                                          function _set(Map storage map, bytes32 key, bytes32 value) private returns (bool) {
                                              // We read and store the key's index to prevent multiple reads from the same storage slot
                                              uint256 keyIndex = map._indexes[key];
                                              if (keyIndex == 0) { // Equivalent to !contains(map, key)
                                                  map._entries.push(MapEntry({ _key: key, _value: value }));
                                                  // The entry is stored at length-1, but we add 1 to all indexes
                                                  // and use 0 as a sentinel value
                                                  map._indexes[key] = map._entries.length;
                                                  return true;
                                              } else {
                                                  map._entries[keyIndex - 1]._value = value;
                                                  return false;
                                              }
                                          }
                                          /**
                                           * @dev Removes a key-value pair from a map. O(1).
                                           *
                                           * Returns true if the key was removed from the map, that is if it was present.
                                           */
                                          function _remove(Map storage map, bytes32 key) private returns (bool) {
                                              // We read and store the key's index to prevent multiple reads from the same storage slot
                                              uint256 keyIndex = map._indexes[key];
                                              if (keyIndex != 0) { // Equivalent to contains(map, key)
                                                  // To delete a key-value pair from the _entries array in O(1), we swap the entry to delete with the last one
                                                  // in the array, and then remove the last entry (sometimes called as 'swap and pop').
                                                  // This modifies the order of the array, as noted in {at}.
                                                  uint256 toDeleteIndex = keyIndex - 1;
                                                  uint256 lastIndex = map._entries.length - 1;
                                                  // When the entry to delete is the last one, the swap operation is unnecessary. However, since this occurs
                                                  // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                                                  MapEntry storage lastEntry = map._entries[lastIndex];
                                                  // Move the last entry to the index where the entry to delete is
                                                  map._entries[toDeleteIndex] = lastEntry;
                                                  // Update the index for the moved entry
                                                  map._indexes[lastEntry._key] = toDeleteIndex + 1; // All indexes are 1-based
                                                  // Delete the slot where the moved entry was stored
                                                  map._entries.pop();
                                                  // Delete the index for the deleted slot
                                                  delete map._indexes[key];
                                                  return true;
                                              } else {
                                                  return false;
                                              }
                                          }
                                          /**
                                           * @dev Returns true if the key is in the map. O(1).
                                           */
                                          function _contains(Map storage map, bytes32 key) private view returns (bool) {
                                              return map._indexes[key] != 0;
                                          }
                                          /**
                                           * @dev Returns the number of key-value pairs in the map. O(1).
                                           */
                                          function _length(Map storage map) private view returns (uint256) {
                                              return map._entries.length;
                                          }
                                         /**
                                          * @dev Returns the key-value pair stored at position `index` in the map. O(1).
                                          *
                                          * Note that there are no guarantees on the ordering of entries inside the
                                          * array, and it may change when more entries are added or removed.
                                          *
                                          * Requirements:
                                          *
                                          * - `index` must be strictly less than {length}.
                                          */
                                          function _at(Map storage map, uint256 index) private view returns (bytes32, bytes32) {
                                              require(map._entries.length > index, "EnumerableMap: index out of bounds");
                                              MapEntry storage entry = map._entries[index];
                                              return (entry._key, entry._value);
                                          }
                                          /**
                                           * @dev Returns the value associated with `key`.  O(1).
                                           *
                                           * Requirements:
                                           *
                                           * - `key` must be in the map.
                                           */
                                          function _get(Map storage map, bytes32 key) private view returns (bytes32) {
                                              return _get(map, key, "EnumerableMap: nonexistent key");
                                          }
                                          /**
                                           * @dev Same as {_get}, with a custom error message when `key` is not in the map.
                                           */
                                          function _get(Map storage map, bytes32 key, string memory errorMessage) private view returns (bytes32) {
                                              uint256 keyIndex = map._indexes[key];
                                              require(keyIndex != 0, errorMessage); // Equivalent to contains(map, key)
                                              return map._entries[keyIndex - 1]._value; // All indexes are 1-based
                                          }
                                          // UintToAddressMap
                                          struct UintToAddressMap {
                                              Map _inner;
                                          }
                                          /**
                                           * @dev Adds a key-value pair to a map, or updates the value for an existing
                                           * key. O(1).
                                           *
                                           * Returns true if the key was added to the map, that is if it was not
                                           * already present.
                                           */
                                          function set(UintToAddressMap storage map, uint256 key, address value) internal returns (bool) {
                                              return _set(map._inner, bytes32(key), bytes32(uint256(value)));
                                          }
                                          /**
                                           * @dev Removes a value from a set. O(1).
                                           *
                                           * Returns true if the key was removed from the map, that is if it was present.
                                           */
                                          function remove(UintToAddressMap storage map, uint256 key) internal returns (bool) {
                                              return _remove(map._inner, bytes32(key));
                                          }
                                          /**
                                           * @dev Returns true if the key is in the map. O(1).
                                           */
                                          function contains(UintToAddressMap storage map, uint256 key) internal view returns (bool) {
                                              return _contains(map._inner, bytes32(key));
                                          }
                                          /**
                                           * @dev Returns the number of elements in the map. O(1).
                                           */
                                          function length(UintToAddressMap storage map) internal view returns (uint256) {
                                              return _length(map._inner);
                                          }
                                         /**
                                          * @dev Returns the element 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(UintToAddressMap storage map, uint256 index) internal view returns (uint256, address) {
                                              (bytes32 key, bytes32 value) = _at(map._inner, index);
                                              return (uint256(key), address(uint256(value)));
                                          }
                                          /**
                                           * @dev Returns the value associated with `key`.  O(1).
                                           *
                                           * Requirements:
                                           *
                                           * - `key` must be in the map.
                                           */
                                          function get(UintToAddressMap storage map, uint256 key) internal view returns (address) {
                                              return address(uint256(_get(map._inner, bytes32(key))));
                                          }
                                          /**
                                           * @dev Same as {get}, with a custom error message when `key` is not in the map.
                                           */
                                          function get(UintToAddressMap storage map, uint256 key, string memory errorMessage) internal view returns (address) {
                                              return address(uint256(_get(map._inner, bytes32(key), errorMessage)));
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev String operations.
                                       */
                                      library Strings {
                                          /**
                                           * @dev Converts a `uint256` to its ASCII `string` 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);
                                              uint256 index = digits - 1;
                                              temp = value;
                                              while (temp != 0) {
                                                  buffer[index--] = byte(uint8(48 + temp % 10));
                                                  temp /= 10;
                                              }
                                              return string(buffer);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      library MushroomLib {
                                          struct MushroomData {
                                              uint256 species;
                                              uint256 strength;
                                              uint256 lifespan;
                                          }
                                          struct MushroomType {
                                              uint256 id;
                                              uint256 strength;
                                              uint256 minLifespan;
                                              uint256 maxLifespan;
                                              uint256 minted;
                                              uint256 cap;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "./adapters/MetadataAdapter.sol";
                                      import "../MushroomLib.sol";
                                      /*
                                          A hub of adapters managing lifespan metadata for arbitrary NFTs
                                          Each adapter has it's own custom logic for that NFT
                                          Lifespan modification requesters have rights to manage lifespan metadata of NFTs via the adapters
                                          Admin(s) can manage the set of resolvers
                                      */
                                      contract MetadataResolver is AccessControlUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          mapping(address => address) public metadataAdapters;
                                          modifier onlyAdmin() {
                                              require(hasRole(DEFAULT_ADMIN_ROLE, msg.sender), "onlyAdmin");
                                              _;
                                          }
                                          modifier onlyLifespanModifier() {
                                              require(hasRole(LIFESPAN_MODIFY_REQUEST_ROLE, msg.sender), "onlyLifespanModifier");
                                              _;
                                          }
                                          bytes32 public constant LIFESPAN_MODIFY_REQUEST_ROLE = keccak256("LIFESPAN_MODIFY_REQUEST_ROLE");
                                          event ResolverSet(address nft, address resolver);
                                          modifier onlyWithMetadataAdapter(address nftContract) {
                                              require(metadataAdapters[nftContract] != address(0), "MetadataRegistry: No resolver set for nft");
                                              _;
                                          }
                                          function hasMetadataAdapter(address nftContract) external view returns (bool) {
                                              return metadataAdapters[nftContract] != address(0);
                                          }
                                          function getMetadataAdapter(address nftContract) external view returns (address) {
                                              return metadataAdapters[nftContract];
                                          }
                                          function isStakeable(address nftContract, uint256 nftIndex) external view returns (bool) {
                                              if (metadataAdapters[nftContract] == address(0)) {
                                                  return false;
                                              }
                                              
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              return resolver.isStakeable(nftIndex);
                                          }
                                          function initialize(address initialLifespanModifier_) public initializer {
                                              _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                                              _setupRole(LIFESPAN_MODIFY_REQUEST_ROLE, initialLifespanModifier_);
                                          }
                                          function getMushroomData(
                                              address nftContract,
                                              uint256 nftIndex,
                                              bytes calldata data
                                          ) external view onlyWithMetadataAdapter(nftContract) returns (MushroomLib.MushroomData memory) {
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              MushroomLib.MushroomData memory mushroomData = resolver.getMushroomData(nftIndex, data);
                                              return mushroomData;
                                          }
                                          function isBurnable(address nftContract, uint256 nftIndex) external view onlyWithMetadataAdapter(nftContract) returns (bool) {
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              return resolver.isBurnable(nftIndex);
                                          }
                                          function setMushroomLifespan(
                                              address nftContract,
                                              uint256 nftIndex,
                                              uint256 lifespan,
                                              bytes calldata data
                                          ) external onlyWithMetadataAdapter(nftContract) onlyLifespanModifier {
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              resolver.setMushroomLifespan(nftIndex, lifespan, data);
                                          }
                                          function setResolver(address nftContract, address resolver) public onlyAdmin {
                                              metadataAdapters[nftContract] = resolver;
                                              emit ResolverSet(nftContract, resolver);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "../../MushroomLib.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      /*
                                          Reads mushroom NFT metadata for a given NFT contract
                                          Also forwards requests from the MetadataResolver to set lifespan
                                      */
                                      abstract contract MetadataAdapter is AccessControlUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          bytes32 public constant LIFESPAN_MODIFY_REQUEST_ROLE = keccak256("LIFESPAN_MODIFY_REQUEST_ROLE");
                                          modifier onlyLifespanModifier() {
                                              require(hasRole(LIFESPAN_MODIFY_REQUEST_ROLE, msg.sender), "onlyLifespanModifier");
                                              _;
                                          }
                                          function getMushroomData(uint256 index, bytes calldata data) external virtual view returns (MushroomLib.MushroomData memory);
                                          function setMushroomLifespan(uint256 index, uint256 lifespan, bytes calldata data) external virtual;
                                          function isBurnable(uint256 index) external view virtual returns (bool);
                                          function isStakeable(uint256 index) external view virtual returns (bool);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      /**
                                       * @title EthVesting
                                       * @dev A eth holder contract that can release its eth balance gradually like a
                                       * typical vesting scheme, with a cliff and vesting period.
                                       */
                                      contract EthVesting {
                                          // The vesting schedule is time-based (i.e. using block timestamps as opposed to e.g. block numbers), and is
                                          // therefore sensitive to timestamp manipulation (which is something miners can do, to a certain degree). Therefore,
                                          // it is recommended to avoid using short time durations (less than a minute). Typical vesting schemes, with a
                                          // cliff period of a year and a duration of four years, are safe to use.
                                          // solhint-disable not-rely-on-time
                                          using SafeMath for uint256;
                                          event EthReleased(uint256 amount);
                                          event EthReleasedBackup(uint256 amount);
                                          event PaymentReceived(address from, uint256 amount);
                                          // beneficiary of tokens after they are released
                                          address payable private _beneficiary;
                                          address payable private _backupBeneficiary;
                                          // Durations and timestamps are expressed in UNIX time, the same units as block.timestamp.
                                          uint256 private _cliff;
                                          uint256 private _start;
                                          uint256 private _duration;
                                          uint256 private _backupReleaseGracePeriod;
                                          uint256 private _released;
                                          /**
                                           * @dev Creates a vesting contract that vests its balance of any ERC20 token to the
                                           * beneficiary, gradually in a linear fashion until start + duration. By then all
                                           * of the balance will have vested.
                                           * @param beneficiary address of the beneficiary to whom vested tokens are transferred
                                           * @param cliffDuration duration in seconds of the cliff in which tokens will begin to vest
                                           * @param start the time (as Unix time) at which point vesting starts
                                           * @param duration duration in seconds of the period in which the tokens will vest
                                           * @param backupReleaseGracePeriod the period after the duration in completed before the backup beneficiary can withdraw
                                           */
                                          constructor (address payable beneficiary, address payable backupBeneficiary, uint256 start, uint256 cliffDuration, uint256 duration, uint256 backupReleaseGracePeriod) public {
                                              require(beneficiary != address(0), "EthVesting: beneficiary is the zero address");
                                              // solhint-disable-next-line max-line-length
                                              require(cliffDuration <= duration, "EthVesting: cliff is longer than duration");
                                              require(duration > 0, "EthVesting: duration is 0");
                                              // solhint-disable-next-line max-line-length
                                              require(start.add(duration) > block.timestamp, "EthVesting: final time is before current time");
                                              _beneficiary = beneficiary;
                                              _backupBeneficiary = backupBeneficiary;
                                              _duration = duration;
                                              _cliff = start.add(cliffDuration);
                                              _start = start;
                                              _backupReleaseGracePeriod = backupReleaseGracePeriod;
                                          }
                                          /**
                                           * @return the beneficiary of the ether.
                                           */
                                          function beneficiary() public view returns (address) {
                                              return _beneficiary;
                                          }
                                          /**
                                           * @return the backup beneficiary of the ether.
                                           */
                                          function backupBeneficiary() public view returns (address) {
                                              return _backupBeneficiary;
                                          }
                                          /**
                                           * @return the period after the duration in completed before the backup beneficiary can withdraw.
                                           */
                                          function backupReleaseGracePeriod() public view returns (uint256) {
                                              return _backupReleaseGracePeriod;
                                          }
                                          /**
                                           * @return the cliff time of the eth vesting.
                                           */
                                          function cliff() public view returns (uint256) {
                                              return _cliff;
                                          }
                                          /**
                                           * @return the start time of the eth vesting.
                                           */
                                          function start() public view returns (uint256) {
                                              return _start;
                                          }
                                          /**
                                           * @return the duration of the eth vesting.
                                           */
                                          function duration() public view returns (uint256) {
                                              return _duration;
                                          }
                                          /**
                                           * @return the amount of the token released.
                                           */
                                          function released() public view returns (uint256) {
                                              return _released;
                                          }
                                          /**
                                           * @notice Transfers vested tokens to beneficiary.
                                           */
                                          function release() public {
                                              uint256 unreleased = _releasableAmount();
                                              require(unreleased > 0, "EthVesting: no eth is due");
                                              _released = _released.add(unreleased);
                                              _beneficiary.transfer(unreleased);
                                              emit EthReleased(unreleased);
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested but hasn't been released yet.
                                           */
                                          function _releasableAmount() private view returns (uint256) {
                                              return _vestedAmount().sub(_released);
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested.
                                           */
                                          function _vestedAmount() private view returns (uint256) {
                                              uint256 currentBalance = address(this).balance;
                                              uint256 totalBalance = currentBalance.add(_released);
                                              if (block.timestamp < _cliff) {
                                                  return 0;
                                              } else if (block.timestamp >= _start.add(_duration)) {
                                                  return totalBalance;
                                              } else {
                                                  return totalBalance.mul(block.timestamp.sub(_start)).div(_duration);
                                              }
                                          }
                                          /**
                                           * @dev After the vesting period is complete, allows for withdrawal by backup beneficiary if funds are unclaimed after the post-duration grace period
                                           */
                                          function backupRelease() public {
                                              require(block.timestamp >= _start.add(_duration).add(_backupReleaseGracePeriod));
                                              _backupBeneficiary.transfer(address(this).balance);
                                              emit EthReleasedBackup(address(this).balance);
                                          }
                                          // Allow Recieve Ether
                                          receive () external payable virtual {
                                              emit PaymentReceived(msg.sender, msg.value);
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Wrappers over Solidity's arithmetic operations with added overflow
                                       * checks.
                                       *
                                       * Arithmetic operations in Solidity wrap on overflow. This can easily result
                                       * in bugs, because programmers usually assume that an overflow raises an
                                       * error, which is the standard behavior in high level programming languages.
                                       * `SafeMath` restores this intuition by reverting the transaction when an
                                       * operation overflows.
                                       *
                                       * Using this library instead of the unchecked operations eliminates an entire
                                       * class of bugs, so it's recommended to use it always.
                                       */
                                      library SafeMath {
                                          /**
                                           * @dev Returns the addition of two unsigned integers, reverting on
                                           * overflow.
                                           *
                                           * Counterpart to Solidity's `+` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Addition cannot overflow.
                                           */
                                          function add(uint256 a, uint256 b) internal pure returns (uint256) {
                                              uint256 c = a + b;
                                              require(c >= a, "SafeMath: addition overflow");
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the subtraction of two unsigned integers, reverting on
                                           * overflow (when the result is negative).
                                           *
                                           * Counterpart to Solidity's `-` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Subtraction cannot overflow.
                                           */
                                          function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return sub(a, b, "SafeMath: subtraction overflow");
                                          }
                                          /**
                                           * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
                                           * overflow (when the result is negative).
                                           *
                                           * Counterpart to Solidity's `-` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Subtraction cannot overflow.
                                           */
                                          function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b <= a, errorMessage);
                                              uint256 c = a - b;
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the multiplication of two unsigned integers, reverting on
                                           * overflow.
                                           *
                                           * Counterpart to Solidity's `*` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Multiplication cannot overflow.
                                           */
                                          function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                                              // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                                              // benefit is lost if 'b' is also tested.
                                              // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
                                              if (a == 0) {
                                                  return 0;
                                              }
                                              uint256 c = a * b;
                                              require(c / a == b, "SafeMath: multiplication overflow");
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the integer division of two unsigned integers. Reverts on
                                           * division by zero. The result is rounded towards zero.
                                           *
                                           * Counterpart to Solidity's `/` operator. Note: this function uses a
                                           * `revert` opcode (which leaves remaining gas untouched) while Solidity
                                           * uses an invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function div(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return div(a, b, "SafeMath: division by zero");
                                          }
                                          /**
                                           * @dev Returns the integer division of two unsigned integers. Reverts with custom message on
                                           * division by zero. The result is rounded towards zero.
                                           *
                                           * Counterpart to Solidity's `/` operator. Note: this function uses a
                                           * `revert` opcode (which leaves remaining gas untouched) while Solidity
                                           * uses an invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b > 0, errorMessage);
                                              uint256 c = a / b;
                                              // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return mod(a, b, "SafeMath: modulo by zero");
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts with custom message when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b != 0, errorMessage);
                                              return a % b;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      import "./EnokiGeyser.sol";
                                      contract GeyserEscrow is Ownable {
                                          EnokiGeyser public geyser;
                                          constructor(EnokiGeyser geyser_) public {
                                              geyser = geyser_;
                                          }
                                          function lockTokens(
                                              uint256 amount,
                                              uint256 durationSec
                                          ) external onlyOwner {
                                              IERC20 distributionToken = geyser.getDistributionToken();
                                              distributionToken.approve(address(geyser), amount);
                                              geyser.lockTokens(amount, durationSec);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "../GSN/Context.sol";
                                      /**
                                       * @dev Contract module which provides a basic access control mechanism, where
                                       * there is an account (an owner) that can be granted exclusive access to
                                       * specific functions.
                                       *
                                       * By default, the owner account will be the one that deploys the contract. This
                                       * can later be changed with {transferOwnership}.
                                       *
                                       * This module is used through inheritance. It will make available the modifier
                                       * `onlyOwner`, which can be applied to your functions to restrict their use to
                                       * the owner.
                                       */
                                      contract Ownable is Context {
                                          address private _owner;
                                          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                                          /**
                                           * @dev Initializes the contract setting the deployer as the initial owner.
                                           */
                                          constructor () internal {
                                              address msgSender = _msgSender();
                                              _owner = msgSender;
                                              emit OwnershipTransferred(address(0), msgSender);
                                          }
                                          /**
                                           * @dev Returns the address of the current owner.
                                           */
                                          function owner() public view returns (address) {
                                              return _owner;
                                          }
                                          /**
                                           * @dev Throws if called by any account other than the owner.
                                           */
                                          modifier onlyOwner() {
                                              require(_owner == _msgSender(), "Ownable: caller is not the owner");
                                              _;
                                          }
                                          /**
                                           * @dev Leaves the contract without owner. It will not be possible to call
                                           * `onlyOwner` functions anymore. Can only be called by the current owner.
                                           *
                                           * NOTE: Renouncing ownership will leave the contract without an owner,
                                           * thereby removing any functionality that is only available to the owner.
                                           */
                                          function renounceOwnership() public virtual onlyOwner {
                                              emit OwnershipTransferred(_owner, address(0));
                                              _owner = address(0);
                                          }
                                          /**
                                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                                           * Can only be called by the current owner.
                                           */
                                          function transferOwnership(address newOwner) public virtual onlyOwner {
                                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                                              emit OwnershipTransferred(_owner, newOwner);
                                              _owner = newOwner;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /*
                                       * @dev Provides information about the current execution context, including the
                                       * sender of the transaction and its data. While these are generally available
                                       * via msg.sender and msg.data, they should not be accessed in such a direct
                                       * manner, since when dealing with GSN meta-transactions the account sending and
                                       * paying for execution may not be the actual sender (as far as an application
                                       * is concerned).
                                       *
                                       * This contract is only required for intermediate, library-like contracts.
                                       */
                                      abstract contract Context {
                                          function _msgSender() internal view virtual returns (address payable) {
                                              return msg.sender;
                                          }
                                          function _msgData() internal view virtual returns (bytes memory) {
                                              this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                                              return msg.data;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface IMiniMe {
                                          /* ========== STANDARD ERC20 ========== */
                                          function totalSupply() external view returns (uint256);
                                          function balanceOf(address account) external view returns (uint256);
                                          function transfer(address recipient, uint256 amount) external returns (bool);
                                          function allowance(address owner, address spender) external view returns (uint256);
                                          function approve(address spender, uint256 amount) external returns (bool);
                                          function transferFrom(
                                              address sender,
                                              address recipient,
                                              uint256 amount
                                          ) external returns (bool);
                                          event Transfer(address indexed from, address indexed to, uint256 value);
                                          event Approval(address indexed owner, address indexed spender, uint256 value);
                                          /* ========== MINIME EXTENSIONS ========== */
                                          function balanceOfAt(address account, uint256 blockNumber) external view returns (uint256);
                                          function totalSupplyAt(uint256 blockNumber) external view returns (uint256);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface IMission  {
                                          function sendSpores(address recipient, uint256 amount) external;
                                          function approvePool(address pool) external;
                                          function revokePool(address pool) external;
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      interface IMushroomFactory  {
                                          function costPerMushroom() external returns (uint256);
                                          function getRemainingMintableForMySpecies(uint256 numMushrooms) external view returns (uint256);
                                          function growMushrooms(address recipient, uint256 numMushrooms) external;
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "../MushroomLib.sol";
                                      abstract contract IMushroomMetadata {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          function hasMetadataAdapter(address nftContract) external virtual view returns (bool);
                                          function getMushroomData(
                                              address nftContract,
                                              uint256 nftIndex,
                                              bytes calldata data
                                          ) external virtual view returns (MushroomLib.MushroomData memory);
                                          function setMushroomLifespan(
                                              address nftContract,
                                              uint256 nftIndex,
                                              uint256 lifespan,
                                              bytes calldata data
                                          ) external virtual;
                                          function setResolver(address nftContract, address resolver) public virtual;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface IRateVoteable {
                                          function changeRate(uint256 percentage) external;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface ISporeToken {
                                          /* ========== STANDARD ERC20 ========== */
                                          function totalSupply() external view returns (uint256);
                                          function balanceOf(address account) external view returns (uint256);
                                          function transfer(address recipient, uint256 amount) external returns (bool);
                                          function allowance(address owner, address spender) external view returns (uint256);
                                          function approve(address spender, uint256 amount) external returns (bool);
                                          function transferFrom(
                                              address sender,
                                              address recipient,
                                              uint256 amount
                                          ) external returns (bool);
                                          event Transfer(address indexed from, address indexed to, uint256 value);
                                          event Approval(address indexed owner, address indexed spender, uint256 value);
                                          /* ========== EXTENSIONS ========== */
                                          function burn(uint256 amount) external;
                                          function mint(address to, uint256 amount) external;
                                          function addInitialLiquidityTransferRights(address account) external;
                                          function enableTransfers() external;
                                          function addMinter(address account) external;
                                          function removeMinter(address account) external;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      abstract contract ITokenPool {
                                          function token() external virtual view returns (IERC20);
                                          function balance() external virtual view returns (uint256);
                                          function transfer(address to, uint256 value) external virtual returns (bool);
                                          function rescueFunds(address tokenToRescue, address to, uint256 amount) external virtual returns (bool);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "../../MushroomNFT.sol";
                                      import "../../MushroomLib.sol";
                                      import "./MetadataAdapter.sol";
                                      /*
                                          Reads mushroom NFT metadata directly from the Mushroom NFT contract
                                          Also forwards requests from the MetadataResolver to a given forwarder, that cannot be modified
                                      */
                                      contract MushroomAdapter is Initializable, MetadataAdapter {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          MushroomNFT public mushroomNft;
                                          function initialize(address nftContract_, address forwardActionsFrom_) public initializer {
                                              mushroomNft = MushroomNFT(nftContract_);
                                              _setupRole(LIFESPAN_MODIFY_REQUEST_ROLE, forwardActionsFrom_);
                                          }
                                          function getMushroomData(uint256 index, bytes calldata data) external override view returns (MushroomLib.MushroomData memory) {
                                              MushroomLib.MushroomData memory mData = mushroomNft.getMushroomData(index);
                                              return mData;
                                          }
                                          // Mushrooms can always be staked
                                          function isStakeable(uint256 nftIndex) external override view returns (bool) {
                                              return true;
                                          }
                                          // All Mushrooms are burnable
                                          function isBurnable(uint256 index) external override view returns (bool) {
                                              return true;
                                          }
                                          function setMushroomLifespan(
                                              uint256 index,
                                              uint256 lifespan,
                                              bytes calldata data
                                          ) external override onlyLifespanModifier {
                                              mushroomNft.setMushroomLifespan(index, lifespan);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
                                      /*
                                          A pool of spores that can be takens by Spore pools according to their spore rate
                                      */
                                      contract Mission is Initializable, OwnableUpgradeSafe {
                                          IERC20 public sporeToken;
                                          mapping (address => bool) public approved;
                                          event SporesHarvested(address pool, uint256 amount);
                                          modifier onlyApprovedPool() {
                                              require(approved[msg.sender], "Mission: Only approved pools");
                                              _;
                                          }
                                          function initialize(IERC20 sporeToken_) public initializer {
                                              __Ownable_init();
                                              sporeToken = sporeToken_;
                                          }
                                          function sendSpores(address recipient, uint256 amount) public onlyApprovedPool {
                                              sporeToken.transfer(recipient, amount);
                                              emit SporesHarvested(msg.sender, amount);
                                          }
                                          function approvePool(address pool) public onlyOwner {
                                              approved[pool] = true;
                                          }
                                          function revokePool(address pool) public onlyOwner {
                                              approved[pool] = false;
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Interface of the ERC20 standard as defined in the EIP.
                                       */
                                      interface IERC20 {
                                          /**
                                           * @dev Returns the amount of tokens in existence.
                                           */
                                          function totalSupply() external view returns (uint256);
                                          /**
                                           * @dev Returns the amount of tokens owned by `account`.
                                           */
                                          function balanceOf(address account) external view returns (uint256);
                                          /**
                                           * @dev Moves `amount` tokens from the caller's account to `recipient`.
                                           *
                                           * Returns a boolean value indicating whether the operation succeeded.
                                           *
                                           * Emits a {Transfer} event.
                                           */
                                          function transfer(address recipient, uint256 amount) external returns (bool);
                                          /**
                                           * @dev Returns the remaining number of tokens that `spender` will be
                                           * allowed to spend on behalf of `owner` through {transferFrom}. This is
                                           * zero by default.
                                           *
                                           * This value changes when {approve} or {transferFrom} are called.
                                           */
                                          function allowance(address owner, address spender) external view returns (uint256);
                                          /**
                                           * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
                                           *
                                           * Returns a boolean value indicating whether the operation succeeded.
                                           *
                                           * IMPORTANT: Beware that changing an allowance with this method brings the risk
                                           * that someone may use both the old and the new allowance by unfortunate
                                           * transaction ordering. One possible solution to mitigate this race
                                           * condition is to first reduce the spender's allowance to 0 and set the
                                           * desired value afterwards:
                                           * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                                           *
                                           * Emits an {Approval} event.
                                           */
                                          function approve(address spender, uint256 amount) external returns (bool);
                                          /**
                                           * @dev Moves `amount` tokens from `sender` to `recipient` using the
                                           * allowance mechanism. `amount` is then deducted from the caller's
                                           * allowance.
                                           *
                                           * Returns a boolean value indicating whether the operation succeeded.
                                           *
                                           * Emits a {Transfer} event.
                                           */
                                          function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
                                          /**
                                           * @dev Emitted when `value` tokens are moved from one account (`from`) to
                                           * another (`to`).
                                           *
                                           * Note that `value` may be zero.
                                           */
                                          event Transfer(address indexed from, address indexed to, uint256 value);
                                          /**
                                           * @dev Emitted when the allowance of a `spender` for an `owner` is set by
                                           * a call to {approve}. `value` is the new allowance.
                                           */
                                          event Approval(address indexed owner, address indexed spender, uint256 value);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "./MushroomNFT.sol";
                                      import "./MushroomLib.sol";
                                      /*
                                          MushroomFactories manage the mushroom generation logic for pools
                                          Each pool will have it's own factory to generate mushrooms according
                                          to its' powers.
                                          The mushroomFactory should be administered by the pool, which grants the ability to grow mushrooms
                                      */
                                      contract MushroomFactory is Initializable, OwnableUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          using SafeMath for uint256;
                                          event MushroomGrown(address recipient, uint256 id, uint256 species, uint256 lifespan);
                                          IERC20 public sporeToken;
                                          MushroomNFT public mushroomNft;
                                          uint256 public costPerMushroom;
                                          uint256 public mySpecies;
                                          uint256 public spawnCount;
                                          function initialize(
                                              IERC20 sporeToken_,
                                              MushroomNFT mushroomNft_,
                                              address sporePool_,
                                              uint256 costPerMushroom_,
                                              uint256 mySpecies_
                                          ) public initializer {
                                              __Ownable_init();
                                              sporeToken = sporeToken_;
                                              mushroomNft = mushroomNft_;
                                              costPerMushroom = costPerMushroom_;
                                              mySpecies = mySpecies_;
                                              transferOwnership(sporePool_);
                                          }
                                          /*
                                              Each mushroom will have a randomly generated lifespan within it's range. To prevent mushrooms harvested at the same block from having the same properties, a spawnCount seed is added to the block timestamp before hashing the timestamp to generate the lifespan for each individual mushroom.
                                              Note that block.timestamp is somewhat manipulatable by Miners. If a Miner was a massive ENOKI fan and only harvested when the mined a block they could give themselves mushrooms with longer lifespan than the average. However, the lifespan is still constained by the max lifespan. 
                                          */
                                          function _generateMushroomLifespan(uint256 minLifespan, uint256 maxLifespan) internal returns (uint256) {
                                              uint256 range = maxLifespan.sub(minLifespan);
                                              uint256 fromMin = uint256(keccak256(abi.encodePacked(block.timestamp.add(spawnCount)))) % range;
                                              spawnCount = spawnCount.add(1);
                                              return minLifespan.add(fromMin);
                                          }
                                          function getRemainingMintableForMySpecies() public view returns (uint256) {
                                              return mushroomNft.getRemainingMintableForSpecies(mySpecies);
                                          }
                                          // Each mushroom costs 1/10th of the spore rate in spores.
                                          function growMushrooms(address recipient, uint256 numMushrooms) public onlyOwner {
                                              MushroomLib.MushroomType memory species = mushroomNft.getSpecies(mySpecies);
                                              require(getRemainingMintableForMySpecies() >= numMushrooms, "MushroomFactory: Mushrooms to grow exceeds species cap");
                                              for (uint256 i = 0; i < numMushrooms; i++) {
                                                  uint256 nextId = mushroomNft.totalSupply().add(1);
                                                  uint256 lifespan = _generateMushroomLifespan(species.minLifespan, species.maxLifespan);
                                                  mushroomNft.mint(recipient, nextId, mySpecies, lifespan);
                                                  emit MushroomGrown(recipient, nextId, mySpecies, lifespan);
                                              }
                                          }
                                      }pragma solidity ^0.6.0;
                                      import "./IERC20.sol";
                                      import "../../math/SafeMath.sol";
                                      import "../../utils/Address.sol";
                                      /**
                                       * @title SafeERC20
                                       * @dev Wrappers around ERC20 operations that throw on failure (when the token
                                       * contract returns false). Tokens that return no value (and instead revert or
                                       * throw on failure) are also supported, non-reverting calls are assumed to be
                                       * successful.
                                       * To use this library you can add a `using SafeERC20 for ERC20;` statement to your contract,
                                       * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
                                       */
                                      library SafeERC20 {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          function safeTransfer(IERC20 token, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
                                          }
                                          function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
                                          }
                                          function safeApprove(IERC20 token, address spender, uint256 value) internal {
                                              // safeApprove should only be called when setting an initial allowance,
                                              // or when resetting it to zero. To increase and decrease it, use
                                              // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                                              // solhint-disable-next-line max-line-length
                                              require((value == 0) || (token.allowance(address(this), spender) == 0),
                                                  "SafeERC20: approve from non-zero to non-zero allowance"
                                              );
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
                                          }
                                          function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).add(value);
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          /**
                                           * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                                           * on the return value: the return value is optional (but if data is returned, it must not be false).
                                           * @param token The token targeted by the call.
                                           * @param data The call data (encoded using abi.encode or one of its variants).
                                           */
                                          function _callOptionalReturn(IERC20 token, bytes memory data) private {
                                              // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                                              // we're implementing it ourselves.
                                              // A Solidity high level call has three parts:
                                              //  1. The target address is checked to verify it contains contract code
                                              //  2. The call itself is made, and success asserted
                                              //  3. The return value is decoded, which in turn checks the size of the returned data.
                                              // solhint-disable-next-line max-line-length
                                              require(address(token).isContract(), "SafeERC20: call to non-contract");
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, bytes memory returndata) = address(token).call(data);
                                              require(success, "SafeERC20: low-level call failed");
                                              if (returndata.length > 0) { // Return data is optional
                                                  // solhint-disable-next-line max-line-length
                                                  require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                                              }
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/GSN/Context.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      /**
                                       * @title PaymentSplitter
                                       * @dev This contract allows to split Ether payments among a group of accounts. The sender does not need to be aware
                                       * that the Ether will be split in this way, since it is handled transparently by the contract.
                                       *
                                       * The split can be in equal parts or in any other arbitrary proportion. The way this is specified is by assigning each
                                       * account to a number of shares. Of all the Ether that this contract receives, each account will then be able to claim
                                       * an amount proportional to the percentage of total shares they were assigned.
                                       *
                                       * `PaymentSplitter` follows a _pull payment_ model. This means that payments are not automatically forwarded to the
                                       * accounts but kept in this contract, and the actual transfer is triggered as a separate step by calling the {release}
                                       * function.
                                       */
                                      contract PaymentSplitter is Context {
                                          using SafeMath for uint256;
                                          event PayeeAdded(address account, uint256 shares);
                                          event PaymentReleased(address to, uint256 amount);
                                          event PaymentReceived(address from, uint256 amount);
                                          uint256 private _totalShares;
                                          uint256 private _totalReleased;
                                          mapping(address => uint256) private _shares;
                                          mapping(address => uint256) private _released;
                                          address[] private _payees;
                                          /**
                                           * @dev Creates an instance of `PaymentSplitter` where each account in `payees` is assigned the number of shares at
                                           * the matching position in the `shares` array.
                                           *
                                           * All addresses in `payees` must be non-zero. Both arrays must have the same non-zero length, and there must be no
                                           * duplicates in `payees`.
                                           */
                                          constructor (address[] memory payees, uint256[] memory shares) public payable {
                                              // solhint-disable-next-line max-line-length
                                              require(payees.length == shares.length, "PaymentSplitter: payees and shares length mismatch");
                                              require(payees.length > 0, "PaymentSplitter: no payees");
                                              for (uint256 i = 0; i < payees.length; i++) {
                                                  _addPayee(payees[i], shares[i]);
                                              }
                                          }
                                          /**
                                           * @dev The Ether received will be logged with {PaymentReceived} events. Note that these events are not fully
                                           * reliable: it's possible for a contract to receive Ether without triggering this function. This only affects the
                                           * reliability of the events, and not the actual splitting of Ether.
                                           *
                                           * To learn more about this see the Solidity documentation for
                                           * https://solidity.readthedocs.io/en/latest/contracts.html#fallback-function[fallback
                                           * functions].
                                           */
                                          receive () external payable virtual {
                                              emit PaymentReceived(_msgSender(), msg.value);
                                          }
                                          /**
                                           * @dev Getter for the total shares held by payees.
                                           */
                                          function totalShares() public view returns (uint256) {
                                              return _totalShares;
                                          }
                                          /**
                                           * @dev Getter for the total amount of Ether already released.
                                           */
                                          function totalReleased() public view returns (uint256) {
                                              return _totalReleased;
                                          }
                                          /**
                                           * @dev Getter for the amount of shares held by an account.
                                           */
                                          function shares(address account) public view returns (uint256) {
                                              return _shares[account];
                                          }
                                          /**
                                           * @dev Getter for the amount of Ether already released to a payee.
                                           */
                                          function released(address account) public view returns (uint256) {
                                              return _released[account];
                                          }
                                          /**
                                           * @dev Getter for the address of the payee number `index`.
                                           */
                                          function payee(uint256 index) public view returns (address) {
                                              return _payees[index];
                                          }
                                          /**
                                           * @dev Triggers a transfer to `account` of the amount of Ether they are owed, according to their percentage of the
                                           * total shares and their previous withdrawals.
                                           */
                                          function release(address payable account) public virtual {
                                              require(_shares[account] > 0, "PaymentSplitter: account has no shares");
                                              uint256 totalReceived = address(this).balance.add(_totalReleased);
                                              uint256 payment = totalReceived.mul(_shares[account]).div(_totalShares).sub(_released[account]);
                                              require(payment != 0, "PaymentSplitter: account is not due payment");
                                              _released[account] = _released[account].add(payment);
                                              _totalReleased = _totalReleased.add(payment);
                                              account.transfer(payment);
                                              emit PaymentReleased(account, payment);
                                          }
                                          /**
                                           * @dev Add a new payee to the contract.
                                           * @param account The address of the payee to add.
                                           * @param shares_ The number of shares owned by the payee.
                                           */
                                          function _addPayee(address account, uint256 shares_) private {
                                              require(account != address(0), "PaymentSplitter: account is the zero address");
                                              require(shares_ > 0, "PaymentSplitter: shares are 0");
                                              require(_shares[account] == 0, "PaymentSplitter: account already has shares");
                                              _payees.push(account);
                                              _shares[account] = shares_;
                                              _totalShares = _totalShares.add(shares_);
                                              emit PayeeAdded(account, shares_);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/Math.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/ReentrancyGuard.sol";
                                      import "./Defensible.sol";
                                      import "./interfaces/IMiniMe.sol";
                                      import "./interfaces/ISporeToken.sol";
                                      import "./interfaces/IRateVoteable.sol";
                                      import "./BannedContractList.sol";
                                      /*
                                          Can be paused by the owner
                                          The mushroomFactory must be set by the owner before mushrooms can be harvested (optionally), and can be modified to use new mushroom spawning logic
                                      */
                                      contract RateVote is ReentrancyGuardUpgradeSafe, Defensible {
                                          using SafeMath for uint256;
                                          /* ========== STATE VARIABLES ========== */
                                          uint256 public constant MAX_PERCENTAGE = 100;
                                          uint256 public votingEnabledTime;
                                          mapping(address => uint256) lastVoted;
                                          struct VoteEpoch {
                                              uint256 startTime;
                                              uint256 activeEpoch;
                                              uint256 increaseVoteWeight;
                                              uint256 decreaseVoteWeight;
                                          }
                                          VoteEpoch public voteEpoch;
                                          uint256 public voteDuration;
                                          IMiniMe public enokiToken;
                                          IRateVoteable public pool;
                                          BannedContractList public bannedContractList;
                                          // In percentage: mul(X).div(100)
                                          uint256 public decreaseRateMultiplier;
                                          uint256 public increaseRateMultiplier;
                                          /* ========== CONSTRUCTOR ========== */
                                          function initialize(
                                              address _pool,
                                              address _enokiToken,
                                              uint256 _voteDuration,
                                              uint256 _votingEnabledTime,
                                              address _bannedContractList
                                          ) public virtual initializer {
                                              __ReentrancyGuard_init();
                                              pool = IRateVoteable(_pool);
                                              decreaseRateMultiplier = 50;
                                              increaseRateMultiplier = 150;
                                              votingEnabledTime = _votingEnabledTime;
                                              voteDuration = _voteDuration;
                                              enokiToken = IMiniMe(_enokiToken);
                                              voteEpoch = VoteEpoch({
                                                  startTime: votingEnabledTime, 
                                                  activeEpoch: 0, 
                                                  increaseVoteWeight: 0, 
                                                  decreaseVoteWeight: 0
                                              });
                                              bannedContractList = BannedContractList(_bannedContractList);
                                          }
                                          /*
                                              Votes with a given nonce invalidate other votes with the same nonce
                                              This ensures only one rate vote can pass for a given time period
                                          */
                                          function getVoteEpoch() external view returns (VoteEpoch memory) {
                                              return voteEpoch;
                                          }
                                          /* === Actions === */
                                          /// @notice Any user can vote once in a given voting epoch, with their balance at the start of the epoch
                                          function vote(uint256 voteId) external nonReentrant defend(bannedContractList) {
                                              require(now > votingEnabledTime, "Too early");
                                              require(now <= voteEpoch.startTime.add(voteDuration), "Vote has ended");
                                              require(lastVoted[msg.sender] < voteEpoch.activeEpoch, "Already voted");
                                              uint256 userWeight = enokiToken.balanceOfAt(msg.sender, voteEpoch.startTime);
                                              if (voteId == 0) {
                                                  // Decrease rate
                                                  voteEpoch.decreaseVoteWeight = voteEpoch.decreaseVoteWeight.add(userWeight);
                                              } else if (voteId == 1) {
                                                  // Increase rate
                                                  voteEpoch.increaseVoteWeight = voteEpoch.increaseVoteWeight.add(userWeight);
                                              } else {
                                                  revert("Invalid voteId");
                                              }
                                              lastVoted[msg.sender] = voteEpoch.activeEpoch;
                                              emit Vote(msg.sender, voteEpoch.activeEpoch, userWeight, voteId);
                                          }
                                          /// @notice Once a vote has exceeded the duration, it can be resolved, implementing the decision and starting the next vote    
                                          function resolveVote() external nonReentrant defend(bannedContractList) {
                                              require(now >= voteEpoch.startTime.add(voteDuration), "Vote still active");
                                              uint256 decision = 0;
                                              if (voteEpoch.decreaseVoteWeight > voteEpoch.increaseVoteWeight) {
                                                  // Decrease wins
                                                  pool.changeRate(decreaseRateMultiplier);
                                              } else if (voteEpoch.increaseVoteWeight > voteEpoch.decreaseVoteWeight) {
                                                  // Increase wins
                                                  pool.changeRate(increaseRateMultiplier);
                                                  decision = 1;
                                              } else {
                                                  //else Tie, no rate change
                                                  decision = 2;
                                              }
                                              emit VoteResolved(voteEpoch.activeEpoch, decision);
                                              voteEpoch.activeEpoch = voteEpoch.activeEpoch.add(1);
                                              voteEpoch.decreaseVoteWeight = 0;
                                              voteEpoch.increaseVoteWeight = 0;
                                              voteEpoch.startTime = now;
                                              emit VoteStarted(voteEpoch.activeEpoch, voteEpoch.startTime, voteEpoch.startTime.add(voteDuration));
                                          }
                                          /* ===Events=== */
                                          event Vote(address indexed user, uint256 indexed epoch, uint256 weight, uint256 indexed vote);
                                          event VoteResolved(uint256 indexed epoch, uint256 indexed decision);
                                          event VoteStarted(uint256 indexed epoch, uint256 startTime, uint256 endTime);
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Standard math utilities missing in the Solidity language.
                                       */
                                      library Math {
                                          /**
                                           * @dev Returns the largest of two numbers.
                                           */
                                          function max(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a >= b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the smallest of two numbers.
                                           */
                                          function min(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a < b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the average of two numbers. The result is rounded towards
                                           * zero.
                                           */
                                          function average(uint256 a, uint256 b) internal pure returns (uint256) {
                                              // (a + b) / 2 can overflow, so we distribute
                                              return (a / 2) + (b / 2) + ((a % 2 + b % 2) / 2);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/Math.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/ReentrancyGuard.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/Pausable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "./Defensible.sol";
                                      import "./interfaces/IMushroomFactory.sol";
                                      import "./interfaces/IMission.sol";
                                      import "./interfaces/IMiniMe.sol";
                                      import "./interfaces/ISporeToken.sol";
                                      import "./BannedContractList.sol";
                                      /*
                                          Staking can be paused by the owner (withdrawing & harvesting cannot be paused)
                                          
                                          The mushroomFactory must be set by the owner before mushrooms can be harvested (optionally)
                                          It and can be modified, to use new mushroom spawning logic
                                          The rateVote contract has control over the spore emission rate. 
                                          It can be modified, to change the voting logic around rate changes.
                                      */
                                      contract SporePool is OwnableUpgradeSafe, ReentrancyGuardUpgradeSafe, PausableUpgradeSafe, Defensible {
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          /* ========== STATE VARIABLES ========== */
                                          ISporeToken public sporeToken;
                                          IERC20 public stakingToken;
                                          uint256 public sporesPerSecond = 0;
                                          uint256 public lastUpdateTime;
                                          uint256 public rewardPerTokenStored;
                                          uint256 public constant MAX_PERCENTAGE = 100;
                                          uint256 public devRewardPercentage;
                                          address public devRewardAddress;
                                          mapping(address => uint256) public userRewardPerTokenPaid;
                                          mapping(address => uint256) public rewards;
                                          uint256 internal _totalSupply;
                                          mapping(address => uint256) internal _balances;
                                          IMushroomFactory public mushroomFactory;
                                          IMission public mission;
                                          BannedContractList public bannedContractList;
                                          uint256 public stakingEnabledTime;
                                          address public rateVote;
                                          IMiniMe public enokiToken;
                                          address public enokiDaoAgent;
                                          
                                          /* ========== CONSTRUCTOR ========== */
                                          function initialize(
                                              address _sporeToken,
                                              address _stakingToken,
                                              address _mission,
                                              address _bannedContractList,
                                              address _devRewardAddress,
                                              address _enokiDaoAgent,
                                              uint256[3] memory uintParams
                                          ) public virtual initializer {
                                              __Context_init_unchained();
                                              __Pausable_init_unchained();
                                              __ReentrancyGuard_init_unchained();
                                              __Ownable_init_unchained();
                                              sporeToken = ISporeToken(_sporeToken);
                                              stakingToken = IERC20(_stakingToken);
                                              mission = IMission(_mission);
                                              bannedContractList = BannedContractList(_bannedContractList);
                                              /*
                                                  [0] uint256 _devRewardPercentage,
                                                  [1] uint256 stakingEnabledTime_,
                                                  [2] uint256 initialRewardRate_,
                                              */
                                              devRewardPercentage = uintParams[0];
                                              devRewardAddress = _devRewardAddress;
                                              stakingEnabledTime = uintParams[1];
                                              sporesPerSecond = uintParams[2];
                                              enokiDaoAgent = _enokiDaoAgent;
                                              emit SporeRateChange(sporesPerSecond);
                                          }
                                          /* ========== VIEWS ========== */
                                          function totalSupply() external view returns (uint256) {
                                              return _totalSupply;
                                          }
                                          function balanceOf(address account) external view returns (uint256) {
                                              return _balances[account];
                                          }
                                          // Rewards are turned off at the mission level
                                          function lastTimeRewardApplicable() public view returns (uint256) {
                                              return block.timestamp;
                                          }
                                          function rewardPerToken() public view returns (uint256) {
                                              if (_totalSupply == 0) {
                                                  return rewardPerTokenStored;
                                              }
                                              // Time difference * sporesPerSecond
                                              return rewardPerTokenStored.add(lastTimeRewardApplicable().sub(lastUpdateTime).mul(sporesPerSecond).mul(1e18).div(_totalSupply));
                                          }
                                          function earned(address account) public view returns (uint256) {
                                              return _balances[account].mul(rewardPerToken().sub(userRewardPerTokenPaid[account])).div(1e18).add(rewards[account]);
                                          }
                                          /* ========== MUTATIVE FUNCTIONS ========== */
                                          function stake(uint256 amount) external virtual nonReentrant defend(bannedContractList) whenNotPaused updateReward(msg.sender) {
                                              require(amount > 0, "Cannot stake 0");
                                              require(now > stakingEnabledTime, "Cannot stake before staking enabled");
                                              _totalSupply = _totalSupply.add(amount);
                                              _balances[msg.sender] = _balances[msg.sender].add(amount);
                                              stakingToken.safeTransferFrom(msg.sender, address(this), amount);
                                              emit Staked(msg.sender, amount);
                                          }
                                          // Withdrawing does not harvest, the rewards must be harvested separately
                                          function withdraw(uint256 amount) public virtual updateReward(msg.sender) {
                                              require(amount > 0, "Cannot withdraw 0");
                                              _totalSupply = _totalSupply.sub(amount);
                                              _balances[msg.sender] = _balances[msg.sender].sub(amount);
                                              stakingToken.safeTransfer(msg.sender, amount);
                                              emit Withdrawn(msg.sender, amount);
                                          }
                                          function harvest(uint256 mushroomsToGrow)
                                              public
                                              nonReentrant
                                              updateReward(msg.sender)
                                              returns (
                                                  uint256 toDev,
                                                  uint256 toDao,
                                                  uint256 remainingReward
                                              )
                                          {
                                              uint256 reward = rewards[msg.sender];
                                              if (reward > 0) {
                                                  remainingReward = reward;
                                                  toDev = 0;
                                                  toDao = 0;
                                                  rewards[msg.sender] = 0;
                                                  // Burn some rewards for mushrooms if desired
                                                  if (mushroomsToGrow > 0) {
                                                      uint256 totalCost = mushroomFactory.costPerMushroom().mul(mushroomsToGrow);
                                                      require(reward >= totalCost, "Not enough rewards to grow the number of mushrooms specified");
                                                      toDev = totalCost.mul(devRewardPercentage).div(MAX_PERCENTAGE);
                                                      if (toDev > 0) {
                                                          mission.sendSpores(devRewardAddress, toDev);
                                                          emit DevRewardPaid(devRewardAddress, toDev);
                                                      }
                                                      toDao = totalCost.sub(toDev);
                                                      mission.sendSpores(enokiDaoAgent, toDao);
                                                      emit DaoRewardPaid(enokiDaoAgent, toDao);
                                                      remainingReward = reward.sub(totalCost);
                                                      mushroomFactory.growMushrooms(msg.sender, mushroomsToGrow);
                                                      emit MushroomsGrown(msg.sender, mushroomsToGrow);
                                                  }
                                                  if (remainingReward > 0) {
                                                      mission.sendSpores(msg.sender, remainingReward);
                                                      emit RewardPaid(msg.sender, remainingReward);
                                                  }
                                              }
                                          }
                                          // Withdraw, forfietting all rewards
                                          function emergencyWithdraw() external nonReentrant {
                                              withdraw(_balances[msg.sender]);
                                          }
                                          /* ========== RESTRICTED FUNCTIONS ========== */
                                          // Added to support recovering LP Rewards from other systems such as BAL to be distributed to holders
                                          function recoverERC20(address tokenAddress, uint256 tokenAmount) external onlyOwner {
                                              // Cannot recover the staking token or the rewards token
                                              require(tokenAddress != address(stakingToken) && tokenAddress != address(sporeToken), "Cannot withdraw the staking or rewards tokens");
                                              //TODO: Add safeTransfer
                                              IERC20(tokenAddress).transfer(owner(), tokenAmount);
                                              emit Recovered(tokenAddress, tokenAmount);
                                          }
                                          function setMushroomFactory(address mushroomFactory_) external onlyOwner {
                                              mushroomFactory = IMushroomFactory(mushroomFactory_);
                                          }
                                          function pauseStaking() external onlyOwner {
                                              _pause();
                                          }
                                          function unpauseStaking() external onlyOwner {
                                              _unpause();
                                          }
                                          function setRateVote(address _rateVote) external onlyOwner {
                                              rateVote = _rateVote;
                                          }
                                          function changeRate(uint256 percentage) external onlyRateVote {
                                              sporesPerSecond = sporesPerSecond.mul(percentage).div(MAX_PERCENTAGE);
                                              emit SporeRateChange(sporesPerSecond);
                                          }
                                          /* ========== MODIFIERS ========== */
                                          modifier updateReward(address account) {
                                              rewardPerTokenStored = rewardPerToken();
                                              lastUpdateTime = lastTimeRewardApplicable();
                                              if (account != address(0)) {
                                                  rewards[account] = earned(account);
                                                  userRewardPerTokenPaid[account] = rewardPerTokenStored;
                                              }
                                              _;
                                          }
                                          modifier onlyRateVote() {
                                              require(msg.sender == rateVote, "onlyRateVote");
                                              _;
                                          }
                                          /* ========== EVENTS ========== */
                                          event RewardAdded(uint256 reward);
                                          event Staked(address indexed user, uint256 amount);
                                          event Withdrawn(address indexed user, uint256 amount);
                                          event RewardPaid(address indexed user, uint256 reward);
                                          event DevRewardPaid(address indexed user, uint256 reward);
                                          event DaoRewardPaid(address indexed user, uint256 reward);
                                          event MushroomsGrown(address indexed user, uint256 number);
                                          event Recovered(address token, uint256 amount);
                                          event SporeRateChange(uint256 newRate);
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../GSN/Context.sol";
                                      import "../Initializable.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.
                                       */
                                      contract PausableUpgradeSafe is Initializable, ContextUpgradeSafe {
                                          /**
                                           * @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.
                                           */
                                          function __Pausable_init() internal initializer {
                                              __Context_init_unchained();
                                              __Pausable_init_unchained();
                                          }
                                          function __Pausable_init_unchained() internal initializer {
                                              _paused = false;
                                          }
                                          /**
                                           * @dev Returns true if the contract is paused, and false otherwise.
                                           */
                                          function paused() public view returns (bool) {
                                              return _paused;
                                          }
                                          /**
                                           * @dev Modifier to make a function callable only when the contract is not paused.
                                           */
                                          modifier whenNotPaused() {
                                              require(!_paused, "Pausable: paused");
                                              _;
                                          }
                                          /**
                                           * @dev Modifier to make a function callable only when the contract is paused.
                                           */
                                          modifier whenPaused() {
                                              require(_paused, "Pausable: not paused");
                                              _;
                                          }
                                          /**
                                           * @dev Triggers stopped state.
                                           */
                                          function _pause() internal virtual whenNotPaused {
                                              _paused = true;
                                              emit Paused(_msgSender());
                                          }
                                          /**
                                           * @dev Returns to normal state.
                                           */
                                          function _unpause() internal virtual whenPaused {
                                              _paused = false;
                                              emit Unpaused(_msgSender());
                                          }
                                          uint256[49] private __gap;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "./SporePool.sol";
                                      /*
                                          ETH Variant of SporePool
                                      */
                                      contract SporePoolEth is SporePool {
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          /* ========== CONSTRUCTOR ========== */
                                          function initialize(
                                              address _sporeToken,
                                              address _stakingToken,
                                              address _mission,
                                              address _bannedContractList,
                                              address _devRewardAddress,
                                              address _enokiDaoAgent,
                                              uint256[3] memory uintParams
                                          ) public override initializer {
                                              __Context_init_unchained();
                                              __Pausable_init_unchained();
                                              __ReentrancyGuard_init_unchained();
                                              __Ownable_init_unchained();
                                              sporeToken = ISporeToken(_sporeToken);
                                              mission = IMission(_mission);
                                              bannedContractList = BannedContractList(_bannedContractList);
                                              /*
                                                  [0] uint256 _devRewardPercentage,
                                                  [1] uint256 stakingEnabledTime_,
                                                  [2] uint256 initialRewardRate_,
                                              */
                                              devRewardPercentage = uintParams[0];
                                              devRewardAddress = _devRewardAddress;
                                              stakingEnabledTime = uintParams[1];
                                              sporesPerSecond = uintParams[2];
                                              enokiDaoAgent = _enokiDaoAgent;
                                              emit SporeRateChange(sporesPerSecond);
                                          }
                                          /* ========== MUTATIVE FUNCTIONS ========== */
                                          function stake(uint256 amount) external override nonReentrant defend(bannedContractList) whenNotPaused updateReward(msg.sender) {
                                              revert("Use stakeEth function for ETH variant");
                                          }
                                          function stakeEth(uint256 amount) external payable nonReentrant defend(bannedContractList) whenNotPaused updateReward(msg.sender) {
                                              require(amount > 0, "Cannot stake 0");
                                              require(msg.value == amount, "Incorrect ETH transfer amount");
                                              require(now > stakingEnabledTime, "Cannot stake before staking enabled");
                                              _totalSupply = _totalSupply.add(amount);
                                              _balances[msg.sender] = _balances[msg.sender].add(amount);
                                              emit Staked(msg.sender, amount);
                                          }
                                          function withdraw(uint256 amount) public override updateReward(msg.sender) {
                                              require(amount > 0, "Cannot withdraw 0");
                                              _totalSupply = _totalSupply.sub(amount);
                                              _balances[msg.sender] = _balances[msg.sender].sub(amount);
                                              msg.sender.transfer(amount);
                                              emit Withdrawn(msg.sender, amount);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts/math/Math.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
                                      import "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
                                      import "./SporeToken.sol";
                                      contract SporePresale is Ownable {
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          mapping(address => bool) public whitelist;
                                          mapping(address => uint256) public ethSupply;
                                          uint256 public whitelistCount;
                                          address payable devAddress;
                                          uint256 public sporePrice = 25;
                                          uint256 public buyLimit = 3 * 1e18;
                                          bool public presaleStart = false;
                                          bool public onlyWhitelist = true;
                                          uint256 public presaleLastSupply = 15000 * 1e18;
                                          SporeToken public spore;
                                          event BuySporeSuccess(address account, uint256 ethAmount, uint256 sporeAmount);
                                          constructor(address payable devAddress_, SporeToken sporeToken_) public {
                                              devAddress = devAddress_;
                                              spore = sporeToken_;
                                          }
                                          function addToWhitelist(address[] memory accounts) public onlyOwner {
                                              for (uint256 i = 0; i < accounts.length; i++) {
                                                  address account = accounts[i];
                                                  require(whitelist[account] == false, "This account is already in whitelist.");
                                                  whitelist[account] = true;
                                                  whitelistCount = whitelistCount + 1;
                                              }
                                          }
                                          function removeFromWhitelist(address[] memory accounts) public onlyOwner {
                                              for (uint256 i = 0; i < accounts.length; i++) {
                                                  address account = accounts[i];
                                                  require(whitelist[account], "This account is not in whitelist.");
                                                  whitelist[account] = false;
                                                  whitelistCount = whitelistCount - 1;
                                              }
                                          }
                                          function getDevAddress() public view returns (address) {
                                              return address(devAddress);
                                          }
                                          function setDevAddress(address payable account) public onlyOwner {
                                              devAddress = account;
                                          }
                                          function startPresale() public onlyOwner {
                                              presaleStart = true;
                                          }
                                          function stopPresale() public onlyOwner {
                                              presaleStart = false;
                                          }
                                          function setSporePrice(uint256 newPrice) public onlyOwner {
                                              sporePrice = newPrice;
                                          }
                                          function setBuyLimit(uint256 newLimit) public onlyOwner {
                                              buyLimit = newLimit;
                                          }
                                          function changeToNotOnlyWhitelist() public onlyOwner {
                                              onlyWhitelist = false;
                                          }
                                          modifier needHaveLastSupply() {
                                              require(presaleLastSupply >= 0, "Oh you are so late.");
                                              _;
                                          }
                                          modifier presaleHasStarted() {
                                              require(presaleStart, "Presale has not been started.");
                                              _;
                                          }
                                          receive() external payable presaleHasStarted needHaveLastSupply {
                                              if (onlyWhitelist) {
                                                  require(whitelist[msg.sender], "This time is only for people who are in whitelist.");
                                              }
                                              uint256 ethTotalAmount = ethSupply[msg.sender].add(msg.value);
                                              require(ethTotalAmount <= buyLimit, "Everyone should buy less than 3 eth.");
                                              uint256 sporeAmount = msg.value.mul(sporePrice);
                                              require(sporeAmount <= presaleLastSupply, "insufficient presale supply");
                                              presaleLastSupply = presaleLastSupply.sub(sporeAmount);
                                              spore.mint(msg.sender, sporeAmount);
                                              ethSupply[msg.sender] = ethTotalAmount;
                                              devAddress.transfer(msg.value);
                                              emit BuySporeSuccess(msg.sender, msg.value, sporeAmount);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Standard math utilities missing in the Solidity language.
                                       */
                                      library Math {
                                          /**
                                           * @dev Returns the largest of two numbers.
                                           */
                                          function max(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a >= b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the smallest of two numbers.
                                           */
                                          function min(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a < b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the average of two numbers. The result is rounded towards
                                           * zero.
                                           */
                                          function average(uint256 a, uint256 b) internal pure returns (uint256) {
                                              // (a + b) / 2 can overflow, so we distribute
                                              return (a / 2) + (b / 2) + ((a % 2 + b % 2) / 2);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "../../GSN/Context.sol";
                                      import "./IERC20.sol";
                                      import "../../math/SafeMath.sol";
                                      import "../../utils/Address.sol";
                                      /**
                                       * @dev Implementation of the {IERC20} interface.
                                       *
                                       * This implementation is agnostic to the way tokens are created. This means
                                       * that a supply mechanism has to be added in a derived contract using {_mint}.
                                       * For a generic mechanism see {ERC20PresetMinterPauser}.
                                       *
                                       * TIP: For a detailed writeup see our guide
                                       * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How
                                       * to implement supply mechanisms].
                                       *
                                       * We have followed general OpenZeppelin guidelines: functions revert instead
                                       * of returning `false` on failure. This behavior is nonetheless conventional
                                       * and does not conflict with the expectations of ERC20 applications.
                                       *
                                       * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
                                       * This allows applications to reconstruct the allowance for all accounts just
                                       * by listening to said events. Other implementations of the EIP may not emit
                                       * these events, as it isn't required by the specification.
                                       *
                                       * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
                                       * functions have been added to mitigate the well-known issues around setting
                                       * allowances. See {IERC20-approve}.
                                       */
                                      contract ERC20 is Context, IERC20 {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          mapping (address => uint256) private _balances;
                                          mapping (address => mapping (address => uint256)) private _allowances;
                                          uint256 private _totalSupply;
                                          string private _name;
                                          string private _symbol;
                                          uint8 private _decimals;
                                          /**
                                           * @dev Sets the values for {name} and {symbol}, initializes {decimals} with
                                           * a default value of 18.
                                           *
                                           * To select a different value for {decimals}, use {_setupDecimals}.
                                           *
                                           * All three of these values are immutable: they can only be set once during
                                           * construction.
                                           */
                                          constructor (string memory name, string memory symbol) public {
                                              _name = name;
                                              _symbol = symbol;
                                              _decimals = 18;
                                          }
                                          /**
                                           * @dev Returns the name of the token.
                                           */
                                          function name() public view returns (string memory) {
                                              return _name;
                                          }
                                          /**
                                           * @dev Returns the symbol of the token, usually a shorter version of the
                                           * name.
                                           */
                                          function symbol() public view returns (string memory) {
                                              return _symbol;
                                          }
                                          /**
                                           * @dev Returns the number of decimals used to get its user representation.
                                           * For example, if `decimals` equals `2`, a balance of `505` tokens should
                                           * be displayed to a user as `5,05` (`505 / 10 ** 2`).
                                           *
                                           * Tokens usually opt for a value of 18, imitating the relationship between
                                           * Ether and Wei. This is the value {ERC20} uses, unless {_setupDecimals} is
                                           * called.
                                           *
                                           * NOTE: This information is only used for _display_ purposes: it in
                                           * no way affects any of the arithmetic of the contract, including
                                           * {IERC20-balanceOf} and {IERC20-transfer}.
                                           */
                                          function decimals() public view returns (uint8) {
                                              return _decimals;
                                          }
                                          /**
                                           * @dev See {IERC20-totalSupply}.
                                           */
                                          function totalSupply() public view override returns (uint256) {
                                              return _totalSupply;
                                          }
                                          /**
                                           * @dev See {IERC20-balanceOf}.
                                           */
                                          function balanceOf(address account) public view override returns (uint256) {
                                              return _balances[account];
                                          }
                                          /**
                                           * @dev See {IERC20-transfer}.
                                           *
                                           * Requirements:
                                           *
                                           * - `recipient` cannot be the zero address.
                                           * - the caller must have a balance of at least `amount`.
                                           */
                                          function transfer(address recipient, uint256 amount) public virtual override returns (bool) {
                                              _transfer(_msgSender(), recipient, amount);
                                              return true;
                                          }
                                          /**
                                           * @dev See {IERC20-allowance}.
                                           */
                                          function allowance(address owner, address spender) public view virtual override returns (uint256) {
                                              return _allowances[owner][spender];
                                          }
                                          /**
                                           * @dev See {IERC20-approve}.
                                           *
                                           * Requirements:
                                           *
                                           * - `spender` cannot be the zero address.
                                           */
                                          function approve(address spender, uint256 amount) public virtual override returns (bool) {
                                              _approve(_msgSender(), spender, amount);
                                              return true;
                                          }
                                          /**
                                           * @dev See {IERC20-transferFrom}.
                                           *
                                           * Emits an {Approval} event indicating the updated allowance. This is not
                                           * required by the EIP. See the note at the beginning of {ERC20};
                                           *
                                           * Requirements:
                                           * - `sender` and `recipient` cannot be the zero address.
                                           * - `sender` must have a balance of at least `amount`.
                                           * - the caller must have allowance for ``sender``'s tokens of at least
                                           * `amount`.
                                           */
                                          function transferFrom(address sender, address recipient, uint256 amount) public virtual override returns (bool) {
                                              _transfer(sender, recipient, amount);
                                              _approve(sender, _msgSender(), _allowances[sender][_msgSender()].sub(amount, "ERC20: transfer amount exceeds allowance"));
                                              return true;
                                          }
                                          /**
                                           * @dev Atomically increases the allowance granted to `spender` by the caller.
                                           *
                                           * This is an alternative to {approve} that can be used as a mitigation for
                                           * problems described in {IERC20-approve}.
                                           *
                                           * Emits an {Approval} event indicating the updated allowance.
                                           *
                                           * Requirements:
                                           *
                                           * - `spender` cannot be the zero address.
                                           */
                                          function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
                                              _approve(_msgSender(), spender, _allowances[_msgSender()][spender].add(addedValue));
                                              return true;
                                          }
                                          /**
                                           * @dev Atomically decreases the allowance granted to `spender` by the caller.
                                           *
                                           * This is an alternative to {approve} that can be used as a mitigation for
                                           * problems described in {IERC20-approve}.
                                           *
                                           * Emits an {Approval} event indicating the updated allowance.
                                           *
                                           * Requirements:
                                           *
                                           * - `spender` cannot be the zero address.
                                           * - `spender` must have allowance for the caller of at least
                                           * `subtractedValue`.
                                           */
                                          function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
                                              _approve(_msgSender(), spender, _allowances[_msgSender()][spender].sub(subtractedValue, "ERC20: decreased allowance below zero"));
                                              return true;
                                          }
                                          /**
                                           * @dev Moves tokens `amount` from `sender` to `recipient`.
                                           *
                                           * This is internal function is equivalent to {transfer}, and can be used to
                                           * e.g. implement automatic token fees, slashing mechanisms, etc.
                                           *
                                           * Emits a {Transfer} event.
                                           *
                                           * Requirements:
                                           *
                                           * - `sender` cannot be the zero address.
                                           * - `recipient` cannot be the zero address.
                                           * - `sender` must have a balance of at least `amount`.
                                           */
                                          function _transfer(address sender, address recipient, uint256 amount) internal virtual {
                                              require(sender != address(0), "ERC20: transfer from the zero address");
                                              require(recipient != address(0), "ERC20: transfer to the zero address");
                                              _beforeTokenTransfer(sender, recipient, amount);
                                              _balances[sender] = _balances[sender].sub(amount, "ERC20: transfer amount exceeds balance");
                                              _balances[recipient] = _balances[recipient].add(amount);
                                              emit Transfer(sender, recipient, amount);
                                          }
                                          /** @dev Creates `amount` tokens and assigns them to `account`, increasing
                                           * the total supply.
                                           *
                                           * Emits a {Transfer} event with `from` set to the zero address.
                                           *
                                           * Requirements
                                           *
                                           * - `to` cannot be the zero address.
                                           */
                                          function _mint(address account, uint256 amount) internal virtual {
                                              require(account != address(0), "ERC20: mint to the zero address");
                                              _beforeTokenTransfer(address(0), account, amount);
                                              _totalSupply = _totalSupply.add(amount);
                                              _balances[account] = _balances[account].add(amount);
                                              emit Transfer(address(0), account, amount);
                                          }
                                          /**
                                           * @dev Destroys `amount` tokens from `account`, reducing the
                                           * total supply.
                                           *
                                           * Emits a {Transfer} event with `to` set to the zero address.
                                           *
                                           * Requirements
                                           *
                                           * - `account` cannot be the zero address.
                                           * - `account` must have at least `amount` tokens.
                                           */
                                          function _burn(address account, uint256 amount) internal virtual {
                                              require(account != address(0), "ERC20: burn from the zero address");
                                              _beforeTokenTransfer(account, address(0), amount);
                                              _balances[account] = _balances[account].sub(amount, "ERC20: burn amount exceeds balance");
                                              _totalSupply = _totalSupply.sub(amount);
                                              emit Transfer(account, address(0), amount);
                                          }
                                          /**
                                           * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.
                                           *
                                           * This 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 Sets {decimals} to a value other than the default one of 18.
                                           *
                                           * WARNING: This function should only be called from the constructor. Most
                                           * applications that interact with token contracts will not expect
                                           * {decimals} to ever change, and may work incorrectly if it does.
                                           */
                                          function _setupDecimals(uint8 decimals_) internal {
                                              _decimals = decimals_;
                                          }
                                          /**
                                           * @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 to 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 { }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.2;
                                      /**
                                       * @dev Collection of functions related to the address type
                                       */
                                      library Address {
                                          /**
                                           * @dev Returns true if `account` is a contract.
                                           *
                                           * [IMPORTANT]
                                           * ====
                                           * It is unsafe to assume that an address for which this function returns
                                           * false is an externally-owned account (EOA) and not a contract.
                                           *
                                           * Among others, `isContract` will return false for the following
                                           * types of addresses:
                                           *
                                           *  - an externally-owned account
                                           *  - a contract in construction
                                           *  - an address where a contract will be created
                                           *  - an address where a contract lived, but was destroyed
                                           * ====
                                           */
                                          function isContract(address account) internal view returns (bool) {
                                              // This method relies in extcodesize, which returns 0 for contracts in
                                              // construction, since the code is only stored at the end of the
                                              // constructor execution.
                                              uint256 size;
                                              // solhint-disable-next-line no-inline-assembly
                                              assembly { size := extcodesize(account) }
                                              return size > 0;
                                          }
                                          /**
                                           * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                                           * `recipient`, forwarding all available gas and reverting on errors.
                                           *
                                           * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                                           * of certain opcodes, possibly making contracts go over the 2300 gas limit
                                           * imposed by `transfer`, making them unable to receive funds via
                                           * `transfer`. {sendValue} removes this limitation.
                                           *
                                           * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                                           *
                                           * IMPORTANT: because control is transferred to `recipient`, care must be
                                           * taken to not create reentrancy vulnerabilities. Consider using
                                           * {ReentrancyGuard} or the
                                           * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                                           */
                                          function sendValue(address payable recipient, uint256 amount) internal {
                                              require(address(this).balance >= amount, "Address: insufficient balance");
                                              // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                                              (bool success, ) = recipient.call{ value: amount }("");
                                              require(success, "Address: unable to send value, recipient may have reverted");
                                          }
                                          /**
                                           * @dev Performs a Solidity function call using a low level `call`. A
                                           * plain`call` is an unsafe replacement for a function call: use this
                                           * function instead.
                                           *
                                           * If `target` reverts with a revert reason, it is bubbled up by this
                                           * function (like regular Solidity function calls).
                                           *
                                           * Returns the raw returned data. To convert to the expected return value,
                                           * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                                           *
                                           * Requirements:
                                           *
                                           * - `target` must be a contract.
                                           * - calling `target` with `data` must not revert.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                                            return functionCall(target, data, "Address: low-level call failed");
                                          }
                                          /**
                                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                                           * `errorMessage` as a fallback revert reason when `target` reverts.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                                              return _functionCallWithValue(target, data, 0, errorMessage);
                                          }
                                          /**
                                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                                           * but also transferring `value` wei to `target`.
                                           *
                                           * Requirements:
                                           *
                                           * - the calling contract must have an ETH balance of at least `value`.
                                           * - the called Solidity function must be `payable`.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                                              return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                                          }
                                          /**
                                           * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                                           * with `errorMessage` as a fallback revert reason when `target` reverts.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
                                              require(address(this).balance >= value, "Address: insufficient balance for call");
                                              return _functionCallWithValue(target, data, value, errorMessage);
                                          }
                                          function _functionCallWithValue(address target, bytes memory data, uint256 weiValue, string memory errorMessage) private returns (bytes memory) {
                                              require(isContract(target), "Address: call to non-contract");
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, bytes memory returndata) = target.call{ value: weiValue }(data);
                                              if (success) {
                                                  return returndata;
                                              } else {
                                                  // Look for revert reason and bubble it up if present
                                                  if (returndata.length > 0) {
                                                      // The easiest way to bubble the revert reason is using memory via assembly
                                                      // solhint-disable-next-line no-inline-assembly
                                                      assembly {
                                                          let returndata_size := mload(returndata)
                                                          revert(add(32, returndata), returndata_size)
                                                      }
                                                  } else {
                                                      revert(errorMessage);
                                                  }
                                              }
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "./IERC20.sol";
                                      import "../../math/SafeMath.sol";
                                      import "../../utils/Address.sol";
                                      /**
                                       * @title SafeERC20
                                       * @dev Wrappers around ERC20 operations that throw on failure (when the token
                                       * contract returns false). Tokens that return no value (and instead revert or
                                       * throw on failure) are also supported, non-reverting calls are assumed to be
                                       * successful.
                                       * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
                                       * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
                                       */
                                      library SafeERC20 {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          function safeTransfer(IERC20 token, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
                                          }
                                          function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
                                          }
                                          /**
                                           * @dev Deprecated. This function has issues similar to the ones found in
                                           * {IERC20-approve}, and its usage is discouraged.
                                           *
                                           * Whenever possible, use {safeIncreaseAllowance} and
                                           * {safeDecreaseAllowance} instead.
                                           */
                                          function safeApprove(IERC20 token, address spender, uint256 value) internal {
                                              // safeApprove should only be called when setting an initial allowance,
                                              // or when resetting it to zero. To increase and decrease it, use
                                              // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                                              // solhint-disable-next-line max-line-length
                                              require((value == 0) || (token.allowance(address(this), spender) == 0),
                                                  "SafeERC20: approve from non-zero to non-zero allowance"
                                              );
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
                                          }
                                          function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).add(value);
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          /**
                                           * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                                           * on the return value: the return value is optional (but if data is returned, it must not be false).
                                           * @param token The token targeted by the call.
                                           * @param data The call data (encoded using abi.encode or one of its variants).
                                           */
                                          function _callOptionalReturn(IERC20 token, bytes memory data) private {
                                              // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                                              // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
                                              // the target address contains contract code and also asserts for success in the low-level call.
                                              bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
                                              if (returndata.length > 0) { // Return data is optional
                                                  // solhint-disable-next-line max-line-length
                                                  require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                                              }
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
                                      import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      contract SporeToken is ERC20("SporeFinance", "SPORE"), Ownable {
                                          using SafeMath for uint256;
                                          /* ========== STATE VARIABLES ========== */
                                          mapping(address => bool) public minters;
                                          address public initialLiquidityManager;
                                          bool internal _transfersEnabled;
                                          mapping(address => bool) internal _canTransferInitialLiquidity;
                                          /* ========== CONSTRUCTOR ========== */
                                          constructor(address initialLiquidityManager_) public {
                                              _transfersEnabled = false;
                                              minters[msg.sender] = true;
                                              initialLiquidityManager = initialLiquidityManager_;
                                              _canTransferInitialLiquidity[msg.sender] = true;
                                          }
                                          /* ========== MUTATIVE FUNCTIONS ========== */
                                          /// @notice Transfer is enabled as normal except during an initial phase
                                          function transfer(address recipient, uint256 amount) public override returns (bool) {
                                              require(_transfersEnabled || _canTransferInitialLiquidity[msg.sender], "SporeToken: transfers not enabled");
                                              return super.transfer(recipient, amount);
                                          }
                                          /// @notice TransferFrom is enabled as normal except during an initial phase
                                          function transferFrom(
                                              address sender,
                                              address recipient,
                                              uint256 amount
                                          ) public override returns (bool) {
                                              require(_transfersEnabled || _canTransferInitialLiquidity[msg.sender], "SporeToken: transfers not enabled");
                                              return super.transferFrom(sender, recipient, amount);
                                          }
                                          /// @notice Any account is entitled to burn their own tokens
                                          function burn(uint256 amount) public {
                                              require(amount > 0);
                                              require(balanceOf(msg.sender) >= amount);
                                              _burn(msg.sender, amount);
                                          }
                                          /* ========== RESTRICTED FUNCTIONS ========== */
                                          function mint(address to, uint256 amount) public onlyMinter {
                                              _mint(to, amount);
                                          }
                                          function addInitialLiquidityTransferRights(address account) public onlyInitialLiquidityManager {
                                              require(!_transfersEnabled, "SporeToken: cannot add initial liquidity transfer rights after global transfers enabled");
                                              _canTransferInitialLiquidity[account] = true;
                                          }
                                          /// @notice One time acion to enable global transfers after the initial liquidity is supplied.
                                          function enableTransfers() public onlyInitialLiquidityManager {
                                              _transfersEnabled = true;
                                          }
                                          function addMinter(address account) public onlyOwner {
                                              minters[account] = true;
                                          }
                                          function removeMinter(address account) public onlyOwner {
                                              minters[account] = false;
                                          }
                                          modifier onlyMinter() {
                                              require(minters[msg.sender], "Restricted to minters.");
                                              _;
                                          }
                                          modifier onlyInitialLiquidityManager() {
                                              require(initialLiquidityManager == msg.sender, "Restricted to initial liquidity manager.");
                                              _;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "../MushroomNFT.sol";
                                      import "../MushroomLib.sol";
                                      /*
                                          MushroomFactories manage the mushroom generation logic for pools
                                          Each pool will have it's own factory to generate mushrooms according
                                          to its' powers.
                                          The mushroomFactory should be administered by the pool, which grants the ability to grow mushrooms
                                      */
                                      contract MushroomLifespanMock is Initializable, OwnableUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          using SafeMath for uint256;
                                          uint256 public spawnCount;
                                          event MushroomGrown(address recipient, uint256 id, uint256 species, uint256 lifespan);
                                          function generateMushroomLifespan(uint256 minLifespan, uint256 maxLifespan) public returns (uint256) {
                                              uint256 range = maxLifespan.sub(minLifespan);
                                              uint256 fromMin = uint256(keccak256(abi.encodePacked(block.timestamp.add(spawnCount)))) % range;
                                              spawnCount = spawnCount.add(1);
                                              return minLifespan.add(fromMin);
                                          }
                                          function getRemainingMintableForMySpecies(MushroomNFT mushroomNft, uint256 speciesId) public view returns (uint256) {
                                              return mushroomNft.getRemainingMintableForSpecies(speciesId);
                                          }
                                          // Each mushroom costs 1/10th of the spore rate in spores.
                                          function growMushrooms(MushroomNFT mushroomNft, uint256 speciesId, address recipient, uint256 numMushrooms) public {
                                              MushroomLib.MushroomType memory species = mushroomNft.getSpecies(speciesId);
                                              require(getRemainingMintableForMySpecies(mushroomNft, speciesId) >= numMushrooms, "MushroomFactory: Mushrooms to grow exceeds species cap");
                                              for (uint256 i = 0; i < numMushrooms; i++) {
                                                  uint256 nextId = mushroomNft.totalSupply().add(1);
                                                  uint256 lifespan = generateMushroomLifespan(species.minLifespan, species.maxLifespan);
                                                  mushroomNft.mint(recipient, nextId, speciesId, lifespan);
                                                  emit MushroomGrown(recipient, nextId, speciesId, lifespan);
                                              }
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      /**
                                       * @title TokenVesting
                                       * @dev A token holder contract that can release its token balance gradually like a
                                       * typical vesting scheme, with a cliff and vesting period. Optionally revocable by the
                                       * owner.
                                       */
                                      contract TokenVesting is Ownable {
                                          // The vesting schedule is time-based (i.e. using block timestamps as opposed to e.g. block numbers), and is
                                          // therefore sensitive to timestamp manipulation (which is something miners can do, to a certain degree). Therefore,
                                          // it is recommended to avoid using short time durations (less than a minute). Typical vesting schemes, with a
                                          // cliff period of a year and a duration of four years, are safe to use.
                                          // solhint-disable not-rely-on-time
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          event TokensReleased(address token, uint256 amount);
                                          event TokenVestingRevoked(address token);
                                          // beneficiary of tokens after they are released
                                          address private _beneficiary;
                                          // Durations and timestamps are expressed in UNIX time, the same units as block.timestamp.
                                          uint256 private _cliff;
                                          uint256 private _start;
                                          uint256 private _duration;
                                          bool private _revocable;
                                          mapping (address => uint256) private _released;
                                          mapping (address => bool) private _revoked;
                                          /**
                                           * @dev Creates a vesting contract that vests its balance of any ERC20 token to the
                                           * beneficiary, gradually in a linear fashion until start + duration. By then all
                                           * of the balance will have vested.
                                           * @param beneficiary address of the beneficiary to whom vested tokens are transferred
                                           * @param cliffDuration duration in seconds of the cliff in which tokens will begin to vest
                                           * @param start the time (as Unix time) at which point vesting starts
                                           * @param duration duration in seconds of the period in which the tokens will vest
                                           * @param revocable whether the vesting is revocable or not
                                           */
                                          constructor (address beneficiary, uint256 start, uint256 cliffDuration, uint256 duration, bool revocable) public {
                                              require(beneficiary != address(0), "TokenVesting: beneficiary is the zero address");
                                              // solhint-disable-next-line max-line-length
                                              require(cliffDuration <= duration, "TokenVesting: cliff is longer than duration");
                                              require(duration > 0, "TokenVesting: duration is 0");
                                              // solhint-disable-next-line max-line-length
                                              require(start.add(duration) > block.timestamp, "TokenVesting: final time is before current time");
                                              _beneficiary = beneficiary;
                                              _revocable = revocable;
                                              _duration = duration;
                                              _cliff = start.add(cliffDuration);
                                              _start = start;
                                          }
                                          /**
                                           * @return the beneficiary of the tokens.
                                           */
                                          function beneficiary() public view returns (address) {
                                              return _beneficiary;
                                          }
                                          /**
                                           * @return the cliff time of the token vesting.
                                           */
                                          function cliff() public view returns (uint256) {
                                              return _cliff;
                                          }
                                          /**
                                           * @return the start time of the token vesting.
                                           */
                                          function start() public view returns (uint256) {
                                              return _start;
                                          }
                                          /**
                                           * @return the duration of the token vesting.
                                           */
                                          function duration() public view returns (uint256) {
                                              return _duration;
                                          }
                                          /**
                                           * @return true if the vesting is revocable.
                                           */
                                          function revocable() public view returns (bool) {
                                              return _revocable;
                                          }
                                          /**
                                           * @return the amount of the token released.
                                           */
                                          function released(address token) public view returns (uint256) {
                                              return _released[token];
                                          }
                                          /**
                                           * @return true if the token is revoked.
                                           */
                                          function revoked(address token) public view returns (bool) {
                                              return _revoked[token];
                                          }
                                          /**
                                           * @notice Transfers vested tokens to beneficiary.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function release(IERC20 token) public {
                                              uint256 unreleased = _releasableAmount(token);
                                              require(unreleased > 0, "TokenVesting: no tokens are due");
                                              _released[address(token)] = _released[address(token)].add(unreleased);
                                              token.safeTransfer(_beneficiary, unreleased);
                                              emit TokensReleased(address(token), unreleased);
                                          }
                                          /**
                                           * @notice Allows the owner to revoke the vesting. Tokens already vested
                                           * remain in the contract, the rest are returned to the owner.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function revoke(IERC20 token) public onlyOwner {
                                              require(_revocable, "TokenVesting: cannot revoke");
                                              require(!_revoked[address(token)], "TokenVesting: token already revoked");
                                              uint256 balance = token.balanceOf(address(this));
                                              uint256 unreleased = _releasableAmount(token);
                                              uint256 refund = balance.sub(unreleased);
                                              _revoked[address(token)] = true;
                                              token.safeTransfer(owner(), refund);
                                              emit TokenVestingRevoked(address(token));
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested but hasn't been released yet.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function _releasableAmount(IERC20 token) private view returns (uint256) {
                                              return _vestedAmount(token).sub(_released[address(token)]);
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function _vestedAmount(IERC20 token) private view returns (uint256) {
                                              uint256 currentBalance = token.balanceOf(address(this));
                                              uint256 totalBalance = currentBalance.add(_released[address(token)]);
                                              if (block.timestamp < _cliff) {
                                                  return 0;
                                              } else if (block.timestamp >= _start.add(_duration) || _revoked[address(token)]) {
                                                  return totalBalance;
                                              } else {
                                                  return totalBalance.mul(block.timestamp.sub(_start)).div(_duration);
                                              }
                                          }
                                      }

                                      File 8 of 14: AdminUpgradeabilityProxy
                                      // SPDX-License-Identifier: MIT
                                      
                                      pragma solidity ^0.6.2;
                                      
                                      /**
                                       * @dev Collection of functions related to the address type
                                       */
                                      library Address {
                                          /**
                                           * @dev Returns true if `account` is a contract.
                                           *
                                           * [IMPORTANT]
                                           * ====
                                           * It is unsafe to assume that an address for which this function returns
                                           * false is an externally-owned account (EOA) and not a contract.
                                           *
                                           * Among others, `isContract` will return false for the following
                                           * types of addresses:
                                           *
                                           *  - an externally-owned account
                                           *  - a contract in construction
                                           *  - an address where a contract will be created
                                           *  - an address where a contract lived, but was destroyed
                                           * ====
                                           */
                                          function isContract(address account) internal view returns (bool) {
                                              // This method relies on extcodesize, which returns 0 for contracts in
                                              // construction, since the code is only stored at the end of the
                                              // constructor execution.
                                      
                                              uint256 size;
                                              // solhint-disable-next-line no-inline-assembly
                                              assembly { size := extcodesize(account) }
                                              return size > 0;
                                          }
                                      
                                      }
                                      /**
                                       * @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.
                                       */
                                      abstract contract Proxy {
                                        /**
                                         * @dev Fallback function.
                                         * Implemented entirely in `_fallback`.
                                         */
                                        fallback () payable external {
                                          _fallback();
                                        }
                                      
                                        /**
                                         * @dev Receive function.
                                         * Implemented entirely in `_fallback`.
                                         */
                                        receive () payable external {
                                          _fallback();
                                        }
                                      
                                        /**
                                         * @return The Address of the implementation.
                                         */
                                        function _implementation() internal virtual 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 virtual {
                                        }
                                      
                                        /**
                                         * @dev fallback implementation.
                                         * Extracted to enable manual triggering.
                                         */
                                        function _fallback() internal {
                                          _willFallback();
                                          _delegate(_implementation());
                                        }
                                      }
                                      
                                      /**
                                       * @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 Contract constructor.
                                         * @param _logic Address of the initial implementation.
                                         * @param _data Data to send as msg.data to the implementation to initialize the proxied contract.
                                         * It should include the signature and the parameters of the function to be called, as described in
                                         * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         * This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.
                                         */
                                        constructor(address _logic, bytes memory _data) public payable {
                                          assert(IMPLEMENTATION_SLOT == bytes32(uint256(keccak256('eip1967.proxy.implementation')) - 1));
                                          _setImplementation(_logic);
                                          if(_data.length > 0) {
                                            (bool success,) = _logic.delegatecall(_data);
                                            require(success);
                                          }
                                        }  
                                      
                                        /**
                                         * @dev Emitted when the implementation is upgraded.
                                         * @param implementation Address of the new implementation.
                                         */
                                        event Upgraded(address indexed implementation);
                                      
                                        /**
                                         * @dev Storage slot with the address of the current implementation.
                                         * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
                                         * validated in the constructor.
                                         */
                                        bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                                      
                                        /**
                                         * @dev Returns the current implementation.
                                         * @return impl Address of the current implementation
                                         */
                                        function _implementation() internal override 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) internal {
                                          require(Address.isContract(newImplementation), "Cannot set a proxy implementation to a non-contract address");
                                      
                                          bytes32 slot = IMPLEMENTATION_SLOT;
                                      
                                          assembly {
                                            sstore(slot, newImplementation)
                                          }
                                        }
                                      }
                                      
                                      /**
                                       * @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 {
                                        /**
                                         * Contract constructor.
                                         * @param _logic address of the initial implementation.
                                         * @param _admin Address of the proxy administrator.
                                         * @param _data Data to send as msg.data to the implementation to initialize the proxied contract.
                                         * It should include the signature and the parameters of the function to be called, as described in
                                         * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         * This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.
                                         */
                                        constructor(address _logic, address _admin, bytes memory _data) UpgradeabilityProxy(_logic, _data) public payable {
                                          assert(ADMIN_SLOT == bytes32(uint256(keccak256('eip1967.proxy.admin')) - 1));
                                          _setAdmin(_admin);
                                        }
                                      
                                        /**
                                         * @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 "eip1967.proxy.admin" subtracted by 1, and is
                                         * validated in the constructor.
                                         */
                                      
                                        bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                                      
                                        /**
                                         * @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();
                                          }
                                        }
                                      
                                        /**
                                         * @return The address of the proxy admin.
                                         */
                                        function admin() external ifAdmin returns (address) {
                                          return _admin();
                                        }
                                      
                                        /**
                                         * @return The address of the implementation.
                                         */
                                        function implementation() external 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/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                                         */
                                        function upgradeToAndCall(address newImplementation, bytes calldata data) payable external ifAdmin {
                                          _upgradeTo(newImplementation);
                                          (bool success,) = newImplementation.delegatecall(data);
                                          require(success);
                                        }
                                      
                                        /**
                                         * @return adm 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 override virtual {
                                          require(msg.sender != _admin(), "Cannot call fallback function from the proxy admin");
                                          super._willFallback();
                                        }
                                      }

                                      File 9 of 14: MushroomAdapter
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      /*
                                          Approve and Ban Contracts to interact with pools.
                                          (All contracts are approved by default, unless banned)
                                      */
                                      contract BannedContractList is Initializable, OwnableUpgradeSafe {
                                          mapping(address => bool) banned;
                                          function initialize() public initializer {
                                              __Ownable_init();
                                          }
                                          function isApproved(address toCheck) external view returns (bool) {
                                              return !banned[toCheck];
                                          }
                                          function isBanned(address toCheck) external view returns (bool) {
                                              return banned[toCheck];
                                          }
                                          function approveContract(address toApprove) external onlyOwner {
                                              banned[toApprove] = false;
                                          }
                                          function banContract(address toBan) external onlyOwner {
                                              banned[toBan] = true;
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../GSN/Context.sol";
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Contract module which provides a basic access control mechanism, where
                                       * there is an account (an owner) that can be granted exclusive access to
                                       * specific functions.
                                       *
                                       * By default, the owner account will be the one that deploys the contract. This
                                       * can later be changed with {transferOwnership}.
                                       *
                                       * This module is used through inheritance. It will make available the modifier
                                       * `onlyOwner`, which can be applied to your functions to restrict their use to
                                       * the owner.
                                       */
                                      contract OwnableUpgradeSafe is Initializable, ContextUpgradeSafe {
                                          address private _owner;
                                          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                                          /**
                                           * @dev Initializes the contract setting the deployer as the initial owner.
                                           */
                                          function __Ownable_init() internal initializer {
                                              __Context_init_unchained();
                                              __Ownable_init_unchained();
                                          }
                                          function __Ownable_init_unchained() internal initializer {
                                              address msgSender = _msgSender();
                                              _owner = msgSender;
                                              emit OwnershipTransferred(address(0), msgSender);
                                          }
                                          /**
                                           * @dev Returns the address of the current owner.
                                           */
                                          function owner() public view returns (address) {
                                              return _owner;
                                          }
                                          /**
                                           * @dev Throws if called by any account other than the owner.
                                           */
                                          modifier onlyOwner() {
                                              require(_owner == _msgSender(), "Ownable: caller is not the owner");
                                              _;
                                          }
                                          /**
                                           * @dev Leaves the contract without owner. It will not be possible to call
                                           * `onlyOwner` functions anymore. Can only be called by the current owner.
                                           *
                                           * NOTE: Renouncing ownership will leave the contract without an owner,
                                           * thereby removing any functionality that is only available to the owner.
                                           */
                                          function renounceOwnership() public virtual onlyOwner {
                                              emit OwnershipTransferred(_owner, address(0));
                                              _owner = address(0);
                                          }
                                          /**
                                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                                           * Can only be called by the current owner.
                                           */
                                          function transferOwnership(address newOwner) public virtual onlyOwner {
                                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                                              emit OwnershipTransferred(_owner, newOwner);
                                              _owner = newOwner;
                                          }
                                          uint256[49] private __gap;
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../Initializable.sol";
                                      /*
                                       * @dev Provides information about the current execution context, including the
                                       * sender of the transaction and its data. While these are generally available
                                       * via msg.sender and msg.data, they should not be accessed in such a direct
                                       * manner, since when dealing with GSN meta-transactions the account sending and
                                       * paying for execution may not be the actual sender (as far as an application
                                       * is concerned).
                                       *
                                       * This contract is only required for intermediate, library-like contracts.
                                       */
                                      contract ContextUpgradeSafe is Initializable {
                                          // Empty internal constructor, to prevent people from mistakenly deploying
                                          // an instance of this contract, which should be used via inheritance.
                                          function __Context_init() internal initializer {
                                              __Context_init_unchained();
                                          }
                                          function __Context_init_unchained() internal initializer {
                                          }
                                          function _msgSender() internal view virtual returns (address payable) {
                                              return msg.sender;
                                          }
                                          function _msgData() internal view virtual returns (bytes memory) {
                                              this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                                              return msg.data;
                                          }
                                          uint256[50] private __gap;
                                      }
                                      pragma solidity >=0.4.24 <0.7.0;
                                      /**
                                       * @title Initializable
                                       *
                                       * @dev Helper contract to support initializer functions. To use it, replace
                                       * the constructor with a function that has the `initializer` modifier.
                                       * WARNING: Unlike constructors, initializer functions must be manually
                                       * invoked. This applies both to deploying an Initializable contract, as well
                                       * as extending an Initializable contract via inheritance.
                                       * WARNING: When used with inheritance, manual care must be taken to not invoke
                                       * a parent initializer twice, or ensure that all initializers are idempotent,
                                       * because this is not dealt with automatically as with constructors.
                                       */
                                      contract Initializable {
                                        /**
                                         * @dev Indicates that the contract has been initialized.
                                         */
                                        bool private initialized;
                                        /**
                                         * @dev Indicates that the contract is in the process of being initialized.
                                         */
                                        bool private initializing;
                                        /**
                                         * @dev Modifier to use in the initializer function of a contract.
                                         */
                                        modifier initializer() {
                                          require(initializing || isConstructor() || !initialized, "Contract instance has already been initialized");
                                          bool isTopLevelCall = !initializing;
                                          if (isTopLevelCall) {
                                            initializing = true;
                                            initialized = true;
                                          }
                                          _;
                                          if (isTopLevelCall) {
                                            initializing = false;
                                          }
                                        }
                                        /// @dev Returns true if and only if the function is running in the constructor
                                        function isConstructor() private view returns (bool) {
                                          // extcodesize checks the size of the code stored in an address, and
                                          // address returns the current address. Since the code is still not
                                          // deployed when running a constructor, any checks on its code size will
                                          // yield zero, making it an effective way to detect if a contract is
                                          // under construction or not.
                                          address self = address(this);
                                          uint256 cs;
                                          assembly { cs := extcodesize(self) }
                                          return cs == 0;
                                        }
                                        // Reserved storage space to allow for layout changes in the future.
                                        uint256[50] private ______gap;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "./BannedContractList.sol";
                                      /*
                                          Prevent smart contracts from calling functions unless approved by the specified whitelist.
                                      */
                                      contract Defensible {
                                       // Only smart contracts will be affected by this modifier
                                        modifier defend(BannedContractList bannedContractList) {
                                          require(
                                            (msg.sender == tx.origin) || bannedContractList.isApproved(msg.sender),
                                            "This smart contract has not been approved"
                                          );
                                          _;
                                        }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      /* 
                                          - Stake up to X mushrooms per user (dao can change)
                                          - Reward mushroom yield rate for lifespan
                                          - When dead, burn mushroom erc721
                                          - Distribute 5% of ENOKI rewards to Chefs
                                      */
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      // import "@openzeppelin/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/ReentrancyGuard.sol";
                                      import "./TokenPool.sol";
                                      import "./Defensible.sol";
                                      import "./MushroomNFT.sol";
                                      import "./MushroomLib.sol";
                                      import "./metadata/MetadataResolver.sol";
                                      /**
                                       * @title Enoki Geyser
                                       * @dev A smart-contract based mechanism to distribute tokens over time, inspired loosely by
                                       *      Compound and Uniswap.
                                       *
                                       *      Distribution tokens are added to a locked pool in the contract and become unlocked over time
                                       *      according to a once-configurable unlock schedule. Once unlocked, they are available to be
                                       *      claimed by users.
                                       *
                                       *      A user may deposit tokens to accrue ownership share over the unlocked pool. This owner share
                                       *      is a function of the number of tokens deposited as well as the length of time deposited.
                                       *      Specifically, a user's share of the currently-unlocked pool equals their "deposit-seconds"
                                       *      divided by the global "deposit-seconds". This aligns the new token distribution with long
                                       *      term supporters of the project, addressing one of the major drawbacks of simple airdrops.
                                       *
                                       *      More background and motivation available at:
                                       *      https://github.com/ampleforth/RFCs/blob/master/RFCs/rfc-1.md
                                       */
                                      contract EnokiGeyser is Initializable, OwnableUpgradeSafe, AccessControlUpgradeSafe, ReentrancyGuardUpgradeSafe, Defensible {
                                          using SafeMath for uint256;
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          event Staked(address indexed user, address nftContract, uint256 nftId, uint256 total, bytes data);
                                          event Unstaked(address indexed user, address nftContract, uint256 nftId, uint256 total, bytes data);
                                          event TokensClaimed(address indexed user, uint256 amount, uint256 userReward, uint256 devReward);
                                          event TokensLocked(uint256 amount, uint256 total);
                                          event TokensLockedAirdrop(address airdrop, uint256 amount, uint256 total);
                                          event LifespanUsed(address nftContract, uint256 nftIndex, uint256 lifespanUsed, uint256 lifespan);
                                          event NewLifespan(address nftContract, uint256 nftIndex, uint256 lifespan);
                                          // amount: Unlocked tokens, total: Total locked tokens
                                          event TokensUnlocked(uint256 amount, uint256 total);
                                          event MaxStakesPerAddressSet(uint256 maxStakesPerAddress);
                                          event MetadataResolverSet(address metadataResolver);
                                          event BurnedMushroom(address nftContract, uint256 nftIndex);
                                          TokenPool public _unlockedPool;
                                          TokenPool public _lockedPool;
                                          MetadataResolver public metadataResolver;
                                          //
                                          // Time-bonus params
                                          //
                                          uint256 public constant BONUS_DECIMALS = 2;
                                          uint256 public startBonus = 0;
                                          uint256 public bonusPeriodSec = 0;
                                          uint256 public maxStakesPerAddress = 0;
                                          //
                                          // Global accounting state
                                          //
                                          uint256 public totalLockedShares = 0;
                                          uint256 public totalStakingShares = 0;
                                          uint256 public totalStrengthStaked = 0;
                                          uint256 private _totalStakingShareSeconds = 0;
                                          uint256 private _lastAccountingTimestampSec = now;
                                          uint256 private _maxUnlockSchedules = 0;
                                          uint256 private _initialSharesPerToken = 0;
                                          //
                                          // Dev reward state
                                          //
                                          uint256 public constant MAX_PERCENTAGE = 100;
                                          uint256 public devRewardPercentage = 0; //0% - 100%
                                          address public devRewardAddress;
                                          address public admin;
                                          BannedContractList public bannedContractList;
                                          //
                                          // User accounting state
                                          //
                                          // Represents a single stake for a user. A user may have multiple.
                                          struct Stake {
                                              address nftContract;
                                              uint256 nftIndex;
                                              uint256 strength;
                                              uint256 stakedAt;
                                          }
                                          // Caches aggregated values from the User->Stake[] map to save computation.
                                          // If lastAccountingTimestampSec is 0, there's no entry for that user.
                                          struct UserTotals {
                                              uint256 userStrengthStaked;
                                              uint256 stakingShareSeconds;
                                              uint256 lastAccountingTimestampSec;
                                          }
                                          // Aggregated staking values per user
                                          mapping(address => UserTotals) private _userTotals;
                                          // The collection of stakes for each user. Ordered by timestamp, earliest to latest.
                                          mapping(address => Stake[]) private _userStakes;
                                          //
                                          // Locked/Unlocked Accounting state
                                          //
                                          struct UnlockSchedule {
                                              uint256 initialLockedShares;
                                              uint256 unlockedShares;
                                              uint256 lastUnlockTimestampSec;
                                              uint256 endAtSec;
                                              uint256 durationSec;
                                          }
                                          UnlockSchedule[] public unlockSchedules;
                                          bool public initializeComplete;
                                          uint256 public constant SECONDS_PER_WEEK = 604800;
                                          uint256 public usedAirdropPool;
                                          uint256 public maxAirdropPool;
                                          address internal constant INITIALIZER_ADDRESS = 0xe9673e2806305557Daa67E3207c123Af9F95F9d2;
                                          IERC20 public enokiToken;
                                          uint256 public stakingEnabledTime;
                                          /**
                                           * @param enokiToken_ The token users receive as they unstake.
                                           * @param maxStakesPerAddress_ Maximum number of NFTs stakeable by a given account.
                                           * @param devRewardAddress_ Recipient address of dev rewards.
                                           * @param devRewardPercentage_ Pecentage of rewards claimed to be distributed for dev address.
                                           */
                                          function initialize(
                                              IERC20 enokiToken_,
                                              uint256 maxStakesPerAddress_,
                                              address devRewardAddress_,
                                              uint256 devRewardPercentage_,
                                              address bannedContractList_,
                                              uint256 stakingEnabledTime_,
                                              uint256 maxAirdropPool_,
                                              address resolver_
                                          ) public {
                                              require(msg.sender == INITIALIZER_ADDRESS, "Only deployer can reinitialize");
                                              require(admin == address(0), "Admin has already been initialized");
                                              require(initializeComplete == false, "Initialization already complete");
                                              // The dev reward must be some fraction of the max. (i.e. <= 100%)
                                              require(devRewardPercentage_ <= MAX_PERCENTAGE, "EnokiGeyser: dev reward too high");
                                              enokiToken = enokiToken_;
                                              maxStakesPerAddress = maxStakesPerAddress_;
                                              emit MaxStakesPerAddressSet(maxStakesPerAddress);
                                              devRewardPercentage = devRewardPercentage_;
                                              devRewardAddress = devRewardAddress_;
                                              stakingEnabledTime = stakingEnabledTime_;
                                              maxAirdropPool = maxAirdropPool_;
                                              metadataResolver = MetadataResolver(resolver_);
                                              emit MetadataResolverSet(address(metadataResolver));
                                              _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                                              bannedContractList = BannedContractList(bannedContractList_);
                                              initializeComplete = true;
                                          }
                                          modifier onlyAdmin() {
                                              require(hasRole(DEFAULT_ADMIN_ROLE, msg.sender), "EnokiGeyser: Only Admin");
                                              _;
                                          }
                                          /* ========== ADMIN FUNCTIONALITY ========== */
                                          // Only effects future stakes
                                          function setMaxStakesPerAddress(uint256 maxStakes) public onlyAdmin {
                                              maxStakesPerAddress = maxStakes;
                                              emit MaxStakesPerAddressSet(maxStakesPerAddress);
                                          }
                                          function setMetadataResolver(address resolver_) public onlyAdmin {
                                              metadataResolver = MetadataResolver(resolver_);
                                              emit MetadataResolverSet(address(metadataResolver));
                                          }
                                          /**
                                           * @return The token users receive as they unstake.
                                           */
                                          function getDistributionToken() public view returns (IERC20) {
                                              return enokiToken;
                                          }
                                          function getNumStakes(address user) external view returns (uint256) {
                                              return _userStakes[user].length;
                                          }
                                          function getStakes(address user) external view returns (Stake[] memory) {
                                              uint256 numStakes = _userStakes[user].length;
                                              Stake[] memory stakes = new Stake[](numStakes);
                                              for (uint256 i = 0; i < _userStakes[user].length; i++) {
                                                  stakes[i] = _userStakes[user][i];
                                              }
                                              return stakes;
                                          }
                                          function getStake(address user, uint256 stakeIndex) external view returns (Stake memory stake) {
                                              Stake storage _userStake = _userStakes[user][stakeIndex];
                                              stake = _userStake;
                                          }
                                          /**
                                           * @dev Transfers amount of deposit tokens from the user.
                                           * @param data Not used.
                                           */
                                          function stake(
                                              address nftContract,
                                              uint256 nftIndex,
                                              bytes calldata data
                                          ) external defend(bannedContractList) {
                                              require(now > stakingEnabledTime, "staking-too-early");
                                              require(metadataResolver.isStakeable(nftContract, nftIndex), "EnokiGeyser: nft not stakeable");
                                              _stakeFor(msg.sender, msg.sender, nftContract, nftIndex);
                                          }
                                          // /**
                                          //  * @dev Transfers amount of deposit tokens from the user.
                                          //  * @param data Not used.
                                          //  */
                                          // function stakeBulk(
                                          //     address[] memory nftContracts,
                                          //     uint256[] memory nftIndicies,
                                          //     bytes calldata data
                                          // ) external defend(bannedContractList) {
                                          //     require(now > stakingEnabledTime, "staking-too-early");
                                          //     require(nftContracts.length == nftIndicies.length, "args length mismatch");
                                          //     for (uint256 i = 0; i < nftContracts.length; i++) {
                                          //         require(metadataResolver.isStakeable(nftContracts[i], nftIndicies[i]), "EnokiGeyser: nft not stakeable");
                                          //         _stakeFor(msg.sender, msg.sender, nftContracts[i], nftIndicies[i]);
                                          //     }
                                          // }
                                          /**
                                           * @dev Private implementation of staking methods.
                                           * @param staker User address who deposits tokens to stake.
                                           * @param beneficiary User address who gains credit for this stake operation.
                                           */
                                          function _stakeFor(
                                              address staker,
                                              address beneficiary,
                                              address nftContract,
                                              uint256 nftIndex
                                          ) private {
                                              require(beneficiary != address(0), "EnokiGeyser: beneficiary is zero address");
                                              require(metadataResolver.isStakeable(nftContract, nftIndex), "EnokiGeyser: Nft specified not stakeable");
                                              // Shares is determined by NFT mushroom rate
                                              MushroomLib.MushroomData memory metadata = metadataResolver.getMushroomData(nftContract, nftIndex, "");
                                              // 1. User Accounting
                                              UserTotals storage totals = _userTotals[beneficiary];
                                              Stake memory newStake = Stake(nftContract, nftIndex, metadata.strength, now);
                                              _userStakes[beneficiary].push(newStake);
                                              require(_userStakes[beneficiary].length <= maxStakesPerAddress, "EnokiGeyser: Stake would exceed maximum stakes for address");
                                              totals.userStrengthStaked = totals.userStrengthStaked.add(metadata.strength);
                                              totalStrengthStaked = totalStrengthStaked.add(metadata.strength);
                                              IERC721(nftContract).transferFrom(staker, address(this), nftIndex);
                                              emit Staked(beneficiary, nftContract, nftIndex, totalStakedFor(beneficiary), "");
                                          }
                                          /**
                                           * @dev Unstakes a certain amount of previously deposited tokens. User also receives their
                                           * alotted number of distribution tokens.
                                           * @param stakes Mushrooms to unstake.
                                           * @param data Not used.
                                           */
                                          function unstake(uint256[] calldata stakes, bytes calldata data)
                                              external
                                              returns (
                                                  uint256 totalReward,
                                                  uint256 userReward,
                                                  uint256 devReward
                                              )
                                          {
                                              _unstake(stakes);
                                          }
                                          /**
                                           * @dev Unstakes a certain amount of previously deposited tokens. User also receives their
                                           * alotted number of distribution tokens.
                                           * @param stakes Mushrooms to unstake.
                                           */
                                          function _unstake(uint256[] memory stakes)
                                              private
                                              returns (
                                                  uint256 totalReward,
                                                  uint256 userReward,
                                                  uint256 devReward
                                              )
                                          {
                                              // 1. User Accounting
                                              UserTotals storage totals = _userTotals[msg.sender];
                                              Stake[] storage accountStakes = _userStakes[msg.sender];
                                              // Redeem from most recent stake and go backwards in time.
                                              uint256 rewardAmount = 0;
                                              for (uint256 i = 0; i < stakes.length; i++) {
                                                  Stake storage currentStake = accountStakes[stakes[i]];
                                                  MushroomLib.MushroomData memory metadata = metadataResolver.getMushroomData(currentStake.nftContract, currentStake.nftIndex, "");
                                                  uint256 lifespanUsed = now.sub(currentStake.stakedAt);
                                                  bool deadMushroom = false;
                                                  // Effective lifespan used is capped at mushroom lifespan
                                                  if (lifespanUsed >= metadata.lifespan) {
                                                      lifespanUsed = metadata.lifespan;
                                                      deadMushroom = true;
                                                  }
                                                  emit LifespanUsed(currentStake.nftContract, currentStake.nftIndex, lifespanUsed, metadata.lifespan);
                                                  rewardAmount = computeNewReward(rewardAmount, metadata.strength, lifespanUsed);
                                                  // Update global aomunt staked
                                                  totalStrengthStaked = totalStrengthStaked.sub(metadata.strength);
                                                  totals.userStrengthStaked = totals.userStrengthStaked.sub(metadata.strength);
                                                  // Burn dead mushrooms, if they can be burnt. Otherwise, they can still be withdrawn with 0 lifespan.
                                                  if (deadMushroom && metadataResolver.isBurnable(currentStake.nftContract, currentStake.nftIndex)) {
                                                      MushroomNFT(currentStake.nftContract).burn(currentStake.nftIndex);
                                                      emit BurnedMushroom(currentStake.nftContract, currentStake.nftIndex);
                                                  } else {
                                                      // If still alive, reduce lifespan of mushroom and return to user. If not burnable, return with 0 lifespan.
                                                      metadataResolver.setMushroomLifespan(currentStake.nftContract, currentStake.nftIndex, metadata.lifespan.sub(lifespanUsed), "");
                                                      IERC721(currentStake.nftContract).transferFrom(address(this), msg.sender, currentStake.nftIndex);
                                                      // TODO: Test
                                                      MushroomLib.MushroomData memory metadata2 = metadataResolver.getMushroomData(currentStake.nftContract, currentStake.nftIndex, "");
                                                      emit NewLifespan(currentStake.nftContract, currentStake.nftIndex, metadata2.lifespan);
                                                  }
                                                  accountStakes.pop();
                                                  emit Unstaked(msg.sender, currentStake.nftContract, currentStake.nftIndex, totalStakedFor(msg.sender), "");
                                              }
                                              // Already set in updateAccounting
                                              // _lastAccountingTimestampSec = now;
                                              // interactions
                                              totalReward= rewardAmount;
                                              (userReward, devReward) = computeDevReward(totalReward);
                                              if (userReward > 0) {
                                                  require(enokiToken.transfer(msg.sender, userReward), "EnokiGeyser: transfer to user out of unlocked pool failed");
                                              }
                                              if (devReward > 0) {
                                                  require(enokiToken.transfer(devRewardAddress, devReward), "EnokiGeyser: transfer to dev out of unlocked pool failed");
                                              }
                                              emit TokensClaimed(msg.sender, rewardAmount, userReward, devReward);
                                              require(totalStakingShares == 0 || totalStaked() > 0, "EnokiGeyser: Error unstaking. Staking shares exist, but no staking tokens do");
                                          }
                                          function computeNewReward(
                                              uint256 currentReward,
                                              uint256 strength,
                                              uint256 timeStaked
                                          ) private view returns (uint256) {
                                              uint256 newReward = strength.mul(timeStaked).div(SECONDS_PER_WEEK);
                                              return currentReward.add(newReward);
                                          }
                                          /**
                                           * @dev Determines split of specified reward amount between user and dev.
                                           * @param totalReward Amount of reward to split.
                                           * @return userReward Reward amounts for user and dev.
                                           * @return devReward Reward amounts for user and dev.
                                           */
                                          function computeDevReward(uint256 totalReward) public view returns (uint256 userReward, uint256 devReward) {
                                              if (devRewardPercentage == 0) {
                                                  userReward = totalReward;
                                                  devReward = 0;
                                              } else if (devRewardPercentage == MAX_PERCENTAGE) {
                                                  userReward = 0;
                                                  devReward = totalReward;
                                              } else {
                                                  devReward = totalReward.mul(devRewardPercentage).div(MAX_PERCENTAGE);
                                                  userReward = totalReward.sub(devReward); // Extra dust due to truncated rounding goes to user
                                              }
                                          }
                                          /**
                                           * @param addr The user to look up staking information for.
                                           * @return The number of staking tokens deposited for addr.
                                           */
                                          function totalStakedFor(address addr) public view returns (uint256) {
                                              return _userTotals[addr].userStrengthStaked;
                                          }
                                          /**
                                           * @return The total number of deposit tokens staked globally, by all users.
                                           */
                                          function totalStaked() public view returns (uint256) {
                                              return totalStrengthStaked;
                                          }
                                          /**
                                           * @return Total number of locked distribution tokens.
                                           */
                                          function totalLocked() public view returns (uint256) {
                                              return enokiToken.balanceOf(address(this));
                                          }
                                          /**
                                           * @dev This funcion allows the contract owner to add more locked distribution tokens, along
                                           *      with the associated "unlock schedule". These locked tokens immediately begin unlocking
                                           *      linearly over the duraction of durationSec timeframe.
                                           * @param amount Number of distribution tokens to lock. These are transferred from the caller.
                                           * @param durationSec Length of time to linear unlock the tokens.
                                           */
                                          function lockTokens(uint256 amount, uint256 durationSec) external onlyOwner {
                                              require(enokiToken.transferFrom(msg.sender, address(this), amount), "EnokiGeyser: transfer failed");
                                              emit TokensLocked(amount, totalLocked());
                                          }
                                          function lockTokensAirdrop(address airdrop, uint256 amount) external onlyAdmin {
                                              require(usedAirdropPool.add(amount) <= maxAirdropPool, "Exceeds maximum airdrop tokens");
                                              usedAirdropPool = usedAirdropPool.add(amount);
                                              
                                              require(enokiToken.transfer(address(airdrop), amount), "EnokiGeyser: transfer into airdrop pool failed");
                                              
                                              emit TokensLockedAirdrop(airdrop, amount, totalLocked());
                                          }
                                      }
                                      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);
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../utils/EnumerableSet.sol";
                                      import "../utils/Address.sol";
                                      import "../GSN/Context.sol";
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Contract module that allows children to implement role-based access
                                       * control mechanisms.
                                       *
                                       * 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, _msgSender()));
                                       *     ...
                                       * }
                                       * ```
                                       *
                                       * 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}.
                                       */
                                      abstract contract AccessControlUpgradeSafe is Initializable, ContextUpgradeSafe {
                                          function __AccessControl_init() internal initializer {
                                              __Context_init_unchained();
                                              __AccessControl_init_unchained();
                                          }
                                          function __AccessControl_init_unchained() internal initializer {
                                          }
                                          using EnumerableSet for EnumerableSet.AddressSet;
                                          using Address for address;
                                          struct RoleData {
                                              EnumerableSet.AddressSet members;
                                              bytes32 adminRole;
                                          }
                                          mapping (bytes32 => RoleData) private _roles;
                                          bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
                                          /**
                                           * @dev Emitted when `account` is granted `role`.
                                           *
                                           * `sender` is the account that originated the contract call, an admin role
                                           * bearer except when using {_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) public view returns (bool) {
                                              return _roles[role].members.contains(account);
                                          }
                                          /**
                                           * @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 returns (uint256) {
                                              return _roles[role].members.length();
                                          }
                                          /**
                                           * @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 returns (address) {
                                              return _roles[role].members.at(index);
                                          }
                                          /**
                                           * @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 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.
                                           */
                                          function grantRole(bytes32 role, address account) public virtual {
                                              require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to grant");
                                              _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.
                                           */
                                          function revokeRole(bytes32 role, address account) public virtual {
                                              require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to revoke");
                                              _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 granted `role`, emits a {RoleRevoked}
                                           * event.
                                           *
                                           * Requirements:
                                           *
                                           * - the caller must be `account`.
                                           */
                                          function renounceRole(bytes32 role, address account) public virtual {
                                              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.
                                           *
                                           * [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}.
                                           * ====
                                           */
                                          function _setupRole(bytes32 role, address account) internal virtual {
                                              _grantRole(role, account);
                                          }
                                          /**
                                           * @dev Sets `adminRole` as ``role``'s admin role.
                                           */
                                          function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
                                              _roles[role].adminRole = adminRole;
                                          }
                                          function _grantRole(bytes32 role, address account) private {
                                              if (_roles[role].members.add(account)) {
                                                  emit RoleGranted(role, account, _msgSender());
                                              }
                                          }
                                          function _revokeRole(bytes32 role, address account) private {
                                              if (_roles[role].members.remove(account)) {
                                                  emit RoleRevoked(role, account, _msgSender());
                                              }
                                          }
                                          uint256[49] private __gap;
                                      }
                                      pragma solidity ^0.6.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.0.0, only sets of type `address` (`AddressSet`) and `uint256`
                                       * (`UintSet`) are supported.
                                       */
                                      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;
                                                  // When the value to delete is the last one, the swap operation is unnecessary. However, since this occurs
                                                  // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                                                  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] = toDeleteIndex + 1; // All indexes are 1-based
                                                  // 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) {
                                              require(set._values.length > index, "EnumerableSet: index out of bounds");
                                              return set._values[index];
                                          }
                                          // 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(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(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(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(uint256(_at(set._inner, index)));
                                          }
                                          // 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));
                                          }
                                      }
                                      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");
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Contract module that helps prevent reentrant calls to a function.
                                       *
                                       * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
                                       * available, which can be applied to functions to make sure there are no nested
                                       * (reentrant) calls to them.
                                       *
                                       * Note that because there is a single `nonReentrant` guard, functions marked as
                                       * `nonReentrant` may not call one another. This can be worked around by making
                                       * those functions `private`, and then adding `external` `nonReentrant` entry
                                       * points to them.
                                       *
                                       * TIP: If you would like to learn more about reentrancy and alternative ways
                                       * to protect against it, check out our blog post
                                       * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
                                       */
                                      contract ReentrancyGuardUpgradeSafe is Initializable {
                                          bool private _notEntered;
                                          function __ReentrancyGuard_init() internal initializer {
                                              __ReentrancyGuard_init_unchained();
                                          }
                                          function __ReentrancyGuard_init_unchained() internal initializer {
                                              // Storing an initial non-zero value makes deployment a bit more
                                              // expensive, but in exchange the refund on every call to nonReentrant
                                              // will be lower in amount. Since refunds are capped to a percetange of
                                              // the total transaction's gas, it is best to keep them low in cases
                                              // like this one, to increase the likelihood of the full refund coming
                                              // into effect.
                                              _notEntered = true;
                                          }
                                          /**
                                           * @dev Prevents a contract from calling itself, directly or indirectly.
                                           * Calling a `nonReentrant` function from another `nonReentrant`
                                           * function is not supported. It is possible to prevent this from happening
                                           * by making the `nonReentrant` function external, and make it call a
                                           * `private` function that does the actual work.
                                           */
                                          modifier nonReentrant() {
                                              // On the first call to nonReentrant, _notEntered will be true
                                              require(_notEntered, "ReentrancyGuard: reentrant call");
                                              // Any calls to nonReentrant after this point will fail
                                              _notEntered = false;
                                              _;
                                              // By storing the original value once again, a refund is triggered (see
                                              // https://eips.ethereum.org/EIPS/eip-2200)
                                              _notEntered = true;
                                          }
                                          uint256[49] private __gap;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      /**
                                       * @title A simple holder of tokens.
                                       * This is a simple contract to hold tokens. It's useful in the case where a separate contract
                                       * needs to hold multiple distinct pools of the same token.
                                       */
                                      contract TokenPool is Initializable, OwnableUpgradeSafe {
                                          IERC20 public token;
                                          function initialize(IERC20 _token) public initializer {
                                              __Ownable_init();
                                              token = _token;
                                          }
                                          function balance() public view returns (uint256) {
                                              return token.balanceOf(address(this));
                                          }
                                          function transfer(address to, uint256 value) external onlyOwner returns (bool) {
                                              return token.transfer(to, value);
                                          }
                                          function rescueFunds(address tokenToRescue, address to, uint256 amount) external onlyOwner returns (bool) {
                                              require(address(token) != tokenToRescue, 'TokenPool: Cannot claim token held by the contract');
                                              return IERC20(tokenToRescue).transfer(to, amount);
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "./ERC721.sol";
                                      import "./MushroomLib.sol";
                                      /*
                                          Minting and burning permissions are managed by the Owner
                                      */
                                      contract MushroomNFT is ERC721UpgradeSafe, OwnableUpgradeSafe, AccessControlUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          mapping (uint256 => MushroomLib.MushroomData) public mushroomData; // NFT Id -> Metadata
                                          mapping (uint256 => MushroomLib.MushroomType) public mushroomTypes; // Species Id -> Metadata
                                          mapping (uint256 => bool) public mushroomTypeExists; // Species Id -> Exists
                                          mapping (uint256 => string) public mushroomMetadataUri; // Species Id -> URI
                                          bytes32 public constant LIFESPAN_MODIFIER_ROLE = keccak256("LIFESPAN_MODIFIER_ROLE");
                                          bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");
                                          function initialize() public initializer {
                                              __Ownable_init_unchained();
                                              __AccessControl_init_unchained();
                                              __ERC721_init("Enoki Mushrooms", "Enoki Mushrooms");
                                              _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                                          }
                                          /* ========== VIEWS ========== */
                                          // Mushrooms inherit their strength from their species
                                          function getMushroomData(uint256 tokenId) public view returns (MushroomLib.MushroomData memory) {
                                              MushroomLib.MushroomData memory data = mushroomData[tokenId];
                                              return data;
                                          }
                                          function getSpecies(uint256 speciesId) public view returns (MushroomLib.MushroomType memory) {
                                              return mushroomTypes[speciesId];
                                          }
                                          function getRemainingMintableForSpecies(uint256 speciesId) public view returns (uint256) {
                                              MushroomLib.MushroomType storage species = mushroomTypes[speciesId];
                                              return species.cap.sub(species.minted);
                                          }
                                          /// @notice Return token URI for mushroom
                                          /// @notice URI is determined by species and can be modifed by the owner
                                          function tokenURI(uint256 tokenId) public view override returns (string memory) {
                                              MushroomLib.MushroomData storage data = mushroomData[tokenId];
                                              return mushroomMetadataUri[data.species];
                                          }  
                                          /* ========== ROLE MANAGEMENT ========== */
                                          // TODO: Ensure we can transfer admin role privledges
                                          modifier onlyLifespanModifier() {
                                              require(hasRole(LIFESPAN_MODIFIER_ROLE, msg.sender), "MushroomNFT: Only approved lifespan modifier");
                                              _;
                                          }
                                          modifier onlyMinter() {
                                              require(hasRole(MINTER_ROLE, msg.sender), "MushroomNFT: Only approved mushroom minter");
                                              _;
                                          }
                                          /* ========== RESTRICTED FUNCTIONS ========== */
                                          /**
                                           * @dev The burner must be the owner of the token, or approved. The EnokiGeyser owns tokens when it burns them.
                                           */
                                          function burn(uint256 tokenId) public {
                                              //solhint-disable-next-line max-line-length
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721Burnable: caller is not owner nor approved");
                                              _burn(tokenId);
                                              _clearMushroomData(tokenId);
                                          }
                                          function mint(address recipient, uint256 tokenId, uint256 speciesId, uint256 lifespan) public onlyMinter {
                                              _mintWithMetadata(recipient, tokenId, speciesId, lifespan);
                                          }
                                          function setMushroomLifespan(uint256 index, uint256 lifespan) public onlyLifespanModifier {
                                              mushroomData[index].lifespan = lifespan;
                                          }
                                          function setSpeciesUri(uint256 speciesId, string memory URI) public onlyOwner {
                                              mushroomMetadataUri[speciesId] = URI;
                                          }
                                          function _mintWithMetadata(address recipient, uint256 tokenId, uint256 speciesId, uint256 lifespan) internal {
                                              require(mushroomTypeExists[speciesId], "MushroomNFT: mushroom species specified does not exist");
                                              MushroomLib.MushroomType storage species = mushroomTypes[speciesId];
                                              require(species.minted < species.cap, "MushroomNFT: minting cap reached for species");
                                              species.minted = species.minted.add(1);
                                              mushroomData[tokenId] = MushroomLib.MushroomData(speciesId, species.strength, lifespan);
                                              _safeMint(recipient, tokenId);
                                          }
                                          // TODO: We don't really have to do this as a newly minted mushroom will set the data
                                          function _clearMushroomData(uint256 tokenId) internal {
                                              MushroomLib.MushroomData storage data = mushroomData[tokenId];
                                              MushroomLib.MushroomType storage species = mushroomTypes[data.species];   
                                              mushroomData[tokenId].species = 0;
                                              mushroomData[tokenId].strength = 0;
                                              mushroomData[tokenId].lifespan = 0;
                                              species.minted = species.minted.sub(1);
                                          }
                                          function setMushroomType(uint256 speciesId, MushroomLib.MushroomType memory mType) public onlyOwner {
                                              if (!mushroomTypeExists[speciesId]) {
                                                  mushroomTypeExists[speciesId] = true;
                                              }
                                              mushroomTypes[speciesId] = mType;
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/GSN/Context.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Metadata.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Enumerable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Receiver.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/introspection/ERC165.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/Address.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/EnumerableSet.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/EnumerableMap.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/Strings.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/Initializable.sol";
                                      /**
                                       * @title ERC721 Non-Fungible Token Standard basic implementation
                                       * @dev see https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      contract ERC721UpgradeSafe is Initializable, ContextUpgradeSafe, ERC165UpgradeSafe, IERC721, IERC721Metadata, IERC721Enumerable {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          using EnumerableSet for EnumerableSet.UintSet;
                                          using EnumerableMap for EnumerableMap.UintToAddressMap;
                                          using Strings for uint256;
                                          // Equals to `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
                                          // which can be also obtained as `IERC721Receiver(0).onERC721Received.selector`
                                          bytes4 private constant _ERC721_RECEIVED = 0x150b7a02;
                                          // Mapping from holder address to their (enumerable) set of owned tokens
                                          mapping (address => EnumerableSet.UintSet) private _holderTokens;
                                          // Enumerable mapping from token ids to their owners
                                          EnumerableMap.UintToAddressMap private _tokenOwners;
                                          // Mapping from token ID to approved address
                                          mapping (uint256 => address) private _tokenApprovals;
                                          // Mapping from owner to operator approvals
                                          mapping (address => mapping (address => bool)) private _operatorApprovals;
                                          // Token name
                                          string private _name;
                                          // Token symbol
                                          string private _symbol;
                                          // Optional mapping for token URIs
                                          mapping(uint256 => string) private _tokenURIs;
                                          // Base URI
                                          string private _baseURI;
                                          /*
                                           *     bytes4(keccak256('balanceOf(address)')) == 0x70a08231
                                           *     bytes4(keccak256('ownerOf(uint256)')) == 0x6352211e
                                           *     bytes4(keccak256('approve(address,uint256)')) == 0x095ea7b3
                                           *     bytes4(keccak256('getApproved(uint256)')) == 0x081812fc
                                           *     bytes4(keccak256('setApprovalForAll(address,bool)')) == 0xa22cb465
                                           *     bytes4(keccak256('isApprovedForAll(address,address)')) == 0xe985e9c5
                                           *     bytes4(keccak256('transferFrom(address,address,uint256)')) == 0x23b872dd
                                           *     bytes4(keccak256('safeTransferFrom(address,address,uint256)')) == 0x42842e0e
                                           *     bytes4(keccak256('safeTransferFrom(address,address,uint256,bytes)')) == 0xb88d4fde
                                           *
                                           *     => 0x70a08231 ^ 0x6352211e ^ 0x095ea7b3 ^ 0x081812fc ^
                                           *        0xa22cb465 ^ 0xe985e9c ^ 0x23b872dd ^ 0x42842e0e ^ 0xb88d4fde == 0x80ac58cd
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721 = 0x80ac58cd;
                                          /*
                                           *     bytes4(keccak256('name()')) == 0x06fdde03
                                           *     bytes4(keccak256('symbol()')) == 0x95d89b41
                                           *     bytes4(keccak256('tokenURI(uint256)')) == 0xc87b56dd
                                           *
                                           *     => 0x06fdde03 ^ 0x95d89b41 ^ 0xc87b56dd == 0x5b5e139f
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721_METADATA = 0x5b5e139f;
                                          /*
                                           *     bytes4(keccak256('totalSupply()')) == 0x18160ddd
                                           *     bytes4(keccak256('tokenOfOwnerByIndex(address,uint256)')) == 0x2f745c59
                                           *     bytes4(keccak256('tokenByIndex(uint256)')) == 0x4f6ccce7
                                           *
                                           *     => 0x18160ddd ^ 0x2f745c59 ^ 0x4f6ccce7 == 0x780e9d63
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721_ENUMERABLE = 0x780e9d63;
                                          function __ERC721_init(string memory name, string memory symbol) internal initializer {
                                              __Context_init_unchained();
                                              __ERC165_init_unchained();
                                              __ERC721_init_unchained(name, symbol);
                                          }
                                          function __ERC721_init_unchained(string memory name, string memory symbol) internal initializer {
                                              _name = name;
                                              _symbol = symbol;
                                              // register the supported interfaces to conform to ERC721 via ERC165
                                              _registerInterface(_INTERFACE_ID_ERC721);
                                              _registerInterface(_INTERFACE_ID_ERC721_METADATA);
                                              _registerInterface(_INTERFACE_ID_ERC721_ENUMERABLE);
                                          }
                                          /**
                                           * @dev Gets the balance of the specified address.
                                           * @param owner address to query the balance of
                                           * @return uint256 representing the amount owned by the passed address
                                           */
                                          function balanceOf(address owner) public view override returns (uint256) {
                                              require(owner != address(0), "ERC721: balance query for the zero address");
                                              return _holderTokens[owner].length();
                                          }
                                          /**
                                           * @dev Gets the owner of the specified token ID.
                                           * @param tokenId uint256 ID of the token to query the owner of
                                           * @return address currently marked as the owner of the given token ID
                                           */
                                          function ownerOf(uint256 tokenId) public view override returns (address) {
                                              return _tokenOwners.get(tokenId, "ERC721: owner query for nonexistent token");
                                          }
                                          /**
                                           * @dev Gets the token name.
                                           * @return string representing the token name
                                           */
                                          function name() public view override returns (string memory) {
                                              return _name;
                                          }
                                          /**
                                           * @dev Gets the token symbol.
                                           * @return string representing the token symbol
                                           */
                                          function symbol() public view override returns (string memory) {
                                              return _symbol;
                                          }
                                          /**
                                           * @dev Returns the URI for a given token ID. May return an empty string.
                                           *
                                           * If a base URI is set (via {_setBaseURI}), it is added as a prefix to the
                                           * token's own URI (via {_setTokenURI}).
                                           *
                                           * If there is a base URI but no token URI, the token's ID will be used as
                                           * its URI when appending it to the base URI. This pattern for autogenerated
                                           * token URIs can lead to large gas savings.
                                           *
                                           * .Examples
                                           * |===
                                           * |`_setBaseURI()` |`_setTokenURI()` |`tokenURI()`
                                           * | ""
                                           * | ""
                                           * | ""
                                           * | ""
                                           * | "token.uri/123"
                                           * | "token.uri/123"
                                           * | "token.uri/"
                                           * | "123"
                                           * | "token.uri/123"
                                           * | "token.uri/"
                                           * | ""
                                           * | "token.uri/<tokenId>"
                                           * |===
                                           *
                                           * Requirements:
                                           *
                                           * - `tokenId` must exist.
                                           */
                                          function tokenURI(uint256 tokenId) public view override virtual returns (string memory) {
                                              require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
                                              string memory _tokenURI = _tokenURIs[tokenId];
                                              // If there is no base URI, return the token URI.
                                              if (bytes(_baseURI).length == 0) {
                                                  return _tokenURI;
                                              }
                                              // If both are set, concatenate the baseURI and tokenURI (via abi.encodePacked).
                                              if (bytes(_tokenURI).length > 0) {
                                                  return string(abi.encodePacked(_baseURI, _tokenURI));
                                              }
                                              // If there is a baseURI but no tokenURI, concatenate the tokenID to the baseURI.
                                              return string(abi.encodePacked(_baseURI, tokenId.toString()));
                                          }
                                          /**
                                          * @dev Returns the base URI set via {_setBaseURI}. This will be
                                          * automatically added as a prefix in {tokenURI} to each token's URI, or
                                          * to the token ID if no specific URI is set for that token ID.
                                          */
                                          function baseURI() public view returns (string memory) {
                                              return _baseURI;
                                          }
                                          /**
                                           * @dev Gets the token ID at a given index of the tokens list of the requested owner.
                                           * @param owner address owning the tokens list to be accessed
                                           * @param index uint256 representing the index to be accessed of the requested tokens list
                                           * @return uint256 token ID at the given index of the tokens list owned by the requested address
                                           */
                                          function tokenOfOwnerByIndex(address owner, uint256 index) public view override returns (uint256) {
                                              return _holderTokens[owner].at(index);
                                          }
                                          /**
                                           * @dev Gets the total amount of tokens stored by the contract.
                                           * @return uint256 representing the total amount of tokens
                                           */
                                          function totalSupply() public view override returns (uint256) {
                                              // _tokenOwners are indexed by tokenIds, so .length() returns the number of tokenIds
                                              return _tokenOwners.length();
                                          }
                                          /**
                                           * @dev Gets the token ID at a given index of all the tokens in this contract
                                           * Reverts if the index is greater or equal to the total number of tokens.
                                           * @param index uint256 representing the index to be accessed of the tokens list
                                           * @return uint256 token ID at the given index of the tokens list
                                           */
                                          function tokenByIndex(uint256 index) public view override returns (uint256) {
                                              (uint256 tokenId, ) = _tokenOwners.at(index);
                                              return tokenId;
                                          }
                                          /**
                                           * @dev Approves another address to transfer the given token ID
                                           * The zero address indicates there is no approved address.
                                           * There can only be one approved address per token at a given time.
                                           * Can only be called by the token owner or an approved operator.
                                           * @param to address to be approved for the given token ID
                                           * @param tokenId uint256 ID of the token to be approved
                                           */
                                          function approve(address to, uint256 tokenId) public virtual override {
                                              address owner = ownerOf(tokenId);
                                              require(to != owner, "ERC721: approval to current owner");
                                              require(_msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                                                  "ERC721: approve caller is not owner nor approved for all"
                                              );
                                              _approve(to, tokenId);
                                          }
                                          /**
                                           * @dev Gets the approved address for a token ID, or zero if no address set
                                           * Reverts if the token ID does not exist.
                                           * @param tokenId uint256 ID of the token to query the approval of
                                           * @return address currently approved for the given token ID
                                           */
                                          function getApproved(uint256 tokenId) public view override returns (address) {
                                              require(_exists(tokenId), "ERC721: approved query for nonexistent token");
                                              return _tokenApprovals[tokenId];
                                          }
                                          /**
                                           * @dev Sets or unsets the approval of a given operator
                                           * An operator is allowed to transfer all tokens of the sender on their behalf.
                                           * @param operator operator address to set the approval
                                           * @param approved representing the status of the approval to be set
                                           */
                                          function setApprovalForAll(address operator, bool approved) public virtual override {
                                              require(operator != _msgSender(), "ERC721: approve to caller");
                                              _operatorApprovals[_msgSender()][operator] = approved;
                                              emit ApprovalForAll(_msgSender(), operator, approved);
                                          }
                                          /**
                                           * @dev Tells whether an operator is approved by a given owner.
                                           * @param owner owner address which you want to query the approval of
                                           * @param operator operator address which you want to query the approval of
                                           * @return bool whether the given operator is approved by the given owner
                                           */
                                          function isApprovedForAll(address owner, address operator) public view override returns (bool) {
                                              return _operatorApprovals[owner][operator];
                                          }
                                          /**
                                           * @dev Transfers the ownership of a given token ID to another address.
                                           * Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
                                           * Requires the msg.sender to be the owner, approved, or operator.
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function transferFrom(address from, address to, uint256 tokenId) public virtual override {
                                              //solhint-disable-next-line max-line-length
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                                              _transfer(from, to, tokenId);
                                          }
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement {IERC721Receiver-onERC721Received},
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the msg.sender to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId) public virtual override {
                                              safeTransferFrom(from, to, tokenId, "");
                                          }
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement {IERC721Receiver-onERC721Received},
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the _msgSender() to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory _data) public virtual override {
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                                              _safeTransfer(from, to, tokenId, _data);
                                          }
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the msg.sender to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function _safeTransfer(address from, address to, uint256 tokenId, bytes memory _data) internal virtual {
                                              _transfer(from, to, tokenId);
                                              require(_checkOnERC721Received(from, to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
                                          }
                                          /**
                                           * @dev Returns whether the specified token exists.
                                           * @param tokenId uint256 ID of the token to query the existence of
                                           * @return bool whether the token exists
                                           */
                                          function _exists(uint256 tokenId) internal view returns (bool) {
                                              return _tokenOwners.contains(tokenId);
                                          }
                                          /**
                                           * @dev Returns whether the given spender can transfer a given token ID.
                                           * @param spender address of the spender to query
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @return bool whether the msg.sender is approved for the given token ID,
                                           * is an operator of the owner, or is the owner of the token
                                           */
                                          function _isApprovedOrOwner(address spender, uint256 tokenId) internal view returns (bool) {
                                              require(_exists(tokenId), "ERC721: operator query for nonexistent token");
                                              address owner = ownerOf(tokenId);
                                              return (spender == owner || getApproved(tokenId) == spender || isApprovedForAll(owner, spender));
                                          }
                                          /**
                                           * @dev Internal function to safely mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           */
                                          function _safeMint(address to, uint256 tokenId) internal virtual {
                                              _safeMint(to, tokenId, "");
                                          }
                                          /**
                                           * @dev Internal function to safely mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function _safeMint(address to, uint256 tokenId, bytes memory _data) internal virtual {
                                              _mint(to, tokenId);
                                              require(_checkOnERC721Received(address(0), to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
                                          }
                                          /**
                                           * @dev Internal function to mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           */
                                          function _mint(address to, uint256 tokenId) internal virtual {
                                              require(to != address(0), "ERC721: mint to the zero address");
                                              require(!_exists(tokenId), "ERC721: token already minted");
                                              _beforeTokenTransfer(address(0), to, tokenId);
                                              _holderTokens[to].add(tokenId);
                                              _tokenOwners.set(tokenId, to);
                                              emit Transfer(address(0), to, tokenId);
                                          }
                                          /**
                                           * @dev Internal function to burn a specific token.
                                           * Reverts if the token does not exist.
                                           * @param tokenId uint256 ID of the token being burned
                                           */
                                          function _burn(uint256 tokenId) internal virtual {
                                              address owner = ownerOf(tokenId);
                                              _beforeTokenTransfer(owner, address(0), tokenId);
                                              // Clear approvals
                                              _approve(address(0), tokenId);
                                              // Clear metadata (if any)
                                              if (bytes(_tokenURIs[tokenId]).length != 0) {
                                                  delete _tokenURIs[tokenId];
                                              }
                                              _holderTokens[owner].remove(tokenId);
                                              _tokenOwners.remove(tokenId);
                                              emit Transfer(owner, address(0), tokenId);
                                          }
                                          /**
                                           * @dev Internal function to transfer ownership of a given token ID to another address.
                                           * As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function _transfer(address from, address to, uint256 tokenId) internal virtual {
                                              require(ownerOf(tokenId) == from, "ERC721: transfer of token that is not own");
                                              require(to != address(0), "ERC721: transfer to the zero address");
                                              _beforeTokenTransfer(from, to, tokenId);
                                              // Clear approvals from the previous owner
                                              _approve(address(0), tokenId);
                                              _holderTokens[from].remove(tokenId);
                                              _holderTokens[to].add(tokenId);
                                              _tokenOwners.set(tokenId, to);
                                              emit Transfer(from, to, tokenId);
                                          }
                                          /**
                                           * @dev Internal function to set the token URI for a given token.
                                           *
                                           * Reverts if the token ID does not exist.
                                           *
                                           * TIP: If all token IDs share a prefix (for example, if your URIs look like
                                           * `https://api.myproject.com/token/<id>`), use {_setBaseURI} to store
                                           * it and save gas.
                                           */
                                          function _setTokenURI(uint256 tokenId, string memory _tokenURI) internal virtual {
                                              require(_exists(tokenId), "ERC721Metadata: URI set of nonexistent token");
                                              _tokenURIs[tokenId] = _tokenURI;
                                          }
                                          /**
                                           * @dev Internal function to set the base URI for all token IDs. It is
                                           * automatically added as a prefix to the value returned in {tokenURI},
                                           * or to the token ID if {tokenURI} is empty.
                                           */
                                          function _setBaseURI(string memory baseURI_) internal virtual {
                                              _baseURI = baseURI_;
                                          }
                                          /**
                                           * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
                                           * The call is not executed if the target address is not a contract.
                                           *
                                           * @param from address representing the previous owner of the given token ID
                                           * @param to target address that will receive the tokens
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes optional data to send along with the call
                                           * @return bool whether the call correctly returned the expected magic value
                                           */
                                          function _checkOnERC721Received(address from, address to, uint256 tokenId, bytes memory _data)
                                              private returns (bool)
                                          {
                                              if (!to.isContract()) {
                                                  return true;
                                              }
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, bytes memory returndata) = to.call(abi.encodeWithSelector(
                                                  IERC721Receiver(to).onERC721Received.selector,
                                                  _msgSender(),
                                                  from,
                                                  tokenId,
                                                  _data
                                              ));
                                              if (!success) {
                                                  if (returndata.length > 0) {
                                                      // solhint-disable-next-line no-inline-assembly
                                                      assembly {
                                                          let returndata_size := mload(returndata)
                                                          revert(add(32, returndata), returndata_size)
                                                      }
                                                  } else {
                                                      revert("ERC721: transfer to non ERC721Receiver implementer");
                                                  }
                                              } else {
                                                  bytes4 retval = abi.decode(returndata, (bytes4));
                                                  return (retval == _ERC721_RECEIVED);
                                              }
                                          }
                                          function _approve(address to, uint256 tokenId) private {
                                              _tokenApprovals[tokenId] = to;
                                              emit Approval(ownerOf(tokenId), to, tokenId);
                                          }
                                          /**
                                           * @dev Hook that is called before any token transfer. This includes minting
                                           * and burning.
                                           *
                                           * Calling conditions:
                                           *
                                           * - when `from` and `to` are both non-zero, ``from``'s `tokenId` will be
                                           * transferred to `to`.
                                           * - when `from` is zero, `tokenId` will be minted for `to`.
                                           * - when `to` is zero, ``from``'s `tokenId` 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 tokenId) internal virtual { }
                                          uint256[41] private __gap;
                                      }
                                      pragma solidity ^0.6.2;
                                      import "../../introspection/IERC165.sol";
                                      /**
                                       * @dev Required interface of an ERC721 compliant contract.
                                       */
                                      interface IERC721 is IERC165 {
                                          event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
                                          event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
                                          event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
                                          /**
                                           * @dev Returns the number of NFTs in ``owner``'s account.
                                           */
                                          function balanceOf(address owner) external view returns (uint256 balance);
                                          /**
                                           * @dev Returns the owner of the NFT specified by `tokenId`.
                                           */
                                          function ownerOf(uint256 tokenId) external view returns (address owner);
                                          /**
                                           * @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to
                                           * another (`to`).
                                           *
                                           *
                                           *
                                           * Requirements:
                                           * - `from`, `to` cannot be zero.
                                           * - `tokenId` must be owned by `from`.
                                           * - If the caller is not `from`, it must be have been allowed to move this
                                           * NFT by either {approve} or {setApprovalForAll}.
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId) external;
                                          /**
                                           * @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to
                                           * another (`to`).
                                           *
                                           * Requirements:
                                           * - If the caller is not `from`, it must be approved to move this NFT by
                                           * either {approve} or {setApprovalForAll}.
                                           */
                                          function transferFrom(address from, address to, uint256 tokenId) external;
                                          function approve(address to, uint256 tokenId) external;
                                          function getApproved(uint256 tokenId) external view returns (address operator);
                                          function setApprovalForAll(address operator, bool _approved) external;
                                          function isApprovedForAll(address owner, address operator) external view returns (bool);
                                          function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;
                                      }
                                      pragma solidity ^0.6.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);
                                      }
                                      pragma solidity ^0.6.2;
                                      import "./IERC721.sol";
                                      /**
                                       * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
                                       * @dev See https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      interface IERC721Metadata is IERC721 {
                                          function name() external view returns (string memory);
                                          function symbol() external view returns (string memory);
                                          function tokenURI(uint256 tokenId) external view returns (string memory);
                                      }
                                      pragma solidity ^0.6.2;
                                      import "./IERC721.sol";
                                      /**
                                       * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
                                       * @dev See https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      interface IERC721Enumerable is IERC721 {
                                          function totalSupply() external view returns (uint256);
                                          function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256 tokenId);
                                          function tokenByIndex(uint256 index) external view returns (uint256);
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @title ERC721 token receiver interface
                                       * @dev Interface for any contract that wants to support safeTransfers
                                       * from ERC721 asset contracts.
                                       */
                                      interface IERC721Receiver {
                                          /**
                                           * @notice Handle the receipt of an NFT
                                           * @dev The ERC721 smart contract calls this function on the recipient
                                           * after a {IERC721-safeTransferFrom}. This function MUST return the function selector,
                                           * otherwise the caller will revert the transaction. The selector to be
                                           * returned can be obtained as `this.onERC721Received.selector`. This
                                           * function MAY throw to revert and reject the transfer.
                                           * Note: the ERC721 contract address is always the message sender.
                                           * @param operator The address which called `safeTransferFrom` function
                                           * @param from The address which previously owned the token
                                           * @param tokenId The NFT identifier which is being transferred
                                           * @param data Additional data with no specified format
                                           * @return bytes4 `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
                                           */
                                          function onERC721Received(address operator, address from, uint256 tokenId, bytes calldata data)
                                          external returns (bytes4);
                                      }
                                      pragma solidity ^0.6.0;
                                      import "./IERC165.sol";
                                      import "../Initializable.sol";
                                      /**
                                       * @dev Implementation of the {IERC165} interface.
                                       *
                                       * Contracts may inherit from this and call {_registerInterface} to declare
                                       * their support of an interface.
                                       */
                                      contract ERC165UpgradeSafe is Initializable, IERC165 {
                                          /*
                                           * bytes4(keccak256('supportsInterface(bytes4)')) == 0x01ffc9a7
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC165 = 0x01ffc9a7;
                                          /**
                                           * @dev Mapping of interface ids to whether or not it's supported.
                                           */
                                          mapping(bytes4 => bool) private _supportedInterfaces;
                                          function __ERC165_init() internal initializer {
                                              __ERC165_init_unchained();
                                          }
                                          function __ERC165_init_unchained() internal initializer {
                                              // Derived contracts need only register support for their own interfaces,
                                              // we register support for ERC165 itself here
                                              _registerInterface(_INTERFACE_ID_ERC165);
                                          }
                                          /**
                                           * @dev See {IERC165-supportsInterface}.
                                           *
                                           * Time complexity O(1), guaranteed to always use less than 30 000 gas.
                                           */
                                          function supportsInterface(bytes4 interfaceId) public view override returns (bool) {
                                              return _supportedInterfaces[interfaceId];
                                          }
                                          /**
                                           * @dev Registers the contract as an implementer of the interface defined by
                                           * `interfaceId`. Support of the actual ERC165 interface is automatic and
                                           * registering its interface id is not required.
                                           *
                                           * See {IERC165-supportsInterface}.
                                           *
                                           * Requirements:
                                           *
                                           * - `interfaceId` cannot be the ERC165 invalid interface (`0xffffffff`).
                                           */
                                          function _registerInterface(bytes4 interfaceId) internal virtual {
                                              require(interfaceId != 0xffffffff, "ERC165: invalid interface id");
                                              _supportedInterfaces[interfaceId] = true;
                                          }
                                          uint256[49] private __gap;
                                      }
                                      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) {
                                              // Solidity only automatically asserts when dividing by 0
                                              require(b > 0, errorMessage);
                                              uint256 c = a / b;
                                              // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return mod(a, b, "SafeMath: modulo by zero");
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts with custom message when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b != 0, errorMessage);
                                              return a % b;
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Library for managing an enumerable variant of Solidity's
                                       * https://solidity.readthedocs.io/en/latest/types.html#mapping-types[`mapping`]
                                       * type.
                                       *
                                       * Maps have the following properties:
                                       *
                                       * - Entries are added, removed, and checked for existence in constant time
                                       * (O(1)).
                                       * - Entries are enumerated in O(n). No guarantees are made on the ordering.
                                       *
                                       * ```
                                       * contract Example {
                                       *     // Add the library methods
                                       *     using EnumerableMap for EnumerableMap.UintToAddressMap;
                                       *
                                       *     // Declare a set state variable
                                       *     EnumerableMap.UintToAddressMap private myMap;
                                       * }
                                       * ```
                                       *
                                       * As of v3.0.0, only maps of type `uint256 -> address` (`UintToAddressMap`) are
                                       * supported.
                                       */
                                      library EnumerableMap {
                                          // To implement this library for multiple types with as little code
                                          // repetition as possible, we write it in terms of a generic Map type with
                                          // bytes32 keys and values.
                                          // The Map implementation uses private functions, and user-facing
                                          // implementations (such as Uint256ToAddressMap) are just wrappers around
                                          // the underlying Map.
                                          // This means that we can only create new EnumerableMaps for types that fit
                                          // in bytes32.
                                          struct MapEntry {
                                              bytes32 _key;
                                              bytes32 _value;
                                          }
                                          struct Map {
                                              // Storage of map keys and values
                                              MapEntry[] _entries;
                                              // Position of the entry defined by a key in the `entries` array, plus 1
                                              // because index 0 means a key is not in the map.
                                              mapping (bytes32 => uint256) _indexes;
                                          }
                                          /**
                                           * @dev Adds a key-value pair to a map, or updates the value for an existing
                                           * key. O(1).
                                           *
                                           * Returns true if the key was added to the map, that is if it was not
                                           * already present.
                                           */
                                          function _set(Map storage map, bytes32 key, bytes32 value) private returns (bool) {
                                              // We read and store the key's index to prevent multiple reads from the same storage slot
                                              uint256 keyIndex = map._indexes[key];
                                              if (keyIndex == 0) { // Equivalent to !contains(map, key)
                                                  map._entries.push(MapEntry({ _key: key, _value: value }));
                                                  // The entry is stored at length-1, but we add 1 to all indexes
                                                  // and use 0 as a sentinel value
                                                  map._indexes[key] = map._entries.length;
                                                  return true;
                                              } else {
                                                  map._entries[keyIndex - 1]._value = value;
                                                  return false;
                                              }
                                          }
                                          /**
                                           * @dev Removes a key-value pair from a map. O(1).
                                           *
                                           * Returns true if the key was removed from the map, that is if it was present.
                                           */
                                          function _remove(Map storage map, bytes32 key) private returns (bool) {
                                              // We read and store the key's index to prevent multiple reads from the same storage slot
                                              uint256 keyIndex = map._indexes[key];
                                              if (keyIndex != 0) { // Equivalent to contains(map, key)
                                                  // To delete a key-value pair from the _entries array in O(1), we swap the entry to delete with the last one
                                                  // in the array, and then remove the last entry (sometimes called as 'swap and pop').
                                                  // This modifies the order of the array, as noted in {at}.
                                                  uint256 toDeleteIndex = keyIndex - 1;
                                                  uint256 lastIndex = map._entries.length - 1;
                                                  // When the entry to delete is the last one, the swap operation is unnecessary. However, since this occurs
                                                  // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                                                  MapEntry storage lastEntry = map._entries[lastIndex];
                                                  // Move the last entry to the index where the entry to delete is
                                                  map._entries[toDeleteIndex] = lastEntry;
                                                  // Update the index for the moved entry
                                                  map._indexes[lastEntry._key] = toDeleteIndex + 1; // All indexes are 1-based
                                                  // Delete the slot where the moved entry was stored
                                                  map._entries.pop();
                                                  // Delete the index for the deleted slot
                                                  delete map._indexes[key];
                                                  return true;
                                              } else {
                                                  return false;
                                              }
                                          }
                                          /**
                                           * @dev Returns true if the key is in the map. O(1).
                                           */
                                          function _contains(Map storage map, bytes32 key) private view returns (bool) {
                                              return map._indexes[key] != 0;
                                          }
                                          /**
                                           * @dev Returns the number of key-value pairs in the map. O(1).
                                           */
                                          function _length(Map storage map) private view returns (uint256) {
                                              return map._entries.length;
                                          }
                                         /**
                                          * @dev Returns the key-value pair stored at position `index` in the map. O(1).
                                          *
                                          * Note that there are no guarantees on the ordering of entries inside the
                                          * array, and it may change when more entries are added or removed.
                                          *
                                          * Requirements:
                                          *
                                          * - `index` must be strictly less than {length}.
                                          */
                                          function _at(Map storage map, uint256 index) private view returns (bytes32, bytes32) {
                                              require(map._entries.length > index, "EnumerableMap: index out of bounds");
                                              MapEntry storage entry = map._entries[index];
                                              return (entry._key, entry._value);
                                          }
                                          /**
                                           * @dev Returns the value associated with `key`.  O(1).
                                           *
                                           * Requirements:
                                           *
                                           * - `key` must be in the map.
                                           */
                                          function _get(Map storage map, bytes32 key) private view returns (bytes32) {
                                              return _get(map, key, "EnumerableMap: nonexistent key");
                                          }
                                          /**
                                           * @dev Same as {_get}, with a custom error message when `key` is not in the map.
                                           */
                                          function _get(Map storage map, bytes32 key, string memory errorMessage) private view returns (bytes32) {
                                              uint256 keyIndex = map._indexes[key];
                                              require(keyIndex != 0, errorMessage); // Equivalent to contains(map, key)
                                              return map._entries[keyIndex - 1]._value; // All indexes are 1-based
                                          }
                                          // UintToAddressMap
                                          struct UintToAddressMap {
                                              Map _inner;
                                          }
                                          /**
                                           * @dev Adds a key-value pair to a map, or updates the value for an existing
                                           * key. O(1).
                                           *
                                           * Returns true if the key was added to the map, that is if it was not
                                           * already present.
                                           */
                                          function set(UintToAddressMap storage map, uint256 key, address value) internal returns (bool) {
                                              return _set(map._inner, bytes32(key), bytes32(uint256(value)));
                                          }
                                          /**
                                           * @dev Removes a value from a set. O(1).
                                           *
                                           * Returns true if the key was removed from the map, that is if it was present.
                                           */
                                          function remove(UintToAddressMap storage map, uint256 key) internal returns (bool) {
                                              return _remove(map._inner, bytes32(key));
                                          }
                                          /**
                                           * @dev Returns true if the key is in the map. O(1).
                                           */
                                          function contains(UintToAddressMap storage map, uint256 key) internal view returns (bool) {
                                              return _contains(map._inner, bytes32(key));
                                          }
                                          /**
                                           * @dev Returns the number of elements in the map. O(1).
                                           */
                                          function length(UintToAddressMap storage map) internal view returns (uint256) {
                                              return _length(map._inner);
                                          }
                                         /**
                                          * @dev Returns the element 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(UintToAddressMap storage map, uint256 index) internal view returns (uint256, address) {
                                              (bytes32 key, bytes32 value) = _at(map._inner, index);
                                              return (uint256(key), address(uint256(value)));
                                          }
                                          /**
                                           * @dev Returns the value associated with `key`.  O(1).
                                           *
                                           * Requirements:
                                           *
                                           * - `key` must be in the map.
                                           */
                                          function get(UintToAddressMap storage map, uint256 key) internal view returns (address) {
                                              return address(uint256(_get(map._inner, bytes32(key))));
                                          }
                                          /**
                                           * @dev Same as {get}, with a custom error message when `key` is not in the map.
                                           */
                                          function get(UintToAddressMap storage map, uint256 key, string memory errorMessage) internal view returns (address) {
                                              return address(uint256(_get(map._inner, bytes32(key), errorMessage)));
                                          }
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev String operations.
                                       */
                                      library Strings {
                                          /**
                                           * @dev Converts a `uint256` to its ASCII `string` 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);
                                              uint256 index = digits - 1;
                                              temp = value;
                                              while (temp != 0) {
                                                  buffer[index--] = byte(uint8(48 + temp % 10));
                                                  temp /= 10;
                                              }
                                              return string(buffer);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      library MushroomLib {
                                          struct MushroomData {
                                              uint256 species;
                                              uint256 strength;
                                              uint256 lifespan;
                                          }
                                          struct MushroomType {
                                              uint256 id;
                                              uint256 strength;
                                              uint256 minLifespan;
                                              uint256 maxLifespan;
                                              uint256 minted;
                                              uint256 cap;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "./adapters/MetadataAdapter.sol";
                                      import "../MushroomLib.sol";
                                      /*
                                          A hub of adapters managing lifespan metadata for arbitrary NFTs
                                          Each adapter has it's own custom logic for that NFT
                                          Lifespan modification requesters have rights to manage lifespan metadata of NFTs via the adapters
                                          Admin(s) can manage the set of resolvers
                                      */
                                      contract MetadataResolver is AccessControlUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          mapping(address => address) public metadataAdapters;
                                          modifier onlyAdmin() {
                                              require(hasRole(DEFAULT_ADMIN_ROLE, msg.sender), "onlyAdmin");
                                              _;
                                          }
                                          modifier onlyLifespanModifier() {
                                              require(hasRole(LIFESPAN_MODIFY_REQUEST_ROLE, msg.sender), "onlyLifespanModifier");
                                              _;
                                          }
                                          bytes32 public constant LIFESPAN_MODIFY_REQUEST_ROLE = keccak256("LIFESPAN_MODIFY_REQUEST_ROLE");
                                          event ResolverSet(address nft, address resolver);
                                          modifier onlyWithMetadataAdapter(address nftContract) {
                                              require(metadataAdapters[nftContract] != address(0), "MetadataRegistry: No resolver set for nft");
                                              _;
                                          }
                                          function hasMetadataAdapter(address nftContract) external view returns (bool) {
                                              return metadataAdapters[nftContract] != address(0);
                                          }
                                          function getMetadataAdapter(address nftContract) external view returns (address) {
                                              return metadataAdapters[nftContract];
                                          }
                                          function isStakeable(address nftContract, uint256 nftIndex) external view returns (bool) {
                                              if (metadataAdapters[nftContract] == address(0)) {
                                                  return false;
                                              }
                                              
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              return resolver.isStakeable(nftIndex);
                                          }
                                          function initialize(address initialLifespanModifier_) public initializer {
                                              _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                                              _setupRole(LIFESPAN_MODIFY_REQUEST_ROLE, initialLifespanModifier_);
                                          }
                                          function getMushroomData(
                                              address nftContract,
                                              uint256 nftIndex,
                                              bytes calldata data
                                          ) external view onlyWithMetadataAdapter(nftContract) returns (MushroomLib.MushroomData memory) {
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              MushroomLib.MushroomData memory mushroomData = resolver.getMushroomData(nftIndex, data);
                                              return mushroomData;
                                          }
                                          function isBurnable(address nftContract, uint256 nftIndex) external view onlyWithMetadataAdapter(nftContract) returns (bool) {
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              return resolver.isBurnable(nftIndex);
                                          }
                                          function setMushroomLifespan(
                                              address nftContract,
                                              uint256 nftIndex,
                                              uint256 lifespan,
                                              bytes calldata data
                                          ) external onlyWithMetadataAdapter(nftContract) onlyLifespanModifier {
                                              MetadataAdapter resolver = MetadataAdapter(metadataAdapters[nftContract]);
                                              resolver.setMushroomLifespan(nftIndex, lifespan, data);
                                          }
                                          function setResolver(address nftContract, address resolver) public onlyAdmin {
                                              metadataAdapters[nftContract] = resolver;
                                              emit ResolverSet(nftContract, resolver);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "../../MushroomLib.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      /*
                                          Reads mushroom NFT metadata for a given NFT contract
                                          Also forwards requests from the MetadataResolver to set lifespan
                                      */
                                      abstract contract MetadataAdapter is AccessControlUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          bytes32 public constant LIFESPAN_MODIFY_REQUEST_ROLE = keccak256("LIFESPAN_MODIFY_REQUEST_ROLE");
                                          modifier onlyLifespanModifier() {
                                              require(hasRole(LIFESPAN_MODIFY_REQUEST_ROLE, msg.sender), "onlyLifespanModifier");
                                              _;
                                          }
                                          function getMushroomData(uint256 index, bytes calldata data) external virtual view returns (MushroomLib.MushroomData memory);
                                          function setMushroomLifespan(uint256 index, uint256 lifespan, bytes calldata data) external virtual;
                                          function isBurnable(uint256 index) external view virtual returns (bool);
                                          function isStakeable(uint256 index) external view virtual returns (bool);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      /**
                                       * @title EthVesting
                                       * @dev A eth holder contract that can release its eth balance gradually like a
                                       * typical vesting scheme, with a cliff and vesting period.
                                       */
                                      contract EthVesting {
                                          // The vesting schedule is time-based (i.e. using block timestamps as opposed to e.g. block numbers), and is
                                          // therefore sensitive to timestamp manipulation (which is something miners can do, to a certain degree). Therefore,
                                          // it is recommended to avoid using short time durations (less than a minute). Typical vesting schemes, with a
                                          // cliff period of a year and a duration of four years, are safe to use.
                                          // solhint-disable not-rely-on-time
                                          using SafeMath for uint256;
                                          event EthReleased(uint256 amount);
                                          event EthReleasedBackup(uint256 amount);
                                          event PaymentReceived(address from, uint256 amount);
                                          // beneficiary of tokens after they are released
                                          address payable private _beneficiary;
                                          address payable private _backupBeneficiary;
                                          // Durations and timestamps are expressed in UNIX time, the same units as block.timestamp.
                                          uint256 private _cliff;
                                          uint256 private _start;
                                          uint256 private _duration;
                                          uint256 private _backupReleaseGracePeriod;
                                          uint256 private _released;
                                          /**
                                           * @dev Creates a vesting contract that vests its balance of any ERC20 token to the
                                           * beneficiary, gradually in a linear fashion until start + duration. By then all
                                           * of the balance will have vested.
                                           * @param beneficiary address of the beneficiary to whom vested tokens are transferred
                                           * @param cliffDuration duration in seconds of the cliff in which tokens will begin to vest
                                           * @param start the time (as Unix time) at which point vesting starts
                                           * @param duration duration in seconds of the period in which the tokens will vest
                                           * @param backupReleaseGracePeriod the period after the duration in completed before the backup beneficiary can withdraw
                                           */
                                          constructor (address payable beneficiary, address payable backupBeneficiary, uint256 start, uint256 cliffDuration, uint256 duration, uint256 backupReleaseGracePeriod) public {
                                              require(beneficiary != address(0), "EthVesting: beneficiary is the zero address");
                                              // solhint-disable-next-line max-line-length
                                              require(cliffDuration <= duration, "EthVesting: cliff is longer than duration");
                                              require(duration > 0, "EthVesting: duration is 0");
                                              // solhint-disable-next-line max-line-length
                                              require(start.add(duration) > block.timestamp, "EthVesting: final time is before current time");
                                              _beneficiary = beneficiary;
                                              _backupBeneficiary = backupBeneficiary;
                                              _duration = duration;
                                              _cliff = start.add(cliffDuration);
                                              _start = start;
                                              _backupReleaseGracePeriod = backupReleaseGracePeriod;
                                          }
                                          /**
                                           * @return the beneficiary of the ether.
                                           */
                                          function beneficiary() public view returns (address) {
                                              return _beneficiary;
                                          }
                                          /**
                                           * @return the backup beneficiary of the ether.
                                           */
                                          function backupBeneficiary() public view returns (address) {
                                              return _backupBeneficiary;
                                          }
                                          /**
                                           * @return the period after the duration in completed before the backup beneficiary can withdraw.
                                           */
                                          function backupReleaseGracePeriod() public view returns (uint256) {
                                              return _backupReleaseGracePeriod;
                                          }
                                          /**
                                           * @return the cliff time of the eth vesting.
                                           */
                                          function cliff() public view returns (uint256) {
                                              return _cliff;
                                          }
                                          /**
                                           * @return the start time of the eth vesting.
                                           */
                                          function start() public view returns (uint256) {
                                              return _start;
                                          }
                                          /**
                                           * @return the duration of the eth vesting.
                                           */
                                          function duration() public view returns (uint256) {
                                              return _duration;
                                          }
                                          /**
                                           * @return the amount of the token released.
                                           */
                                          function released() public view returns (uint256) {
                                              return _released;
                                          }
                                          /**
                                           * @notice Transfers vested tokens to beneficiary.
                                           */
                                          function release() public {
                                              uint256 unreleased = _releasableAmount();
                                              require(unreleased > 0, "EthVesting: no eth is due");
                                              _released = _released.add(unreleased);
                                              _beneficiary.transfer(unreleased);
                                              emit EthReleased(unreleased);
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested but hasn't been released yet.
                                           */
                                          function _releasableAmount() private view returns (uint256) {
                                              return _vestedAmount().sub(_released);
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested.
                                           */
                                          function _vestedAmount() private view returns (uint256) {
                                              uint256 currentBalance = address(this).balance;
                                              uint256 totalBalance = currentBalance.add(_released);
                                              if (block.timestamp < _cliff) {
                                                  return 0;
                                              } else if (block.timestamp >= _start.add(_duration)) {
                                                  return totalBalance;
                                              } else {
                                                  return totalBalance.mul(block.timestamp.sub(_start)).div(_duration);
                                              }
                                          }
                                          /**
                                           * @dev After the vesting period is complete, allows for withdrawal by backup beneficiary if funds are unclaimed after the post-duration grace period
                                           */
                                          function backupRelease() public {
                                              require(block.timestamp >= _start.add(_duration).add(_backupReleaseGracePeriod));
                                              _backupBeneficiary.transfer(address(this).balance);
                                              emit EthReleasedBackup(address(this).balance);
                                          }
                                          // Allow Recieve Ether
                                          receive () external payable virtual {
                                              emit PaymentReceived(msg.sender, msg.value);
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Wrappers over Solidity's arithmetic operations with added overflow
                                       * checks.
                                       *
                                       * Arithmetic operations in Solidity wrap on overflow. This can easily result
                                       * in bugs, because programmers usually assume that an overflow raises an
                                       * error, which is the standard behavior in high level programming languages.
                                       * `SafeMath` restores this intuition by reverting the transaction when an
                                       * operation overflows.
                                       *
                                       * Using this library instead of the unchecked operations eliminates an entire
                                       * class of bugs, so it's recommended to use it always.
                                       */
                                      library SafeMath {
                                          /**
                                           * @dev Returns the addition of two unsigned integers, reverting on
                                           * overflow.
                                           *
                                           * Counterpart to Solidity's `+` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Addition cannot overflow.
                                           */
                                          function add(uint256 a, uint256 b) internal pure returns (uint256) {
                                              uint256 c = a + b;
                                              require(c >= a, "SafeMath: addition overflow");
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the subtraction of two unsigned integers, reverting on
                                           * overflow (when the result is negative).
                                           *
                                           * Counterpart to Solidity's `-` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Subtraction cannot overflow.
                                           */
                                          function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return sub(a, b, "SafeMath: subtraction overflow");
                                          }
                                          /**
                                           * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
                                           * overflow (when the result is negative).
                                           *
                                           * Counterpart to Solidity's `-` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Subtraction cannot overflow.
                                           */
                                          function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b <= a, errorMessage);
                                              uint256 c = a - b;
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the multiplication of two unsigned integers, reverting on
                                           * overflow.
                                           *
                                           * Counterpart to Solidity's `*` operator.
                                           *
                                           * Requirements:
                                           *
                                           * - Multiplication cannot overflow.
                                           */
                                          function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                                              // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                                              // benefit is lost if 'b' is also tested.
                                              // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
                                              if (a == 0) {
                                                  return 0;
                                              }
                                              uint256 c = a * b;
                                              require(c / a == b, "SafeMath: multiplication overflow");
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the integer division of two unsigned integers. Reverts on
                                           * division by zero. The result is rounded towards zero.
                                           *
                                           * Counterpart to Solidity's `/` operator. Note: this function uses a
                                           * `revert` opcode (which leaves remaining gas untouched) while Solidity
                                           * uses an invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function div(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return div(a, b, "SafeMath: division by zero");
                                          }
                                          /**
                                           * @dev Returns the integer division of two unsigned integers. Reverts with custom message on
                                           * division by zero. The result is rounded towards zero.
                                           *
                                           * Counterpart to Solidity's `/` operator. Note: this function uses a
                                           * `revert` opcode (which leaves remaining gas untouched) while Solidity
                                           * uses an invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b > 0, errorMessage);
                                              uint256 c = a / b;
                                              // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                                              return c;
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return mod(a, b, "SafeMath: modulo by zero");
                                          }
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts with custom message when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           *
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b != 0, errorMessage);
                                              return a % b;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      import "./EnokiGeyser.sol";
                                      contract GeyserEscrow is Ownable {
                                          EnokiGeyser public geyser;
                                          constructor(EnokiGeyser geyser_) public {
                                              geyser = geyser_;
                                          }
                                          function lockTokens(
                                              uint256 amount,
                                              uint256 durationSec
                                          ) external onlyOwner {
                                              IERC20 distributionToken = geyser.getDistributionToken();
                                              distributionToken.approve(address(geyser), amount);
                                              geyser.lockTokens(amount, durationSec);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "../GSN/Context.sol";
                                      /**
                                       * @dev Contract module which provides a basic access control mechanism, where
                                       * there is an account (an owner) that can be granted exclusive access to
                                       * specific functions.
                                       *
                                       * By default, the owner account will be the one that deploys the contract. This
                                       * can later be changed with {transferOwnership}.
                                       *
                                       * This module is used through inheritance. It will make available the modifier
                                       * `onlyOwner`, which can be applied to your functions to restrict their use to
                                       * the owner.
                                       */
                                      contract Ownable is Context {
                                          address private _owner;
                                          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                                          /**
                                           * @dev Initializes the contract setting the deployer as the initial owner.
                                           */
                                          constructor () internal {
                                              address msgSender = _msgSender();
                                              _owner = msgSender;
                                              emit OwnershipTransferred(address(0), msgSender);
                                          }
                                          /**
                                           * @dev Returns the address of the current owner.
                                           */
                                          function owner() public view returns (address) {
                                              return _owner;
                                          }
                                          /**
                                           * @dev Throws if called by any account other than the owner.
                                           */
                                          modifier onlyOwner() {
                                              require(_owner == _msgSender(), "Ownable: caller is not the owner");
                                              _;
                                          }
                                          /**
                                           * @dev Leaves the contract without owner. It will not be possible to call
                                           * `onlyOwner` functions anymore. Can only be called by the current owner.
                                           *
                                           * NOTE: Renouncing ownership will leave the contract without an owner,
                                           * thereby removing any functionality that is only available to the owner.
                                           */
                                          function renounceOwnership() public virtual onlyOwner {
                                              emit OwnershipTransferred(_owner, address(0));
                                              _owner = address(0);
                                          }
                                          /**
                                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                                           * Can only be called by the current owner.
                                           */
                                          function transferOwnership(address newOwner) public virtual onlyOwner {
                                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                                              emit OwnershipTransferred(_owner, newOwner);
                                              _owner = newOwner;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /*
                                       * @dev Provides information about the current execution context, including the
                                       * sender of the transaction and its data. While these are generally available
                                       * via msg.sender and msg.data, they should not be accessed in such a direct
                                       * manner, since when dealing with GSN meta-transactions the account sending and
                                       * paying for execution may not be the actual sender (as far as an application
                                       * is concerned).
                                       *
                                       * This contract is only required for intermediate, library-like contracts.
                                       */
                                      abstract contract Context {
                                          function _msgSender() internal view virtual returns (address payable) {
                                              return msg.sender;
                                          }
                                          function _msgData() internal view virtual returns (bytes memory) {
                                              this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                                              return msg.data;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface IMiniMe {
                                          /* ========== STANDARD ERC20 ========== */
                                          function totalSupply() external view returns (uint256);
                                          function balanceOf(address account) external view returns (uint256);
                                          function transfer(address recipient, uint256 amount) external returns (bool);
                                          function allowance(address owner, address spender) external view returns (uint256);
                                          function approve(address spender, uint256 amount) external returns (bool);
                                          function transferFrom(
                                              address sender,
                                              address recipient,
                                              uint256 amount
                                          ) external returns (bool);
                                          event Transfer(address indexed from, address indexed to, uint256 value);
                                          event Approval(address indexed owner, address indexed spender, uint256 value);
                                          /* ========== MINIME EXTENSIONS ========== */
                                          function balanceOfAt(address account, uint256 blockNumber) external view returns (uint256);
                                          function totalSupplyAt(uint256 blockNumber) external view returns (uint256);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface IMission  {
                                          function sendSpores(address recipient, uint256 amount) external;
                                          function approvePool(address pool) external;
                                          function revokePool(address pool) external;
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      interface IMushroomFactory  {
                                          function costPerMushroom() external returns (uint256);
                                          function getRemainingMintableForMySpecies(uint256 numMushrooms) external view returns (uint256);
                                          function growMushrooms(address recipient, uint256 numMushrooms) external;
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "../MushroomLib.sol";
                                      abstract contract IMushroomMetadata {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          function hasMetadataAdapter(address nftContract) external virtual view returns (bool);
                                          function getMushroomData(
                                              address nftContract,
                                              uint256 nftIndex,
                                              bytes calldata data
                                          ) external virtual view returns (MushroomLib.MushroomData memory);
                                          function setMushroomLifespan(
                                              address nftContract,
                                              uint256 nftIndex,
                                              uint256 lifespan,
                                              bytes calldata data
                                          ) external virtual;
                                          function setResolver(address nftContract, address resolver) public virtual;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface IRateVoteable {
                                          function changeRate(uint256 percentage) external;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      interface ISporeToken {
                                          /* ========== STANDARD ERC20 ========== */
                                          function totalSupply() external view returns (uint256);
                                          function balanceOf(address account) external view returns (uint256);
                                          function transfer(address recipient, uint256 amount) external returns (bool);
                                          function allowance(address owner, address spender) external view returns (uint256);
                                          function approve(address spender, uint256 amount) external returns (bool);
                                          function transferFrom(
                                              address sender,
                                              address recipient,
                                              uint256 amount
                                          ) external returns (bool);
                                          event Transfer(address indexed from, address indexed to, uint256 value);
                                          event Approval(address indexed owner, address indexed spender, uint256 value);
                                          /* ========== EXTENSIONS ========== */
                                          function burn(uint256 amount) external;
                                          function mint(address to, uint256 amount) external;
                                          function addInitialLiquidityTransferRights(address account) external;
                                          function enableTransfers() external;
                                          function addMinter(address account) external;
                                          function removeMinter(address account) external;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      abstract contract ITokenPool {
                                          function token() external virtual view returns (IERC20);
                                          function balance() external virtual view returns (uint256);
                                          function transfer(address to, uint256 value) external virtual returns (bool);
                                          function rescueFunds(address tokenToRescue, address to, uint256 amount) external virtual returns (bool);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "../../MushroomNFT.sol";
                                      import "../../MushroomLib.sol";
                                      import "./MetadataAdapter.sol";
                                      /*
                                          Reads mushroom NFT metadata directly from the Mushroom NFT contract
                                          Also forwards requests from the MetadataResolver to a given forwarder, that cannot be modified
                                      */
                                      contract MushroomAdapter is Initializable, MetadataAdapter {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          MushroomNFT public mushroomNft;
                                          function initialize(address nftContract_, address forwardActionsFrom_) public initializer {
                                              mushroomNft = MushroomNFT(nftContract_);
                                              _setupRole(LIFESPAN_MODIFY_REQUEST_ROLE, forwardActionsFrom_);
                                          }
                                          function getMushroomData(uint256 index, bytes calldata data) external override view returns (MushroomLib.MushroomData memory) {
                                              MushroomLib.MushroomData memory mData = mushroomNft.getMushroomData(index);
                                              return mData;
                                          }
                                          // Mushrooms can always be staked
                                          function isStakeable(uint256 nftIndex) external override view returns (bool) {
                                              return true;
                                          }
                                          // All Mushrooms are burnable
                                          function isBurnable(uint256 index) external override view returns (bool) {
                                              return true;
                                          }
                                          function setMushroomLifespan(
                                              uint256 index,
                                              uint256 lifespan,
                                              bytes calldata data
                                          ) external override onlyLifespanModifier {
                                              mushroomNft.setMushroomLifespan(index, lifespan);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
                                      /*
                                          A pool of spores that can be takens by Spore pools according to their spore rate
                                      */
                                      contract Mission is Initializable, OwnableUpgradeSafe {
                                          IERC20 public sporeToken;
                                          mapping (address => bool) public approved;
                                          event SporesHarvested(address pool, uint256 amount);
                                          modifier onlyApprovedPool() {
                                              require(approved[msg.sender], "Mission: Only approved pools");
                                              _;
                                          }
                                          function initialize(IERC20 sporeToken_) public initializer {
                                              __Ownable_init();
                                              sporeToken = sporeToken_;
                                          }
                                          function sendSpores(address recipient, uint256 amount) public onlyApprovedPool {
                                              sporeToken.transfer(recipient, amount);
                                              emit SporesHarvested(msg.sender, amount);
                                          }
                                          function approvePool(address pool) public onlyOwner {
                                              approved[pool] = true;
                                          }
                                          function revokePool(address pool) public onlyOwner {
                                              approved[pool] = false;
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Interface of the ERC20 standard as defined in the EIP.
                                       */
                                      interface IERC20 {
                                          /**
                                           * @dev Returns the amount of tokens in existence.
                                           */
                                          function totalSupply() external view returns (uint256);
                                          /**
                                           * @dev Returns the amount of tokens owned by `account`.
                                           */
                                          function balanceOf(address account) external view returns (uint256);
                                          /**
                                           * @dev Moves `amount` tokens from the caller's account to `recipient`.
                                           *
                                           * Returns a boolean value indicating whether the operation succeeded.
                                           *
                                           * Emits a {Transfer} event.
                                           */
                                          function transfer(address recipient, uint256 amount) external returns (bool);
                                          /**
                                           * @dev Returns the remaining number of tokens that `spender` will be
                                           * allowed to spend on behalf of `owner` through {transferFrom}. This is
                                           * zero by default.
                                           *
                                           * This value changes when {approve} or {transferFrom} are called.
                                           */
                                          function allowance(address owner, address spender) external view returns (uint256);
                                          /**
                                           * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
                                           *
                                           * Returns a boolean value indicating whether the operation succeeded.
                                           *
                                           * IMPORTANT: Beware that changing an allowance with this method brings the risk
                                           * that someone may use both the old and the new allowance by unfortunate
                                           * transaction ordering. One possible solution to mitigate this race
                                           * condition is to first reduce the spender's allowance to 0 and set the
                                           * desired value afterwards:
                                           * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                                           *
                                           * Emits an {Approval} event.
                                           */
                                          function approve(address spender, uint256 amount) external returns (bool);
                                          /**
                                           * @dev Moves `amount` tokens from `sender` to `recipient` using the
                                           * allowance mechanism. `amount` is then deducted from the caller's
                                           * allowance.
                                           *
                                           * Returns a boolean value indicating whether the operation succeeded.
                                           *
                                           * Emits a {Transfer} event.
                                           */
                                          function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
                                          /**
                                           * @dev Emitted when `value` tokens are moved from one account (`from`) to
                                           * another (`to`).
                                           *
                                           * Note that `value` may be zero.
                                           */
                                          event Transfer(address indexed from, address indexed to, uint256 value);
                                          /**
                                           * @dev Emitted when the allowance of a `spender` for an `owner` is set by
                                           * a call to {approve}. `value` is the new allowance.
                                           */
                                          event Approval(address indexed owner, address indexed spender, uint256 value);
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "./MushroomNFT.sol";
                                      import "./MushroomLib.sol";
                                      /*
                                          MushroomFactories manage the mushroom generation logic for pools
                                          Each pool will have it's own factory to generate mushrooms according
                                          to its' powers.
                                          The mushroomFactory should be administered by the pool, which grants the ability to grow mushrooms
                                      */
                                      contract MushroomFactory is Initializable, OwnableUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          using SafeMath for uint256;
                                          event MushroomGrown(address recipient, uint256 id, uint256 species, uint256 lifespan);
                                          IERC20 public sporeToken;
                                          MushroomNFT public mushroomNft;
                                          uint256 public costPerMushroom;
                                          uint256 public mySpecies;
                                          uint256 public spawnCount;
                                          function initialize(
                                              IERC20 sporeToken_,
                                              MushroomNFT mushroomNft_,
                                              address sporePool_,
                                              uint256 costPerMushroom_,
                                              uint256 mySpecies_
                                          ) public initializer {
                                              __Ownable_init();
                                              sporeToken = sporeToken_;
                                              mushroomNft = mushroomNft_;
                                              costPerMushroom = costPerMushroom_;
                                              mySpecies = mySpecies_;
                                              transferOwnership(sporePool_);
                                          }
                                          /*
                                              Each mushroom will have a randomly generated lifespan within it's range. To prevent mushrooms harvested at the same block from having the same properties, a spawnCount seed is added to the block timestamp before hashing the timestamp to generate the lifespan for each individual mushroom.
                                              Note that block.timestamp is somewhat manipulatable by Miners. If a Miner was a massive ENOKI fan and only harvested when the mined a block they could give themselves mushrooms with longer lifespan than the average. However, the lifespan is still constained by the max lifespan. 
                                          */
                                          function _generateMushroomLifespan(uint256 minLifespan, uint256 maxLifespan) internal returns (uint256) {
                                              uint256 range = maxLifespan.sub(minLifespan);
                                              uint256 fromMin = uint256(keccak256(abi.encodePacked(block.timestamp.add(spawnCount)))) % range;
                                              spawnCount = spawnCount.add(1);
                                              return minLifespan.add(fromMin);
                                          }
                                          function getRemainingMintableForMySpecies() public view returns (uint256) {
                                              return mushroomNft.getRemainingMintableForSpecies(mySpecies);
                                          }
                                          // Each mushroom costs 1/10th of the spore rate in spores.
                                          function growMushrooms(address recipient, uint256 numMushrooms) public onlyOwner {
                                              MushroomLib.MushroomType memory species = mushroomNft.getSpecies(mySpecies);
                                              require(getRemainingMintableForMySpecies() >= numMushrooms, "MushroomFactory: Mushrooms to grow exceeds species cap");
                                              for (uint256 i = 0; i < numMushrooms; i++) {
                                                  uint256 nextId = mushroomNft.totalSupply().add(1);
                                                  uint256 lifespan = _generateMushroomLifespan(species.minLifespan, species.maxLifespan);
                                                  mushroomNft.mint(recipient, nextId, mySpecies, lifespan);
                                                  emit MushroomGrown(recipient, nextId, mySpecies, lifespan);
                                              }
                                          }
                                      }pragma solidity ^0.6.0;
                                      import "./IERC20.sol";
                                      import "../../math/SafeMath.sol";
                                      import "../../utils/Address.sol";
                                      /**
                                       * @title SafeERC20
                                       * @dev Wrappers around ERC20 operations that throw on failure (when the token
                                       * contract returns false). Tokens that return no value (and instead revert or
                                       * throw on failure) are also supported, non-reverting calls are assumed to be
                                       * successful.
                                       * To use this library you can add a `using SafeERC20 for ERC20;` statement to your contract,
                                       * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
                                       */
                                      library SafeERC20 {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          function safeTransfer(IERC20 token, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
                                          }
                                          function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
                                          }
                                          function safeApprove(IERC20 token, address spender, uint256 value) internal {
                                              // safeApprove should only be called when setting an initial allowance,
                                              // or when resetting it to zero. To increase and decrease it, use
                                              // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                                              // solhint-disable-next-line max-line-length
                                              require((value == 0) || (token.allowance(address(this), spender) == 0),
                                                  "SafeERC20: approve from non-zero to non-zero allowance"
                                              );
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
                                          }
                                          function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).add(value);
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          /**
                                           * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                                           * on the return value: the return value is optional (but if data is returned, it must not be false).
                                           * @param token The token targeted by the call.
                                           * @param data The call data (encoded using abi.encode or one of its variants).
                                           */
                                          function _callOptionalReturn(IERC20 token, bytes memory data) private {
                                              // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                                              // we're implementing it ourselves.
                                              // A Solidity high level call has three parts:
                                              //  1. The target address is checked to verify it contains contract code
                                              //  2. The call itself is made, and success asserted
                                              //  3. The return value is decoded, which in turn checks the size of the returned data.
                                              // solhint-disable-next-line max-line-length
                                              require(address(token).isContract(), "SafeERC20: call to non-contract");
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, bytes memory returndata) = address(token).call(data);
                                              require(success, "SafeERC20: low-level call failed");
                                              if (returndata.length > 0) { // Return data is optional
                                                  // solhint-disable-next-line max-line-length
                                                  require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                                              }
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/GSN/Context.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      /**
                                       * @title PaymentSplitter
                                       * @dev This contract allows to split Ether payments among a group of accounts. The sender does not need to be aware
                                       * that the Ether will be split in this way, since it is handled transparently by the contract.
                                       *
                                       * The split can be in equal parts or in any other arbitrary proportion. The way this is specified is by assigning each
                                       * account to a number of shares. Of all the Ether that this contract receives, each account will then be able to claim
                                       * an amount proportional to the percentage of total shares they were assigned.
                                       *
                                       * `PaymentSplitter` follows a _pull payment_ model. This means that payments are not automatically forwarded to the
                                       * accounts but kept in this contract, and the actual transfer is triggered as a separate step by calling the {release}
                                       * function.
                                       */
                                      contract PaymentSplitter is Context {
                                          using SafeMath for uint256;
                                          event PayeeAdded(address account, uint256 shares);
                                          event PaymentReleased(address to, uint256 amount);
                                          event PaymentReceived(address from, uint256 amount);
                                          uint256 private _totalShares;
                                          uint256 private _totalReleased;
                                          mapping(address => uint256) private _shares;
                                          mapping(address => uint256) private _released;
                                          address[] private _payees;
                                          /**
                                           * @dev Creates an instance of `PaymentSplitter` where each account in `payees` is assigned the number of shares at
                                           * the matching position in the `shares` array.
                                           *
                                           * All addresses in `payees` must be non-zero. Both arrays must have the same non-zero length, and there must be no
                                           * duplicates in `payees`.
                                           */
                                          constructor (address[] memory payees, uint256[] memory shares) public payable {
                                              // solhint-disable-next-line max-line-length
                                              require(payees.length == shares.length, "PaymentSplitter: payees and shares length mismatch");
                                              require(payees.length > 0, "PaymentSplitter: no payees");
                                              for (uint256 i = 0; i < payees.length; i++) {
                                                  _addPayee(payees[i], shares[i]);
                                              }
                                          }
                                          /**
                                           * @dev The Ether received will be logged with {PaymentReceived} events. Note that these events are not fully
                                           * reliable: it's possible for a contract to receive Ether without triggering this function. This only affects the
                                           * reliability of the events, and not the actual splitting of Ether.
                                           *
                                           * To learn more about this see the Solidity documentation for
                                           * https://solidity.readthedocs.io/en/latest/contracts.html#fallback-function[fallback
                                           * functions].
                                           */
                                          receive () external payable virtual {
                                              emit PaymentReceived(_msgSender(), msg.value);
                                          }
                                          /**
                                           * @dev Getter for the total shares held by payees.
                                           */
                                          function totalShares() public view returns (uint256) {
                                              return _totalShares;
                                          }
                                          /**
                                           * @dev Getter for the total amount of Ether already released.
                                           */
                                          function totalReleased() public view returns (uint256) {
                                              return _totalReleased;
                                          }
                                          /**
                                           * @dev Getter for the amount of shares held by an account.
                                           */
                                          function shares(address account) public view returns (uint256) {
                                              return _shares[account];
                                          }
                                          /**
                                           * @dev Getter for the amount of Ether already released to a payee.
                                           */
                                          function released(address account) public view returns (uint256) {
                                              return _released[account];
                                          }
                                          /**
                                           * @dev Getter for the address of the payee number `index`.
                                           */
                                          function payee(uint256 index) public view returns (address) {
                                              return _payees[index];
                                          }
                                          /**
                                           * @dev Triggers a transfer to `account` of the amount of Ether they are owed, according to their percentage of the
                                           * total shares and their previous withdrawals.
                                           */
                                          function release(address payable account) public virtual {
                                              require(_shares[account] > 0, "PaymentSplitter: account has no shares");
                                              uint256 totalReceived = address(this).balance.add(_totalReleased);
                                              uint256 payment = totalReceived.mul(_shares[account]).div(_totalShares).sub(_released[account]);
                                              require(payment != 0, "PaymentSplitter: account is not due payment");
                                              _released[account] = _released[account].add(payment);
                                              _totalReleased = _totalReleased.add(payment);
                                              account.transfer(payment);
                                              emit PaymentReleased(account, payment);
                                          }
                                          /**
                                           * @dev Add a new payee to the contract.
                                           * @param account The address of the payee to add.
                                           * @param shares_ The number of shares owned by the payee.
                                           */
                                          function _addPayee(address account, uint256 shares_) private {
                                              require(account != address(0), "PaymentSplitter: account is the zero address");
                                              require(shares_ > 0, "PaymentSplitter: shares are 0");
                                              require(_shares[account] == 0, "PaymentSplitter: account already has shares");
                                              _payees.push(account);
                                              _shares[account] = shares_;
                                              _totalShares = _totalShares.add(shares_);
                                              emit PayeeAdded(account, shares_);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/Math.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/ReentrancyGuard.sol";
                                      import "./Defensible.sol";
                                      import "./interfaces/IMiniMe.sol";
                                      import "./interfaces/ISporeToken.sol";
                                      import "./interfaces/IRateVoteable.sol";
                                      import "./BannedContractList.sol";
                                      /*
                                          Can be paused by the owner
                                          The mushroomFactory must be set by the owner before mushrooms can be harvested (optionally), and can be modified to use new mushroom spawning logic
                                      */
                                      contract RateVote is ReentrancyGuardUpgradeSafe, Defensible {
                                          using SafeMath for uint256;
                                          /* ========== STATE VARIABLES ========== */
                                          uint256 public constant MAX_PERCENTAGE = 100;
                                          uint256 public votingEnabledTime;
                                          mapping(address => uint256) lastVoted;
                                          struct VoteEpoch {
                                              uint256 startTime;
                                              uint256 activeEpoch;
                                              uint256 increaseVoteWeight;
                                              uint256 decreaseVoteWeight;
                                          }
                                          VoteEpoch public voteEpoch;
                                          uint256 public voteDuration;
                                          IMiniMe public enokiToken;
                                          IRateVoteable public pool;
                                          BannedContractList public bannedContractList;
                                          // In percentage: mul(X).div(100)
                                          uint256 public decreaseRateMultiplier;
                                          uint256 public increaseRateMultiplier;
                                          /* ========== CONSTRUCTOR ========== */
                                          function initialize(
                                              address _pool,
                                              address _enokiToken,
                                              uint256 _voteDuration,
                                              uint256 _votingEnabledTime,
                                              address _bannedContractList
                                          ) public virtual initializer {
                                              __ReentrancyGuard_init();
                                              pool = IRateVoteable(_pool);
                                              decreaseRateMultiplier = 50;
                                              increaseRateMultiplier = 150;
                                              votingEnabledTime = _votingEnabledTime;
                                              voteDuration = _voteDuration;
                                              enokiToken = IMiniMe(_enokiToken);
                                              voteEpoch = VoteEpoch({
                                                  startTime: votingEnabledTime, 
                                                  activeEpoch: 0, 
                                                  increaseVoteWeight: 0, 
                                                  decreaseVoteWeight: 0
                                              });
                                              bannedContractList = BannedContractList(_bannedContractList);
                                          }
                                          /*
                                              Votes with a given nonce invalidate other votes with the same nonce
                                              This ensures only one rate vote can pass for a given time period
                                          */
                                          function getVoteEpoch() external view returns (VoteEpoch memory) {
                                              return voteEpoch;
                                          }
                                          /* === Actions === */
                                          /// @notice Any user can vote once in a given voting epoch, with their balance at the start of the epoch
                                          function vote(uint256 voteId) external nonReentrant defend(bannedContractList) {
                                              require(now > votingEnabledTime, "Too early");
                                              require(now <= voteEpoch.startTime.add(voteDuration), "Vote has ended");
                                              require(lastVoted[msg.sender] < voteEpoch.activeEpoch, "Already voted");
                                              uint256 userWeight = enokiToken.balanceOfAt(msg.sender, voteEpoch.startTime);
                                              if (voteId == 0) {
                                                  // Decrease rate
                                                  voteEpoch.decreaseVoteWeight = voteEpoch.decreaseVoteWeight.add(userWeight);
                                              } else if (voteId == 1) {
                                                  // Increase rate
                                                  voteEpoch.increaseVoteWeight = voteEpoch.increaseVoteWeight.add(userWeight);
                                              } else {
                                                  revert("Invalid voteId");
                                              }
                                              lastVoted[msg.sender] = voteEpoch.activeEpoch;
                                              emit Vote(msg.sender, voteEpoch.activeEpoch, userWeight, voteId);
                                          }
                                          /// @notice Once a vote has exceeded the duration, it can be resolved, implementing the decision and starting the next vote    
                                          function resolveVote() external nonReentrant defend(bannedContractList) {
                                              require(now >= voteEpoch.startTime.add(voteDuration), "Vote still active");
                                              uint256 decision = 0;
                                              if (voteEpoch.decreaseVoteWeight > voteEpoch.increaseVoteWeight) {
                                                  // Decrease wins
                                                  pool.changeRate(decreaseRateMultiplier);
                                              } else if (voteEpoch.increaseVoteWeight > voteEpoch.decreaseVoteWeight) {
                                                  // Increase wins
                                                  pool.changeRate(increaseRateMultiplier);
                                                  decision = 1;
                                              } else {
                                                  //else Tie, no rate change
                                                  decision = 2;
                                              }
                                              emit VoteResolved(voteEpoch.activeEpoch, decision);
                                              voteEpoch.activeEpoch = voteEpoch.activeEpoch.add(1);
                                              voteEpoch.decreaseVoteWeight = 0;
                                              voteEpoch.increaseVoteWeight = 0;
                                              voteEpoch.startTime = now;
                                              emit VoteStarted(voteEpoch.activeEpoch, voteEpoch.startTime, voteEpoch.startTime.add(voteDuration));
                                          }
                                          /* ===Events=== */
                                          event Vote(address indexed user, uint256 indexed epoch, uint256 weight, uint256 indexed vote);
                                          event VoteResolved(uint256 indexed epoch, uint256 indexed decision);
                                          event VoteStarted(uint256 indexed epoch, uint256 startTime, uint256 endTime);
                                      }
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Standard math utilities missing in the Solidity language.
                                       */
                                      library Math {
                                          /**
                                           * @dev Returns the largest of two numbers.
                                           */
                                          function max(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a >= b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the smallest of two numbers.
                                           */
                                          function min(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a < b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the average of two numbers. The result is rounded towards
                                           * zero.
                                           */
                                          function average(uint256 a, uint256 b) internal pure returns (uint256) {
                                              // (a + b) / 2 can overflow, so we distribute
                                              return (a / 2) + (b / 2) + ((a % 2 + b % 2) / 2);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/Math.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/ReentrancyGuard.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/utils/Pausable.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "./Defensible.sol";
                                      import "./interfaces/IMushroomFactory.sol";
                                      import "./interfaces/IMission.sol";
                                      import "./interfaces/IMiniMe.sol";
                                      import "./interfaces/ISporeToken.sol";
                                      import "./BannedContractList.sol";
                                      /*
                                          Staking can be paused by the owner (withdrawing & harvesting cannot be paused)
                                          
                                          The mushroomFactory must be set by the owner before mushrooms can be harvested (optionally)
                                          It and can be modified, to use new mushroom spawning logic
                                          The rateVote contract has control over the spore emission rate. 
                                          It can be modified, to change the voting logic around rate changes.
                                      */
                                      contract SporePool is OwnableUpgradeSafe, ReentrancyGuardUpgradeSafe, PausableUpgradeSafe, Defensible {
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          /* ========== STATE VARIABLES ========== */
                                          ISporeToken public sporeToken;
                                          IERC20 public stakingToken;
                                          uint256 public sporesPerSecond = 0;
                                          uint256 public lastUpdateTime;
                                          uint256 public rewardPerTokenStored;
                                          uint256 public constant MAX_PERCENTAGE = 100;
                                          uint256 public devRewardPercentage;
                                          address public devRewardAddress;
                                          mapping(address => uint256) public userRewardPerTokenPaid;
                                          mapping(address => uint256) public rewards;
                                          uint256 internal _totalSupply;
                                          mapping(address => uint256) internal _balances;
                                          IMushroomFactory public mushroomFactory;
                                          IMission public mission;
                                          BannedContractList public bannedContractList;
                                          uint256 public stakingEnabledTime;
                                          address public rateVote;
                                          IMiniMe public enokiToken;
                                          address public enokiDaoAgent;
                                          
                                          /* ========== CONSTRUCTOR ========== */
                                          function initialize(
                                              address _sporeToken,
                                              address _stakingToken,
                                              address _mission,
                                              address _bannedContractList,
                                              address _devRewardAddress,
                                              address _enokiDaoAgent,
                                              uint256[3] memory uintParams
                                          ) public virtual initializer {
                                              __Context_init_unchained();
                                              __Pausable_init_unchained();
                                              __ReentrancyGuard_init_unchained();
                                              __Ownable_init_unchained();
                                              sporeToken = ISporeToken(_sporeToken);
                                              stakingToken = IERC20(_stakingToken);
                                              mission = IMission(_mission);
                                              bannedContractList = BannedContractList(_bannedContractList);
                                              /*
                                                  [0] uint256 _devRewardPercentage,
                                                  [1] uint256 stakingEnabledTime_,
                                                  [2] uint256 initialRewardRate_,
                                              */
                                              devRewardPercentage = uintParams[0];
                                              devRewardAddress = _devRewardAddress;
                                              stakingEnabledTime = uintParams[1];
                                              sporesPerSecond = uintParams[2];
                                              enokiDaoAgent = _enokiDaoAgent;
                                              emit SporeRateChange(sporesPerSecond);
                                          }
                                          /* ========== VIEWS ========== */
                                          function totalSupply() external view returns (uint256) {
                                              return _totalSupply;
                                          }
                                          function balanceOf(address account) external view returns (uint256) {
                                              return _balances[account];
                                          }
                                          // Rewards are turned off at the mission level
                                          function lastTimeRewardApplicable() public view returns (uint256) {
                                              return block.timestamp;
                                          }
                                          function rewardPerToken() public view returns (uint256) {
                                              if (_totalSupply == 0) {
                                                  return rewardPerTokenStored;
                                              }
                                              // Time difference * sporesPerSecond
                                              return rewardPerTokenStored.add(lastTimeRewardApplicable().sub(lastUpdateTime).mul(sporesPerSecond).mul(1e18).div(_totalSupply));
                                          }
                                          function earned(address account) public view returns (uint256) {
                                              return _balances[account].mul(rewardPerToken().sub(userRewardPerTokenPaid[account])).div(1e18).add(rewards[account]);
                                          }
                                          /* ========== MUTATIVE FUNCTIONS ========== */
                                          function stake(uint256 amount) external virtual nonReentrant defend(bannedContractList) whenNotPaused updateReward(msg.sender) {
                                              require(amount > 0, "Cannot stake 0");
                                              require(now > stakingEnabledTime, "Cannot stake before staking enabled");
                                              _totalSupply = _totalSupply.add(amount);
                                              _balances[msg.sender] = _balances[msg.sender].add(amount);
                                              stakingToken.safeTransferFrom(msg.sender, address(this), amount);
                                              emit Staked(msg.sender, amount);
                                          }
                                          // Withdrawing does not harvest, the rewards must be harvested separately
                                          function withdraw(uint256 amount) public virtual updateReward(msg.sender) {
                                              require(amount > 0, "Cannot withdraw 0");
                                              _totalSupply = _totalSupply.sub(amount);
                                              _balances[msg.sender] = _balances[msg.sender].sub(amount);
                                              stakingToken.safeTransfer(msg.sender, amount);
                                              emit Withdrawn(msg.sender, amount);
                                          }
                                          function harvest(uint256 mushroomsToGrow)
                                              public
                                              nonReentrant
                                              updateReward(msg.sender)
                                              returns (
                                                  uint256 toDev,
                                                  uint256 toDao,
                                                  uint256 remainingReward
                                              )
                                          {
                                              uint256 reward = rewards[msg.sender];
                                              if (reward > 0) {
                                                  remainingReward = reward;
                                                  toDev = 0;
                                                  toDao = 0;
                                                  rewards[msg.sender] = 0;
                                                  // Burn some rewards for mushrooms if desired
                                                  if (mushroomsToGrow > 0) {
                                                      uint256 totalCost = mushroomFactory.costPerMushroom().mul(mushroomsToGrow);
                                                      require(reward >= totalCost, "Not enough rewards to grow the number of mushrooms specified");
                                                      toDev = totalCost.mul(devRewardPercentage).div(MAX_PERCENTAGE);
                                                      if (toDev > 0) {
                                                          mission.sendSpores(devRewardAddress, toDev);
                                                          emit DevRewardPaid(devRewardAddress, toDev);
                                                      }
                                                      toDao = totalCost.sub(toDev);
                                                      mission.sendSpores(enokiDaoAgent, toDao);
                                                      emit DaoRewardPaid(enokiDaoAgent, toDao);
                                                      remainingReward = reward.sub(totalCost);
                                                      mushroomFactory.growMushrooms(msg.sender, mushroomsToGrow);
                                                      emit MushroomsGrown(msg.sender, mushroomsToGrow);
                                                  }
                                                  if (remainingReward > 0) {
                                                      mission.sendSpores(msg.sender, remainingReward);
                                                      emit RewardPaid(msg.sender, remainingReward);
                                                  }
                                              }
                                          }
                                          // Withdraw, forfietting all rewards
                                          function emergencyWithdraw() external nonReentrant {
                                              withdraw(_balances[msg.sender]);
                                          }
                                          /* ========== RESTRICTED FUNCTIONS ========== */
                                          // Added to support recovering LP Rewards from other systems such as BAL to be distributed to holders
                                          function recoverERC20(address tokenAddress, uint256 tokenAmount) external onlyOwner {
                                              // Cannot recover the staking token or the rewards token
                                              require(tokenAddress != address(stakingToken) && tokenAddress != address(sporeToken), "Cannot withdraw the staking or rewards tokens");
                                              //TODO: Add safeTransfer
                                              IERC20(tokenAddress).transfer(owner(), tokenAmount);
                                              emit Recovered(tokenAddress, tokenAmount);
                                          }
                                          function setMushroomFactory(address mushroomFactory_) external onlyOwner {
                                              mushroomFactory = IMushroomFactory(mushroomFactory_);
                                          }
                                          function pauseStaking() external onlyOwner {
                                              _pause();
                                          }
                                          function unpauseStaking() external onlyOwner {
                                              _unpause();
                                          }
                                          function setRateVote(address _rateVote) external onlyOwner {
                                              rateVote = _rateVote;
                                          }
                                          function changeRate(uint256 percentage) external onlyRateVote {
                                              sporesPerSecond = sporesPerSecond.mul(percentage).div(MAX_PERCENTAGE);
                                              emit SporeRateChange(sporesPerSecond);
                                          }
                                          /* ========== MODIFIERS ========== */
                                          modifier updateReward(address account) {
                                              rewardPerTokenStored = rewardPerToken();
                                              lastUpdateTime = lastTimeRewardApplicable();
                                              if (account != address(0)) {
                                                  rewards[account] = earned(account);
                                                  userRewardPerTokenPaid[account] = rewardPerTokenStored;
                                              }
                                              _;
                                          }
                                          modifier onlyRateVote() {
                                              require(msg.sender == rateVote, "onlyRateVote");
                                              _;
                                          }
                                          /* ========== EVENTS ========== */
                                          event RewardAdded(uint256 reward);
                                          event Staked(address indexed user, uint256 amount);
                                          event Withdrawn(address indexed user, uint256 amount);
                                          event RewardPaid(address indexed user, uint256 reward);
                                          event DevRewardPaid(address indexed user, uint256 reward);
                                          event DaoRewardPaid(address indexed user, uint256 reward);
                                          event MushroomsGrown(address indexed user, uint256 number);
                                          event Recovered(address token, uint256 amount);
                                          event SporeRateChange(uint256 newRate);
                                      }
                                      pragma solidity ^0.6.0;
                                      import "../GSN/Context.sol";
                                      import "../Initializable.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.
                                       */
                                      contract PausableUpgradeSafe is Initializable, ContextUpgradeSafe {
                                          /**
                                           * @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.
                                           */
                                          function __Pausable_init() internal initializer {
                                              __Context_init_unchained();
                                              __Pausable_init_unchained();
                                          }
                                          function __Pausable_init_unchained() internal initializer {
                                              _paused = false;
                                          }
                                          /**
                                           * @dev Returns true if the contract is paused, and false otherwise.
                                           */
                                          function paused() public view returns (bool) {
                                              return _paused;
                                          }
                                          /**
                                           * @dev Modifier to make a function callable only when the contract is not paused.
                                           */
                                          modifier whenNotPaused() {
                                              require(!_paused, "Pausable: paused");
                                              _;
                                          }
                                          /**
                                           * @dev Modifier to make a function callable only when the contract is paused.
                                           */
                                          modifier whenPaused() {
                                              require(_paused, "Pausable: not paused");
                                              _;
                                          }
                                          /**
                                           * @dev Triggers stopped state.
                                           */
                                          function _pause() internal virtual whenNotPaused {
                                              _paused = true;
                                              emit Paused(_msgSender());
                                          }
                                          /**
                                           * @dev Returns to normal state.
                                           */
                                          function _unpause() internal virtual whenPaused {
                                              _paused = false;
                                              emit Unpaused(_msgSender());
                                          }
                                          uint256[49] private __gap;
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "./SporePool.sol";
                                      /*
                                          ETH Variant of SporePool
                                      */
                                      contract SporePoolEth is SporePool {
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          /* ========== CONSTRUCTOR ========== */
                                          function initialize(
                                              address _sporeToken,
                                              address _stakingToken,
                                              address _mission,
                                              address _bannedContractList,
                                              address _devRewardAddress,
                                              address _enokiDaoAgent,
                                              uint256[3] memory uintParams
                                          ) public override initializer {
                                              __Context_init_unchained();
                                              __Pausable_init_unchained();
                                              __ReentrancyGuard_init_unchained();
                                              __Ownable_init_unchained();
                                              sporeToken = ISporeToken(_sporeToken);
                                              mission = IMission(_mission);
                                              bannedContractList = BannedContractList(_bannedContractList);
                                              /*
                                                  [0] uint256 _devRewardPercentage,
                                                  [1] uint256 stakingEnabledTime_,
                                                  [2] uint256 initialRewardRate_,
                                              */
                                              devRewardPercentage = uintParams[0];
                                              devRewardAddress = _devRewardAddress;
                                              stakingEnabledTime = uintParams[1];
                                              sporesPerSecond = uintParams[2];
                                              enokiDaoAgent = _enokiDaoAgent;
                                              emit SporeRateChange(sporesPerSecond);
                                          }
                                          /* ========== MUTATIVE FUNCTIONS ========== */
                                          function stake(uint256 amount) external override nonReentrant defend(bannedContractList) whenNotPaused updateReward(msg.sender) {
                                              revert("Use stakeEth function for ETH variant");
                                          }
                                          function stakeEth(uint256 amount) external payable nonReentrant defend(bannedContractList) whenNotPaused updateReward(msg.sender) {
                                              require(amount > 0, "Cannot stake 0");
                                              require(msg.value == amount, "Incorrect ETH transfer amount");
                                              require(now > stakingEnabledTime, "Cannot stake before staking enabled");
                                              _totalSupply = _totalSupply.add(amount);
                                              _balances[msg.sender] = _balances[msg.sender].add(amount);
                                              emit Staked(msg.sender, amount);
                                          }
                                          function withdraw(uint256 amount) public override updateReward(msg.sender) {
                                              require(amount > 0, "Cannot withdraw 0");
                                              _totalSupply = _totalSupply.sub(amount);
                                              _balances[msg.sender] = _balances[msg.sender].sub(amount);
                                              msg.sender.transfer(amount);
                                              emit Withdrawn(msg.sender, amount);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts/math/Math.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
                                      import "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
                                      import "./SporeToken.sol";
                                      contract SporePresale is Ownable {
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          mapping(address => bool) public whitelist;
                                          mapping(address => uint256) public ethSupply;
                                          uint256 public whitelistCount;
                                          address payable devAddress;
                                          uint256 public sporePrice = 25;
                                          uint256 public buyLimit = 3 * 1e18;
                                          bool public presaleStart = false;
                                          bool public onlyWhitelist = true;
                                          uint256 public presaleLastSupply = 15000 * 1e18;
                                          SporeToken public spore;
                                          event BuySporeSuccess(address account, uint256 ethAmount, uint256 sporeAmount);
                                          constructor(address payable devAddress_, SporeToken sporeToken_) public {
                                              devAddress = devAddress_;
                                              spore = sporeToken_;
                                          }
                                          function addToWhitelist(address[] memory accounts) public onlyOwner {
                                              for (uint256 i = 0; i < accounts.length; i++) {
                                                  address account = accounts[i];
                                                  require(whitelist[account] == false, "This account is already in whitelist.");
                                                  whitelist[account] = true;
                                                  whitelistCount = whitelistCount + 1;
                                              }
                                          }
                                          function removeFromWhitelist(address[] memory accounts) public onlyOwner {
                                              for (uint256 i = 0; i < accounts.length; i++) {
                                                  address account = accounts[i];
                                                  require(whitelist[account], "This account is not in whitelist.");
                                                  whitelist[account] = false;
                                                  whitelistCount = whitelistCount - 1;
                                              }
                                          }
                                          function getDevAddress() public view returns (address) {
                                              return address(devAddress);
                                          }
                                          function setDevAddress(address payable account) public onlyOwner {
                                              devAddress = account;
                                          }
                                          function startPresale() public onlyOwner {
                                              presaleStart = true;
                                          }
                                          function stopPresale() public onlyOwner {
                                              presaleStart = false;
                                          }
                                          function setSporePrice(uint256 newPrice) public onlyOwner {
                                              sporePrice = newPrice;
                                          }
                                          function setBuyLimit(uint256 newLimit) public onlyOwner {
                                              buyLimit = newLimit;
                                          }
                                          function changeToNotOnlyWhitelist() public onlyOwner {
                                              onlyWhitelist = false;
                                          }
                                          modifier needHaveLastSupply() {
                                              require(presaleLastSupply >= 0, "Oh you are so late.");
                                              _;
                                          }
                                          modifier presaleHasStarted() {
                                              require(presaleStart, "Presale has not been started.");
                                              _;
                                          }
                                          receive() external payable presaleHasStarted needHaveLastSupply {
                                              if (onlyWhitelist) {
                                                  require(whitelist[msg.sender], "This time is only for people who are in whitelist.");
                                              }
                                              uint256 ethTotalAmount = ethSupply[msg.sender].add(msg.value);
                                              require(ethTotalAmount <= buyLimit, "Everyone should buy less than 3 eth.");
                                              uint256 sporeAmount = msg.value.mul(sporePrice);
                                              require(sporeAmount <= presaleLastSupply, "insufficient presale supply");
                                              presaleLastSupply = presaleLastSupply.sub(sporeAmount);
                                              spore.mint(msg.sender, sporeAmount);
                                              ethSupply[msg.sender] = ethTotalAmount;
                                              devAddress.transfer(msg.value);
                                              emit BuySporeSuccess(msg.sender, msg.value, sporeAmount);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      /**
                                       * @dev Standard math utilities missing in the Solidity language.
                                       */
                                      library Math {
                                          /**
                                           * @dev Returns the largest of two numbers.
                                           */
                                          function max(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a >= b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the smallest of two numbers.
                                           */
                                          function min(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return a < b ? a : b;
                                          }
                                          /**
                                           * @dev Returns the average of two numbers. The result is rounded towards
                                           * zero.
                                           */
                                          function average(uint256 a, uint256 b) internal pure returns (uint256) {
                                              // (a + b) / 2 can overflow, so we distribute
                                              return (a / 2) + (b / 2) + ((a % 2 + b % 2) / 2);
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "../../GSN/Context.sol";
                                      import "./IERC20.sol";
                                      import "../../math/SafeMath.sol";
                                      import "../../utils/Address.sol";
                                      /**
                                       * @dev Implementation of the {IERC20} interface.
                                       *
                                       * This implementation is agnostic to the way tokens are created. This means
                                       * that a supply mechanism has to be added in a derived contract using {_mint}.
                                       * For a generic mechanism see {ERC20PresetMinterPauser}.
                                       *
                                       * TIP: For a detailed writeup see our guide
                                       * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How
                                       * to implement supply mechanisms].
                                       *
                                       * We have followed general OpenZeppelin guidelines: functions revert instead
                                       * of returning `false` on failure. This behavior is nonetheless conventional
                                       * and does not conflict with the expectations of ERC20 applications.
                                       *
                                       * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
                                       * This allows applications to reconstruct the allowance for all accounts just
                                       * by listening to said events. Other implementations of the EIP may not emit
                                       * these events, as it isn't required by the specification.
                                       *
                                       * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
                                       * functions have been added to mitigate the well-known issues around setting
                                       * allowances. See {IERC20-approve}.
                                       */
                                      contract ERC20 is Context, IERC20 {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          mapping (address => uint256) private _balances;
                                          mapping (address => mapping (address => uint256)) private _allowances;
                                          uint256 private _totalSupply;
                                          string private _name;
                                          string private _symbol;
                                          uint8 private _decimals;
                                          /**
                                           * @dev Sets the values for {name} and {symbol}, initializes {decimals} with
                                           * a default value of 18.
                                           *
                                           * To select a different value for {decimals}, use {_setupDecimals}.
                                           *
                                           * All three of these values are immutable: they can only be set once during
                                           * construction.
                                           */
                                          constructor (string memory name, string memory symbol) public {
                                              _name = name;
                                              _symbol = symbol;
                                              _decimals = 18;
                                          }
                                          /**
                                           * @dev Returns the name of the token.
                                           */
                                          function name() public view returns (string memory) {
                                              return _name;
                                          }
                                          /**
                                           * @dev Returns the symbol of the token, usually a shorter version of the
                                           * name.
                                           */
                                          function symbol() public view returns (string memory) {
                                              return _symbol;
                                          }
                                          /**
                                           * @dev Returns the number of decimals used to get its user representation.
                                           * For example, if `decimals` equals `2`, a balance of `505` tokens should
                                           * be displayed to a user as `5,05` (`505 / 10 ** 2`).
                                           *
                                           * Tokens usually opt for a value of 18, imitating the relationship between
                                           * Ether and Wei. This is the value {ERC20} uses, unless {_setupDecimals} is
                                           * called.
                                           *
                                           * NOTE: This information is only used for _display_ purposes: it in
                                           * no way affects any of the arithmetic of the contract, including
                                           * {IERC20-balanceOf} and {IERC20-transfer}.
                                           */
                                          function decimals() public view returns (uint8) {
                                              return _decimals;
                                          }
                                          /**
                                           * @dev See {IERC20-totalSupply}.
                                           */
                                          function totalSupply() public view override returns (uint256) {
                                              return _totalSupply;
                                          }
                                          /**
                                           * @dev See {IERC20-balanceOf}.
                                           */
                                          function balanceOf(address account) public view override returns (uint256) {
                                              return _balances[account];
                                          }
                                          /**
                                           * @dev See {IERC20-transfer}.
                                           *
                                           * Requirements:
                                           *
                                           * - `recipient` cannot be the zero address.
                                           * - the caller must have a balance of at least `amount`.
                                           */
                                          function transfer(address recipient, uint256 amount) public virtual override returns (bool) {
                                              _transfer(_msgSender(), recipient, amount);
                                              return true;
                                          }
                                          /**
                                           * @dev See {IERC20-allowance}.
                                           */
                                          function allowance(address owner, address spender) public view virtual override returns (uint256) {
                                              return _allowances[owner][spender];
                                          }
                                          /**
                                           * @dev See {IERC20-approve}.
                                           *
                                           * Requirements:
                                           *
                                           * - `spender` cannot be the zero address.
                                           */
                                          function approve(address spender, uint256 amount) public virtual override returns (bool) {
                                              _approve(_msgSender(), spender, amount);
                                              return true;
                                          }
                                          /**
                                           * @dev See {IERC20-transferFrom}.
                                           *
                                           * Emits an {Approval} event indicating the updated allowance. This is not
                                           * required by the EIP. See the note at the beginning of {ERC20};
                                           *
                                           * Requirements:
                                           * - `sender` and `recipient` cannot be the zero address.
                                           * - `sender` must have a balance of at least `amount`.
                                           * - the caller must have allowance for ``sender``'s tokens of at least
                                           * `amount`.
                                           */
                                          function transferFrom(address sender, address recipient, uint256 amount) public virtual override returns (bool) {
                                              _transfer(sender, recipient, amount);
                                              _approve(sender, _msgSender(), _allowances[sender][_msgSender()].sub(amount, "ERC20: transfer amount exceeds allowance"));
                                              return true;
                                          }
                                          /**
                                           * @dev Atomically increases the allowance granted to `spender` by the caller.
                                           *
                                           * This is an alternative to {approve} that can be used as a mitigation for
                                           * problems described in {IERC20-approve}.
                                           *
                                           * Emits an {Approval} event indicating the updated allowance.
                                           *
                                           * Requirements:
                                           *
                                           * - `spender` cannot be the zero address.
                                           */
                                          function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
                                              _approve(_msgSender(), spender, _allowances[_msgSender()][spender].add(addedValue));
                                              return true;
                                          }
                                          /**
                                           * @dev Atomically decreases the allowance granted to `spender` by the caller.
                                           *
                                           * This is an alternative to {approve} that can be used as a mitigation for
                                           * problems described in {IERC20-approve}.
                                           *
                                           * Emits an {Approval} event indicating the updated allowance.
                                           *
                                           * Requirements:
                                           *
                                           * - `spender` cannot be the zero address.
                                           * - `spender` must have allowance for the caller of at least
                                           * `subtractedValue`.
                                           */
                                          function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
                                              _approve(_msgSender(), spender, _allowances[_msgSender()][spender].sub(subtractedValue, "ERC20: decreased allowance below zero"));
                                              return true;
                                          }
                                          /**
                                           * @dev Moves tokens `amount` from `sender` to `recipient`.
                                           *
                                           * This is internal function is equivalent to {transfer}, and can be used to
                                           * e.g. implement automatic token fees, slashing mechanisms, etc.
                                           *
                                           * Emits a {Transfer} event.
                                           *
                                           * Requirements:
                                           *
                                           * - `sender` cannot be the zero address.
                                           * - `recipient` cannot be the zero address.
                                           * - `sender` must have a balance of at least `amount`.
                                           */
                                          function _transfer(address sender, address recipient, uint256 amount) internal virtual {
                                              require(sender != address(0), "ERC20: transfer from the zero address");
                                              require(recipient != address(0), "ERC20: transfer to the zero address");
                                              _beforeTokenTransfer(sender, recipient, amount);
                                              _balances[sender] = _balances[sender].sub(amount, "ERC20: transfer amount exceeds balance");
                                              _balances[recipient] = _balances[recipient].add(amount);
                                              emit Transfer(sender, recipient, amount);
                                          }
                                          /** @dev Creates `amount` tokens and assigns them to `account`, increasing
                                           * the total supply.
                                           *
                                           * Emits a {Transfer} event with `from` set to the zero address.
                                           *
                                           * Requirements
                                           *
                                           * - `to` cannot be the zero address.
                                           */
                                          function _mint(address account, uint256 amount) internal virtual {
                                              require(account != address(0), "ERC20: mint to the zero address");
                                              _beforeTokenTransfer(address(0), account, amount);
                                              _totalSupply = _totalSupply.add(amount);
                                              _balances[account] = _balances[account].add(amount);
                                              emit Transfer(address(0), account, amount);
                                          }
                                          /**
                                           * @dev Destroys `amount` tokens from `account`, reducing the
                                           * total supply.
                                           *
                                           * Emits a {Transfer} event with `to` set to the zero address.
                                           *
                                           * Requirements
                                           *
                                           * - `account` cannot be the zero address.
                                           * - `account` must have at least `amount` tokens.
                                           */
                                          function _burn(address account, uint256 amount) internal virtual {
                                              require(account != address(0), "ERC20: burn from the zero address");
                                              _beforeTokenTransfer(account, address(0), amount);
                                              _balances[account] = _balances[account].sub(amount, "ERC20: burn amount exceeds balance");
                                              _totalSupply = _totalSupply.sub(amount);
                                              emit Transfer(account, address(0), amount);
                                          }
                                          /**
                                           * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.
                                           *
                                           * This 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 Sets {decimals} to a value other than the default one of 18.
                                           *
                                           * WARNING: This function should only be called from the constructor. Most
                                           * applications that interact with token contracts will not expect
                                           * {decimals} to ever change, and may work incorrectly if it does.
                                           */
                                          function _setupDecimals(uint8 decimals_) internal {
                                              _decimals = decimals_;
                                          }
                                          /**
                                           * @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 to 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 { }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.2;
                                      /**
                                       * @dev Collection of functions related to the address type
                                       */
                                      library Address {
                                          /**
                                           * @dev Returns true if `account` is a contract.
                                           *
                                           * [IMPORTANT]
                                           * ====
                                           * It is unsafe to assume that an address for which this function returns
                                           * false is an externally-owned account (EOA) and not a contract.
                                           *
                                           * Among others, `isContract` will return false for the following
                                           * types of addresses:
                                           *
                                           *  - an externally-owned account
                                           *  - a contract in construction
                                           *  - an address where a contract will be created
                                           *  - an address where a contract lived, but was destroyed
                                           * ====
                                           */
                                          function isContract(address account) internal view returns (bool) {
                                              // This method relies in extcodesize, which returns 0 for contracts in
                                              // construction, since the code is only stored at the end of the
                                              // constructor execution.
                                              uint256 size;
                                              // solhint-disable-next-line no-inline-assembly
                                              assembly { size := extcodesize(account) }
                                              return size > 0;
                                          }
                                          /**
                                           * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                                           * `recipient`, forwarding all available gas and reverting on errors.
                                           *
                                           * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                                           * of certain opcodes, possibly making contracts go over the 2300 gas limit
                                           * imposed by `transfer`, making them unable to receive funds via
                                           * `transfer`. {sendValue} removes this limitation.
                                           *
                                           * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                                           *
                                           * IMPORTANT: because control is transferred to `recipient`, care must be
                                           * taken to not create reentrancy vulnerabilities. Consider using
                                           * {ReentrancyGuard} or the
                                           * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                                           */
                                          function sendValue(address payable recipient, uint256 amount) internal {
                                              require(address(this).balance >= amount, "Address: insufficient balance");
                                              // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                                              (bool success, ) = recipient.call{ value: amount }("");
                                              require(success, "Address: unable to send value, recipient may have reverted");
                                          }
                                          /**
                                           * @dev Performs a Solidity function call using a low level `call`. A
                                           * plain`call` is an unsafe replacement for a function call: use this
                                           * function instead.
                                           *
                                           * If `target` reverts with a revert reason, it is bubbled up by this
                                           * function (like regular Solidity function calls).
                                           *
                                           * Returns the raw returned data. To convert to the expected return value,
                                           * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                                           *
                                           * Requirements:
                                           *
                                           * - `target` must be a contract.
                                           * - calling `target` with `data` must not revert.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                                            return functionCall(target, data, "Address: low-level call failed");
                                          }
                                          /**
                                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                                           * `errorMessage` as a fallback revert reason when `target` reverts.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                                              return _functionCallWithValue(target, data, 0, errorMessage);
                                          }
                                          /**
                                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                                           * but also transferring `value` wei to `target`.
                                           *
                                           * Requirements:
                                           *
                                           * - the calling contract must have an ETH balance of at least `value`.
                                           * - the called Solidity function must be `payable`.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                                              return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                                          }
                                          /**
                                           * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                                           * with `errorMessage` as a fallback revert reason when `target` reverts.
                                           *
                                           * _Available since v3.1._
                                           */
                                          function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
                                              require(address(this).balance >= value, "Address: insufficient balance for call");
                                              return _functionCallWithValue(target, data, value, errorMessage);
                                          }
                                          function _functionCallWithValue(address target, bytes memory data, uint256 weiValue, string memory errorMessage) private returns (bytes memory) {
                                              require(isContract(target), "Address: call to non-contract");
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, bytes memory returndata) = target.call{ value: weiValue }(data);
                                              if (success) {
                                                  return returndata;
                                              } else {
                                                  // Look for revert reason and bubble it up if present
                                                  if (returndata.length > 0) {
                                                      // The easiest way to bubble the revert reason is using memory via assembly
                                                      // solhint-disable-next-line no-inline-assembly
                                                      assembly {
                                                          let returndata_size := mload(returndata)
                                                          revert(add(32, returndata), returndata_size)
                                                      }
                                                  } else {
                                                      revert(errorMessage);
                                                  }
                                              }
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "./IERC20.sol";
                                      import "../../math/SafeMath.sol";
                                      import "../../utils/Address.sol";
                                      /**
                                       * @title SafeERC20
                                       * @dev Wrappers around ERC20 operations that throw on failure (when the token
                                       * contract returns false). Tokens that return no value (and instead revert or
                                       * throw on failure) are also supported, non-reverting calls are assumed to be
                                       * successful.
                                       * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
                                       * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
                                       */
                                      library SafeERC20 {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          function safeTransfer(IERC20 token, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
                                          }
                                          function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
                                          }
                                          /**
                                           * @dev Deprecated. This function has issues similar to the ones found in
                                           * {IERC20-approve}, and its usage is discouraged.
                                           *
                                           * Whenever possible, use {safeIncreaseAllowance} and
                                           * {safeDecreaseAllowance} instead.
                                           */
                                          function safeApprove(IERC20 token, address spender, uint256 value) internal {
                                              // safeApprove should only be called when setting an initial allowance,
                                              // or when resetting it to zero. To increase and decrease it, use
                                              // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                                              // solhint-disable-next-line max-line-length
                                              require((value == 0) || (token.allowance(address(this), spender) == 0),
                                                  "SafeERC20: approve from non-zero to non-zero allowance"
                                              );
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
                                          }
                                          function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).add(value);
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                          /**
                                           * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                                           * on the return value: the return value is optional (but if data is returned, it must not be false).
                                           * @param token The token targeted by the call.
                                           * @param data The call data (encoded using abi.encode or one of its variants).
                                           */
                                          function _callOptionalReturn(IERC20 token, bytes memory data) private {
                                              // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                                              // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
                                              // the target address contains contract code and also asserts for success in the low-level call.
                                              bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
                                              if (returndata.length > 0) { // Return data is optional
                                                  // solhint-disable-next-line max-line-length
                                                  require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                                              }
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
                                      import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      contract SporeToken is ERC20("SporeFinance", "SPORE"), Ownable {
                                          using SafeMath for uint256;
                                          /* ========== STATE VARIABLES ========== */
                                          mapping(address => bool) public minters;
                                          address public initialLiquidityManager;
                                          bool internal _transfersEnabled;
                                          mapping(address => bool) internal _canTransferInitialLiquidity;
                                          /* ========== CONSTRUCTOR ========== */
                                          constructor(address initialLiquidityManager_) public {
                                              _transfersEnabled = false;
                                              minters[msg.sender] = true;
                                              initialLiquidityManager = initialLiquidityManager_;
                                              _canTransferInitialLiquidity[msg.sender] = true;
                                          }
                                          /* ========== MUTATIVE FUNCTIONS ========== */
                                          /// @notice Transfer is enabled as normal except during an initial phase
                                          function transfer(address recipient, uint256 amount) public override returns (bool) {
                                              require(_transfersEnabled || _canTransferInitialLiquidity[msg.sender], "SporeToken: transfers not enabled");
                                              return super.transfer(recipient, amount);
                                          }
                                          /// @notice TransferFrom is enabled as normal except during an initial phase
                                          function transferFrom(
                                              address sender,
                                              address recipient,
                                              uint256 amount
                                          ) public override returns (bool) {
                                              require(_transfersEnabled || _canTransferInitialLiquidity[msg.sender], "SporeToken: transfers not enabled");
                                              return super.transferFrom(sender, recipient, amount);
                                          }
                                          /// @notice Any account is entitled to burn their own tokens
                                          function burn(uint256 amount) public {
                                              require(amount > 0);
                                              require(balanceOf(msg.sender) >= amount);
                                              _burn(msg.sender, amount);
                                          }
                                          /* ========== RESTRICTED FUNCTIONS ========== */
                                          function mint(address to, uint256 amount) public onlyMinter {
                                              _mint(to, amount);
                                          }
                                          function addInitialLiquidityTransferRights(address account) public onlyInitialLiquidityManager {
                                              require(!_transfersEnabled, "SporeToken: cannot add initial liquidity transfer rights after global transfers enabled");
                                              _canTransferInitialLiquidity[account] = true;
                                          }
                                          /// @notice One time acion to enable global transfers after the initial liquidity is supplied.
                                          function enableTransfers() public onlyInitialLiquidityManager {
                                              _transfersEnabled = true;
                                          }
                                          function addMinter(address account) public onlyOwner {
                                              minters[account] = true;
                                          }
                                          function removeMinter(address account) public onlyOwner {
                                              minters[account] = false;
                                          }
                                          modifier onlyMinter() {
                                              require(minters[msg.sender], "Restricted to minters.");
                                              _;
                                          }
                                          modifier onlyInitialLiquidityManager() {
                                              require(initialLiquidityManager == msg.sender, "Restricted to initial liquidity manager.");
                                              _;
                                          }
                                      }
                                      // SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      import "../MushroomNFT.sol";
                                      import "../MushroomLib.sol";
                                      /*
                                          MushroomFactories manage the mushroom generation logic for pools
                                          Each pool will have it's own factory to generate mushrooms according
                                          to its' powers.
                                          The mushroomFactory should be administered by the pool, which grants the ability to grow mushrooms
                                      */
                                      contract MushroomLifespanMock is Initializable, OwnableUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          using SafeMath for uint256;
                                          uint256 public spawnCount;
                                          event MushroomGrown(address recipient, uint256 id, uint256 species, uint256 lifespan);
                                          function generateMushroomLifespan(uint256 minLifespan, uint256 maxLifespan) public returns (uint256) {
                                              uint256 range = maxLifespan.sub(minLifespan);
                                              uint256 fromMin = uint256(keccak256(abi.encodePacked(block.timestamp.add(spawnCount)))) % range;
                                              spawnCount = spawnCount.add(1);
                                              return minLifespan.add(fromMin);
                                          }
                                          function getRemainingMintableForMySpecies(MushroomNFT mushroomNft, uint256 speciesId) public view returns (uint256) {
                                              return mushroomNft.getRemainingMintableForSpecies(speciesId);
                                          }
                                          // Each mushroom costs 1/10th of the spore rate in spores.
                                          function growMushrooms(MushroomNFT mushroomNft, uint256 speciesId, address recipient, uint256 numMushrooms) public {
                                              MushroomLib.MushroomType memory species = mushroomNft.getSpecies(speciesId);
                                              require(getRemainingMintableForMySpecies(mushroomNft, speciesId) >= numMushrooms, "MushroomFactory: Mushrooms to grow exceeds species cap");
                                              for (uint256 i = 0; i < numMushrooms; i++) {
                                                  uint256 nextId = mushroomNft.totalSupply().add(1);
                                                  uint256 lifespan = generateMushroomLifespan(species.minLifespan, species.maxLifespan);
                                                  mushroomNft.mint(recipient, nextId, speciesId, lifespan);
                                                  emit MushroomGrown(recipient, nextId, speciesId, lifespan);
                                              }
                                          }
                                      }// SPDX-License-Identifier: MIT
                                      pragma solidity ^0.6.0;
                                      import "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
                                      import "@openzeppelin/contracts/access/Ownable.sol";
                                      import "@openzeppelin/contracts/math/SafeMath.sol";
                                      /**
                                       * @title TokenVesting
                                       * @dev A token holder contract that can release its token balance gradually like a
                                       * typical vesting scheme, with a cliff and vesting period. Optionally revocable by the
                                       * owner.
                                       */
                                      contract TokenVesting is Ownable {
                                          // The vesting schedule is time-based (i.e. using block timestamps as opposed to e.g. block numbers), and is
                                          // therefore sensitive to timestamp manipulation (which is something miners can do, to a certain degree). Therefore,
                                          // it is recommended to avoid using short time durations (less than a minute). Typical vesting schemes, with a
                                          // cliff period of a year and a duration of four years, are safe to use.
                                          // solhint-disable not-rely-on-time
                                          using SafeMath for uint256;
                                          using SafeERC20 for IERC20;
                                          event TokensReleased(address token, uint256 amount);
                                          event TokenVestingRevoked(address token);
                                          // beneficiary of tokens after they are released
                                          address private _beneficiary;
                                          // Durations and timestamps are expressed in UNIX time, the same units as block.timestamp.
                                          uint256 private _cliff;
                                          uint256 private _start;
                                          uint256 private _duration;
                                          bool private _revocable;
                                          mapping (address => uint256) private _released;
                                          mapping (address => bool) private _revoked;
                                          /**
                                           * @dev Creates a vesting contract that vests its balance of any ERC20 token to the
                                           * beneficiary, gradually in a linear fashion until start + duration. By then all
                                           * of the balance will have vested.
                                           * @param beneficiary address of the beneficiary to whom vested tokens are transferred
                                           * @param cliffDuration duration in seconds of the cliff in which tokens will begin to vest
                                           * @param start the time (as Unix time) at which point vesting starts
                                           * @param duration duration in seconds of the period in which the tokens will vest
                                           * @param revocable whether the vesting is revocable or not
                                           */
                                          constructor (address beneficiary, uint256 start, uint256 cliffDuration, uint256 duration, bool revocable) public {
                                              require(beneficiary != address(0), "TokenVesting: beneficiary is the zero address");
                                              // solhint-disable-next-line max-line-length
                                              require(cliffDuration <= duration, "TokenVesting: cliff is longer than duration");
                                              require(duration > 0, "TokenVesting: duration is 0");
                                              // solhint-disable-next-line max-line-length
                                              require(start.add(duration) > block.timestamp, "TokenVesting: final time is before current time");
                                              _beneficiary = beneficiary;
                                              _revocable = revocable;
                                              _duration = duration;
                                              _cliff = start.add(cliffDuration);
                                              _start = start;
                                          }
                                          /**
                                           * @return the beneficiary of the tokens.
                                           */
                                          function beneficiary() public view returns (address) {
                                              return _beneficiary;
                                          }
                                          /**
                                           * @return the cliff time of the token vesting.
                                           */
                                          function cliff() public view returns (uint256) {
                                              return _cliff;
                                          }
                                          /**
                                           * @return the start time of the token vesting.
                                           */
                                          function start() public view returns (uint256) {
                                              return _start;
                                          }
                                          /**
                                           * @return the duration of the token vesting.
                                           */
                                          function duration() public view returns (uint256) {
                                              return _duration;
                                          }
                                          /**
                                           * @return true if the vesting is revocable.
                                           */
                                          function revocable() public view returns (bool) {
                                              return _revocable;
                                          }
                                          /**
                                           * @return the amount of the token released.
                                           */
                                          function released(address token) public view returns (uint256) {
                                              return _released[token];
                                          }
                                          /**
                                           * @return true if the token is revoked.
                                           */
                                          function revoked(address token) public view returns (bool) {
                                              return _revoked[token];
                                          }
                                          /**
                                           * @notice Transfers vested tokens to beneficiary.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function release(IERC20 token) public {
                                              uint256 unreleased = _releasableAmount(token);
                                              require(unreleased > 0, "TokenVesting: no tokens are due");
                                              _released[address(token)] = _released[address(token)].add(unreleased);
                                              token.safeTransfer(_beneficiary, unreleased);
                                              emit TokensReleased(address(token), unreleased);
                                          }
                                          /**
                                           * @notice Allows the owner to revoke the vesting. Tokens already vested
                                           * remain in the contract, the rest are returned to the owner.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function revoke(IERC20 token) public onlyOwner {
                                              require(_revocable, "TokenVesting: cannot revoke");
                                              require(!_revoked[address(token)], "TokenVesting: token already revoked");
                                              uint256 balance = token.balanceOf(address(this));
                                              uint256 unreleased = _releasableAmount(token);
                                              uint256 refund = balance.sub(unreleased);
                                              _revoked[address(token)] = true;
                                              token.safeTransfer(owner(), refund);
                                              emit TokenVestingRevoked(address(token));
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested but hasn't been released yet.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function _releasableAmount(IERC20 token) private view returns (uint256) {
                                              return _vestedAmount(token).sub(_released[address(token)]);
                                          }
                                          /**
                                           * @dev Calculates the amount that has already vested.
                                           * @param token ERC20 token which is being vested
                                           */
                                          function _vestedAmount(IERC20 token) private view returns (uint256) {
                                              uint256 currentBalance = token.balanceOf(address(this));
                                              uint256 totalBalance = currentBalance.add(_released[address(token)]);
                                              if (block.timestamp < _cliff) {
                                                  return 0;
                                              } else if (block.timestamp >= _start.add(_duration) || _revoked[address(token)]) {
                                                  return totalBalance;
                                              } else {
                                                  return totalBalance.mul(block.timestamp.sub(_start)).div(_duration);
                                              }
                                          }
                                      }

                                      File 10 of 14: MushroomNFT
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol
                                      
                                      // 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) {
                                              // Solidity only automatically asserts when dividing by 0
                                              require(b > 0, errorMessage);
                                              uint256 c = a / b;
                                              // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                                      
                                              return c;
                                          }
                                      
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                                              return mod(a, b, "SafeMath: modulo by zero");
                                          }
                                      
                                          /**
                                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                                           * Reverts with custom message when dividing by zero.
                                           *
                                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                                           * invalid opcode to revert (consuming all remaining gas).
                                           *
                                           * Requirements:
                                           * - The divisor cannot be zero.
                                           */
                                          function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                                              require(b != 0, errorMessage);
                                              return a % b;
                                          }
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/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);
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/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");
                                          }
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol
                                      
                                      // pragma solidity ^0.6.0;
                                      
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/utils/Address.sol";
                                      
                                      /**
                                       * @title SafeERC20
                                       * @dev Wrappers around ERC20 operations that throw on failure (when the token
                                       * contract returns false). Tokens that return no value (and instead revert or
                                       * throw on failure) are also supported, non-reverting calls are assumed to be
                                       * successful.
                                       * To use this library you can add a `using SafeERC20 for ERC20;` statement to your contract,
                                       * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
                                       */
                                      library SafeERC20 {
                                          using SafeMath for uint256;
                                          using Address for address;
                                      
                                          function safeTransfer(IERC20 token, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
                                          }
                                      
                                          function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
                                          }
                                      
                                          function safeApprove(IERC20 token, address spender, uint256 value) internal {
                                              // safeApprove should only be called when setting an initial allowance,
                                              // or when resetting it to zero. To increase and decrease it, use
                                              // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                                              // solhint-disable-next-line max-line-length
                                              require((value == 0) || (token.allowance(address(this), spender) == 0),
                                                  "SafeERC20: approve from non-zero to non-zero allowance"
                                              );
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
                                          }
                                      
                                          function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).add(value);
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                      
                                          function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                                              uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
                                              _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                                          }
                                      
                                          /**
                                           * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                                           * on the return value: the return value is optional (but if data is returned, it must not be false).
                                           * @param token The token targeted by the call.
                                           * @param data The call data (encoded using abi.encode or one of its variants).
                                           */
                                          function _callOptionalReturn(IERC20 token, bytes memory data) private {
                                              // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                                              // we're implementing it ourselves.
                                      
                                              // A Solidity high level call has three parts:
                                              //  1. The target address is checked to verify it contains contract code
                                              //  2. The call itself is made, and success asserted
                                              //  3. The return value is decoded, which in turn checks the size of the returned data.
                                              // solhint-disable-next-line max-line-length
                                              require(address(token).isContract(), "SafeERC20: call to non-contract");
                                      
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, bytes memory returndata) = address(token).call(data);
                                              require(success, "SafeERC20: low-level call failed");
                                      
                                              if (returndata.length > 0) { // Return data is optional
                                                  // solhint-disable-next-line max-line-length
                                                  require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                                              }
                                          }
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/Initializable.sol
                                      
                                      // pragma solidity >=0.4.24 <0.7.0;
                                      
                                      
                                      /**
                                       * @title Initializable
                                       *
                                       * @dev Helper contract to support initializer functions. To use it, replace
                                       * the constructor with a function that has the `initializer` modifier.
                                       * WARNING: Unlike constructors, initializer functions must be manually
                                       * invoked. This applies both to deploying an Initializable contract, as well
                                       * as extending an Initializable contract via inheritance.
                                       * WARNING: When used with inheritance, manual care must be taken to not invoke
                                       * a parent initializer twice, or ensure that all initializers are idempotent,
                                       * because this is not dealt with automatically as with constructors.
                                       */
                                      contract Initializable {
                                      
                                        /**
                                         * @dev Indicates that the contract has been initialized.
                                         */
                                        bool private initialized;
                                      
                                        /**
                                         * @dev Indicates that the contract is in the process of being initialized.
                                         */
                                        bool private initializing;
                                      
                                        /**
                                         * @dev Modifier to use in the initializer function of a contract.
                                         */
                                        modifier initializer() {
                                          require(initializing || isConstructor() || !initialized, "Contract instance has already been initialized");
                                      
                                          bool isTopLevelCall = !initializing;
                                          if (isTopLevelCall) {
                                            initializing = true;
                                            initialized = true;
                                          }
                                      
                                          _;
                                      
                                          if (isTopLevelCall) {
                                            initializing = false;
                                          }
                                        }
                                      
                                        /// @dev Returns true if and only if the function is running in the constructor
                                        function isConstructor() private view returns (bool) {
                                          // extcodesize checks the size of the code stored in an address, and
                                          // address returns the current address. Since the code is still not
                                          // deployed when running a constructor, any checks on its code size will
                                          // yield zero, making it an effective way to detect if a contract is
                                          // under construction or not.
                                          address self = address(this);
                                          uint256 cs;
                                          assembly { cs := extcodesize(self) }
                                          return cs == 0;
                                        }
                                      
                                        // Reserved storage space to allow for layout changes in the future.
                                        uint256[50] private ______gap;
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/GSN/Context.sol
                                      
                                      // pragma solidity ^0.6.0;
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/Initializable.sol";
                                      
                                      /*
                                       * @dev Provides information about the current execution context, including the
                                       * sender of the transaction and its data. While these are generally available
                                       * via msg.sender and msg.data, they should not be accessed in such a direct
                                       * manner, since when dealing with GSN meta-transactions the account sending and
                                       * paying for execution may not be the actual sender (as far as an application
                                       * is concerned).
                                       *
                                       * This contract is only required for intermediate, library-like contracts.
                                       */
                                      contract ContextUpgradeSafe is Initializable {
                                          // Empty internal constructor, to prevent people from mistakenly deploying
                                          // an instance of this contract, which should be used via inheritance.
                                      
                                          function __Context_init() internal initializer {
                                              __Context_init_unchained();
                                          }
                                      
                                          function __Context_init_unchained() internal initializer {
                                      
                                      
                                          }
                                      
                                      
                                          function _msgSender() internal view virtual returns (address payable) {
                                              return msg.sender;
                                          }
                                      
                                          function _msgData() internal view virtual returns (bytes memory) {
                                              this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                                              return msg.data;
                                          }
                                      
                                          uint256[50] private __gap;
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol
                                      
                                      // pragma solidity ^0.6.0;
                                      
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/GSN/Context.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/Initializable.sol";
                                      /**
                                       * @dev Contract module which provides a basic access control mechanism, where
                                       * there is an account (an owner) that can be granted exclusive access to
                                       * specific functions.
                                       *
                                       * By default, the owner account will be the one that deploys the contract. This
                                       * can later be changed with {transferOwnership}.
                                       *
                                       * This module is used through inheritance. It will make available the modifier
                                       * `onlyOwner`, which can be applied to your functions to restrict their use to
                                       * the owner.
                                       */
                                      contract OwnableUpgradeSafe is Initializable, ContextUpgradeSafe {
                                          address private _owner;
                                      
                                          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                                      
                                          /**
                                           * @dev Initializes the contract setting the deployer as the initial owner.
                                           */
                                      
                                          function __Ownable_init() internal initializer {
                                              __Context_init_unchained();
                                              __Ownable_init_unchained();
                                          }
                                      
                                          function __Ownable_init_unchained() internal initializer {
                                      
                                      
                                              address msgSender = _msgSender();
                                              _owner = msgSender;
                                              emit OwnershipTransferred(address(0), msgSender);
                                      
                                          }
                                      
                                      
                                          /**
                                           * @dev Returns the address of the current owner.
                                           */
                                          function owner() public view returns (address) {
                                              return _owner;
                                          }
                                      
                                          /**
                                           * @dev Throws if called by any account other than the owner.
                                           */
                                          modifier onlyOwner() {
                                              require(_owner == _msgSender(), "Ownable: caller is not the owner");
                                              _;
                                          }
                                      
                                          /**
                                           * @dev Leaves the contract without owner. It will not be possible to call
                                           * `onlyOwner` functions anymore. Can only be called by the current owner.
                                           *
                                           * NOTE: Renouncing ownership will leave the contract without an owner,
                                           * thereby removing any functionality that is only available to the owner.
                                           */
                                          function renounceOwnership() public virtual onlyOwner {
                                              emit OwnershipTransferred(_owner, address(0));
                                              _owner = address(0);
                                          }
                                      
                                          /**
                                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                                           * Can only be called by the current owner.
                                           */
                                          function transferOwnership(address newOwner) public virtual onlyOwner {
                                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                                              emit OwnershipTransferred(_owner, newOwner);
                                              _owner = newOwner;
                                          }
                                      
                                          uint256[49] private __gap;
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/utils/EnumerableSet.sol
                                      
                                      // pragma solidity ^0.6.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.0.0, only sets of type `address` (`AddressSet`) and `uint256`
                                       * (`UintSet`) are supported.
                                       */
                                      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;
                                      
                                                  // When the value to delete is the last one, the swap operation is unnecessary. However, since this occurs
                                                  // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                                      
                                                  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] = toDeleteIndex + 1; // All indexes are 1-based
                                      
                                                  // 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) {
                                              require(set._values.length > index, "EnumerableSet: index out of bounds");
                                              return set._values[index];
                                          }
                                      
                                          // 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(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(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(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(uint256(_at(set._inner, index)));
                                          }
                                      
                                      
                                          // 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));
                                          }
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol
                                      
                                      // pragma solidity ^0.6.0;
                                      
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/utils/EnumerableSet.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/utils/Address.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/GSN/Context.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/Initializable.sol";
                                      
                                      /**
                                       * @dev Contract module that allows children to implement role-based access
                                       * control mechanisms.
                                       *
                                       * 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, _msgSender()));
                                       *     ...
                                       * }
                                       * ```
                                       *
                                       * 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}.
                                       */
                                      abstract contract AccessControlUpgradeSafe is Initializable, ContextUpgradeSafe {
                                          function __AccessControl_init() internal initializer {
                                              __Context_init_unchained();
                                              __AccessControl_init_unchained();
                                          }
                                      
                                          function __AccessControl_init_unchained() internal initializer {
                                      
                                      
                                          }
                                      
                                          using EnumerableSet for EnumerableSet.AddressSet;
                                          using Address for address;
                                      
                                          struct RoleData {
                                              EnumerableSet.AddressSet members;
                                              bytes32 adminRole;
                                          }
                                      
                                          mapping (bytes32 => RoleData) private _roles;
                                      
                                          bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
                                      
                                          /**
                                           * @dev Emitted when `account` is granted `role`.
                                           *
                                           * `sender` is the account that originated the contract call, an admin role
                                           * bearer except when using {_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) public view returns (bool) {
                                              return _roles[role].members.contains(account);
                                          }
                                      
                                          /**
                                           * @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 returns (uint256) {
                                              return _roles[role].members.length();
                                          }
                                      
                                          /**
                                           * @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 returns (address) {
                                              return _roles[role].members.at(index);
                                          }
                                      
                                          /**
                                           * @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 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.
                                           */
                                          function grantRole(bytes32 role, address account) public virtual {
                                              require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to grant");
                                      
                                              _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.
                                           */
                                          function revokeRole(bytes32 role, address account) public virtual {
                                              require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to revoke");
                                      
                                              _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 granted `role`, emits a {RoleRevoked}
                                           * event.
                                           *
                                           * Requirements:
                                           *
                                           * - the caller must be `account`.
                                           */
                                          function renounceRole(bytes32 role, address account) public virtual {
                                              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.
                                           *
                                           * [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}.
                                           * ====
                                           */
                                          function _setupRole(bytes32 role, address account) internal virtual {
                                              _grantRole(role, account);
                                          }
                                      
                                          /**
                                           * @dev Sets `adminRole` as ``role``'s admin role.
                                           */
                                          function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
                                              _roles[role].adminRole = adminRole;
                                          }
                                      
                                          function _grantRole(bytes32 role, address account) private {
                                              if (_roles[role].members.add(account)) {
                                                  emit RoleGranted(role, account, _msgSender());
                                              }
                                          }
                                      
                                          function _revokeRole(bytes32 role, address account) private {
                                              if (_roles[role].members.remove(account)) {
                                                  emit RoleRevoked(role, account, _msgSender());
                                              }
                                          }
                                      
                                          uint256[49] private __gap;
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/introspection/IERC165.sol
                                      
                                      // pragma solidity ^0.6.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);
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol
                                      
                                      // pragma solidity ^0.6.2;
                                      
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/introspection/IERC165.sol";
                                      
                                      /**
                                       * @dev Required interface of an ERC721 compliant contract.
                                       */
                                      interface IERC721 is IERC165 {
                                          event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
                                          event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
                                          event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
                                      
                                          /**
                                           * @dev Returns the number of NFTs in ``owner``'s account.
                                           */
                                          function balanceOf(address owner) external view returns (uint256 balance);
                                      
                                          /**
                                           * @dev Returns the owner of the NFT specified by `tokenId`.
                                           */
                                          function ownerOf(uint256 tokenId) external view returns (address owner);
                                      
                                          /**
                                           * @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to
                                           * another (`to`).
                                           *
                                           *
                                           *
                                           * Requirements:
                                           * - `from`, `to` cannot be zero.
                                           * - `tokenId` must be owned by `from`.
                                           * - If the caller is not `from`, it must be have been allowed to move this
                                           * NFT by either {approve} or {setApprovalForAll}.
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId) external;
                                          /**
                                           * @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to
                                           * another (`to`).
                                           *
                                           * Requirements:
                                           * - If the caller is not `from`, it must be approved to move this NFT by
                                           * either {approve} or {setApprovalForAll}.
                                           */
                                          function transferFrom(address from, address to, uint256 tokenId) external;
                                          function approve(address to, uint256 tokenId) external;
                                          function getApproved(uint256 tokenId) external view returns (address operator);
                                      
                                          function setApprovalForAll(address operator, bool _approved) external;
                                          function isApprovedForAll(address owner, address operator) external view returns (bool);
                                      
                                      
                                          function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Metadata.sol
                                      
                                      // pragma solidity ^0.6.2;
                                      
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      
                                      /**
                                       * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
                                       * @dev See https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      interface IERC721Metadata is IERC721 {
                                          function name() external view returns (string memory);
                                          function symbol() external view returns (string memory);
                                          function tokenURI(uint256 tokenId) external view returns (string memory);
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Enumerable.sol
                                      
                                      // pragma solidity ^0.6.2;
                                      
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      
                                      /**
                                       * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
                                       * @dev See https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      interface IERC721Enumerable is IERC721 {
                                          function totalSupply() external view returns (uint256);
                                          function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256 tokenId);
                                      
                                          function tokenByIndex(uint256 index) external view returns (uint256);
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Receiver.sol
                                      
                                      // pragma solidity ^0.6.0;
                                      
                                      /**
                                       * @title ERC721 token receiver interface
                                       * @dev Interface for any contract that wants to support safeTransfers
                                       * from ERC721 asset contracts.
                                       */
                                      interface IERC721Receiver {
                                          /**
                                           * @notice Handle the receipt of an NFT
                                           * @dev The ERC721 smart contract calls this function on the recipient
                                           * after a {IERC721-safeTransferFrom}. This function MUST return the function selector,
                                           * otherwise the caller will revert the transaction. The selector to be
                                           * returned can be obtained as `this.onERC721Received.selector`. This
                                           * function MAY throw to revert and reject the transfer.
                                           * Note: the ERC721 contract address is always the message sender.
                                           * @param operator The address which called `safeTransferFrom` function
                                           * @param from The address which previously owned the token
                                           * @param tokenId The NFT identifier which is being transferred
                                           * @param data Additional data with no specified format
                                           * @return bytes4 `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
                                           */
                                          function onERC721Received(address operator, address from, uint256 tokenId, bytes calldata data)
                                          external returns (bytes4);
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/introspection/ERC165.sol
                                      
                                      // pragma solidity ^0.6.0;
                                      
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/introspection/IERC165.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/Initializable.sol";
                                      
                                      /**
                                       * @dev Implementation of the {IERC165} interface.
                                       *
                                       * Contracts may inherit from this and call {_registerInterface} to declare
                                       * their support of an interface.
                                       */
                                      contract ERC165UpgradeSafe is Initializable, IERC165 {
                                          /*
                                           * bytes4(keccak256('supportsInterface(bytes4)')) == 0x01ffc9a7
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC165 = 0x01ffc9a7;
                                      
                                          /**
                                           * @dev Mapping of interface ids to whether or not it's supported.
                                           */
                                          mapping(bytes4 => bool) private _supportedInterfaces;
                                      
                                      
                                          function __ERC165_init() internal initializer {
                                              __ERC165_init_unchained();
                                          }
                                      
                                          function __ERC165_init_unchained() internal initializer {
                                      
                                      
                                              // Derived contracts need only register support for their own interfaces,
                                              // we register support for ERC165 itself here
                                              _registerInterface(_INTERFACE_ID_ERC165);
                                      
                                          }
                                      
                                      
                                          /**
                                           * @dev See {IERC165-supportsInterface}.
                                           *
                                           * Time complexity O(1), guaranteed to always use less than 30 000 gas.
                                           */
                                          function supportsInterface(bytes4 interfaceId) public view override returns (bool) {
                                              return _supportedInterfaces[interfaceId];
                                          }
                                      
                                          /**
                                           * @dev Registers the contract as an implementer of the interface defined by
                                           * `interfaceId`. Support of the actual ERC165 interface is automatic and
                                           * registering its interface id is not required.
                                           *
                                           * See {IERC165-supportsInterface}.
                                           *
                                           * Requirements:
                                           *
                                           * - `interfaceId` cannot be the ERC165 invalid interface (`0xffffffff`).
                                           */
                                          function _registerInterface(bytes4 interfaceId) internal virtual {
                                              require(interfaceId != 0xffffffff, "ERC165: invalid interface id");
                                              _supportedInterfaces[interfaceId] = true;
                                          }
                                      
                                          uint256[49] private __gap;
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/utils/EnumerableMap.sol
                                      
                                      // pragma solidity ^0.6.0;
                                      
                                      /**
                                       * @dev Library for managing an enumerable variant of Solidity's
                                       * https://solidity.readthedocs.io/en/latest/types.html#mapping-types[`mapping`]
                                       * type.
                                       *
                                       * Maps have the following properties:
                                       *
                                       * - Entries are added, removed, and checked for existence in constant time
                                       * (O(1)).
                                       * - Entries are enumerated in O(n). No guarantees are made on the ordering.
                                       *
                                       * ```
                                       * contract Example {
                                       *     // Add the library methods
                                       *     using EnumerableMap for EnumerableMap.UintToAddressMap;
                                       *
                                       *     // Declare a set state variable
                                       *     EnumerableMap.UintToAddressMap private myMap;
                                       * }
                                       * ```
                                       *
                                       * As of v3.0.0, only maps of type `uint256 -> address` (`UintToAddressMap`) are
                                       * supported.
                                       */
                                      library EnumerableMap {
                                          // To implement this library for multiple types with as little code
                                          // repetition as possible, we write it in terms of a generic Map type with
                                          // bytes32 keys and values.
                                          // The Map implementation uses private functions, and user-facing
                                          // implementations (such as Uint256ToAddressMap) are just wrappers around
                                          // the underlying Map.
                                          // This means that we can only create new EnumerableMaps for types that fit
                                          // in bytes32.
                                      
                                          struct MapEntry {
                                              bytes32 _key;
                                              bytes32 _value;
                                          }
                                      
                                          struct Map {
                                              // Storage of map keys and values
                                              MapEntry[] _entries;
                                      
                                              // Position of the entry defined by a key in the `entries` array, plus 1
                                              // because index 0 means a key is not in the map.
                                              mapping (bytes32 => uint256) _indexes;
                                          }
                                      
                                          /**
                                           * @dev Adds a key-value pair to a map, or updates the value for an existing
                                           * key. O(1).
                                           *
                                           * Returns true if the key was added to the map, that is if it was not
                                           * already present.
                                           */
                                          function _set(Map storage map, bytes32 key, bytes32 value) private returns (bool) {
                                              // We read and store the key's index to prevent multiple reads from the same storage slot
                                              uint256 keyIndex = map._indexes[key];
                                      
                                              if (keyIndex == 0) { // Equivalent to !contains(map, key)
                                                  map._entries.push(MapEntry({ _key: key, _value: value }));
                                                  // The entry is stored at length-1, but we add 1 to all indexes
                                                  // and use 0 as a sentinel value
                                                  map._indexes[key] = map._entries.length;
                                                  return true;
                                              } else {
                                                  map._entries[keyIndex - 1]._value = value;
                                                  return false;
                                              }
                                          }
                                      
                                          /**
                                           * @dev Removes a key-value pair from a map. O(1).
                                           *
                                           * Returns true if the key was removed from the map, that is if it was present.
                                           */
                                          function _remove(Map storage map, bytes32 key) private returns (bool) {
                                              // We read and store the key's index to prevent multiple reads from the same storage slot
                                              uint256 keyIndex = map._indexes[key];
                                      
                                              if (keyIndex != 0) { // Equivalent to contains(map, key)
                                                  // To delete a key-value pair from the _entries array in O(1), we swap the entry to delete with the last one
                                                  // in the array, and then remove the last entry (sometimes called as 'swap and pop').
                                                  // This modifies the order of the array, as noted in {at}.
                                      
                                                  uint256 toDeleteIndex = keyIndex - 1;
                                                  uint256 lastIndex = map._entries.length - 1;
                                      
                                                  // When the entry to delete is the last one, the swap operation is unnecessary. However, since this occurs
                                                  // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                                      
                                                  MapEntry storage lastEntry = map._entries[lastIndex];
                                      
                                                  // Move the last entry to the index where the entry to delete is
                                                  map._entries[toDeleteIndex] = lastEntry;
                                                  // Update the index for the moved entry
                                                  map._indexes[lastEntry._key] = toDeleteIndex + 1; // All indexes are 1-based
                                      
                                                  // Delete the slot where the moved entry was stored
                                                  map._entries.pop();
                                      
                                                  // Delete the index for the deleted slot
                                                  delete map._indexes[key];
                                      
                                                  return true;
                                              } else {
                                                  return false;
                                              }
                                          }
                                      
                                          /**
                                           * @dev Returns true if the key is in the map. O(1).
                                           */
                                          function _contains(Map storage map, bytes32 key) private view returns (bool) {
                                              return map._indexes[key] != 0;
                                          }
                                      
                                          /**
                                           * @dev Returns the number of key-value pairs in the map. O(1).
                                           */
                                          function _length(Map storage map) private view returns (uint256) {
                                              return map._entries.length;
                                          }
                                      
                                         /**
                                          * @dev Returns the key-value pair stored at position `index` in the map. O(1).
                                          *
                                          * Note that there are no guarantees on the ordering of entries inside the
                                          * array, and it may change when more entries are added or removed.
                                          *
                                          * Requirements:
                                          *
                                          * - `index` must be strictly less than {length}.
                                          */
                                          function _at(Map storage map, uint256 index) private view returns (bytes32, bytes32) {
                                              require(map._entries.length > index, "EnumerableMap: index out of bounds");
                                      
                                              MapEntry storage entry = map._entries[index];
                                              return (entry._key, entry._value);
                                          }
                                      
                                          /**
                                           * @dev Returns the value associated with `key`.  O(1).
                                           *
                                           * Requirements:
                                           *
                                           * - `key` must be in the map.
                                           */
                                          function _get(Map storage map, bytes32 key) private view returns (bytes32) {
                                              return _get(map, key, "EnumerableMap: nonexistent key");
                                          }
                                      
                                          /**
                                           * @dev Same as {_get}, with a custom error message when `key` is not in the map.
                                           */
                                          function _get(Map storage map, bytes32 key, string memory errorMessage) private view returns (bytes32) {
                                              uint256 keyIndex = map._indexes[key];
                                              require(keyIndex != 0, errorMessage); // Equivalent to contains(map, key)
                                              return map._entries[keyIndex - 1]._value; // All indexes are 1-based
                                          }
                                      
                                          // UintToAddressMap
                                      
                                          struct UintToAddressMap {
                                              Map _inner;
                                          }
                                      
                                          /**
                                           * @dev Adds a key-value pair to a map, or updates the value for an existing
                                           * key. O(1).
                                           *
                                           * Returns true if the key was added to the map, that is if it was not
                                           * already present.
                                           */
                                          function set(UintToAddressMap storage map, uint256 key, address value) internal returns (bool) {
                                              return _set(map._inner, bytes32(key), bytes32(uint256(value)));
                                          }
                                      
                                          /**
                                           * @dev Removes a value from a set. O(1).
                                           *
                                           * Returns true if the key was removed from the map, that is if it was present.
                                           */
                                          function remove(UintToAddressMap storage map, uint256 key) internal returns (bool) {
                                              return _remove(map._inner, bytes32(key));
                                          }
                                      
                                          /**
                                           * @dev Returns true if the key is in the map. O(1).
                                           */
                                          function contains(UintToAddressMap storage map, uint256 key) internal view returns (bool) {
                                              return _contains(map._inner, bytes32(key));
                                          }
                                      
                                          /**
                                           * @dev Returns the number of elements in the map. O(1).
                                           */
                                          function length(UintToAddressMap storage map) internal view returns (uint256) {
                                              return _length(map._inner);
                                          }
                                      
                                         /**
                                          * @dev Returns the element 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(UintToAddressMap storage map, uint256 index) internal view returns (uint256, address) {
                                              (bytes32 key, bytes32 value) = _at(map._inner, index);
                                              return (uint256(key), address(uint256(value)));
                                          }
                                      
                                          /**
                                           * @dev Returns the value associated with `key`.  O(1).
                                           *
                                           * Requirements:
                                           *
                                           * - `key` must be in the map.
                                           */
                                          function get(UintToAddressMap storage map, uint256 key) internal view returns (address) {
                                              return address(uint256(_get(map._inner, bytes32(key))));
                                          }
                                      
                                          /**
                                           * @dev Same as {get}, with a custom error message when `key` is not in the map.
                                           */
                                          function get(UintToAddressMap storage map, uint256 key, string memory errorMessage) internal view returns (address) {
                                              return address(uint256(_get(map._inner, bytes32(key), errorMessage)));
                                          }
                                      }
                                      
                                      
                                      // Dependency file: @openzeppelin/contracts-ethereum-package/contracts/utils/Strings.sol
                                      
                                      // pragma solidity ^0.6.0;
                                      
                                      /**
                                       * @dev String operations.
                                       */
                                      library Strings {
                                          /**
                                           * @dev Converts a `uint256` to its ASCII `string` 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);
                                              uint256 index = digits - 1;
                                              temp = value;
                                              while (temp != 0) {
                                                  buffer[index--] = byte(uint8(48 + temp % 10));
                                                  temp /= 10;
                                              }
                                              return string(buffer);
                                          }
                                      }
                                      
                                      
                                      // Dependency file: contracts/ERC721.sol
                                      
                                      // SPDX-License-Identifier: MIT
                                      
                                      // pragma solidity ^0.6.0;
                                      
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/GSN/Context.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Metadata.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Enumerable.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC721/IERC721Receiver.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/introspection/ERC165.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/utils/Address.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/utils/EnumerableSet.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/utils/EnumerableMap.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/utils/Strings.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/Initializable.sol";
                                      
                                      /**
                                       * @title ERC721 Non-Fungible Token Standard basic implementation
                                       * @dev see https://eips.ethereum.org/EIPS/eip-721
                                       */
                                      contract ERC721UpgradeSafe is Initializable, ContextUpgradeSafe, ERC165UpgradeSafe, IERC721, IERC721Metadata, IERC721Enumerable {
                                          using SafeMath for uint256;
                                          using Address for address;
                                          using EnumerableSet for EnumerableSet.UintSet;
                                          using EnumerableMap for EnumerableMap.UintToAddressMap;
                                          using Strings for uint256;
                                      
                                          // Equals to `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
                                          // which can be also obtained as `IERC721Receiver(0).onERC721Received.selector`
                                          bytes4 private constant _ERC721_RECEIVED = 0x150b7a02;
                                      
                                          // Mapping from holder address to their (enumerable) set of owned tokens
                                          mapping (address => EnumerableSet.UintSet) private _holderTokens;
                                      
                                          // Enumerable mapping from token ids to their owners
                                          EnumerableMap.UintToAddressMap private _tokenOwners;
                                      
                                          // Mapping from token ID to approved address
                                          mapping (uint256 => address) private _tokenApprovals;
                                      
                                          // Mapping from owner to operator approvals
                                          mapping (address => mapping (address => bool)) private _operatorApprovals;
                                      
                                          // Token name
                                          string private _name;
                                      
                                          // Token symbol
                                          string private _symbol;
                                      
                                          // Optional mapping for token URIs
                                          mapping(uint256 => string) private _tokenURIs;
                                      
                                          // Base URI
                                          string private _baseURI;
                                      
                                          /*
                                           *     bytes4(keccak256('balanceOf(address)')) == 0x70a08231
                                           *     bytes4(keccak256('ownerOf(uint256)')) == 0x6352211e
                                           *     bytes4(keccak256('approve(address,uint256)')) == 0x095ea7b3
                                           *     bytes4(keccak256('getApproved(uint256)')) == 0x081812fc
                                           *     bytes4(keccak256('setApprovalForAll(address,bool)')) == 0xa22cb465
                                           *     bytes4(keccak256('isApprovedForAll(address,address)')) == 0xe985e9c5
                                           *     bytes4(keccak256('transferFrom(address,address,uint256)')) == 0x23b872dd
                                           *     bytes4(keccak256('safeTransferFrom(address,address,uint256)')) == 0x42842e0e
                                           *     bytes4(keccak256('safeTransferFrom(address,address,uint256,bytes)')) == 0xb88d4fde
                                           *
                                           *     => 0x70a08231 ^ 0x6352211e ^ 0x095ea7b3 ^ 0x081812fc ^
                                           *        0xa22cb465 ^ 0xe985e9c ^ 0x23b872dd ^ 0x42842e0e ^ 0xb88d4fde == 0x80ac58cd
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721 = 0x80ac58cd;
                                      
                                          /*
                                           *     bytes4(keccak256('name()')) == 0x06fdde03
                                           *     bytes4(keccak256('symbol()')) == 0x95d89b41
                                           *     bytes4(keccak256('tokenURI(uint256)')) == 0xc87b56dd
                                           *
                                           *     => 0x06fdde03 ^ 0x95d89b41 ^ 0xc87b56dd == 0x5b5e139f
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721_METADATA = 0x5b5e139f;
                                      
                                          /*
                                           *     bytes4(keccak256('totalSupply()')) == 0x18160ddd
                                           *     bytes4(keccak256('tokenOfOwnerByIndex(address,uint256)')) == 0x2f745c59
                                           *     bytes4(keccak256('tokenByIndex(uint256)')) == 0x4f6ccce7
                                           *
                                           *     => 0x18160ddd ^ 0x2f745c59 ^ 0x4f6ccce7 == 0x780e9d63
                                           */
                                          bytes4 private constant _INTERFACE_ID_ERC721_ENUMERABLE = 0x780e9d63;
                                      
                                      
                                          function __ERC721_init(string memory name, string memory symbol) internal initializer {
                                              __Context_init_unchained();
                                              __ERC165_init_unchained();
                                              __ERC721_init_unchained(name, symbol);
                                          }
                                      
                                          function __ERC721_init_unchained(string memory name, string memory symbol) internal initializer {
                                      
                                      
                                              _name = name;
                                              _symbol = symbol;
                                      
                                              // register the supported interfaces to conform to ERC721 via ERC165
                                              _registerInterface(_INTERFACE_ID_ERC721);
                                              _registerInterface(_INTERFACE_ID_ERC721_METADATA);
                                              _registerInterface(_INTERFACE_ID_ERC721_ENUMERABLE);
                                      
                                          }
                                      
                                      
                                          /**
                                           * @dev Gets the balance of the specified address.
                                           * @param owner address to query the balance of
                                           * @return uint256 representing the amount owned by the passed address
                                           */
                                          function balanceOf(address owner) public view override returns (uint256) {
                                              require(owner != address(0), "ERC721: balance query for the zero address");
                                      
                                              return _holderTokens[owner].length();
                                          }
                                      
                                          /**
                                           * @dev Gets the owner of the specified token ID.
                                           * @param tokenId uint256 ID of the token to query the owner of
                                           * @return address currently marked as the owner of the given token ID
                                           */
                                          function ownerOf(uint256 tokenId) public view override returns (address) {
                                              return _tokenOwners.get(tokenId, "ERC721: owner query for nonexistent token");
                                          }
                                      
                                          /**
                                           * @dev Gets the token name.
                                           * @return string representing the token name
                                           */
                                          function name() public view override returns (string memory) {
                                              return _name;
                                          }
                                      
                                          /**
                                           * @dev Gets the token symbol.
                                           * @return string representing the token symbol
                                           */
                                          function symbol() public view override returns (string memory) {
                                              return _symbol;
                                          }
                                      
                                          /**
                                           * @dev Returns the URI for a given token ID. May return an empty string.
                                           *
                                           * If a base URI is set (via {_setBaseURI}), it is added as a prefix to the
                                           * token's own URI (via {_setTokenURI}).
                                           *
                                           * If there is a base URI but no token URI, the token's ID will be used as
                                           * its URI when appending it to the base URI. This pattern for autogenerated
                                           * token URIs can lead to large gas savings.
                                           *
                                           * .Examples
                                           * |===
                                           * |`_setBaseURI()` |`_setTokenURI()` |`tokenURI()`
                                           * | ""
                                           * | ""
                                           * | ""
                                           * | ""
                                           * | "token.uri/123"
                                           * | "token.uri/123"
                                           * | "token.uri/"
                                           * | "123"
                                           * | "token.uri/123"
                                           * | "token.uri/"
                                           * | ""
                                           * | "token.uri/<tokenId>"
                                           * |===
                                           *
                                           * Requirements:
                                           *
                                           * - `tokenId` must exist.
                                           */
                                          function tokenURI(uint256 tokenId) public view override virtual returns (string memory) {
                                              require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
                                      
                                              string memory _tokenURI = _tokenURIs[tokenId];
                                      
                                              // If there is no base URI, return the token URI.
                                              if (bytes(_baseURI).length == 0) {
                                                  return _tokenURI;
                                              }
                                              // If both are set, concatenate the baseURI and tokenURI (via abi.encodePacked).
                                              if (bytes(_tokenURI).length > 0) {
                                                  return string(abi.encodePacked(_baseURI, _tokenURI));
                                              }
                                              // If there is a baseURI but no tokenURI, concatenate the tokenID to the baseURI.
                                              return string(abi.encodePacked(_baseURI, tokenId.toString()));
                                          }
                                      
                                          /**
                                          * @dev Returns the base URI set via {_setBaseURI}. This will be
                                          * automatically added as a prefix in {tokenURI} to each token's URI, or
                                          * to the token ID if no specific URI is set for that token ID.
                                          */
                                          function baseURI() public view returns (string memory) {
                                              return _baseURI;
                                          }
                                      
                                          /**
                                           * @dev Gets the token ID at a given index of the tokens list of the requested owner.
                                           * @param owner address owning the tokens list to be accessed
                                           * @param index uint256 representing the index to be accessed of the requested tokens list
                                           * @return uint256 token ID at the given index of the tokens list owned by the requested address
                                           */
                                          function tokenOfOwnerByIndex(address owner, uint256 index) public view override returns (uint256) {
                                              return _holderTokens[owner].at(index);
                                          }
                                      
                                          /**
                                           * @dev Gets the total amount of tokens stored by the contract.
                                           * @return uint256 representing the total amount of tokens
                                           */
                                          function totalSupply() public view override returns (uint256) {
                                              // _tokenOwners are indexed by tokenIds, so .length() returns the number of tokenIds
                                              return _tokenOwners.length();
                                          }
                                      
                                          /**
                                           * @dev Gets the token ID at a given index of all the tokens in this contract
                                           * Reverts if the index is greater or equal to the total number of tokens.
                                           * @param index uint256 representing the index to be accessed of the tokens list
                                           * @return uint256 token ID at the given index of the tokens list
                                           */
                                          function tokenByIndex(uint256 index) public view override returns (uint256) {
                                              (uint256 tokenId, ) = _tokenOwners.at(index);
                                              return tokenId;
                                          }
                                      
                                          /**
                                           * @dev Approves another address to transfer the given token ID
                                           * The zero address indicates there is no approved address.
                                           * There can only be one approved address per token at a given time.
                                           * Can only be called by the token owner or an approved operator.
                                           * @param to address to be approved for the given token ID
                                           * @param tokenId uint256 ID of the token to be approved
                                           */
                                          function approve(address to, uint256 tokenId) public virtual override {
                                              address owner = ownerOf(tokenId);
                                              require(to != owner, "ERC721: approval to current owner");
                                      
                                              require(_msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                                                  "ERC721: approve caller is not owner nor approved for all"
                                              );
                                      
                                              _approve(to, tokenId);
                                          }
                                      
                                          /**
                                           * @dev Gets the approved address for a token ID, or zero if no address set
                                           * Reverts if the token ID does not exist.
                                           * @param tokenId uint256 ID of the token to query the approval of
                                           * @return address currently approved for the given token ID
                                           */
                                          function getApproved(uint256 tokenId) public view override returns (address) {
                                              require(_exists(tokenId), "ERC721: approved query for nonexistent token");
                                      
                                              return _tokenApprovals[tokenId];
                                          }
                                      
                                          /**
                                           * @dev Sets or unsets the approval of a given operator
                                           * An operator is allowed to transfer all tokens of the sender on their behalf.
                                           * @param operator operator address to set the approval
                                           * @param approved representing the status of the approval to be set
                                           */
                                          function setApprovalForAll(address operator, bool approved) public virtual override {
                                              require(operator != _msgSender(), "ERC721: approve to caller");
                                      
                                              _operatorApprovals[_msgSender()][operator] = approved;
                                              emit ApprovalForAll(_msgSender(), operator, approved);
                                          }
                                      
                                          /**
                                           * @dev Tells whether an operator is approved by a given owner.
                                           * @param owner owner address which you want to query the approval of
                                           * @param operator operator address which you want to query the approval of
                                           * @return bool whether the given operator is approved by the given owner
                                           */
                                          function isApprovedForAll(address owner, address operator) public view override returns (bool) {
                                              return _operatorApprovals[owner][operator];
                                          }
                                      
                                          /**
                                           * @dev Transfers the ownership of a given token ID to another address.
                                           * Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
                                           * Requires the msg.sender to be the owner, approved, or operator.
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function transferFrom(address from, address to, uint256 tokenId) public virtual override {
                                              //solhint-disable-next-line max-line-length
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                                      
                                              _transfer(from, to, tokenId);
                                          }
                                      
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement {IERC721Receiver-onERC721Received},
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the msg.sender to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId) public virtual override {
                                              safeTransferFrom(from, to, tokenId, "");
                                          }
                                      
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement {IERC721Receiver-onERC721Received},
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the _msgSender() to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory _data) public virtual override {
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                                              _safeTransfer(from, to, tokenId, _data);
                                          }
                                      
                                          /**
                                           * @dev Safely transfers the ownership of a given token ID to another address
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * Requires the msg.sender to be the owner, approved, or operator
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function _safeTransfer(address from, address to, uint256 tokenId, bytes memory _data) internal virtual {
                                              _transfer(from, to, tokenId);
                                              require(_checkOnERC721Received(from, to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
                                          }
                                      
                                          /**
                                           * @dev Returns whether the specified token exists.
                                           * @param tokenId uint256 ID of the token to query the existence of
                                           * @return bool whether the token exists
                                           */
                                          function _exists(uint256 tokenId) internal view returns (bool) {
                                              return _tokenOwners.contains(tokenId);
                                          }
                                      
                                          /**
                                           * @dev Returns whether the given spender can transfer a given token ID.
                                           * @param spender address of the spender to query
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @return bool whether the msg.sender is approved for the given token ID,
                                           * is an operator of the owner, or is the owner of the token
                                           */
                                          function _isApprovedOrOwner(address spender, uint256 tokenId) internal view returns (bool) {
                                              require(_exists(tokenId), "ERC721: operator query for nonexistent token");
                                              address owner = ownerOf(tokenId);
                                              return (spender == owner || getApproved(tokenId) == spender || isApprovedForAll(owner, spender));
                                          }
                                      
                                          /**
                                           * @dev Internal function to safely mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           */
                                          function _safeMint(address to, uint256 tokenId) internal virtual {
                                              _safeMint(to, tokenId, "");
                                          }
                                      
                                          /**
                                           * @dev Internal function to safely mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * If the target address is a contract, it must implement `onERC721Received`,
                                           * which is called upon a safe transfer, and return the magic value
                                           * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                                           * the transfer is reverted.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           * @param _data bytes data to send along with a safe transfer check
                                           */
                                          function _safeMint(address to, uint256 tokenId, bytes memory _data) internal virtual {
                                              _mint(to, tokenId);
                                              require(_checkOnERC721Received(address(0), to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
                                          }
                                      
                                          /**
                                           * @dev Internal function to mint a new token.
                                           * Reverts if the given token ID already exists.
                                           * @param to The address that will own the minted token
                                           * @param tokenId uint256 ID of the token to be minted
                                           */
                                          function _mint(address to, uint256 tokenId) internal virtual {
                                              require(to != address(0), "ERC721: mint to the zero address");
                                              require(!_exists(tokenId), "ERC721: token already minted");
                                      
                                              _beforeTokenTransfer(address(0), to, tokenId);
                                      
                                              _holderTokens[to].add(tokenId);
                                      
                                              _tokenOwners.set(tokenId, to);
                                      
                                              emit Transfer(address(0), to, tokenId);
                                          }
                                      
                                          /**
                                           * @dev Internal function to burn a specific token.
                                           * Reverts if the token does not exist.
                                           * @param tokenId uint256 ID of the token being burned
                                           */
                                          function _burn(uint256 tokenId) internal virtual {
                                              address owner = ownerOf(tokenId);
                                      
                                              _beforeTokenTransfer(owner, address(0), tokenId);
                                      
                                              // Clear approvals
                                              _approve(address(0), tokenId);
                                      
                                              // Clear metadata (if any)
                                              if (bytes(_tokenURIs[tokenId]).length != 0) {
                                                  delete _tokenURIs[tokenId];
                                              }
                                      
                                              _holderTokens[owner].remove(tokenId);
                                      
                                              _tokenOwners.remove(tokenId);
                                      
                                              emit Transfer(owner, address(0), tokenId);
                                          }
                                      
                                          /**
                                           * @dev Internal function to transfer ownership of a given token ID to another address.
                                           * As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
                                           * @param from current owner of the token
                                           * @param to address to receive the ownership of the given token ID
                                           * @param tokenId uint256 ID of the token to be transferred
                                           */
                                          function _transfer(address from, address to, uint256 tokenId) internal virtual {
                                              require(ownerOf(tokenId) == from, "ERC721: transfer of token that is not own");
                                              require(to != address(0), "ERC721: transfer to the zero address");
                                      
                                              _beforeTokenTransfer(from, to, tokenId);
                                      
                                              // Clear approvals from the previous owner
                                              _approve(address(0), tokenId);
                                      
                                              _holderTokens[from].remove(tokenId);
                                              _holderTokens[to].add(tokenId);
                                      
                                              _tokenOwners.set(tokenId, to);
                                      
                                              emit Transfer(from, to, tokenId);
                                          }
                                      
                                          /**
                                           * @dev Internal function to set the token URI for a given token.
                                           *
                                           * Reverts if the token ID does not exist.
                                           *
                                           * TIP: If all token IDs share a prefix (for example, if your URIs look like
                                           * `https://api.myproject.com/token/<id>`), use {_setBaseURI} to store
                                           * it and save gas.
                                           */
                                          function _setTokenURI(uint256 tokenId, string memory _tokenURI) internal virtual {
                                              require(_exists(tokenId), "ERC721Metadata: URI set of nonexistent token");
                                              _tokenURIs[tokenId] = _tokenURI;
                                          }
                                      
                                          /**
                                           * @dev Internal function to set the base URI for all token IDs. It is
                                           * automatically added as a prefix to the value returned in {tokenURI},
                                           * or to the token ID if {tokenURI} is empty.
                                           */
                                          function _setBaseURI(string memory baseURI_) internal virtual {
                                              _baseURI = baseURI_;
                                          }
                                      
                                          /**
                                           * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
                                           * The call is not executed if the target address is not a contract.
                                           *
                                           * @param from address representing the previous owner of the given token ID
                                           * @param to target address that will receive the tokens
                                           * @param tokenId uint256 ID of the token to be transferred
                                           * @param _data bytes optional data to send along with the call
                                           * @return bool whether the call correctly returned the expected magic value
                                           */
                                          function _checkOnERC721Received(address from, address to, uint256 tokenId, bytes memory _data)
                                              private returns (bool)
                                          {
                                              if (!to.isContract()) {
                                                  return true;
                                              }
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, bytes memory returndata) = to.call(abi.encodeWithSelector(
                                                  IERC721Receiver(to).onERC721Received.selector,
                                                  _msgSender(),
                                                  from,
                                                  tokenId,
                                                  _data
                                              ));
                                              if (!success) {
                                                  if (returndata.length > 0) {
                                                      // solhint-disable-next-line no-inline-assembly
                                                      assembly {
                                                          let returndata_size := mload(returndata)
                                                          revert(add(32, returndata), returndata_size)
                                                      }
                                                  } else {
                                                      revert("ERC721: transfer to non ERC721Receiver implementer");
                                                  }
                                              } else {
                                                  bytes4 retval = abi.decode(returndata, (bytes4));
                                                  return (retval == _ERC721_RECEIVED);
                                              }
                                          }
                                      
                                          function _approve(address to, uint256 tokenId) private {
                                              _tokenApprovals[tokenId] = to;
                                              emit Approval(ownerOf(tokenId), to, tokenId);
                                          }
                                      
                                          /**
                                           * @dev Hook that is called before any token transfer. This includes minting
                                           * and burning.
                                           *
                                           * Calling conditions:
                                           *
                                           * - when `from` and `to` are both non-zero, ``from``'s `tokenId` will be
                                           * transferred to `to`.
                                           * - when `from` is zero, `tokenId` will be minted for `to`.
                                           * - when `to` is zero, ``from``'s `tokenId` 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 tokenId) internal virtual { }
                                      
                                          uint256[41] private __gap;
                                      }
                                      
                                      
                                      // Dependency file: contracts/MushroomLib.sol
                                      
                                      
                                      // pragma solidity ^0.6.0;
                                      
                                      library MushroomLib {
                                          struct MushroomData {
                                              uint256 species;
                                              uint256 strength;
                                              uint256 lifespan;
                                          }
                                      
                                          struct MushroomType {
                                              uint256 id;
                                              uint256 strength;
                                              uint256 minLifespan;
                                              uint256 maxLifespan;
                                              uint256 minted;
                                              uint256 cap;
                                          }
                                      }
                                      
                                      
                                      // Dependency file: contracts/MushroomNFT.sol
                                      
                                      
                                      // pragma solidity ^0.6.0;
                                      pragma experimental ABIEncoderV2;
                                      
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/access/AccessControl.sol";
                                      // import "contracts/ERC721.sol";
                                      // import "contracts/MushroomLib.sol";
                                      
                                      /*
                                          Minting and burning permissions are managed by the Owner
                                      */
                                      contract MushroomNFT is ERC721UpgradeSafe, OwnableUpgradeSafe, AccessControlUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                      
                                          mapping (uint256 => MushroomLib.MushroomData) public mushroomData; // NFT Id -> Metadata
                                          mapping (uint256 => MushroomLib.MushroomType) public mushroomTypes; // Species Id -> Metadata
                                          mapping (uint256 => bool) public mushroomTypeExists; // Species Id -> Exists
                                          mapping (uint256 => string) public mushroomMetadataUri; // Species Id -> URI
                                      
                                          bytes32 public constant LIFESPAN_MODIFIER_ROLE = keccak256("LIFESPAN_MODIFIER_ROLE");
                                          bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");
                                      
                                          uint256 public burnedCount;
                                      
                                          function initialize() public initializer {
                                              __Ownable_init_unchained();
                                              __AccessControl_init_unchained();
                                              __ERC721_init("Enoki Mushrooms", "Enoki Mushrooms");
                                      
                                              _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                                          }
                                      
                                          /* ========== VIEWS ========== */
                                      
                                          // Mushrooms inherit their strength from their species
                                          function getMushroomData(uint256 tokenId) public view returns (MushroomLib.MushroomData memory) {
                                              MushroomLib.MushroomData memory data = mushroomData[tokenId];
                                              return data;
                                          }
                                      
                                          function getSpecies(uint256 speciesId) public view returns (MushroomLib.MushroomType memory) {
                                              return mushroomTypes[speciesId];
                                          }
                                      
                                          function getRemainingMintableForSpecies(uint256 speciesId) public view returns (uint256) {
                                              MushroomLib.MushroomType storage species = mushroomTypes[speciesId];
                                              return species.cap.sub(species.minted);
                                          }
                                      
                                          /// @notice Return token URI for mushroom
                                          /// @notice URI is determined by species and can be modifed by the owner
                                          function tokenURI(uint256 tokenId) public view override returns (string memory) {
                                              MushroomLib.MushroomData storage data = mushroomData[tokenId];
                                              return mushroomMetadataUri[data.species];
                                          }  
                                      
                                          /* ========== ROLE MANAGEMENT ========== */
                                      
                                          // TODO: Ensure we can transfer admin role privledges
                                      
                                          modifier onlyLifespanModifier() {
                                              require(hasRole(LIFESPAN_MODIFIER_ROLE, msg.sender), "MushroomNFT: Only approved lifespan modifier");
                                              _;
                                          }
                                      
                                          modifier onlyMinter() {
                                              require(hasRole(MINTER_ROLE, msg.sender), "MushroomNFT: Only approved mushroom minter");
                                              _;
                                          }
                                      
                                          modifier onlyAdmin() {
                                              require(hasRole(DEFAULT_ADMIN_ROLE, msg.sender), "MushroomNFT: Only approved admin");
                                              _;
                                          }
                                      
                                          /* ========== RESTRICTED FUNCTIONS ========== */
                                      
                                          /**
                                           * @dev The burner must be the owner of the token, or approved. The EnokiGeyser owns tokens when it burns them.
                                           */
                                          function burn(uint256 tokenId) public {
                                              //solhint-disable-next-line max-line-length
                                              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721Burnable: caller is not owner nor approved");
                                              _burn(tokenId);
                                              burnedCount = burnedCount.add(1);
                                              _clearMushroomData(tokenId);
                                          }
                                      
                                          function initializeBurnCount(uint256 count) public onlyAdmin {
                                              burnedCount = count;
                                          }
                                      
                                          function mint(address recipient, uint256 tokenId, uint256 speciesId, uint256 lifespan) public onlyMinter {
                                              _mintWithMetadata(recipient, tokenId, speciesId, lifespan);
                                          }
                                      
                                          /// @notice return next available index Id
                                          function nextIndex() external view returns (uint256) {
                                              return totalSupply().add(burnedCount).add(1);
                                          }
                                      
                                          function setMushroomLifespan(uint256 index, uint256 lifespan) public onlyLifespanModifier {
                                              mushroomData[index].lifespan = lifespan;
                                          }
                                      
                                          function setSpeciesUri(uint256 speciesId, string memory URI) public onlyOwner {
                                              mushroomMetadataUri[speciesId] = URI;
                                          }
                                      
                                          function _mintWithMetadata(address recipient, uint256 tokenId, uint256 speciesId, uint256 lifespan) internal {
                                              require(mushroomTypeExists[speciesId], "MushroomNFT: mushroom species specified does not exist");
                                              MushroomLib.MushroomType storage species = mushroomTypes[speciesId];
                                      
                                              require(species.minted < species.cap, "MushroomNFT: minting cap reached for species");
                                      
                                              species.minted = species.minted.add(1);
                                              mushroomData[tokenId] = MushroomLib.MushroomData(speciesId, species.strength, lifespan);
                                      
                                              _safeMint(recipient, tokenId);
                                          }
                                      
                                          // TODO: We don't really have to do this as a newly minted mushroom will set the data
                                          function _clearMushroomData(uint256 tokenId) internal {
                                              MushroomLib.MushroomData storage data = mushroomData[tokenId];
                                              MushroomLib.MushroomType storage species = mushroomTypes[data.species];   
                                      
                                              mushroomData[tokenId].species = 0;
                                              mushroomData[tokenId].strength = 0;
                                              mushroomData[tokenId].lifespan = 0;
                                      
                                              species.minted = species.minted.sub(1);
                                          }
                                          function setMushroomType(uint256 speciesId, MushroomLib.MushroomType memory mType) public onlyOwner {
                                              if (!mushroomTypeExists[speciesId]) {
                                                  mushroomTypeExists[speciesId] = true;
                                              }
                                      
                                              mushroomTypes[speciesId] = mType;
                                          }
                                      }
                                      
                                      // Root file: contracts/MushroomFactory.sol
                                      
                                      
                                      pragma solidity ^0.6.0;
                                      // pragma experimental ABIEncoderV2;
                                      
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/math/SafeMath.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/IERC20.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/token/ERC20/SafeERC20.sol";
                                      // import "@openzeppelin/contracts-ethereum-package/contracts/access/Ownable.sol";
                                      
                                      // import "contracts/MushroomNFT.sol";
                                      // import "contracts/MushroomLib.sol";
                                      
                                      /*
                                          MushroomFactories manage the mushroom generation logic for pools
                                          Each pool will have it's own factory to generate mushrooms according
                                          to its' powers.
                                      
                                          The mushroomFactory should be administered by the pool, which grants the ability to grow mushrooms
                                      */
                                      contract MushroomFactory is Initializable, OwnableUpgradeSafe {
                                          using MushroomLib for MushroomLib.MushroomData;
                                          using MushroomLib for MushroomLib.MushroomType;
                                          using SafeMath for uint256;
                                      
                                          event MushroomGrown(address recipient, uint256 id, uint256 species, uint256 lifespan);
                                      
                                          IERC20 public sporeToken;
                                          MushroomNFT public mushroomNft;
                                      
                                          uint256 public costPerMushroom;
                                          uint256 public mySpecies;
                                      
                                          uint256 public spawnCount;
                                      
                                          function initialize(
                                              IERC20 sporeToken_,
                                              MushroomNFT mushroomNft_,
                                              address sporePool_,
                                              uint256 costPerMushroom_,
                                              uint256 mySpecies_
                                          ) public initializer {
                                              __Ownable_init();
                                              sporeToken = sporeToken_;
                                              mushroomNft = mushroomNft_;
                                              costPerMushroom = costPerMushroom_;
                                              mySpecies = mySpecies_;
                                              transferOwnership(sporePool_);
                                          }
                                      
                                          /*
                                              Each mushroom will have a randomly generated lifespan within it's range. To prevent mushrooms harvested at the same block from having the same properties, a spawnCount seed is added to the block timestamp before hashing the timestamp to generate the lifespan for each individual mushroom.
                                      
                                              Note that block.timestamp is somewhat manipulatable by Miners. If a Miner was a massive ENOKI fan and only harvested when the mined a block they could give themselves mushrooms with longer lifespan than the average. However, the lifespan is still constained by the max lifespan. 
                                          */
                                          function _generateMushroomLifespan(uint256 minLifespan, uint256 maxLifespan) internal returns (uint256) {
                                              uint256 range = maxLifespan.sub(minLifespan);
                                              uint256 fromMin = uint256(keccak256(abi.encodePacked(block.timestamp.add(spawnCount)))) % range;
                                              spawnCount = spawnCount.add(1);
                                      
                                              return minLifespan.add(fromMin);
                                          }
                                      
                                          function getRemainingMintableForMySpecies() public view returns (uint256) {
                                              return mushroomNft.getRemainingMintableForSpecies(mySpecies);
                                          }
                                      
                                          // Each mushroom costs 1/10th of the spore rate in spores.
                                          function growMushrooms(address recipient, uint256 numMushrooms) public onlyOwner {
                                              MushroomLib.MushroomType memory species = mushroomNft.getSpecies(mySpecies);
                                      
                                              require(getRemainingMintableForMySpecies() >= numMushrooms, "MushroomFactory: Mushrooms to grow exceeds species cap");
                                              for (uint256 i = 0; i < numMushrooms; i++) {
                                                  uint256 nextId = mushroomNft.nextIndex();
                                                  
                                                  uint256 lifespan = _generateMushroomLifespan(species.minLifespan, species.maxLifespan);
                                                  mushroomNft.mint(recipient, nextId, mySpecies, lifespan);
                                                  emit MushroomGrown(recipient, nextId, mySpecies, lifespan);
                                              }
                                          }
                                      }

                                      File 11 of 14: AppProxyUpgradeable
                                      // File: contracts/common/UnstructuredStorage.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      library UnstructuredStorage {
                                          function getStorageBool(bytes32 position) internal view returns (bool data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageAddress(bytes32 position) internal view returns (address data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageBytes32(bytes32 position) internal view returns (bytes32 data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageUint256(bytes32 position) internal view returns (uint256 data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function setStorageBool(bytes32 position, bool data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageAddress(bytes32 position, address data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageBytes32(bytes32 position, bytes32 data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageUint256(bytes32 position, uint256 data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      }
                                      
                                      // File: contracts/acl/IACL.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      interface IACL {
                                          function initialize(address permissionsCreator) external;
                                      
                                          // TODO: this should be external
                                          // See https://github.com/ethereum/solidity/issues/4832
                                          function hasPermission(address who, address where, bytes32 what, bytes how) public view returns (bool);
                                      }
                                      
                                      // File: contracts/common/IVaultRecoverable.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      interface IVaultRecoverable {
                                          event RecoverToVault(address indexed vault, address indexed token, uint256 amount);
                                      
                                          function transferToVault(address token) external;
                                      
                                          function allowRecoverability(address token) external view returns (bool);
                                          function getRecoveryVault() external view returns (address);
                                      }
                                      
                                      // File: contracts/kernel/IKernel.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      interface IKernelEvents {
                                          event SetApp(bytes32 indexed namespace, bytes32 indexed appId, address app);
                                      }
                                      
                                      
                                      // This should be an interface, but interfaces can't inherit yet :(
                                      contract IKernel is IKernelEvents, IVaultRecoverable {
                                          function acl() public view returns (IACL);
                                          function hasPermission(address who, address where, bytes32 what, bytes how) public view returns (bool);
                                      
                                          function setApp(bytes32 namespace, bytes32 appId, address app) public;
                                          function getApp(bytes32 namespace, bytes32 appId) public view returns (address);
                                      }
                                      
                                      // File: contracts/apps/AppStorage.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      contract AppStorage {
                                          using UnstructuredStorage for bytes32;
                                      
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant KERNEL_POSITION = keccak256("aragonOS.appStorage.kernel");
                                          bytes32 internal constant APP_ID_POSITION = keccak256("aragonOS.appStorage.appId");
                                          */
                                          bytes32 internal constant KERNEL_POSITION = 0x4172f0f7d2289153072b0a6ca36959e0cbe2efc3afe50fc81636caa96338137b;
                                          bytes32 internal constant APP_ID_POSITION = 0xd625496217aa6a3453eecb9c3489dc5a53e6c67b444329ea2b2cbc9ff547639b;
                                      
                                          function kernel() public view returns (IKernel) {
                                              return IKernel(KERNEL_POSITION.getStorageAddress());
                                          }
                                      
                                          function appId() public view returns (bytes32) {
                                              return APP_ID_POSITION.getStorageBytes32();
                                          }
                                      
                                          function setKernel(IKernel _kernel) internal {
                                              KERNEL_POSITION.setStorageAddress(address(_kernel));
                                          }
                                      
                                          function setAppId(bytes32 _appId) internal {
                                              APP_ID_POSITION.setStorageBytes32(_appId);
                                          }
                                      }
                                      
                                      // File: contracts/common/IsContract.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract IsContract {
                                          /*
                                          * NOTE: this should NEVER be used for authentication
                                          * (see pitfalls: https://github.com/fergarrui/ethereum-security/tree/master/contracts/extcodesize).
                                          *
                                          * This is only intended to be used as a sanity check that an address is actually a contract,
                                          * RATHER THAN an address not being a contract.
                                          */
                                          function isContract(address _target) internal view returns (bool) {
                                              if (_target == address(0)) {
                                                  return false;
                                              }
                                      
                                              uint256 size;
                                              assembly { size := extcodesize(_target) }
                                              return size > 0;
                                          }
                                      }
                                      
                                      // File: contracts/lib/misc/ERCProxy.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract ERCProxy {
                                          uint256 internal constant FORWARDING = 1;
                                          uint256 internal constant UPGRADEABLE = 2;
                                      
                                          function proxyType() public pure returns (uint256 proxyTypeId);
                                          function implementation() public view returns (address codeAddr);
                                      }
                                      
                                      // File: contracts/common/DelegateProxy.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      contract DelegateProxy is ERCProxy, IsContract {
                                          uint256 internal constant FWD_GAS_LIMIT = 10000;
                                      
                                          /**
                                          * @dev Performs a delegatecall and returns whatever the delegatecall returned (entire context execution will return!)
                                          * @param _dst Destination address to perform the delegatecall
                                          * @param _calldata Calldata for the delegatecall
                                          */
                                          function delegatedFwd(address _dst, bytes _calldata) internal {
                                              require(isContract(_dst));
                                              uint256 fwdGasLimit = FWD_GAS_LIMIT;
                                      
                                              assembly {
                                                  let result := delegatecall(sub(gas, fwdGasLimit), _dst, add(_calldata, 0x20), mload(_calldata), 0, 0)
                                                  let size := returndatasize
                                                  let ptr := mload(0x40)
                                                  returndatacopy(ptr, 0, size)
                                      
                                                  // revert instead of invalid() bc if the underlying call failed with invalid() it already wasted gas.
                                                  // if the call returned error data, forward it
                                                  switch result case 0 { revert(ptr, size) }
                                                  default { return(ptr, size) }
                                              }
                                          }
                                      }
                                      
                                      // File: contracts/common/DepositableStorage.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      contract DepositableStorage {
                                          using UnstructuredStorage for bytes32;
                                      
                                          // keccak256("aragonOS.depositableStorage.depositable")
                                          bytes32 internal constant DEPOSITABLE_POSITION = 0x665fd576fbbe6f247aff98f5c94a561e3f71ec2d3c988d56f12d342396c50cea;
                                      
                                          function isDepositable() public view returns (bool) {
                                              return DEPOSITABLE_POSITION.getStorageBool();
                                          }
                                      
                                          function setDepositable(bool _depositable) internal {
                                              DEPOSITABLE_POSITION.setStorageBool(_depositable);
                                          }
                                      }
                                      
                                      // File: contracts/common/DepositableDelegateProxy.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      contract DepositableDelegateProxy is DepositableStorage, DelegateProxy {
                                          event ProxyDeposit(address sender, uint256 value);
                                      
                                          function () external payable {
                                              uint256 forwardGasThreshold = FWD_GAS_LIMIT;
                                              bytes32 isDepositablePosition = DEPOSITABLE_POSITION;
                                      
                                              // Optimized assembly implementation to prevent EIP-1884 from breaking deposits, reference code in Solidity:
                                              // https://github.com/aragon/aragonOS/blob/v4.2.1/contracts/common/DepositableDelegateProxy.sol#L10-L20
                                              assembly {
                                                  // Continue only if the gas left is lower than the threshold for forwarding to the implementation code,
                                                  // otherwise continue outside of the assembly block.
                                                  if lt(gas, forwardGasThreshold) {
                                                      // Only accept the deposit and emit an event if all of the following are true:
                                                      // the proxy accepts deposits (isDepositable), msg.data.length == 0, and msg.value > 0
                                                      if and(and(sload(isDepositablePosition), iszero(calldatasize)), gt(callvalue, 0)) {
                                                          // Equivalent Solidity code for emitting the event:
                                                          // emit ProxyDeposit(msg.sender, msg.value);
                                      
                                                          let logData := mload(0x40) // free memory pointer
                                                          mstore(logData, caller) // add 'msg.sender' to the log data (first event param)
                                                          mstore(add(logData, 0x20), callvalue) // add 'msg.value' to the log data (second event param)
                                      
                                                          // Emit an event with one topic to identify the event: keccak256('ProxyDeposit(address,uint256)') = 0x15ee...dee1
                                                          log1(logData, 0x40, 0x15eeaa57c7bd188c1388020bcadc2c436ec60d647d36ef5b9eb3c742217ddee1)
                                      
                                                          stop() // Stop. Exits execution context
                                                      }
                                      
                                                      // If any of above checks failed, revert the execution (if ETH was sent, it is returned to the sender)
                                                      revert(0, 0)
                                                  }
                                              }
                                      
                                              address target = implementation();
                                              delegatedFwd(target, msg.data);
                                          }
                                      }
                                      
                                      // File: contracts/kernel/KernelConstants.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract KernelAppIds {
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant KERNEL_CORE_APP_ID = apmNamehash("kernel");
                                          bytes32 internal constant KERNEL_DEFAULT_ACL_APP_ID = apmNamehash("acl");
                                          bytes32 internal constant KERNEL_DEFAULT_VAULT_APP_ID = apmNamehash("vault");
                                          */
                                          bytes32 internal constant KERNEL_CORE_APP_ID = 0x3b4bf6bf3ad5000ecf0f989d5befde585c6860fea3e574a4fab4c49d1c177d9c;
                                          bytes32 internal constant KERNEL_DEFAULT_ACL_APP_ID = 0xe3262375f45a6e2026b7e7b18c2b807434f2508fe1a2a3dfb493c7df8f4aad6a;
                                          bytes32 internal constant KERNEL_DEFAULT_VAULT_APP_ID = 0x7e852e0fcfce6551c13800f1e7476f982525c2b5277ba14b24339c68416336d1;
                                      }
                                      
                                      
                                      contract KernelNamespaceConstants {
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant KERNEL_CORE_NAMESPACE = keccak256("core");
                                          bytes32 internal constant KERNEL_APP_BASES_NAMESPACE = keccak256("base");
                                          bytes32 internal constant KERNEL_APP_ADDR_NAMESPACE = keccak256("app");
                                          */
                                          bytes32 internal constant KERNEL_CORE_NAMESPACE = 0xc681a85306374a5ab27f0bbc385296a54bcd314a1948b6cf61c4ea1bc44bb9f8;
                                          bytes32 internal constant KERNEL_APP_BASES_NAMESPACE = 0xf1f3eb40f5bc1ad1344716ced8b8a0431d840b5783aea1fd01786bc26f35ac0f;
                                          bytes32 internal constant KERNEL_APP_ADDR_NAMESPACE = 0xd6f028ca0e8edb4a8c9757ca4fdccab25fa1e0317da1188108f7d2dee14902fb;
                                      }
                                      
                                      // File: contracts/apps/AppProxyBase.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      
                                      
                                      contract AppProxyBase is AppStorage, DepositableDelegateProxy, KernelNamespaceConstants {
                                          /**
                                          * @dev Initialize AppProxy
                                          * @param _kernel Reference to organization kernel for the app
                                          * @param _appId Identifier for app
                                          * @param _initializePayload Payload for call to be made after setup to initialize
                                          */
                                          constructor(IKernel _kernel, bytes32 _appId, bytes _initializePayload) public {
                                              setKernel(_kernel);
                                              setAppId(_appId);
                                      
                                              // Implicit check that kernel is actually a Kernel
                                              // The EVM doesn't actually provide a way for us to make sure, but we can force a revert to
                                              // occur if the kernel is set to 0x0 or a non-code address when we try to call a method on
                                              // it.
                                              address appCode = getAppBase(_appId);
                                      
                                              // If initialize payload is provided, it will be executed
                                              if (_initializePayload.length > 0) {
                                                  require(isContract(appCode));
                                                  // Cannot make delegatecall as a delegateproxy.delegatedFwd as it
                                                  // returns ending execution context and halts contract deployment
                                                  require(appCode.delegatecall(_initializePayload));
                                              }
                                          }
                                      
                                          function getAppBase(bytes32 _appId) internal view returns (address) {
                                              return kernel().getApp(KERNEL_APP_BASES_NAMESPACE, _appId);
                                          }
                                      }
                                      
                                      // File: contracts/apps/AppProxyUpgradeable.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      contract AppProxyUpgradeable is AppProxyBase {
                                          /**
                                          * @dev Initialize AppProxyUpgradeable (makes it an upgradeable Aragon app)
                                          * @param _kernel Reference to organization kernel for the app
                                          * @param _appId Identifier for app
                                          * @param _initializePayload Payload for call to be made after setup to initialize
                                          */
                                          constructor(IKernel _kernel, bytes32 _appId, bytes _initializePayload)
                                              AppProxyBase(_kernel, _appId, _initializePayload)
                                              public // solium-disable-line visibility-first
                                          {
                                              // solium-disable-previous-line no-empty-blocks
                                          }
                                      
                                          /**
                                           * @dev ERC897, the address the proxy would delegate calls to
                                           */
                                          function implementation() public view returns (address) {
                                              return getAppBase(appId());
                                          }
                                      
                                          /**
                                           * @dev ERC897, whether it is a forwarding (1) or an upgradeable (2) proxy
                                           */
                                          function proxyType() public pure returns (uint256 proxyTypeId) {
                                              return UPGRADEABLE;
                                          }
                                      }

                                      File 12 of 14: KernelProxy
                                      // File: contracts/acl/IACL.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      interface IACL {
                                          function initialize(address permissionsCreator) external;
                                      
                                          // TODO: this should be external
                                          // See https://github.com/ethereum/solidity/issues/4832
                                          function hasPermission(address who, address where, bytes32 what, bytes how) public view returns (bool);
                                      }
                                      
                                      // File: contracts/common/IVaultRecoverable.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      interface IVaultRecoverable {
                                          event RecoverToVault(address indexed vault, address indexed token, uint256 amount);
                                      
                                          function transferToVault(address token) external;
                                      
                                          function allowRecoverability(address token) external view returns (bool);
                                          function getRecoveryVault() external view returns (address);
                                      }
                                      
                                      // File: contracts/kernel/IKernel.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      interface IKernelEvents {
                                          event SetApp(bytes32 indexed namespace, bytes32 indexed appId, address app);
                                      }
                                      
                                      
                                      // This should be an interface, but interfaces can't inherit yet :(
                                      contract IKernel is IKernelEvents, IVaultRecoverable {
                                          function acl() public view returns (IACL);
                                          function hasPermission(address who, address where, bytes32 what, bytes how) public view returns (bool);
                                      
                                          function setApp(bytes32 namespace, bytes32 appId, address app) public;
                                          function getApp(bytes32 namespace, bytes32 appId) public view returns (address);
                                      }
                                      
                                      // File: contracts/kernel/KernelConstants.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract KernelAppIds {
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant KERNEL_CORE_APP_ID = apmNamehash("kernel");
                                          bytes32 internal constant KERNEL_DEFAULT_ACL_APP_ID = apmNamehash("acl");
                                          bytes32 internal constant KERNEL_DEFAULT_VAULT_APP_ID = apmNamehash("vault");
                                          */
                                          bytes32 internal constant KERNEL_CORE_APP_ID = 0x3b4bf6bf3ad5000ecf0f989d5befde585c6860fea3e574a4fab4c49d1c177d9c;
                                          bytes32 internal constant KERNEL_DEFAULT_ACL_APP_ID = 0xe3262375f45a6e2026b7e7b18c2b807434f2508fe1a2a3dfb493c7df8f4aad6a;
                                          bytes32 internal constant KERNEL_DEFAULT_VAULT_APP_ID = 0x7e852e0fcfce6551c13800f1e7476f982525c2b5277ba14b24339c68416336d1;
                                      }
                                      
                                      
                                      contract KernelNamespaceConstants {
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant KERNEL_CORE_NAMESPACE = keccak256("core");
                                          bytes32 internal constant KERNEL_APP_BASES_NAMESPACE = keccak256("base");
                                          bytes32 internal constant KERNEL_APP_ADDR_NAMESPACE = keccak256("app");
                                          */
                                          bytes32 internal constant KERNEL_CORE_NAMESPACE = 0xc681a85306374a5ab27f0bbc385296a54bcd314a1948b6cf61c4ea1bc44bb9f8;
                                          bytes32 internal constant KERNEL_APP_BASES_NAMESPACE = 0xf1f3eb40f5bc1ad1344716ced8b8a0431d840b5783aea1fd01786bc26f35ac0f;
                                          bytes32 internal constant KERNEL_APP_ADDR_NAMESPACE = 0xd6f028ca0e8edb4a8c9757ca4fdccab25fa1e0317da1188108f7d2dee14902fb;
                                      }
                                      
                                      // File: contracts/kernel/KernelStorage.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      contract KernelStorage {
                                          // namespace => app id => address
                                          mapping (bytes32 => mapping (bytes32 => address)) public apps;
                                          bytes32 public recoveryVaultAppId;
                                      }
                                      
                                      // File: contracts/common/IsContract.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract IsContract {
                                          /*
                                          * NOTE: this should NEVER be used for authentication
                                          * (see pitfalls: https://github.com/fergarrui/ethereum-security/tree/master/contracts/extcodesize).
                                          *
                                          * This is only intended to be used as a sanity check that an address is actually a contract,
                                          * RATHER THAN an address not being a contract.
                                          */
                                          function isContract(address _target) internal view returns (bool) {
                                              if (_target == address(0)) {
                                                  return false;
                                              }
                                      
                                              uint256 size;
                                              assembly { size := extcodesize(_target) }
                                              return size > 0;
                                          }
                                      }
                                      
                                      // File: contracts/lib/misc/ERCProxy.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract ERCProxy {
                                          uint256 internal constant FORWARDING = 1;
                                          uint256 internal constant UPGRADEABLE = 2;
                                      
                                          function proxyType() public pure returns (uint256 proxyTypeId);
                                          function implementation() public view returns (address codeAddr);
                                      }
                                      
                                      // File: contracts/common/DelegateProxy.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      contract DelegateProxy is ERCProxy, IsContract {
                                          uint256 internal constant FWD_GAS_LIMIT = 10000;
                                      
                                          /**
                                          * @dev Performs a delegatecall and returns whatever the delegatecall returned (entire context execution will return!)
                                          * @param _dst Destination address to perform the delegatecall
                                          * @param _calldata Calldata for the delegatecall
                                          */
                                          function delegatedFwd(address _dst, bytes _calldata) internal {
                                              require(isContract(_dst));
                                              uint256 fwdGasLimit = FWD_GAS_LIMIT;
                                      
                                              assembly {
                                                  let result := delegatecall(sub(gas, fwdGasLimit), _dst, add(_calldata, 0x20), mload(_calldata), 0, 0)
                                                  let size := returndatasize
                                                  let ptr := mload(0x40)
                                                  returndatacopy(ptr, 0, size)
                                      
                                                  // revert instead of invalid() bc if the underlying call failed with invalid() it already wasted gas.
                                                  // if the call returned error data, forward it
                                                  switch result case 0 { revert(ptr, size) }
                                                  default { return(ptr, size) }
                                              }
                                          }
                                      }
                                      
                                      // File: contracts/common/UnstructuredStorage.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      library UnstructuredStorage {
                                          function getStorageBool(bytes32 position) internal view returns (bool data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageAddress(bytes32 position) internal view returns (address data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageBytes32(bytes32 position) internal view returns (bytes32 data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageUint256(bytes32 position) internal view returns (uint256 data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function setStorageBool(bytes32 position, bool data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageAddress(bytes32 position, address data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageBytes32(bytes32 position, bytes32 data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageUint256(bytes32 position, uint256 data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      }
                                      
                                      // File: contracts/common/DepositableStorage.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      contract DepositableStorage {
                                          using UnstructuredStorage for bytes32;
                                      
                                          // keccak256("aragonOS.depositableStorage.depositable")
                                          bytes32 internal constant DEPOSITABLE_POSITION = 0x665fd576fbbe6f247aff98f5c94a561e3f71ec2d3c988d56f12d342396c50cea;
                                      
                                          function isDepositable() public view returns (bool) {
                                              return DEPOSITABLE_POSITION.getStorageBool();
                                          }
                                      
                                          function setDepositable(bool _depositable) internal {
                                              DEPOSITABLE_POSITION.setStorageBool(_depositable);
                                          }
                                      }
                                      
                                      // File: contracts/common/DepositableDelegateProxy.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      contract DepositableDelegateProxy is DepositableStorage, DelegateProxy {
                                          event ProxyDeposit(address sender, uint256 value);
                                      
                                          function () external payable {
                                              uint256 forwardGasThreshold = FWD_GAS_LIMIT;
                                              bytes32 isDepositablePosition = DEPOSITABLE_POSITION;
                                      
                                              // Optimized assembly implementation to prevent EIP-1884 from breaking deposits, reference code in Solidity:
                                              // https://github.com/aragon/aragonOS/blob/v4.2.1/contracts/common/DepositableDelegateProxy.sol#L10-L20
                                              assembly {
                                                  // Continue only if the gas left is lower than the threshold for forwarding to the implementation code,
                                                  // otherwise continue outside of the assembly block.
                                                  if lt(gas, forwardGasThreshold) {
                                                      // Only accept the deposit and emit an event if all of the following are true:
                                                      // the proxy accepts deposits (isDepositable), msg.data.length == 0, and msg.value > 0
                                                      if and(and(sload(isDepositablePosition), iszero(calldatasize)), gt(callvalue, 0)) {
                                                          // Equivalent Solidity code for emitting the event:
                                                          // emit ProxyDeposit(msg.sender, msg.value);
                                      
                                                          let logData := mload(0x40) // free memory pointer
                                                          mstore(logData, caller) // add 'msg.sender' to the log data (first event param)
                                                          mstore(add(logData, 0x20), callvalue) // add 'msg.value' to the log data (second event param)
                                      
                                                          // Emit an event with one topic to identify the event: keccak256('ProxyDeposit(address,uint256)') = 0x15ee...dee1
                                                          log1(logData, 0x40, 0x15eeaa57c7bd188c1388020bcadc2c436ec60d647d36ef5b9eb3c742217ddee1)
                                      
                                                          stop() // Stop. Exits execution context
                                                      }
                                      
                                                      // If any of above checks failed, revert the execution (if ETH was sent, it is returned to the sender)
                                                      revert(0, 0)
                                                  }
                                              }
                                      
                                              address target = implementation();
                                              delegatedFwd(target, msg.data);
                                          }
                                      }
                                      
                                      // File: contracts/kernel/KernelProxy.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      contract KernelProxy is IKernelEvents, KernelStorage, KernelAppIds, KernelNamespaceConstants, IsContract, DepositableDelegateProxy {
                                          /**
                                          * @dev KernelProxy is a proxy contract to a kernel implementation. The implementation
                                          *      can update the reference, which effectively upgrades the contract
                                          * @param _kernelImpl Address of the contract used as implementation for kernel
                                          */
                                          constructor(IKernel _kernelImpl) public {
                                              require(isContract(address(_kernelImpl)));
                                              apps[KERNEL_CORE_NAMESPACE][KERNEL_CORE_APP_ID] = _kernelImpl;
                                      
                                              // Note that emitting this event is important for verifying that a KernelProxy instance
                                              // was never upgraded to a malicious Kernel logic contract over its lifespan.
                                              // This starts the "chain of trust", that can be followed through later SetApp() events
                                              // emitted during kernel upgrades.
                                              emit SetApp(KERNEL_CORE_NAMESPACE, KERNEL_CORE_APP_ID, _kernelImpl);
                                          }
                                      
                                          /**
                                           * @dev ERC897, whether it is a forwarding (1) or an upgradeable (2) proxy
                                           */
                                          function proxyType() public pure returns (uint256 proxyTypeId) {
                                              return UPGRADEABLE;
                                          }
                                      
                                          /**
                                          * @dev ERC897, the address the proxy would delegate calls to
                                          */
                                          function implementation() public view returns (address) {
                                              return apps[KERNEL_CORE_NAMESPACE][KERNEL_CORE_APP_ID];
                                          }
                                      }

                                      File 13 of 14: Kernel
                                      // File: contracts/acl/IACL.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      interface IACL {
                                          function initialize(address permissionsCreator) external;
                                      
                                          // TODO: this should be external
                                          // See https://github.com/ethereum/solidity/issues/4832
                                          function hasPermission(address who, address where, bytes32 what, bytes how) public view returns (bool);
                                      }
                                      
                                      // File: contracts/common/IVaultRecoverable.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      interface IVaultRecoverable {
                                          event RecoverToVault(address indexed vault, address indexed token, uint256 amount);
                                      
                                          function transferToVault(address token) external;
                                      
                                          function allowRecoverability(address token) external view returns (bool);
                                          function getRecoveryVault() external view returns (address);
                                      }
                                      
                                      // File: contracts/kernel/IKernel.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      interface IKernelEvents {
                                          event SetApp(bytes32 indexed namespace, bytes32 indexed appId, address app);
                                      }
                                      
                                      
                                      // This should be an interface, but interfaces can't inherit yet :(
                                      contract IKernel is IKernelEvents, IVaultRecoverable {
                                          function acl() public view returns (IACL);
                                          function hasPermission(address who, address where, bytes32 what, bytes how) public view returns (bool);
                                      
                                          function setApp(bytes32 namespace, bytes32 appId, address app) public;
                                          function getApp(bytes32 namespace, bytes32 appId) public view returns (address);
                                      }
                                      
                                      // File: contracts/kernel/KernelConstants.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract KernelAppIds {
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant KERNEL_CORE_APP_ID = apmNamehash("kernel");
                                          bytes32 internal constant KERNEL_DEFAULT_ACL_APP_ID = apmNamehash("acl");
                                          bytes32 internal constant KERNEL_DEFAULT_VAULT_APP_ID = apmNamehash("vault");
                                          */
                                          bytes32 internal constant KERNEL_CORE_APP_ID = 0x3b4bf6bf3ad5000ecf0f989d5befde585c6860fea3e574a4fab4c49d1c177d9c;
                                          bytes32 internal constant KERNEL_DEFAULT_ACL_APP_ID = 0xe3262375f45a6e2026b7e7b18c2b807434f2508fe1a2a3dfb493c7df8f4aad6a;
                                          bytes32 internal constant KERNEL_DEFAULT_VAULT_APP_ID = 0x7e852e0fcfce6551c13800f1e7476f982525c2b5277ba14b24339c68416336d1;
                                      }
                                      
                                      
                                      contract KernelNamespaceConstants {
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant KERNEL_CORE_NAMESPACE = keccak256("core");
                                          bytes32 internal constant KERNEL_APP_BASES_NAMESPACE = keccak256("base");
                                          bytes32 internal constant KERNEL_APP_ADDR_NAMESPACE = keccak256("app");
                                          */
                                          bytes32 internal constant KERNEL_CORE_NAMESPACE = 0xc681a85306374a5ab27f0bbc385296a54bcd314a1948b6cf61c4ea1bc44bb9f8;
                                          bytes32 internal constant KERNEL_APP_BASES_NAMESPACE = 0xf1f3eb40f5bc1ad1344716ced8b8a0431d840b5783aea1fd01786bc26f35ac0f;
                                          bytes32 internal constant KERNEL_APP_ADDR_NAMESPACE = 0xd6f028ca0e8edb4a8c9757ca4fdccab25fa1e0317da1188108f7d2dee14902fb;
                                      }
                                      
                                      // File: contracts/kernel/KernelStorage.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      contract KernelStorage {
                                          // namespace => app id => address
                                          mapping (bytes32 => mapping (bytes32 => address)) public apps;
                                          bytes32 public recoveryVaultAppId;
                                      }
                                      
                                      // File: contracts/acl/ACLSyntaxSugar.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract ACLSyntaxSugar {
                                          function arr() internal pure returns (uint256[]) {
                                              return new uint256[](0);
                                          }
                                      
                                          function arr(bytes32 _a) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a));
                                          }
                                      
                                          function arr(bytes32 _a, bytes32 _b) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b));
                                          }
                                      
                                          function arr(address _a) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a));
                                          }
                                      
                                          function arr(address _a, address _b) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b));
                                          }
                                      
                                          function arr(address _a, uint256 _b, uint256 _c) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), _b, _c);
                                          }
                                      
                                          function arr(address _a, uint256 _b, uint256 _c, uint256 _d) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), _b, _c, _d);
                                          }
                                      
                                          function arr(address _a, uint256 _b) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b));
                                          }
                                      
                                          function arr(address _a, address _b, uint256 _c, uint256 _d, uint256 _e) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b), _c, _d, _e);
                                          }
                                      
                                          function arr(address _a, address _b, address _c) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b), uint256(_c));
                                          }
                                      
                                          function arr(address _a, address _b, uint256 _c) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b), uint256(_c));
                                          }
                                      
                                          function arr(uint256 _a) internal pure returns (uint256[] r) {
                                              r = new uint256[](1);
                                              r[0] = _a;
                                          }
                                      
                                          function arr(uint256 _a, uint256 _b) internal pure returns (uint256[] r) {
                                              r = new uint256[](2);
                                              r[0] = _a;
                                              r[1] = _b;
                                          }
                                      
                                          function arr(uint256 _a, uint256 _b, uint256 _c) internal pure returns (uint256[] r) {
                                              r = new uint256[](3);
                                              r[0] = _a;
                                              r[1] = _b;
                                              r[2] = _c;
                                          }
                                      
                                          function arr(uint256 _a, uint256 _b, uint256 _c, uint256 _d) internal pure returns (uint256[] r) {
                                              r = new uint256[](4);
                                              r[0] = _a;
                                              r[1] = _b;
                                              r[2] = _c;
                                              r[3] = _d;
                                          }
                                      
                                          function arr(uint256 _a, uint256 _b, uint256 _c, uint256 _d, uint256 _e) internal pure returns (uint256[] r) {
                                              r = new uint256[](5);
                                              r[0] = _a;
                                              r[1] = _b;
                                              r[2] = _c;
                                              r[3] = _d;
                                              r[4] = _e;
                                          }
                                      }
                                      
                                      
                                      contract ACLHelpers {
                                          function decodeParamOp(uint256 _x) internal pure returns (uint8 b) {
                                              return uint8(_x >> (8 * 30));
                                          }
                                      
                                          function decodeParamId(uint256 _x) internal pure returns (uint8 b) {
                                              return uint8(_x >> (8 * 31));
                                          }
                                      
                                          function decodeParamsList(uint256 _x) internal pure returns (uint32 a, uint32 b, uint32 c) {
                                              a = uint32(_x);
                                              b = uint32(_x >> (8 * 4));
                                              c = uint32(_x >> (8 * 8));
                                          }
                                      }
                                      
                                      // File: contracts/common/ConversionHelpers.sol
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      library ConversionHelpers {
                                          string private constant ERROR_IMPROPER_LENGTH = "CONVERSION_IMPROPER_LENGTH";
                                      
                                          function dangerouslyCastUintArrayToBytes(uint256[] memory _input) internal pure returns (bytes memory output) {
                                              // Force cast the uint256[] into a bytes array, by overwriting its length
                                              // Note that the bytes array doesn't need to be initialized as we immediately overwrite it
                                              // with the input and a new length. The input becomes invalid from this point forward.
                                              uint256 byteLength = _input.length * 32;
                                              assembly {
                                                  output := _input
                                                  mstore(output, byteLength)
                                              }
                                          }
                                      
                                          function dangerouslyCastBytesToUintArray(bytes memory _input) internal pure returns (uint256[] memory output) {
                                              // Force cast the bytes array into a uint256[], by overwriting its length
                                              // Note that the uint256[] doesn't need to be initialized as we immediately overwrite it
                                              // with the input and a new length. The input becomes invalid from this point forward.
                                              uint256 intsLength = _input.length / 32;
                                              require(_input.length == intsLength * 32, ERROR_IMPROPER_LENGTH);
                                      
                                              assembly {
                                                  output := _input
                                                  mstore(output, intsLength)
                                              }
                                          }
                                      }
                                      
                                      // File: contracts/common/IsContract.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract IsContract {
                                          /*
                                          * NOTE: this should NEVER be used for authentication
                                          * (see pitfalls: https://github.com/fergarrui/ethereum-security/tree/master/contracts/extcodesize).
                                          *
                                          * This is only intended to be used as a sanity check that an address is actually a contract,
                                          * RATHER THAN an address not being a contract.
                                          */
                                          function isContract(address _target) internal view returns (bool) {
                                              if (_target == address(0)) {
                                                  return false;
                                              }
                                      
                                              uint256 size;
                                              assembly { size := extcodesize(_target) }
                                              return size > 0;
                                          }
                                      }
                                      
                                      // File: contracts/common/Uint256Helpers.sol
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      library Uint256Helpers {
                                          uint256 private constant MAX_UINT64 = uint64(-1);
                                      
                                          string private constant ERROR_NUMBER_TOO_BIG = "UINT64_NUMBER_TOO_BIG";
                                      
                                          function toUint64(uint256 a) internal pure returns (uint64) {
                                              require(a <= MAX_UINT64, ERROR_NUMBER_TOO_BIG);
                                              return uint64(a);
                                          }
                                      }
                                      
                                      // File: contracts/common/TimeHelpers.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      contract TimeHelpers {
                                          using Uint256Helpers for uint256;
                                      
                                          /**
                                          * @dev Returns the current block number.
                                          *      Using a function rather than `block.number` allows us to easily mock the block number in
                                          *      tests.
                                          */
                                          function getBlockNumber() internal view returns (uint256) {
                                              return block.number;
                                          }
                                      
                                          /**
                                          * @dev Returns the current block number, converted to uint64.
                                          *      Using a function rather than `block.number` allows us to easily mock the block number in
                                          *      tests.
                                          */
                                          function getBlockNumber64() internal view returns (uint64) {
                                              return getBlockNumber().toUint64();
                                          }
                                      
                                          /**
                                          * @dev Returns the current timestamp.
                                          *      Using a function rather than `block.timestamp` allows us to easily mock it in
                                          *      tests.
                                          */
                                          function getTimestamp() internal view returns (uint256) {
                                              return block.timestamp; // solium-disable-line security/no-block-members
                                          }
                                      
                                          /**
                                          * @dev Returns the current timestamp, converted to uint64.
                                          *      Using a function rather than `block.timestamp` allows us to easily mock it in
                                          *      tests.
                                          */
                                          function getTimestamp64() internal view returns (uint64) {
                                              return getTimestamp().toUint64();
                                          }
                                      }
                                      
                                      // File: contracts/common/UnstructuredStorage.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      library UnstructuredStorage {
                                          function getStorageBool(bytes32 position) internal view returns (bool data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageAddress(bytes32 position) internal view returns (address data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageBytes32(bytes32 position) internal view returns (bytes32 data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageUint256(bytes32 position) internal view returns (uint256 data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function setStorageBool(bytes32 position, bool data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageAddress(bytes32 position, address data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageBytes32(bytes32 position, bytes32 data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageUint256(bytes32 position, uint256 data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      }
                                      
                                      // File: contracts/common/Initializable.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      contract Initializable is TimeHelpers {
                                          using UnstructuredStorage for bytes32;
                                      
                                          // keccak256("aragonOS.initializable.initializationBlock")
                                          bytes32 internal constant INITIALIZATION_BLOCK_POSITION = 0xebb05b386a8d34882b8711d156f463690983dc47815980fb82aeeff1aa43579e;
                                      
                                          string private constant ERROR_ALREADY_INITIALIZED = "INIT_ALREADY_INITIALIZED";
                                          string private constant ERROR_NOT_INITIALIZED = "INIT_NOT_INITIALIZED";
                                      
                                          modifier onlyInit {
                                              require(getInitializationBlock() == 0, ERROR_ALREADY_INITIALIZED);
                                              _;
                                          }
                                      
                                          modifier isInitialized {
                                              require(hasInitialized(), ERROR_NOT_INITIALIZED);
                                              _;
                                          }
                                      
                                          /**
                                          * @return Block number in which the contract was initialized
                                          */
                                          function getInitializationBlock() public view returns (uint256) {
                                              return INITIALIZATION_BLOCK_POSITION.getStorageUint256();
                                          }
                                      
                                          /**
                                          * @return Whether the contract has been initialized by the time of the current block
                                          */
                                          function hasInitialized() public view returns (bool) {
                                              uint256 initializationBlock = getInitializationBlock();
                                              return initializationBlock != 0 && getBlockNumber() >= initializationBlock;
                                          }
                                      
                                          /**
                                          * @dev Function to be called by top level contract after initialization has finished.
                                          */
                                          function initialized() internal onlyInit {
                                              INITIALIZATION_BLOCK_POSITION.setStorageUint256(getBlockNumber());
                                          }
                                      
                                          /**
                                          * @dev Function to be called by top level contract after initialization to enable the contract
                                          *      at a future block number rather than immediately.
                                          */
                                          function initializedAt(uint256 _blockNumber) internal onlyInit {
                                              INITIALIZATION_BLOCK_POSITION.setStorageUint256(_blockNumber);
                                          }
                                      }
                                      
                                      // File: contracts/common/Petrifiable.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      contract Petrifiable is Initializable {
                                          // Use block UINT256_MAX (which should be never) as the initializable date
                                          uint256 internal constant PETRIFIED_BLOCK = uint256(-1);
                                      
                                          function isPetrified() public view returns (bool) {
                                              return getInitializationBlock() == PETRIFIED_BLOCK;
                                          }
                                      
                                          /**
                                          * @dev Function to be called by top level contract to prevent being initialized.
                                          *      Useful for freezing base contracts when they're used behind proxies.
                                          */
                                          function petrify() internal onlyInit {
                                              initializedAt(PETRIFIED_BLOCK);
                                          }
                                      }
                                      
                                      // File: contracts/lib/token/ERC20.sol
                                      
                                      // See https://github.com/OpenZeppelin/openzeppelin-solidity/blob/a9f910d34f0ab33a1ae5e714f69f9596a02b4d91/contracts/token/ERC20/ERC20.sol
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      /**
                                       * @title ERC20 interface
                                       * @dev see https://github.com/ethereum/EIPs/issues/20
                                       */
                                      contract ERC20 {
                                          function totalSupply() public view returns (uint256);
                                      
                                          function balanceOf(address _who) public view returns (uint256);
                                      
                                          function allowance(address _owner, address _spender)
                                              public view returns (uint256);
                                      
                                          function transfer(address _to, uint256 _value) public returns (bool);
                                      
                                          function approve(address _spender, uint256 _value)
                                              public returns (bool);
                                      
                                          function transferFrom(address _from, address _to, uint256 _value)
                                              public returns (bool);
                                      
                                          event Transfer(
                                              address indexed from,
                                              address indexed to,
                                              uint256 value
                                          );
                                      
                                          event Approval(
                                              address indexed owner,
                                              address indexed spender,
                                              uint256 value
                                          );
                                      }
                                      
                                      // File: contracts/common/EtherTokenConstant.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      // aragonOS and aragon-apps rely on address(0) to denote native ETH, in
                                      // contracts where both tokens and ETH are accepted
                                      contract EtherTokenConstant {
                                          address internal constant ETH = address(0);
                                      }
                                      
                                      // File: contracts/common/SafeERC20.sol
                                      
                                      // Inspired by AdEx (https://github.com/AdExNetwork/adex-protocol-eth/blob/b9df617829661a7518ee10f4cb6c4108659dd6d5/contracts/libs/SafeERC20.sol)
                                      // and 0x (https://github.com/0xProject/0x-monorepo/blob/737d1dc54d72872e24abce5a1dbe1b66d35fa21a/contracts/protocol/contracts/protocol/AssetProxy/ERC20Proxy.sol#L143)
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      library SafeERC20 {
                                          // Before 0.5, solidity has a mismatch between `address.transfer()` and `token.transfer()`:
                                          // https://github.com/ethereum/solidity/issues/3544
                                          bytes4 private constant TRANSFER_SELECTOR = 0xa9059cbb;
                                      
                                          string private constant ERROR_TOKEN_BALANCE_REVERTED = "SAFE_ERC_20_BALANCE_REVERTED";
                                          string private constant ERROR_TOKEN_ALLOWANCE_REVERTED = "SAFE_ERC_20_ALLOWANCE_REVERTED";
                                      
                                          function invokeAndCheckSuccess(address _addr, bytes memory _calldata)
                                              private
                                              returns (bool)
                                          {
                                              bool ret;
                                              assembly {
                                                  let ptr := mload(0x40)    // free memory pointer
                                      
                                                  let success := call(
                                                      gas,                  // forward all gas
                                                      _addr,                // address
                                                      0,                    // no value
                                                      add(_calldata, 0x20), // calldata start
                                                      mload(_calldata),     // calldata length
                                                      ptr,                  // write output over free memory
                                                      0x20                  // uint256 return
                                                  )
                                      
                                                  if gt(success, 0) {
                                                      // Check number of bytes returned from last function call
                                                      switch returndatasize
                                      
                                                      // No bytes returned: assume success
                                                      case 0 {
                                                          ret := 1
                                                      }
                                      
                                                      // 32 bytes returned: check if non-zero
                                                      case 0x20 {
                                                          // Only return success if returned data was true
                                                          // Already have output in ptr
                                                          ret := eq(mload(ptr), 1)
                                                      }
                                      
                                                      // Not sure what was returned: don't mark as success
                                                      default { }
                                                  }
                                              }
                                              return ret;
                                          }
                                      
                                          function staticInvoke(address _addr, bytes memory _calldata)
                                              private
                                              view
                                              returns (bool, uint256)
                                          {
                                              bool success;
                                              uint256 ret;
                                              assembly {
                                                  let ptr := mload(0x40)    // free memory pointer
                                      
                                                  success := staticcall(
                                                      gas,                  // forward all gas
                                                      _addr,                // address
                                                      add(_calldata, 0x20), // calldata start
                                                      mload(_calldata),     // calldata length
                                                      ptr,                  // write output over free memory
                                                      0x20                  // uint256 return
                                                  )
                                      
                                                  if gt(success, 0) {
                                                      ret := mload(ptr)
                                                  }
                                              }
                                              return (success, ret);
                                          }
                                      
                                          /**
                                          * @dev Same as a standards-compliant ERC20.transfer() that never reverts (returns false).
                                          *      Note that this makes an external call to the token.
                                          */
                                          function safeTransfer(ERC20 _token, address _to, uint256 _amount) internal returns (bool) {
                                              bytes memory transferCallData = abi.encodeWithSelector(
                                                  TRANSFER_SELECTOR,
                                                  _to,
                                                  _amount
                                              );
                                              return invokeAndCheckSuccess(_token, transferCallData);
                                          }
                                      
                                          /**
                                          * @dev Same as a standards-compliant ERC20.transferFrom() that never reverts (returns false).
                                          *      Note that this makes an external call to the token.
                                          */
                                          function safeTransferFrom(ERC20 _token, address _from, address _to, uint256 _amount) internal returns (bool) {
                                              bytes memory transferFromCallData = abi.encodeWithSelector(
                                                  _token.transferFrom.selector,
                                                  _from,
                                                  _to,
                                                  _amount
                                              );
                                              return invokeAndCheckSuccess(_token, transferFromCallData);
                                          }
                                      
                                          /**
                                          * @dev Same as a standards-compliant ERC20.approve() that never reverts (returns false).
                                          *      Note that this makes an external call to the token.
                                          */
                                          function safeApprove(ERC20 _token, address _spender, uint256 _amount) internal returns (bool) {
                                              bytes memory approveCallData = abi.encodeWithSelector(
                                                  _token.approve.selector,
                                                  _spender,
                                                  _amount
                                              );
                                              return invokeAndCheckSuccess(_token, approveCallData);
                                          }
                                      
                                          /**
                                          * @dev Static call into ERC20.balanceOf().
                                          * Reverts if the call fails for some reason (should never fail).
                                          */
                                          function staticBalanceOf(ERC20 _token, address _owner) internal view returns (uint256) {
                                              bytes memory balanceOfCallData = abi.encodeWithSelector(
                                                  _token.balanceOf.selector,
                                                  _owner
                                              );
                                      
                                              (bool success, uint256 tokenBalance) = staticInvoke(_token, balanceOfCallData);
                                              require(success, ERROR_TOKEN_BALANCE_REVERTED);
                                      
                                              return tokenBalance;
                                          }
                                      
                                          /**
                                          * @dev Static call into ERC20.allowance().
                                          * Reverts if the call fails for some reason (should never fail).
                                          */
                                          function staticAllowance(ERC20 _token, address _owner, address _spender) internal view returns (uint256) {
                                              bytes memory allowanceCallData = abi.encodeWithSelector(
                                                  _token.allowance.selector,
                                                  _owner,
                                                  _spender
                                              );
                                      
                                              (bool success, uint256 allowance) = staticInvoke(_token, allowanceCallData);
                                              require(success, ERROR_TOKEN_ALLOWANCE_REVERTED);
                                      
                                              return allowance;
                                          }
                                      
                                          /**
                                          * @dev Static call into ERC20.totalSupply().
                                          * Reverts if the call fails for some reason (should never fail).
                                          */
                                          function staticTotalSupply(ERC20 _token) internal view returns (uint256) {
                                              bytes memory totalSupplyCallData = abi.encodeWithSelector(_token.totalSupply.selector);
                                      
                                              (bool success, uint256 totalSupply) = staticInvoke(_token, totalSupplyCallData);
                                              require(success, ERROR_TOKEN_ALLOWANCE_REVERTED);
                                      
                                              return totalSupply;
                                          }
                                      }
                                      
                                      // File: contracts/common/VaultRecoverable.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      contract VaultRecoverable is IVaultRecoverable, EtherTokenConstant, IsContract {
                                          using SafeERC20 for ERC20;
                                      
                                          string private constant ERROR_DISALLOWED = "RECOVER_DISALLOWED";
                                          string private constant ERROR_VAULT_NOT_CONTRACT = "RECOVER_VAULT_NOT_CONTRACT";
                                          string private constant ERROR_TOKEN_TRANSFER_FAILED = "RECOVER_TOKEN_TRANSFER_FAILED";
                                      
                                          /**
                                           * @notice Send funds to recovery Vault. This contract should never receive funds,
                                           *         but in case it does, this function allows one to recover them.
                                           * @param _token Token balance to be sent to recovery vault.
                                           */
                                          function transferToVault(address _token) external {
                                              require(allowRecoverability(_token), ERROR_DISALLOWED);
                                              address vault = getRecoveryVault();
                                              require(isContract(vault), ERROR_VAULT_NOT_CONTRACT);
                                      
                                              uint256 balance;
                                              if (_token == ETH) {
                                                  balance = address(this).balance;
                                                  vault.transfer(balance);
                                              } else {
                                                  ERC20 token = ERC20(_token);
                                                  balance = token.staticBalanceOf(this);
                                                  require(token.safeTransfer(vault, balance), ERROR_TOKEN_TRANSFER_FAILED);
                                              }
                                      
                                              emit RecoverToVault(vault, _token, balance);
                                          }
                                      
                                          /**
                                          * @dev By default deriving from AragonApp makes it recoverable
                                          * @param token Token address that would be recovered
                                          * @return bool whether the app allows the recovery
                                          */
                                          function allowRecoverability(address token) public view returns (bool) {
                                              return true;
                                          }
                                      
                                          // Cast non-implemented interface to be public so we can use it internally
                                          function getRecoveryVault() public view returns (address);
                                      }
                                      
                                      // File: contracts/apps/AppStorage.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      contract AppStorage {
                                          using UnstructuredStorage for bytes32;
                                      
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant KERNEL_POSITION = keccak256("aragonOS.appStorage.kernel");
                                          bytes32 internal constant APP_ID_POSITION = keccak256("aragonOS.appStorage.appId");
                                          */
                                          bytes32 internal constant KERNEL_POSITION = 0x4172f0f7d2289153072b0a6ca36959e0cbe2efc3afe50fc81636caa96338137b;
                                          bytes32 internal constant APP_ID_POSITION = 0xd625496217aa6a3453eecb9c3489dc5a53e6c67b444329ea2b2cbc9ff547639b;
                                      
                                          function kernel() public view returns (IKernel) {
                                              return IKernel(KERNEL_POSITION.getStorageAddress());
                                          }
                                      
                                          function appId() public view returns (bytes32) {
                                              return APP_ID_POSITION.getStorageBytes32();
                                          }
                                      
                                          function setKernel(IKernel _kernel) internal {
                                              KERNEL_POSITION.setStorageAddress(address(_kernel));
                                          }
                                      
                                          function setAppId(bytes32 _appId) internal {
                                              APP_ID_POSITION.setStorageBytes32(_appId);
                                          }
                                      }
                                      
                                      // File: contracts/lib/misc/ERCProxy.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract ERCProxy {
                                          uint256 internal constant FORWARDING = 1;
                                          uint256 internal constant UPGRADEABLE = 2;
                                      
                                          function proxyType() public pure returns (uint256 proxyTypeId);
                                          function implementation() public view returns (address codeAddr);
                                      }
                                      
                                      // File: contracts/common/DelegateProxy.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      contract DelegateProxy is ERCProxy, IsContract {
                                          uint256 internal constant FWD_GAS_LIMIT = 10000;
                                      
                                          /**
                                          * @dev Performs a delegatecall and returns whatever the delegatecall returned (entire context execution will return!)
                                          * @param _dst Destination address to perform the delegatecall
                                          * @param _calldata Calldata for the delegatecall
                                          */
                                          function delegatedFwd(address _dst, bytes _calldata) internal {
                                              require(isContract(_dst));
                                              uint256 fwdGasLimit = FWD_GAS_LIMIT;
                                      
                                              assembly {
                                                  let result := delegatecall(sub(gas, fwdGasLimit), _dst, add(_calldata, 0x20), mload(_calldata), 0, 0)
                                                  let size := returndatasize
                                                  let ptr := mload(0x40)
                                                  returndatacopy(ptr, 0, size)
                                      
                                                  // revert instead of invalid() bc if the underlying call failed with invalid() it already wasted gas.
                                                  // if the call returned error data, forward it
                                                  switch result case 0 { revert(ptr, size) }
                                                  default { return(ptr, size) }
                                              }
                                          }
                                      }
                                      
                                      // File: contracts/common/DepositableStorage.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      contract DepositableStorage {
                                          using UnstructuredStorage for bytes32;
                                      
                                          // keccak256("aragonOS.depositableStorage.depositable")
                                          bytes32 internal constant DEPOSITABLE_POSITION = 0x665fd576fbbe6f247aff98f5c94a561e3f71ec2d3c988d56f12d342396c50cea;
                                      
                                          function isDepositable() public view returns (bool) {
                                              return DEPOSITABLE_POSITION.getStorageBool();
                                          }
                                      
                                          function setDepositable(bool _depositable) internal {
                                              DEPOSITABLE_POSITION.setStorageBool(_depositable);
                                          }
                                      }
                                      
                                      // File: contracts/common/DepositableDelegateProxy.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      contract DepositableDelegateProxy is DepositableStorage, DelegateProxy {
                                          event ProxyDeposit(address sender, uint256 value);
                                      
                                          function () external payable {
                                              uint256 forwardGasThreshold = FWD_GAS_LIMIT;
                                              bytes32 isDepositablePosition = DEPOSITABLE_POSITION;
                                      
                                              // Optimized assembly implementation to prevent EIP-1884 from breaking deposits, reference code in Solidity:
                                              // https://github.com/aragon/aragonOS/blob/v4.2.1/contracts/common/DepositableDelegateProxy.sol#L10-L20
                                              assembly {
                                                  // Continue only if the gas left is lower than the threshold for forwarding to the implementation code,
                                                  // otherwise continue outside of the assembly block.
                                                  if lt(gas, forwardGasThreshold) {
                                                      // Only accept the deposit and emit an event if all of the following are true:
                                                      // the proxy accepts deposits (isDepositable), msg.data.length == 0, and msg.value > 0
                                                      if and(and(sload(isDepositablePosition), iszero(calldatasize)), gt(callvalue, 0)) {
                                                          // Equivalent Solidity code for emitting the event:
                                                          // emit ProxyDeposit(msg.sender, msg.value);
                                      
                                                          let logData := mload(0x40) // free memory pointer
                                                          mstore(logData, caller) // add 'msg.sender' to the log data (first event param)
                                                          mstore(add(logData, 0x20), callvalue) // add 'msg.value' to the log data (second event param)
                                      
                                                          // Emit an event with one topic to identify the event: keccak256('ProxyDeposit(address,uint256)') = 0x15ee...dee1
                                                          log1(logData, 0x40, 0x15eeaa57c7bd188c1388020bcadc2c436ec60d647d36ef5b9eb3c742217ddee1)
                                      
                                                          stop() // Stop. Exits execution context
                                                      }
                                      
                                                      // If any of above checks failed, revert the execution (if ETH was sent, it is returned to the sender)
                                                      revert(0, 0)
                                                  }
                                              }
                                      
                                              address target = implementation();
                                              delegatedFwd(target, msg.data);
                                          }
                                      }
                                      
                                      // File: contracts/apps/AppProxyBase.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      
                                      
                                      contract AppProxyBase is AppStorage, DepositableDelegateProxy, KernelNamespaceConstants {
                                          /**
                                          * @dev Initialize AppProxy
                                          * @param _kernel Reference to organization kernel for the app
                                          * @param _appId Identifier for app
                                          * @param _initializePayload Payload for call to be made after setup to initialize
                                          */
                                          constructor(IKernel _kernel, bytes32 _appId, bytes _initializePayload) public {
                                              setKernel(_kernel);
                                              setAppId(_appId);
                                      
                                              // Implicit check that kernel is actually a Kernel
                                              // The EVM doesn't actually provide a way for us to make sure, but we can force a revert to
                                              // occur if the kernel is set to 0x0 or a non-code address when we try to call a method on
                                              // it.
                                              address appCode = getAppBase(_appId);
                                      
                                              // If initialize payload is provided, it will be executed
                                              if (_initializePayload.length > 0) {
                                                  require(isContract(appCode));
                                                  // Cannot make delegatecall as a delegateproxy.delegatedFwd as it
                                                  // returns ending execution context and halts contract deployment
                                                  require(appCode.delegatecall(_initializePayload));
                                              }
                                          }
                                      
                                          function getAppBase(bytes32 _appId) internal view returns (address) {
                                              return kernel().getApp(KERNEL_APP_BASES_NAMESPACE, _appId);
                                          }
                                      }
                                      
                                      // File: contracts/apps/AppProxyUpgradeable.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      contract AppProxyUpgradeable is AppProxyBase {
                                          /**
                                          * @dev Initialize AppProxyUpgradeable (makes it an upgradeable Aragon app)
                                          * @param _kernel Reference to organization kernel for the app
                                          * @param _appId Identifier for app
                                          * @param _initializePayload Payload for call to be made after setup to initialize
                                          */
                                          constructor(IKernel _kernel, bytes32 _appId, bytes _initializePayload)
                                              AppProxyBase(_kernel, _appId, _initializePayload)
                                              public // solium-disable-line visibility-first
                                          {
                                              // solium-disable-previous-line no-empty-blocks
                                          }
                                      
                                          /**
                                           * @dev ERC897, the address the proxy would delegate calls to
                                           */
                                          function implementation() public view returns (address) {
                                              return getAppBase(appId());
                                          }
                                      
                                          /**
                                           * @dev ERC897, whether it is a forwarding (1) or an upgradeable (2) proxy
                                           */
                                          function proxyType() public pure returns (uint256 proxyTypeId) {
                                              return UPGRADEABLE;
                                          }
                                      }
                                      
                                      // File: contracts/apps/AppProxyPinned.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      
                                      contract AppProxyPinned is IsContract, AppProxyBase {
                                          using UnstructuredStorage for bytes32;
                                      
                                          // keccak256("aragonOS.appStorage.pinnedCode")
                                          bytes32 internal constant PINNED_CODE_POSITION = 0xdee64df20d65e53d7f51cb6ab6d921a0a6a638a91e942e1d8d02df28e31c038e;
                                      
                                          /**
                                          * @dev Initialize AppProxyPinned (makes it an un-upgradeable Aragon app)
                                          * @param _kernel Reference to organization kernel for the app
                                          * @param _appId Identifier for app
                                          * @param _initializePayload Payload for call to be made after setup to initialize
                                          */
                                          constructor(IKernel _kernel, bytes32 _appId, bytes _initializePayload)
                                              AppProxyBase(_kernel, _appId, _initializePayload)
                                              public // solium-disable-line visibility-first
                                          {
                                              setPinnedCode(getAppBase(_appId));
                                              require(isContract(pinnedCode()));
                                          }
                                      
                                          /**
                                           * @dev ERC897, the address the proxy would delegate calls to
                                           */
                                          function implementation() public view returns (address) {
                                              return pinnedCode();
                                          }
                                      
                                          /**
                                           * @dev ERC897, whether it is a forwarding (1) or an upgradeable (2) proxy
                                           */
                                          function proxyType() public pure returns (uint256 proxyTypeId) {
                                              return FORWARDING;
                                          }
                                      
                                          function setPinnedCode(address _pinnedCode) internal {
                                              PINNED_CODE_POSITION.setStorageAddress(_pinnedCode);
                                          }
                                      
                                          function pinnedCode() internal view returns (address) {
                                              return PINNED_CODE_POSITION.getStorageAddress();
                                          }
                                      }
                                      
                                      // File: contracts/factory/AppProxyFactory.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      contract AppProxyFactory {
                                          event NewAppProxy(address proxy, bool isUpgradeable, bytes32 appId);
                                      
                                          /**
                                          * @notice Create a new upgradeable app instance on `_kernel` with identifier `_appId`
                                          * @param _kernel App's Kernel reference
                                          * @param _appId Identifier for app
                                          * @return AppProxyUpgradeable
                                          */
                                          function newAppProxy(IKernel _kernel, bytes32 _appId) public returns (AppProxyUpgradeable) {
                                              return newAppProxy(_kernel, _appId, new bytes(0));
                                          }
                                      
                                          /**
                                          * @notice Create a new upgradeable app instance on `_kernel` with identifier `_appId` and initialization payload `_initializePayload`
                                          * @param _kernel App's Kernel reference
                                          * @param _appId Identifier for app
                                          * @return AppProxyUpgradeable
                                          */
                                          function newAppProxy(IKernel _kernel, bytes32 _appId, bytes _initializePayload) public returns (AppProxyUpgradeable) {
                                              AppProxyUpgradeable proxy = new AppProxyUpgradeable(_kernel, _appId, _initializePayload);
                                              emit NewAppProxy(address(proxy), true, _appId);
                                              return proxy;
                                          }
                                      
                                          /**
                                          * @notice Create a new pinned app instance on `_kernel` with identifier `_appId`
                                          * @param _kernel App's Kernel reference
                                          * @param _appId Identifier for app
                                          * @return AppProxyPinned
                                          */
                                          function newAppProxyPinned(IKernel _kernel, bytes32 _appId) public returns (AppProxyPinned) {
                                              return newAppProxyPinned(_kernel, _appId, new bytes(0));
                                          }
                                      
                                          /**
                                          * @notice Create a new pinned app instance on `_kernel` with identifier `_appId` and initialization payload `_initializePayload`
                                          * @param _kernel App's Kernel reference
                                          * @param _appId Identifier for app
                                          * @param _initializePayload Proxy initialization payload
                                          * @return AppProxyPinned
                                          */
                                          function newAppProxyPinned(IKernel _kernel, bytes32 _appId, bytes _initializePayload) public returns (AppProxyPinned) {
                                              AppProxyPinned proxy = new AppProxyPinned(_kernel, _appId, _initializePayload);
                                              emit NewAppProxy(address(proxy), false, _appId);
                                              return proxy;
                                          }
                                      }
                                      
                                      // File: contracts/kernel/Kernel.sol
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      // solium-disable-next-line max-len
                                      contract Kernel is IKernel, KernelStorage, KernelAppIds, KernelNamespaceConstants, Petrifiable, IsContract, VaultRecoverable, AppProxyFactory, ACLSyntaxSugar {
                                          /* Hardcoded constants to save gas
                                          bytes32 public constant APP_MANAGER_ROLE = keccak256("APP_MANAGER_ROLE");
                                          */
                                          bytes32 public constant APP_MANAGER_ROLE = 0xb6d92708f3d4817afc106147d969e229ced5c46e65e0a5002a0d391287762bd0;
                                      
                                          string private constant ERROR_APP_NOT_CONTRACT = "KERNEL_APP_NOT_CONTRACT";
                                          string private constant ERROR_INVALID_APP_CHANGE = "KERNEL_INVALID_APP_CHANGE";
                                          string private constant ERROR_AUTH_FAILED = "KERNEL_AUTH_FAILED";
                                      
                                          /**
                                          * @dev Constructor that allows the deployer to choose if the base instance should be petrified immediately.
                                          * @param _shouldPetrify Immediately petrify this instance so that it can never be initialized
                                          */
                                          constructor(bool _shouldPetrify) public {
                                              if (_shouldPetrify) {
                                                  petrify();
                                              }
                                          }
                                      
                                          /**
                                          * @dev Initialize can only be called once. It saves the block number in which it was initialized.
                                          * @notice Initialize this kernel instance along with its ACL and set `_permissionsCreator` as the entity that can create other permissions
                                          * @param _baseAcl Address of base ACL app
                                          * @param _permissionsCreator Entity that will be given permission over createPermission
                                          */
                                          function initialize(IACL _baseAcl, address _permissionsCreator) public onlyInit {
                                              initialized();
                                      
                                              // Set ACL base
                                              _setApp(KERNEL_APP_BASES_NAMESPACE, KERNEL_DEFAULT_ACL_APP_ID, _baseAcl);
                                      
                                              // Create ACL instance and attach it as the default ACL app
                                              IACL acl = IACL(newAppProxy(this, KERNEL_DEFAULT_ACL_APP_ID));
                                              acl.initialize(_permissionsCreator);
                                              _setApp(KERNEL_APP_ADDR_NAMESPACE, KERNEL_DEFAULT_ACL_APP_ID, acl);
                                      
                                              recoveryVaultAppId = KERNEL_DEFAULT_VAULT_APP_ID;
                                          }
                                      
                                          /**
                                          * @dev Create a new instance of an app linked to this kernel
                                          * @notice Create a new upgradeable instance of `_appId` app linked to the Kernel, setting its code to `_appBase`
                                          * @param _appId Identifier for app
                                          * @param _appBase Address of the app's base implementation
                                          * @return AppProxy instance
                                          */
                                          function newAppInstance(bytes32 _appId, address _appBase)
                                              public
                                              auth(APP_MANAGER_ROLE, arr(KERNEL_APP_BASES_NAMESPACE, _appId))
                                              returns (ERCProxy appProxy)
                                          {
                                              return newAppInstance(_appId, _appBase, new bytes(0), false);
                                          }
                                      
                                          /**
                                          * @dev Create a new instance of an app linked to this kernel and set its base
                                          *      implementation if it was not already set
                                          * @notice Create a new upgradeable instance of `_appId` app linked to the Kernel, setting its code to `_appBase`. `_setDefault ? 'Also sets it as the default app instance.':''`
                                          * @param _appId Identifier for app
                                          * @param _appBase Address of the app's base implementation
                                          * @param _initializePayload Payload for call made by the proxy during its construction to initialize
                                          * @param _setDefault Whether the app proxy app is the default one.
                                          *        Useful when the Kernel needs to know of an instance of a particular app,
                                          *        like Vault for escape hatch mechanism.
                                          * @return AppProxy instance
                                          */
                                          function newAppInstance(bytes32 _appId, address _appBase, bytes _initializePayload, bool _setDefault)
                                              public
                                              auth(APP_MANAGER_ROLE, arr(KERNEL_APP_BASES_NAMESPACE, _appId))
                                              returns (ERCProxy appProxy)
                                          {
                                              _setAppIfNew(KERNEL_APP_BASES_NAMESPACE, _appId, _appBase);
                                              appProxy = newAppProxy(this, _appId, _initializePayload);
                                              // By calling setApp directly and not the internal functions, we make sure the params are checked
                                              // and it will only succeed if sender has permissions to set something to the namespace.
                                              if (_setDefault) {
                                                  setApp(KERNEL_APP_ADDR_NAMESPACE, _appId, appProxy);
                                              }
                                          }
                                      
                                          /**
                                          * @dev Create a new pinned instance of an app linked to this kernel
                                          * @notice Create a new non-upgradeable instance of `_appId` app linked to the Kernel, setting its code to `_appBase`.
                                          * @param _appId Identifier for app
                                          * @param _appBase Address of the app's base implementation
                                          * @return AppProxy instance
                                          */
                                          function newPinnedAppInstance(bytes32 _appId, address _appBase)
                                              public
                                              auth(APP_MANAGER_ROLE, arr(KERNEL_APP_BASES_NAMESPACE, _appId))
                                              returns (ERCProxy appProxy)
                                          {
                                              return newPinnedAppInstance(_appId, _appBase, new bytes(0), false);
                                          }
                                      
                                          /**
                                          * @dev Create a new pinned instance of an app linked to this kernel and set
                                          *      its base implementation if it was not already set
                                          * @notice Create a new non-upgradeable instance of `_appId` app linked to the Kernel, setting its code to `_appBase`. `_setDefault ? 'Also sets it as the default app instance.':''`
                                          * @param _appId Identifier for app
                                          * @param _appBase Address of the app's base implementation
                                          * @param _initializePayload Payload for call made by the proxy during its construction to initialize
                                          * @param _setDefault Whether the app proxy app is the default one.
                                          *        Useful when the Kernel needs to know of an instance of a particular app,
                                          *        like Vault for escape hatch mechanism.
                                          * @return AppProxy instance
                                          */
                                          function newPinnedAppInstance(bytes32 _appId, address _appBase, bytes _initializePayload, bool _setDefault)
                                              public
                                              auth(APP_MANAGER_ROLE, arr(KERNEL_APP_BASES_NAMESPACE, _appId))
                                              returns (ERCProxy appProxy)
                                          {
                                              _setAppIfNew(KERNEL_APP_BASES_NAMESPACE, _appId, _appBase);
                                              appProxy = newAppProxyPinned(this, _appId, _initializePayload);
                                              // By calling setApp directly and not the internal functions, we make sure the params are checked
                                              // and it will only succeed if sender has permissions to set something to the namespace.
                                              if (_setDefault) {
                                                  setApp(KERNEL_APP_ADDR_NAMESPACE, _appId, appProxy);
                                              }
                                          }
                                      
                                          /**
                                          * @dev Set the resolving address of an app instance or base implementation
                                          * @notice Set the resolving address of `_appId` in namespace `_namespace` to `_app`
                                          * @param _namespace App namespace to use
                                          * @param _appId Identifier for app
                                          * @param _app Address of the app instance or base implementation
                                          * @return ID of app
                                          */
                                          function setApp(bytes32 _namespace, bytes32 _appId, address _app)
                                              public
                                              auth(APP_MANAGER_ROLE, arr(_namespace, _appId))
                                          {
                                              _setApp(_namespace, _appId, _app);
                                          }
                                      
                                          /**
                                          * @dev Set the default vault id for the escape hatch mechanism
                                          * @param _recoveryVaultAppId Identifier of the recovery vault app
                                          */
                                          function setRecoveryVaultAppId(bytes32 _recoveryVaultAppId)
                                              public
                                              auth(APP_MANAGER_ROLE, arr(KERNEL_APP_ADDR_NAMESPACE, _recoveryVaultAppId))
                                          {
                                              recoveryVaultAppId = _recoveryVaultAppId;
                                          }
                                      
                                          // External access to default app id and namespace constants to mimic default getters for constants
                                          /* solium-disable function-order, mixedcase */
                                          function CORE_NAMESPACE() external pure returns (bytes32) { return KERNEL_CORE_NAMESPACE; }
                                          function APP_BASES_NAMESPACE() external pure returns (bytes32) { return KERNEL_APP_BASES_NAMESPACE; }
                                          function APP_ADDR_NAMESPACE() external pure returns (bytes32) { return KERNEL_APP_ADDR_NAMESPACE; }
                                          function KERNEL_APP_ID() external pure returns (bytes32) { return KERNEL_CORE_APP_ID; }
                                          function DEFAULT_ACL_APP_ID() external pure returns (bytes32) { return KERNEL_DEFAULT_ACL_APP_ID; }
                                          /* solium-enable function-order, mixedcase */
                                      
                                          /**
                                          * @dev Get the address of an app instance or base implementation
                                          * @param _namespace App namespace to use
                                          * @param _appId Identifier for app
                                          * @return Address of the app
                                          */
                                          function getApp(bytes32 _namespace, bytes32 _appId) public view returns (address) {
                                              return apps[_namespace][_appId];
                                          }
                                      
                                          /**
                                          * @dev Get the address of the recovery Vault instance (to recover funds)
                                          * @return Address of the Vault
                                          */
                                          function getRecoveryVault() public view returns (address) {
                                              return apps[KERNEL_APP_ADDR_NAMESPACE][recoveryVaultAppId];
                                          }
                                      
                                          /**
                                          * @dev Get the installed ACL app
                                          * @return ACL app
                                          */
                                          function acl() public view returns (IACL) {
                                              return IACL(getApp(KERNEL_APP_ADDR_NAMESPACE, KERNEL_DEFAULT_ACL_APP_ID));
                                          }
                                      
                                          /**
                                          * @dev Function called by apps to check ACL on kernel or to check permission status
                                          * @param _who Sender of the original call
                                          * @param _where Address of the app
                                          * @param _what Identifier for a group of actions in app
                                          * @param _how Extra data for ACL auth
                                          * @return Boolean indicating whether the ACL allows the role or not.
                                          *         Always returns false if the kernel hasn't been initialized yet.
                                          */
                                          function hasPermission(address _who, address _where, bytes32 _what, bytes _how) public view returns (bool) {
                                              IACL defaultAcl = acl();
                                              return address(defaultAcl) != address(0) && // Poor man's initialization check (saves gas)
                                                  defaultAcl.hasPermission(_who, _where, _what, _how);
                                          }
                                      
                                          function _setApp(bytes32 _namespace, bytes32 _appId, address _app) internal {
                                              require(isContract(_app), ERROR_APP_NOT_CONTRACT);
                                              apps[_namespace][_appId] = _app;
                                              emit SetApp(_namespace, _appId, _app);
                                          }
                                      
                                          function _setAppIfNew(bytes32 _namespace, bytes32 _appId, address _app) internal {
                                              address app = getApp(_namespace, _appId);
                                              if (app != address(0)) {
                                                  // The only way to set an app is if it passes the isContract check, so no need to check it again
                                                  require(app == _app, ERROR_INVALID_APP_CHANGE);
                                              } else {
                                                  _setApp(_namespace, _appId, _app);
                                              }
                                          }
                                      
                                          modifier auth(bytes32 _role, uint256[] memory _params) {
                                              require(
                                                  hasPermission(msg.sender, address(this), _role, ConversionHelpers.dangerouslyCastUintArrayToBytes(_params)),
                                                  ERROR_AUTH_FAILED
                                              );
                                              _;
                                          }
                                      }

                                      File 14 of 14: TokenManager
                                      // File: @aragon/os/contracts/common/UnstructuredStorage.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      library UnstructuredStorage {
                                          function getStorageBool(bytes32 position) internal view returns (bool data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageAddress(bytes32 position) internal view returns (address data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageBytes32(bytes32 position) internal view returns (bytes32 data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function getStorageUint256(bytes32 position) internal view returns (uint256 data) {
                                              assembly { data := sload(position) }
                                          }
                                      
                                          function setStorageBool(bytes32 position, bool data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageAddress(bytes32 position, address data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageBytes32(bytes32 position, bytes32 data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      
                                          function setStorageUint256(bytes32 position, uint256 data) internal {
                                              assembly { sstore(position, data) }
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/acl/IACL.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      interface IACL {
                                          function initialize(address permissionsCreator) external;
                                      
                                          // TODO: this should be external
                                          // See https://github.com/ethereum/solidity/issues/4832
                                          function hasPermission(address who, address where, bytes32 what, bytes how) public view returns (bool);
                                      }
                                      
                                      // File: @aragon/os/contracts/common/IVaultRecoverable.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      interface IVaultRecoverable {
                                          event RecoverToVault(address indexed vault, address indexed token, uint256 amount);
                                      
                                          function transferToVault(address token) external;
                                      
                                          function allowRecoverability(address token) external view returns (bool);
                                          function getRecoveryVault() external view returns (address);
                                      }
                                      
                                      // File: @aragon/os/contracts/kernel/IKernel.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      interface IKernelEvents {
                                          event SetApp(bytes32 indexed namespace, bytes32 indexed appId, address app);
                                      }
                                      
                                      
                                      // This should be an interface, but interfaces can't inherit yet :(
                                      contract IKernel is IKernelEvents, IVaultRecoverable {
                                          function acl() public view returns (IACL);
                                          function hasPermission(address who, address where, bytes32 what, bytes how) public view returns (bool);
                                      
                                          function setApp(bytes32 namespace, bytes32 appId, address app) public;
                                          function getApp(bytes32 namespace, bytes32 appId) public view returns (address);
                                      }
                                      
                                      // File: @aragon/os/contracts/apps/AppStorage.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      contract AppStorage {
                                          using UnstructuredStorage for bytes32;
                                      
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant KERNEL_POSITION = keccak256("aragonOS.appStorage.kernel");
                                          bytes32 internal constant APP_ID_POSITION = keccak256("aragonOS.appStorage.appId");
                                          */
                                          bytes32 internal constant KERNEL_POSITION = 0x4172f0f7d2289153072b0a6ca36959e0cbe2efc3afe50fc81636caa96338137b;
                                          bytes32 internal constant APP_ID_POSITION = 0xd625496217aa6a3453eecb9c3489dc5a53e6c67b444329ea2b2cbc9ff547639b;
                                      
                                          function kernel() public view returns (IKernel) {
                                              return IKernel(KERNEL_POSITION.getStorageAddress());
                                          }
                                      
                                          function appId() public view returns (bytes32) {
                                              return APP_ID_POSITION.getStorageBytes32();
                                          }
                                      
                                          function setKernel(IKernel _kernel) internal {
                                              KERNEL_POSITION.setStorageAddress(address(_kernel));
                                          }
                                      
                                          function setAppId(bytes32 _appId) internal {
                                              APP_ID_POSITION.setStorageBytes32(_appId);
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/acl/ACLSyntaxSugar.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract ACLSyntaxSugar {
                                          function arr() internal pure returns (uint256[]) {
                                              return new uint256[](0);
                                          }
                                      
                                          function arr(bytes32 _a) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a));
                                          }
                                      
                                          function arr(bytes32 _a, bytes32 _b) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b));
                                          }
                                      
                                          function arr(address _a) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a));
                                          }
                                      
                                          function arr(address _a, address _b) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b));
                                          }
                                      
                                          function arr(address _a, uint256 _b, uint256 _c) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), _b, _c);
                                          }
                                      
                                          function arr(address _a, uint256 _b, uint256 _c, uint256 _d) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), _b, _c, _d);
                                          }
                                      
                                          function arr(address _a, uint256 _b) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b));
                                          }
                                      
                                          function arr(address _a, address _b, uint256 _c, uint256 _d, uint256 _e) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b), _c, _d, _e);
                                          }
                                      
                                          function arr(address _a, address _b, address _c) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b), uint256(_c));
                                          }
                                      
                                          function arr(address _a, address _b, uint256 _c) internal pure returns (uint256[] r) {
                                              return arr(uint256(_a), uint256(_b), uint256(_c));
                                          }
                                      
                                          function arr(uint256 _a) internal pure returns (uint256[] r) {
                                              r = new uint256[](1);
                                              r[0] = _a;
                                          }
                                      
                                          function arr(uint256 _a, uint256 _b) internal pure returns (uint256[] r) {
                                              r = new uint256[](2);
                                              r[0] = _a;
                                              r[1] = _b;
                                          }
                                      
                                          function arr(uint256 _a, uint256 _b, uint256 _c) internal pure returns (uint256[] r) {
                                              r = new uint256[](3);
                                              r[0] = _a;
                                              r[1] = _b;
                                              r[2] = _c;
                                          }
                                      
                                          function arr(uint256 _a, uint256 _b, uint256 _c, uint256 _d) internal pure returns (uint256[] r) {
                                              r = new uint256[](4);
                                              r[0] = _a;
                                              r[1] = _b;
                                              r[2] = _c;
                                              r[3] = _d;
                                          }
                                      
                                          function arr(uint256 _a, uint256 _b, uint256 _c, uint256 _d, uint256 _e) internal pure returns (uint256[] r) {
                                              r = new uint256[](5);
                                              r[0] = _a;
                                              r[1] = _b;
                                              r[2] = _c;
                                              r[3] = _d;
                                              r[4] = _e;
                                          }
                                      }
                                      
                                      
                                      contract ACLHelpers {
                                          function decodeParamOp(uint256 _x) internal pure returns (uint8 b) {
                                              return uint8(_x >> (8 * 30));
                                          }
                                      
                                          function decodeParamId(uint256 _x) internal pure returns (uint8 b) {
                                              return uint8(_x >> (8 * 31));
                                          }
                                      
                                          function decodeParamsList(uint256 _x) internal pure returns (uint32 a, uint32 b, uint32 c) {
                                              a = uint32(_x);
                                              b = uint32(_x >> (8 * 4));
                                              c = uint32(_x >> (8 * 8));
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/common/Uint256Helpers.sol
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      library Uint256Helpers {
                                          uint256 private constant MAX_UINT64 = uint64(-1);
                                      
                                          string private constant ERROR_NUMBER_TOO_BIG = "UINT64_NUMBER_TOO_BIG";
                                      
                                          function toUint64(uint256 a) internal pure returns (uint64) {
                                              require(a <= MAX_UINT64, ERROR_NUMBER_TOO_BIG);
                                              return uint64(a);
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/common/TimeHelpers.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      contract TimeHelpers {
                                          using Uint256Helpers for uint256;
                                      
                                          /**
                                          * @dev Returns the current block number.
                                          *      Using a function rather than `block.number` allows us to easily mock the block number in
                                          *      tests.
                                          */
                                          function getBlockNumber() internal view returns (uint256) {
                                              return block.number;
                                          }
                                      
                                          /**
                                          * @dev Returns the current block number, converted to uint64.
                                          *      Using a function rather than `block.number` allows us to easily mock the block number in
                                          *      tests.
                                          */
                                          function getBlockNumber64() internal view returns (uint64) {
                                              return getBlockNumber().toUint64();
                                          }
                                      
                                          /**
                                          * @dev Returns the current timestamp.
                                          *      Using a function rather than `block.timestamp` allows us to easily mock it in
                                          *      tests.
                                          */
                                          function getTimestamp() internal view returns (uint256) {
                                              return block.timestamp; // solium-disable-line security/no-block-members
                                          }
                                      
                                          /**
                                          * @dev Returns the current timestamp, converted to uint64.
                                          *      Using a function rather than `block.timestamp` allows us to easily mock it in
                                          *      tests.
                                          */
                                          function getTimestamp64() internal view returns (uint64) {
                                              return getTimestamp().toUint64();
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/common/Initializable.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      contract Initializable is TimeHelpers {
                                          using UnstructuredStorage for bytes32;
                                      
                                          // keccak256("aragonOS.initializable.initializationBlock")
                                          bytes32 internal constant INITIALIZATION_BLOCK_POSITION = 0xebb05b386a8d34882b8711d156f463690983dc47815980fb82aeeff1aa43579e;
                                      
                                          string private constant ERROR_ALREADY_INITIALIZED = "INIT_ALREADY_INITIALIZED";
                                          string private constant ERROR_NOT_INITIALIZED = "INIT_NOT_INITIALIZED";
                                      
                                          modifier onlyInit {
                                              require(getInitializationBlock() == 0, ERROR_ALREADY_INITIALIZED);
                                              _;
                                          }
                                      
                                          modifier isInitialized {
                                              require(hasInitialized(), ERROR_NOT_INITIALIZED);
                                              _;
                                          }
                                      
                                          /**
                                          * @return Block number in which the contract was initialized
                                          */
                                          function getInitializationBlock() public view returns (uint256) {
                                              return INITIALIZATION_BLOCK_POSITION.getStorageUint256();
                                          }
                                      
                                          /**
                                          * @return Whether the contract has been initialized by the time of the current block
                                          */
                                          function hasInitialized() public view returns (bool) {
                                              uint256 initializationBlock = getInitializationBlock();
                                              return initializationBlock != 0 && getBlockNumber() >= initializationBlock;
                                          }
                                      
                                          /**
                                          * @dev Function to be called by top level contract after initialization has finished.
                                          */
                                          function initialized() internal onlyInit {
                                              INITIALIZATION_BLOCK_POSITION.setStorageUint256(getBlockNumber());
                                          }
                                      
                                          /**
                                          * @dev Function to be called by top level contract after initialization to enable the contract
                                          *      at a future block number rather than immediately.
                                          */
                                          function initializedAt(uint256 _blockNumber) internal onlyInit {
                                              INITIALIZATION_BLOCK_POSITION.setStorageUint256(_blockNumber);
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/common/Petrifiable.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      contract Petrifiable is Initializable {
                                          // Use block UINT256_MAX (which should be never) as the initializable date
                                          uint256 internal constant PETRIFIED_BLOCK = uint256(-1);
                                      
                                          function isPetrified() public view returns (bool) {
                                              return getInitializationBlock() == PETRIFIED_BLOCK;
                                          }
                                      
                                          /**
                                          * @dev Function to be called by top level contract to prevent being initialized.
                                          *      Useful for freezing base contracts when they're used behind proxies.
                                          */
                                          function petrify() internal onlyInit {
                                              initializedAt(PETRIFIED_BLOCK);
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/common/Autopetrified.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      contract Autopetrified is Petrifiable {
                                          constructor() public {
                                              // Immediately petrify base (non-proxy) instances of inherited contracts on deploy.
                                              // This renders them uninitializable (and unusable without a proxy).
                                              petrify();
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/common/ConversionHelpers.sol
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      library ConversionHelpers {
                                          string private constant ERROR_IMPROPER_LENGTH = "CONVERSION_IMPROPER_LENGTH";
                                      
                                          function dangerouslyCastUintArrayToBytes(uint256[] memory _input) internal pure returns (bytes memory output) {
                                              // Force cast the uint256[] into a bytes array, by overwriting its length
                                              // Note that the bytes array doesn't need to be initialized as we immediately overwrite it
                                              // with the input and a new length. The input becomes invalid from this point forward.
                                              uint256 byteLength = _input.length * 32;
                                              assembly {
                                                  output := _input
                                                  mstore(output, byteLength)
                                              }
                                          }
                                      
                                          function dangerouslyCastBytesToUintArray(bytes memory _input) internal pure returns (uint256[] memory output) {
                                              // Force cast the bytes array into a uint256[], by overwriting its length
                                              // Note that the uint256[] doesn't need to be initialized as we immediately overwrite it
                                              // with the input and a new length. The input becomes invalid from this point forward.
                                              uint256 intsLength = _input.length / 32;
                                              require(_input.length == intsLength * 32, ERROR_IMPROPER_LENGTH);
                                      
                                              assembly {
                                                  output := _input
                                                  mstore(output, intsLength)
                                              }
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/common/ReentrancyGuard.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      contract ReentrancyGuard {
                                          using UnstructuredStorage for bytes32;
                                      
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant REENTRANCY_MUTEX_POSITION = keccak256("aragonOS.reentrancyGuard.mutex");
                                          */
                                          bytes32 private constant REENTRANCY_MUTEX_POSITION = 0xe855346402235fdd185c890e68d2c4ecad599b88587635ee285bce2fda58dacb;
                                      
                                          string private constant ERROR_REENTRANT = "REENTRANCY_REENTRANT_CALL";
                                      
                                          modifier nonReentrant() {
                                              // Ensure mutex is unlocked
                                              require(!REENTRANCY_MUTEX_POSITION.getStorageBool(), ERROR_REENTRANT);
                                      
                                              // Lock mutex before function call
                                              REENTRANCY_MUTEX_POSITION.setStorageBool(true);
                                      
                                              // Perform function call
                                              _;
                                      
                                              // Unlock mutex after function call
                                              REENTRANCY_MUTEX_POSITION.setStorageBool(false);
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/lib/token/ERC20.sol
                                      
                                      // See https://github.com/OpenZeppelin/openzeppelin-solidity/blob/a9f910d34f0ab33a1ae5e714f69f9596a02b4d91/contracts/token/ERC20/ERC20.sol
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      /**
                                       * @title ERC20 interface
                                       * @dev see https://github.com/ethereum/EIPs/issues/20
                                       */
                                      contract ERC20 {
                                          function totalSupply() public view returns (uint256);
                                      
                                          function balanceOf(address _who) public view returns (uint256);
                                      
                                          function allowance(address _owner, address _spender)
                                              public view returns (uint256);
                                      
                                          function transfer(address _to, uint256 _value) public returns (bool);
                                      
                                          function approve(address _spender, uint256 _value)
                                              public returns (bool);
                                      
                                          function transferFrom(address _from, address _to, uint256 _value)
                                              public returns (bool);
                                      
                                          event Transfer(
                                              address indexed from,
                                              address indexed to,
                                              uint256 value
                                          );
                                      
                                          event Approval(
                                              address indexed owner,
                                              address indexed spender,
                                              uint256 value
                                          );
                                      }
                                      
                                      // File: @aragon/os/contracts/common/EtherTokenConstant.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      // aragonOS and aragon-apps rely on address(0) to denote native ETH, in
                                      // contracts where both tokens and ETH are accepted
                                      contract EtherTokenConstant {
                                          address internal constant ETH = address(0);
                                      }
                                      
                                      // File: @aragon/os/contracts/common/IsContract.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract IsContract {
                                          /*
                                          * NOTE: this should NEVER be used for authentication
                                          * (see pitfalls: https://github.com/fergarrui/ethereum-security/tree/master/contracts/extcodesize).
                                          *
                                          * This is only intended to be used as a sanity check that an address is actually a contract,
                                          * RATHER THAN an address not being a contract.
                                          */
                                          function isContract(address _target) internal view returns (bool) {
                                              if (_target == address(0)) {
                                                  return false;
                                              }
                                      
                                              uint256 size;
                                              assembly { size := extcodesize(_target) }
                                              return size > 0;
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/common/SafeERC20.sol
                                      
                                      // Inspired by AdEx (https://github.com/AdExNetwork/adex-protocol-eth/blob/b9df617829661a7518ee10f4cb6c4108659dd6d5/contracts/libs/SafeERC20.sol)
                                      // and 0x (https://github.com/0xProject/0x-monorepo/blob/737d1dc54d72872e24abce5a1dbe1b66d35fa21a/contracts/protocol/contracts/protocol/AssetProxy/ERC20Proxy.sol#L143)
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      library SafeERC20 {
                                          // Before 0.5, solidity has a mismatch between `address.transfer()` and `token.transfer()`:
                                          // https://github.com/ethereum/solidity/issues/3544
                                          bytes4 private constant TRANSFER_SELECTOR = 0xa9059cbb;
                                      
                                          string private constant ERROR_TOKEN_BALANCE_REVERTED = "SAFE_ERC_20_BALANCE_REVERTED";
                                          string private constant ERROR_TOKEN_ALLOWANCE_REVERTED = "SAFE_ERC_20_ALLOWANCE_REVERTED";
                                      
                                          function invokeAndCheckSuccess(address _addr, bytes memory _calldata)
                                              private
                                              returns (bool)
                                          {
                                              bool ret;
                                              assembly {
                                                  let ptr := mload(0x40)    // free memory pointer
                                      
                                                  let success := call(
                                                      gas,                  // forward all gas
                                                      _addr,                // address
                                                      0,                    // no value
                                                      add(_calldata, 0x20), // calldata start
                                                      mload(_calldata),     // calldata length
                                                      ptr,                  // write output over free memory
                                                      0x20                  // uint256 return
                                                  )
                                      
                                                  if gt(success, 0) {
                                                      // Check number of bytes returned from last function call
                                                      switch returndatasize
                                      
                                                      // No bytes returned: assume success
                                                      case 0 {
                                                          ret := 1
                                                      }
                                      
                                                      // 32 bytes returned: check if non-zero
                                                      case 0x20 {
                                                          // Only return success if returned data was true
                                                          // Already have output in ptr
                                                          ret := eq(mload(ptr), 1)
                                                      }
                                      
                                                      // Not sure what was returned: don't mark as success
                                                      default { }
                                                  }
                                              }
                                              return ret;
                                          }
                                      
                                          function staticInvoke(address _addr, bytes memory _calldata)
                                              private
                                              view
                                              returns (bool, uint256)
                                          {
                                              bool success;
                                              uint256 ret;
                                              assembly {
                                                  let ptr := mload(0x40)    // free memory pointer
                                      
                                                  success := staticcall(
                                                      gas,                  // forward all gas
                                                      _addr,                // address
                                                      add(_calldata, 0x20), // calldata start
                                                      mload(_calldata),     // calldata length
                                                      ptr,                  // write output over free memory
                                                      0x20                  // uint256 return
                                                  )
                                      
                                                  if gt(success, 0) {
                                                      ret := mload(ptr)
                                                  }
                                              }
                                              return (success, ret);
                                          }
                                      
                                          /**
                                          * @dev Same as a standards-compliant ERC20.transfer() that never reverts (returns false).
                                          *      Note that this makes an external call to the token.
                                          */
                                          function safeTransfer(ERC20 _token, address _to, uint256 _amount) internal returns (bool) {
                                              bytes memory transferCallData = abi.encodeWithSelector(
                                                  TRANSFER_SELECTOR,
                                                  _to,
                                                  _amount
                                              );
                                              return invokeAndCheckSuccess(_token, transferCallData);
                                          }
                                      
                                          /**
                                          * @dev Same as a standards-compliant ERC20.transferFrom() that never reverts (returns false).
                                          *      Note that this makes an external call to the token.
                                          */
                                          function safeTransferFrom(ERC20 _token, address _from, address _to, uint256 _amount) internal returns (bool) {
                                              bytes memory transferFromCallData = abi.encodeWithSelector(
                                                  _token.transferFrom.selector,
                                                  _from,
                                                  _to,
                                                  _amount
                                              );
                                              return invokeAndCheckSuccess(_token, transferFromCallData);
                                          }
                                      
                                          /**
                                          * @dev Same as a standards-compliant ERC20.approve() that never reverts (returns false).
                                          *      Note that this makes an external call to the token.
                                          */
                                          function safeApprove(ERC20 _token, address _spender, uint256 _amount) internal returns (bool) {
                                              bytes memory approveCallData = abi.encodeWithSelector(
                                                  _token.approve.selector,
                                                  _spender,
                                                  _amount
                                              );
                                              return invokeAndCheckSuccess(_token, approveCallData);
                                          }
                                      
                                          /**
                                          * @dev Static call into ERC20.balanceOf().
                                          * Reverts if the call fails for some reason (should never fail).
                                          */
                                          function staticBalanceOf(ERC20 _token, address _owner) internal view returns (uint256) {
                                              bytes memory balanceOfCallData = abi.encodeWithSelector(
                                                  _token.balanceOf.selector,
                                                  _owner
                                              );
                                      
                                              (bool success, uint256 tokenBalance) = staticInvoke(_token, balanceOfCallData);
                                              require(success, ERROR_TOKEN_BALANCE_REVERTED);
                                      
                                              return tokenBalance;
                                          }
                                      
                                          /**
                                          * @dev Static call into ERC20.allowance().
                                          * Reverts if the call fails for some reason (should never fail).
                                          */
                                          function staticAllowance(ERC20 _token, address _owner, address _spender) internal view returns (uint256) {
                                              bytes memory allowanceCallData = abi.encodeWithSelector(
                                                  _token.allowance.selector,
                                                  _owner,
                                                  _spender
                                              );
                                      
                                              (bool success, uint256 allowance) = staticInvoke(_token, allowanceCallData);
                                              require(success, ERROR_TOKEN_ALLOWANCE_REVERTED);
                                      
                                              return allowance;
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/common/VaultRecoverable.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      contract VaultRecoverable is IVaultRecoverable, EtherTokenConstant, IsContract {
                                          using SafeERC20 for ERC20;
                                      
                                          string private constant ERROR_DISALLOWED = "RECOVER_DISALLOWED";
                                          string private constant ERROR_VAULT_NOT_CONTRACT = "RECOVER_VAULT_NOT_CONTRACT";
                                          string private constant ERROR_TOKEN_TRANSFER_FAILED = "RECOVER_TOKEN_TRANSFER_FAILED";
                                      
                                          /**
                                           * @notice Send funds to recovery Vault. This contract should never receive funds,
                                           *         but in case it does, this function allows one to recover them.
                                           * @param _token Token balance to be sent to recovery vault.
                                           */
                                          function transferToVault(address _token) external {
                                              require(allowRecoverability(_token), ERROR_DISALLOWED);
                                              address vault = getRecoveryVault();
                                              require(isContract(vault), ERROR_VAULT_NOT_CONTRACT);
                                      
                                              uint256 balance;
                                              if (_token == ETH) {
                                                  balance = address(this).balance;
                                                  vault.transfer(balance);
                                              } else {
                                                  ERC20 token = ERC20(_token);
                                                  balance = token.staticBalanceOf(this);
                                                  require(token.safeTransfer(vault, balance), ERROR_TOKEN_TRANSFER_FAILED);
                                              }
                                      
                                              emit RecoverToVault(vault, _token, balance);
                                          }
                                      
                                          /**
                                          * @dev By default deriving from AragonApp makes it recoverable
                                          * @param token Token address that would be recovered
                                          * @return bool whether the app allows the recovery
                                          */
                                          function allowRecoverability(address token) public view returns (bool) {
                                              return true;
                                          }
                                      
                                          // Cast non-implemented interface to be public so we can use it internally
                                          function getRecoveryVault() public view returns (address);
                                      }
                                      
                                      // File: @aragon/os/contracts/evmscript/IEVMScriptExecutor.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      interface IEVMScriptExecutor {
                                          function execScript(bytes script, bytes input, address[] blacklist) external returns (bytes);
                                          function executorType() external pure returns (bytes32);
                                      }
                                      
                                      // File: @aragon/os/contracts/evmscript/IEVMScriptRegistry.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      contract EVMScriptRegistryConstants {
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant EVMSCRIPT_REGISTRY_APP_ID = apmNamehash("evmreg");
                                          */
                                          bytes32 internal constant EVMSCRIPT_REGISTRY_APP_ID = 0xddbcfd564f642ab5627cf68b9b7d374fb4f8a36e941a75d89c87998cef03bd61;
                                      }
                                      
                                      
                                      interface IEVMScriptRegistry {
                                          function addScriptExecutor(IEVMScriptExecutor executor) external returns (uint id);
                                          function disableScriptExecutor(uint256 executorId) external;
                                      
                                          // TODO: this should be external
                                          // See https://github.com/ethereum/solidity/issues/4832
                                          function getScriptExecutor(bytes script) public view returns (IEVMScriptExecutor);
                                      }
                                      
                                      // File: @aragon/os/contracts/kernel/KernelConstants.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      contract KernelAppIds {
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant KERNEL_CORE_APP_ID = apmNamehash("kernel");
                                          bytes32 internal constant KERNEL_DEFAULT_ACL_APP_ID = apmNamehash("acl");
                                          bytes32 internal constant KERNEL_DEFAULT_VAULT_APP_ID = apmNamehash("vault");
                                          */
                                          bytes32 internal constant KERNEL_CORE_APP_ID = 0x3b4bf6bf3ad5000ecf0f989d5befde585c6860fea3e574a4fab4c49d1c177d9c;
                                          bytes32 internal constant KERNEL_DEFAULT_ACL_APP_ID = 0xe3262375f45a6e2026b7e7b18c2b807434f2508fe1a2a3dfb493c7df8f4aad6a;
                                          bytes32 internal constant KERNEL_DEFAULT_VAULT_APP_ID = 0x7e852e0fcfce6551c13800f1e7476f982525c2b5277ba14b24339c68416336d1;
                                      }
                                      
                                      
                                      contract KernelNamespaceConstants {
                                          /* Hardcoded constants to save gas
                                          bytes32 internal constant KERNEL_CORE_NAMESPACE = keccak256("core");
                                          bytes32 internal constant KERNEL_APP_BASES_NAMESPACE = keccak256("base");
                                          bytes32 internal constant KERNEL_APP_ADDR_NAMESPACE = keccak256("app");
                                          */
                                          bytes32 internal constant KERNEL_CORE_NAMESPACE = 0xc681a85306374a5ab27f0bbc385296a54bcd314a1948b6cf61c4ea1bc44bb9f8;
                                          bytes32 internal constant KERNEL_APP_BASES_NAMESPACE = 0xf1f3eb40f5bc1ad1344716ced8b8a0431d840b5783aea1fd01786bc26f35ac0f;
                                          bytes32 internal constant KERNEL_APP_ADDR_NAMESPACE = 0xd6f028ca0e8edb4a8c9757ca4fdccab25fa1e0317da1188108f7d2dee14902fb;
                                      }
                                      
                                      // File: @aragon/os/contracts/evmscript/EVMScriptRunner.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      contract EVMScriptRunner is AppStorage, Initializable, EVMScriptRegistryConstants, KernelNamespaceConstants {
                                          string private constant ERROR_EXECUTOR_UNAVAILABLE = "EVMRUN_EXECUTOR_UNAVAILABLE";
                                          string private constant ERROR_PROTECTED_STATE_MODIFIED = "EVMRUN_PROTECTED_STATE_MODIFIED";
                                      
                                          /* This is manually crafted in assembly
                                          string private constant ERROR_EXECUTOR_INVALID_RETURN = "EVMRUN_EXECUTOR_INVALID_RETURN";
                                          */
                                      
                                          event ScriptResult(address indexed executor, bytes script, bytes input, bytes returnData);
                                      
                                          function getEVMScriptExecutor(bytes _script) public view returns (IEVMScriptExecutor) {
                                              return IEVMScriptExecutor(getEVMScriptRegistry().getScriptExecutor(_script));
                                          }
                                      
                                          function getEVMScriptRegistry() public view returns (IEVMScriptRegistry) {
                                              address registryAddr = kernel().getApp(KERNEL_APP_ADDR_NAMESPACE, EVMSCRIPT_REGISTRY_APP_ID);
                                              return IEVMScriptRegistry(registryAddr);
                                          }
                                      
                                          function runScript(bytes _script, bytes _input, address[] _blacklist)
                                              internal
                                              isInitialized
                                              protectState
                                              returns (bytes)
                                          {
                                              IEVMScriptExecutor executor = getEVMScriptExecutor(_script);
                                              require(address(executor) != address(0), ERROR_EXECUTOR_UNAVAILABLE);
                                      
                                              bytes4 sig = executor.execScript.selector;
                                              bytes memory data = abi.encodeWithSelector(sig, _script, _input, _blacklist);
                                      
                                              bytes memory output;
                                              assembly {
                                                  let success := delegatecall(
                                                      gas,                // forward all gas
                                                      executor,           // address
                                                      add(data, 0x20),    // calldata start
                                                      mload(data),        // calldata length
                                                      0,                  // don't write output (we'll handle this ourselves)
                                                      0                   // don't write output
                                                  )
                                      
                                                  output := mload(0x40) // free mem ptr get
                                      
                                                  switch success
                                                  case 0 {
                                                      // If the call errored, forward its full error data
                                                      returndatacopy(output, 0, returndatasize)
                                                      revert(output, returndatasize)
                                                  }
                                                  default {
                                                      switch gt(returndatasize, 0x3f)
                                                      case 0 {
                                                          // Need at least 0x40 bytes returned for properly ABI-encoded bytes values,
                                                          // revert with "EVMRUN_EXECUTOR_INVALID_RETURN"
                                                          // See remix: doing a `revert("EVMRUN_EXECUTOR_INVALID_RETURN")` always results in
                                                          // this memory layout
                                                          mstore(output, 0x08c379a000000000000000000000000000000000000000000000000000000000)         // error identifier
                                                          mstore(add(output, 0x04), 0x0000000000000000000000000000000000000000000000000000000000000020) // starting offset
                                                          mstore(add(output, 0x24), 0x000000000000000000000000000000000000000000000000000000000000001e) // reason length
                                                          mstore(add(output, 0x44), 0x45564d52554e5f4558454355544f525f494e56414c49445f52455455524e0000) // reason
                                      
                                                          revert(output, 100) // 100 = 4 + 3 * 32 (error identifier + 3 words for the ABI encoded error)
                                                      }
                                                      default {
                                                          // Copy result
                                                          //
                                                          // Needs to perform an ABI decode for the expected `bytes` return type of
                                                          // `executor.execScript()` as solidity will automatically ABI encode the returned bytes as:
                                                          //    [ position of the first dynamic length return value = 0x20 (32 bytes) ]
                                                          //    [ output length (32 bytes) ]
                                                          //    [ output content (N bytes) ]
                                                          //
                                                          // Perform the ABI decode by ignoring the first 32 bytes of the return data
                                                          let copysize := sub(returndatasize, 0x20)
                                                          returndatacopy(output, 0x20, copysize)
                                      
                                                          mstore(0x40, add(output, copysize)) // free mem ptr set
                                                      }
                                                  }
                                              }
                                      
                                              emit ScriptResult(address(executor), _script, _input, output);
                                      
                                              return output;
                                          }
                                      
                                          modifier protectState {
                                              address preKernel = address(kernel());
                                              bytes32 preAppId = appId();
                                              _; // exec
                                              require(address(kernel()) == preKernel, ERROR_PROTECTED_STATE_MODIFIED);
                                              require(appId() == preAppId, ERROR_PROTECTED_STATE_MODIFIED);
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/apps/AragonApp.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      // Contracts inheriting from AragonApp are, by default, immediately petrified upon deployment so
                                      // that they can never be initialized.
                                      // Unless overriden, this behaviour enforces those contracts to be usable only behind an AppProxy.
                                      // ReentrancyGuard, EVMScriptRunner, and ACLSyntaxSugar are not directly used by this contract, but
                                      // are included so that they are automatically usable by subclassing contracts
                                      contract AragonApp is AppStorage, Autopetrified, VaultRecoverable, ReentrancyGuard, EVMScriptRunner, ACLSyntaxSugar {
                                          string private constant ERROR_AUTH_FAILED = "APP_AUTH_FAILED";
                                      
                                          modifier auth(bytes32 _role) {
                                              require(canPerform(msg.sender, _role, new uint256[](0)), ERROR_AUTH_FAILED);
                                              _;
                                          }
                                      
                                          modifier authP(bytes32 _role, uint256[] _params) {
                                              require(canPerform(msg.sender, _role, _params), ERROR_AUTH_FAILED);
                                              _;
                                          }
                                      
                                          /**
                                          * @dev Check whether an action can be performed by a sender for a particular role on this app
                                          * @param _sender Sender of the call
                                          * @param _role Role on this app
                                          * @param _params Permission params for the role
                                          * @return Boolean indicating whether the sender has the permissions to perform the action.
                                          *         Always returns false if the app hasn't been initialized yet.
                                          */
                                          function canPerform(address _sender, bytes32 _role, uint256[] _params) public view returns (bool) {
                                              if (!hasInitialized()) {
                                                  return false;
                                              }
                                      
                                              IKernel linkedKernel = kernel();
                                              if (address(linkedKernel) == address(0)) {
                                                  return false;
                                              }
                                      
                                              return linkedKernel.hasPermission(
                                                  _sender,
                                                  address(this),
                                                  _role,
                                                  ConversionHelpers.dangerouslyCastUintArrayToBytes(_params)
                                              );
                                          }
                                      
                                          /**
                                          * @dev Get the recovery vault for the app
                                          * @return Recovery vault address for the app
                                          */
                                          function getRecoveryVault() public view returns (address) {
                                              // Funds recovery via a vault is only available when used with a kernel
                                              return kernel().getRecoveryVault(); // if kernel is not set, it will revert
                                          }
                                      }
                                      
                                      // File: @aragon/os/contracts/common/IForwarder.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    MIT
                                       */
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      interface IForwarder {
                                          function isForwarder() external pure returns (bool);
                                      
                                          // TODO: this should be external
                                          // See https://github.com/ethereum/solidity/issues/4832
                                          function canForward(address sender, bytes evmCallScript) public view returns (bool);
                                      
                                          // TODO: this should be external
                                          // See https://github.com/ethereum/solidity/issues/4832
                                          function forward(bytes evmCallScript) public;
                                      }
                                      
                                      // File: @aragon/os/contracts/lib/math/SafeMath.sol
                                      
                                      // See https://github.com/OpenZeppelin/openzeppelin-solidity/blob/d51e38758e1d985661534534d5c61e27bece5042/contracts/math/SafeMath.sol
                                      // Adapted to use pragma ^0.4.24 and satisfy our linter rules
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      
                                      /**
                                       * @title SafeMath
                                       * @dev Math operations with safety checks that revert on error
                                       */
                                      library SafeMath {
                                          string private constant ERROR_ADD_OVERFLOW = "MATH_ADD_OVERFLOW";
                                          string private constant ERROR_SUB_UNDERFLOW = "MATH_SUB_UNDERFLOW";
                                          string private constant ERROR_MUL_OVERFLOW = "MATH_MUL_OVERFLOW";
                                          string private constant ERROR_DIV_ZERO = "MATH_DIV_ZERO";
                                      
                                          /**
                                          * @dev Multiplies two numbers, reverts on overflow.
                                          */
                                          function mul(uint256 _a, uint256 _b) internal pure returns (uint256) {
                                              // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                                              // benefit is lost if 'b' is also tested.
                                              // See: https://github.com/OpenZeppelin/openzeppelin-solidity/pull/522
                                              if (_a == 0) {
                                                  return 0;
                                              }
                                      
                                              uint256 c = _a * _b;
                                              require(c / _a == _b, ERROR_MUL_OVERFLOW);
                                      
                                              return c;
                                          }
                                      
                                          /**
                                          * @dev Integer division of two numbers truncating the quotient, reverts on division by zero.
                                          */
                                          function div(uint256 _a, uint256 _b) internal pure returns (uint256) {
                                              require(_b > 0, ERROR_DIV_ZERO); // Solidity only automatically asserts when dividing by 0
                                              uint256 c = _a / _b;
                                              // assert(_a == _b * c + _a % _b); // There is no case in which this doesn't hold
                                      
                                              return c;
                                          }
                                      
                                          /**
                                          * @dev Subtracts two numbers, reverts on overflow (i.e. if subtrahend is greater than minuend).
                                          */
                                          function sub(uint256 _a, uint256 _b) internal pure returns (uint256) {
                                              require(_b <= _a, ERROR_SUB_UNDERFLOW);
                                              uint256 c = _a - _b;
                                      
                                              return c;
                                          }
                                      
                                          /**
                                          * @dev Adds two numbers, reverts on overflow.
                                          */
                                          function add(uint256 _a, uint256 _b) internal pure returns (uint256) {
                                              uint256 c = _a + _b;
                                              require(c >= _a, ERROR_ADD_OVERFLOW);
                                      
                                              return c;
                                          }
                                      
                                          /**
                                          * @dev Divides two numbers and returns the remainder (unsigned integer modulo),
                                          * reverts when dividing by zero.
                                          */
                                          function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                                              require(b != 0, ERROR_DIV_ZERO);
                                              return a % b;
                                          }
                                      }
                                      
                                      // File: @aragon/apps-shared-minime/contracts/ITokenController.sol
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      /// @dev The token controller contract must implement these functions
                                      
                                      
                                      interface ITokenController {
                                          /// @notice Called when `_owner` sends ether to the MiniMe Token contract
                                          /// @param _owner The address that sent the ether to create tokens
                                          /// @return True if the ether is accepted, false if it throws
                                          function proxyPayment(address _owner) external payable returns(bool);
                                      
                                          /// @notice Notifies the controller about a token transfer allowing the
                                          ///  controller to react if desired
                                          /// @param _from The origin of the transfer
                                          /// @param _to The destination of the transfer
                                          /// @param _amount The amount of the transfer
                                          /// @return False if the controller does not authorize the transfer
                                          function onTransfer(address _from, address _to, uint _amount) external returns(bool);
                                      
                                          /// @notice Notifies the controller about an approval allowing the
                                          ///  controller to react if desired
                                          /// @param _owner The address that calls `approve()`
                                          /// @param _spender The spender in the `approve()` call
                                          /// @param _amount The amount in the `approve()` call
                                          /// @return False if the controller does not authorize the approval
                                          function onApprove(address _owner, address _spender, uint _amount) external returns(bool);
                                      }
                                      
                                      // File: @aragon/apps-shared-minime/contracts/MiniMeToken.sol
                                      
                                      pragma solidity ^0.4.24;
                                      
                                      /*
                                          Copyright 2016, Jordi Baylina
                                          This program is free software: you can redistribute it and/or modify
                                          it under the terms of the GNU General Public License as published by
                                          the Free Software Foundation, either version 3 of the License, or
                                          (at your option) any later version.
                                          This program is distributed in the hope that it will be useful,
                                          but WITHOUT ANY WARRANTY; without even the implied warranty of
                                          MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                                          GNU General Public License for more details.
                                          You should have received a copy of the GNU General Public License
                                          along with this program.  If not, see <http://www.gnu.org/licenses/>.
                                       */
                                      
                                      /// @title MiniMeToken Contract
                                      /// @author Jordi Baylina
                                      /// @dev This token contract's goal is to make it easy for anyone to clone this
                                      ///  token using the token distribution at a given block, this will allow DAO's
                                      ///  and DApps to upgrade their features in a decentralized manner without
                                      ///  affecting the original token
                                      /// @dev It is ERC20 compliant, but still needs to under go further testing.
                                      
                                      
                                      contract Controlled {
                                          /// @notice The address of the controller is the only address that can call
                                          ///  a function with this modifier
                                          modifier onlyController {
                                              require(msg.sender == controller);
                                              _;
                                          }
                                      
                                          address public controller;
                                      
                                          function Controlled()  public { controller = msg.sender;}
                                      
                                          /// @notice Changes the controller of the contract
                                          /// @param _newController The new controller of the contract
                                          function changeController(address _newController) onlyController  public {
                                              controller = _newController;
                                          }
                                      }
                                      
                                      contract ApproveAndCallFallBack {
                                          function receiveApproval(
                                              address from,
                                              uint256 _amount,
                                              address _token,
                                              bytes _data
                                          ) public;
                                      }
                                      
                                      /// @dev The actual token contract, the default controller is the msg.sender
                                      ///  that deploys the contract, so usually this token will be deployed by a
                                      ///  token controller contract, which Giveth will call a "Campaign"
                                      contract MiniMeToken is Controlled {
                                      
                                          string public name;                //The Token's name: e.g. DigixDAO Tokens
                                          uint8 public decimals;             //Number of decimals of the smallest unit
                                          string public symbol;              //An identifier: e.g. REP
                                          string public version = "MMT_0.1"; //An arbitrary versioning scheme
                                      
                                      
                                          /// @dev `Checkpoint` is the structure that attaches a block number to a
                                          ///  given value, the block number attached is the one that last changed the
                                          ///  value
                                          struct Checkpoint {
                                      
                                              // `fromBlock` is the block number that the value was generated from
                                              uint128 fromBlock;
                                      
                                              // `value` is the amount of tokens at a specific block number
                                              uint128 value;
                                          }
                                      
                                          // `parentToken` is the Token address that was cloned to produce this token;
                                          //  it will be 0x0 for a token that was not cloned
                                          MiniMeToken public parentToken;
                                      
                                          // `parentSnapShotBlock` is the block number from the Parent Token that was
                                          //  used to determine the initial distribution of the Clone Token
                                          uint public parentSnapShotBlock;
                                      
                                          // `creationBlock` is the block number that the Clone Token was created
                                          uint public creationBlock;
                                      
                                          // `balances` is the map that tracks the balance of each address, in this
                                          //  contract when the balance changes the block number that the change
                                          //  occurred is also included in the map
                                          mapping (address => Checkpoint[]) balances;
                                      
                                          // `allowed` tracks any extra transfer rights as in all ERC20 tokens
                                          mapping (address => mapping (address => uint256)) allowed;
                                      
                                          // Tracks the history of the `totalSupply` of the token
                                          Checkpoint[] totalSupplyHistory;
                                      
                                          // Flag that determines if the token is transferable or not.
                                          bool public transfersEnabled;
                                      
                                          // The factory used to create new clone tokens
                                          MiniMeTokenFactory public tokenFactory;
                                      
                                      ////////////////
                                      // Constructor
                                      ////////////////
                                      
                                          /// @notice Constructor to create a MiniMeToken
                                          /// @param _tokenFactory The address of the MiniMeTokenFactory contract that
                                          ///  will create the Clone token contracts, the token factory needs to be
                                          ///  deployed first
                                          /// @param _parentToken Address of the parent token, set to 0x0 if it is a
                                          ///  new token
                                          /// @param _parentSnapShotBlock Block of the parent token that will
                                          ///  determine the initial distribution of the clone token, set to 0 if it
                                          ///  is a new token
                                          /// @param _tokenName Name of the new token
                                          /// @param _decimalUnits Number of decimals of the new token
                                          /// @param _tokenSymbol Token Symbol for the new token
                                          /// @param _transfersEnabled If true, tokens will be able to be transferred
                                          function MiniMeToken(
                                              MiniMeTokenFactory _tokenFactory,
                                              MiniMeToken _parentToken,
                                              uint _parentSnapShotBlock,
                                              string _tokenName,
                                              uint8 _decimalUnits,
                                              string _tokenSymbol,
                                              bool _transfersEnabled
                                          )  public
                                          {
                                              tokenFactory = _tokenFactory;
                                              name = _tokenName;                                 // Set the name
                                              decimals = _decimalUnits;                          // Set the decimals
                                              symbol = _tokenSymbol;                             // Set the symbol
                                              parentToken = _parentToken;
                                              parentSnapShotBlock = _parentSnapShotBlock;
                                              transfersEnabled = _transfersEnabled;
                                              creationBlock = block.number;
                                          }
                                      
                                      
                                      ///////////////////
                                      // ERC20 Methods
                                      ///////////////////
                                      
                                          /// @notice Send `_amount` tokens to `_to` from `msg.sender`
                                          /// @param _to The address of the recipient
                                          /// @param _amount The amount of tokens to be transferred
                                          /// @return Whether the transfer was successful or not
                                          function transfer(address _to, uint256 _amount) public returns (bool success) {
                                              require(transfersEnabled);
                                              return doTransfer(msg.sender, _to, _amount);
                                          }
                                      
                                          /// @notice Send `_amount` tokens to `_to` from `_from` on the condition it
                                          ///  is approved by `_from`
                                          /// @param _from The address holding the tokens being transferred
                                          /// @param _to The address of the recipient
                                          /// @param _amount The amount of tokens to be transferred
                                          /// @return True if the transfer was successful
                                          function transferFrom(address _from, address _to, uint256 _amount) public returns (bool success) {
                                      
                                              // The controller of this contract can move tokens around at will,
                                              //  this is important to recognize! Confirm that you trust the
                                              //  controller of this contract, which in most situations should be
                                              //  another open source smart contract or 0x0
                                              if (msg.sender != controller) {
                                                  require(transfersEnabled);
                                      
                                                  // The standard ERC 20 transferFrom functionality
                                                  if (allowed[_from][msg.sender] < _amount)
                                                      return false;
                                                  allowed[_from][msg.sender] -= _amount;
                                              }
                                              return doTransfer(_from, _to, _amount);
                                          }
                                      
                                          /// @dev This is the actual transfer function in the token contract, it can
                                          ///  only be called by other functions in this contract.
                                          /// @param _from The address holding the tokens being transferred
                                          /// @param _to The address of the recipient
                                          /// @param _amount The amount of tokens to be transferred
                                          /// @return True if the transfer was successful
                                          function doTransfer(address _from, address _to, uint _amount) internal returns(bool) {
                                              if (_amount == 0) {
                                                  return true;
                                              }
                                              require(parentSnapShotBlock < block.number);
                                              // Do not allow transfer to 0x0 or the token contract itself
                                              require((_to != 0) && (_to != address(this)));
                                              // If the amount being transfered is more than the balance of the
                                              //  account the transfer returns false
                                              var previousBalanceFrom = balanceOfAt(_from, block.number);
                                              if (previousBalanceFrom < _amount) {
                                                  return false;
                                              }
                                              // Alerts the token controller of the transfer
                                              if (isContract(controller)) {
                                                  // Adding the ` == true` makes the linter shut up so...
                                                  require(ITokenController(controller).onTransfer(_from, _to, _amount) == true);
                                              }
                                              // First update the balance array with the new value for the address
                                              //  sending the tokens
                                              updateValueAtNow(balances[_from], previousBalanceFrom - _amount);
                                              // Then update the balance array with the new value for the address
                                              //  receiving the tokens
                                              var previousBalanceTo = balanceOfAt(_to, block.number);
                                              require(previousBalanceTo + _amount >= previousBalanceTo); // Check for overflow
                                              updateValueAtNow(balances[_to], previousBalanceTo + _amount);
                                              // An event to make the transfer easy to find on the blockchain
                                              Transfer(_from, _to, _amount);
                                              return true;
                                          }
                                      
                                          /// @param _owner The address that's balance is being requested
                                          /// @return The balance of `_owner` at the current block
                                          function balanceOf(address _owner) public constant returns (uint256 balance) {
                                              return balanceOfAt(_owner, block.number);
                                          }
                                      
                                          /// @notice `msg.sender` approves `_spender` to spend `_amount` tokens on
                                          ///  its behalf. This is a modified version of the ERC20 approve function
                                          ///  to be a little bit safer
                                          /// @param _spender The address of the account able to transfer the tokens
                                          /// @param _amount The amount of tokens to be approved for transfer
                                          /// @return True if the approval was successful
                                          function approve(address _spender, uint256 _amount) public returns (bool success) {
                                              require(transfersEnabled);
                                      
                                              // To change the approve amount you first have to reduce the addresses`
                                              //  allowance to zero by calling `approve(_spender,0)` if it is not
                                              //  already 0 to mitigate the race condition described here:
                                              //  https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                                              require((_amount == 0) || (allowed[msg.sender][_spender] == 0));
                                      
                                              // Alerts the token controller of the approve function call
                                              if (isContract(controller)) {
                                                  // Adding the ` == true` makes the linter shut up so...
                                                  require(ITokenController(controller).onApprove(msg.sender, _spender, _amount) == true);
                                              }
                                      
                                              allowed[msg.sender][_spender] = _amount;
                                              Approval(msg.sender, _spender, _amount);
                                              return true;
                                          }
                                      
                                          /// @dev This function makes it easy to read the `allowed[]` map
                                          /// @param _owner The address of the account that owns the token
                                          /// @param _spender The address of the account able to transfer the tokens
                                          /// @return Amount of remaining tokens of _owner that _spender is allowed
                                          ///  to spend
                                          function allowance(address _owner, address _spender) public constant returns (uint256 remaining) {
                                              return allowed[_owner][_spender];
                                          }
                                      
                                          /// @notice `msg.sender` approves `_spender` to send `_amount` tokens on
                                          ///  its behalf, and then a function is triggered in the contract that is
                                          ///  being approved, `_spender`. This allows users to use their tokens to
                                          ///  interact with contracts in one function call instead of two
                                          /// @param _spender The address of the contract able to transfer the tokens
                                          /// @param _amount The amount of tokens to be approved for transfer
                                          /// @return True if the function call was successful
                                          function approveAndCall(ApproveAndCallFallBack _spender, uint256 _amount, bytes _extraData) public returns (bool success) {
                                              require(approve(_spender, _amount));
                                      
                                              _spender.receiveApproval(
                                                  msg.sender,
                                                  _amount,
                                                  this,
                                                  _extraData
                                              );
                                      
                                              return true;
                                          }
                                      
                                          /// @dev This function makes it easy to get the total number of tokens
                                          /// @return The total number of tokens
                                          function totalSupply() public constant returns (uint) {
                                              return totalSupplyAt(block.number);
                                          }
                                      
                                      
                                      ////////////////
                                      // Query balance and totalSupply in History
                                      ////////////////
                                      
                                          /// @dev Queries the balance of `_owner` at a specific `_blockNumber`
                                          /// @param _owner The address from which the balance will be retrieved
                                          /// @param _blockNumber The block number when the balance is queried
                                          /// @return The balance at `_blockNumber`
                                          function balanceOfAt(address _owner, uint _blockNumber) public constant returns (uint) {
                                      
                                              // These next few lines are used when the balance of the token is
                                              //  requested before a check point was ever created for this token, it
                                              //  requires that the `parentToken.balanceOfAt` be queried at the
                                              //  genesis block for that token as this contains initial balance of
                                              //  this token
                                              if ((balances[_owner].length == 0) || (balances[_owner][0].fromBlock > _blockNumber)) {
                                                  if (address(parentToken) != 0) {
                                                      return parentToken.balanceOfAt(_owner, min(_blockNumber, parentSnapShotBlock));
                                                  } else {
                                                      // Has no parent
                                                      return 0;
                                                  }
                                      
                                              // This will return the expected balance during normal situations
                                              } else {
                                                  return getValueAt(balances[_owner], _blockNumber);
                                              }
                                          }
                                      
                                          /// @notice Total amount of tokens at a specific `_blockNumber`.
                                          /// @param _blockNumber The block number when the totalSupply is queried
                                          /// @return The total amount of tokens at `_blockNumber`
                                          function totalSupplyAt(uint _blockNumber) public constant returns(uint) {
                                      
                                              // These next few lines are used when the totalSupply of the token is
                                              //  requested before a check point was ever created for this token, it
                                              //  requires that the `parentToken.totalSupplyAt` be queried at the
                                              //  genesis block for this token as that contains totalSupply of this
                                              //  token at this block number.
                                              if ((totalSupplyHistory.length == 0) || (totalSupplyHistory[0].fromBlock > _blockNumber)) {
                                                  if (address(parentToken) != 0) {
                                                      return parentToken.totalSupplyAt(min(_blockNumber, parentSnapShotBlock));
                                                  } else {
                                                      return 0;
                                                  }
                                      
                                              // This will return the expected totalSupply during normal situations
                                              } else {
                                                  return getValueAt(totalSupplyHistory, _blockNumber);
                                              }
                                          }
                                      
                                      ////////////////
                                      // Clone Token Method
                                      ////////////////
                                      
                                          /// @notice Creates a new clone token with the initial distribution being
                                          ///  this token at `_snapshotBlock`
                                          /// @param _cloneTokenName Name of the clone token
                                          /// @param _cloneDecimalUnits Number of decimals of the smallest unit
                                          /// @param _cloneTokenSymbol Symbol of the clone token
                                          /// @param _snapshotBlock Block when the distribution of the parent token is
                                          ///  copied to set the initial distribution of the new clone token;
                                          ///  if the block is zero than the actual block, the current block is used
                                          /// @param _transfersEnabled True if transfers are allowed in the clone
                                          /// @return The address of the new MiniMeToken Contract
                                          function createCloneToken(
                                              string _cloneTokenName,
                                              uint8 _cloneDecimalUnits,
                                              string _cloneTokenSymbol,
                                              uint _snapshotBlock,
                                              bool _transfersEnabled
                                          ) public returns(MiniMeToken)
                                          {
                                              uint256 snapshot = _snapshotBlock == 0 ? block.number - 1 : _snapshotBlock;
                                      
                                              MiniMeToken cloneToken = tokenFactory.createCloneToken(
                                                  this,
                                                  snapshot,
                                                  _cloneTokenName,
                                                  _cloneDecimalUnits,
                                                  _cloneTokenSymbol,
                                                  _transfersEnabled
                                              );
                                      
                                              cloneToken.changeController(msg.sender);
                                      
                                              // An event to make the token easy to find on the blockchain
                                              NewCloneToken(address(cloneToken), snapshot);
                                              return cloneToken;
                                          }
                                      
                                      ////////////////
                                      // Generate and destroy tokens
                                      ////////////////
                                      
                                          /// @notice Generates `_amount` tokens that are assigned to `_owner`
                                          /// @param _owner The address that will be assigned the new tokens
                                          /// @param _amount The quantity of tokens generated
                                          /// @return True if the tokens are generated correctly
                                          function generateTokens(address _owner, uint _amount) onlyController public returns (bool) {
                                              uint curTotalSupply = totalSupply();
                                              require(curTotalSupply + _amount >= curTotalSupply); // Check for overflow
                                              uint previousBalanceTo = balanceOf(_owner);
                                              require(previousBalanceTo + _amount >= previousBalanceTo); // Check for overflow
                                              updateValueAtNow(totalSupplyHistory, curTotalSupply + _amount);
                                              updateValueAtNow(balances[_owner], previousBalanceTo + _amount);
                                              Transfer(0, _owner, _amount);
                                              return true;
                                          }
                                      
                                      
                                          /// @notice Burns `_amount` tokens from `_owner`
                                          /// @param _owner The address that will lose the tokens
                                          /// @param _amount The quantity of tokens to burn
                                          /// @return True if the tokens are burned correctly
                                          function destroyTokens(address _owner, uint _amount) onlyController public returns (bool) {
                                              uint curTotalSupply = totalSupply();
                                              require(curTotalSupply >= _amount);
                                              uint previousBalanceFrom = balanceOf(_owner);
                                              require(previousBalanceFrom >= _amount);
                                              updateValueAtNow(totalSupplyHistory, curTotalSupply - _amount);
                                              updateValueAtNow(balances[_owner], previousBalanceFrom - _amount);
                                              Transfer(_owner, 0, _amount);
                                              return true;
                                          }
                                      
                                      ////////////////
                                      // Enable tokens transfers
                                      ////////////////
                                      
                                      
                                          /// @notice Enables token holders to transfer their tokens freely if true
                                          /// @param _transfersEnabled True if transfers are allowed in the clone
                                          function enableTransfers(bool _transfersEnabled) onlyController public {
                                              transfersEnabled = _transfersEnabled;
                                          }
                                      
                                      ////////////////
                                      // Internal helper functions to query and set a value in a snapshot array
                                      ////////////////
                                      
                                          /// @dev `getValueAt` retrieves the number of tokens at a given block number
                                          /// @param checkpoints The history of values being queried
                                          /// @param _block The block number to retrieve the value at
                                          /// @return The number of tokens being queried
                                          function getValueAt(Checkpoint[] storage checkpoints, uint _block) constant internal returns (uint) {
                                              if (checkpoints.length == 0)
                                                  return 0;
                                      
                                              // Shortcut for the actual value
                                              if (_block >= checkpoints[checkpoints.length-1].fromBlock)
                                                  return checkpoints[checkpoints.length-1].value;
                                              if (_block < checkpoints[0].fromBlock)
                                                  return 0;
                                      
                                              // Binary search of the value in the array
                                              uint min = 0;
                                              uint max = checkpoints.length-1;
                                              while (max > min) {
                                                  uint mid = (max + min + 1) / 2;
                                                  if (checkpoints[mid].fromBlock<=_block) {
                                                      min = mid;
                                                  } else {
                                                      max = mid-1;
                                                  }
                                              }
                                              return checkpoints[min].value;
                                          }
                                      
                                          /// @dev `updateValueAtNow` used to update the `balances` map and the
                                          ///  `totalSupplyHistory`
                                          /// @param checkpoints The history of data being updated
                                          /// @param _value The new number of tokens
                                          function updateValueAtNow(Checkpoint[] storage checkpoints, uint _value) internal {
                                              if ((checkpoints.length == 0) || (checkpoints[checkpoints.length - 1].fromBlock < block.number)) {
                                                  Checkpoint storage newCheckPoint = checkpoints[checkpoints.length++];
                                                  newCheckPoint.fromBlock = uint128(block.number);
                                                  newCheckPoint.value = uint128(_value);
                                              } else {
                                                  Checkpoint storage oldCheckPoint = checkpoints[checkpoints.length - 1];
                                                  oldCheckPoint.value = uint128(_value);
                                              }
                                          }
                                      
                                          /// @dev Internal function to determine if an address is a contract
                                          /// @param _addr The address being queried
                                          /// @return True if `_addr` is a contract
                                          function isContract(address _addr) constant internal returns(bool) {
                                              uint size;
                                              if (_addr == 0)
                                                  return false;
                                      
                                              assembly {
                                                  size := extcodesize(_addr)
                                              }
                                      
                                              return size>0;
                                          }
                                      
                                          /// @dev Helper function to return a min betwen the two uints
                                          function min(uint a, uint b) pure internal returns (uint) {
                                              return a < b ? a : b;
                                          }
                                      
                                          /// @notice The fallback function: If the contract's controller has not been
                                          ///  set to 0, then the `proxyPayment` method is called which relays the
                                          ///  ether and creates tokens as described in the token controller contract
                                          function () external payable {
                                              require(isContract(controller));
                                              // Adding the ` == true` makes the linter shut up so...
                                              require(ITokenController(controller).proxyPayment.value(msg.value)(msg.sender) == true);
                                          }
                                      
                                      //////////
                                      // Safety Methods
                                      //////////
                                      
                                          /// @notice This method can be used by the controller to extract mistakenly
                                          ///  sent tokens to this contract.
                                          /// @param _token The address of the token contract that you want to recover
                                          ///  set to 0 in case you want to extract ether.
                                          function claimTokens(address _token) onlyController public {
                                              if (_token == 0x0) {
                                                  controller.transfer(this.balance);
                                                  return;
                                              }
                                      
                                              MiniMeToken token = MiniMeToken(_token);
                                              uint balance = token.balanceOf(this);
                                              token.transfer(controller, balance);
                                              ClaimedTokens(_token, controller, balance);
                                          }
                                      
                                      ////////////////
                                      // Events
                                      ////////////////
                                          event ClaimedTokens(address indexed _token, address indexed _controller, uint _amount);
                                          event Transfer(address indexed _from, address indexed _to, uint256 _amount);
                                          event NewCloneToken(address indexed _cloneToken, uint _snapshotBlock);
                                          event Approval(
                                              address indexed _owner,
                                              address indexed _spender,
                                              uint256 _amount
                                              );
                                      
                                      }
                                      
                                      
                                      ////////////////
                                      // MiniMeTokenFactory
                                      ////////////////
                                      
                                      /// @dev This contract is used to generate clone contracts from a contract.
                                      ///  In solidity this is the way to create a contract from a contract of the
                                      ///  same class
                                      contract MiniMeTokenFactory {
                                      
                                          /// @notice Update the DApp by creating a new token with new functionalities
                                          ///  the msg.sender becomes the controller of this clone token
                                          /// @param _parentToken Address of the token being cloned
                                          /// @param _snapshotBlock Block of the parent token that will
                                          ///  determine the initial distribution of the clone token
                                          /// @param _tokenName Name of the new token
                                          /// @param _decimalUnits Number of decimals of the new token
                                          /// @param _tokenSymbol Token Symbol for the new token
                                          /// @param _transfersEnabled If true, tokens will be able to be transferred
                                          /// @return The address of the new token contract
                                          function createCloneToken(
                                              MiniMeToken _parentToken,
                                              uint _snapshotBlock,
                                              string _tokenName,
                                              uint8 _decimalUnits,
                                              string _tokenSymbol,
                                              bool _transfersEnabled
                                          ) public returns (MiniMeToken)
                                          {
                                              MiniMeToken newToken = new MiniMeToken(
                                                  this,
                                                  _parentToken,
                                                  _snapshotBlock,
                                                  _tokenName,
                                                  _decimalUnits,
                                                  _tokenSymbol,
                                                  _transfersEnabled
                                              );
                                      
                                              newToken.changeController(msg.sender);
                                              return newToken;
                                          }
                                      }
                                      
                                      // File: contracts/TokenManager.sol
                                      
                                      /*
                                       * SPDX-License-Identitifer:    GPL-3.0-or-later
                                       */
                                      
                                      /* solium-disable function-order */
                                      
                                      pragma solidity 0.4.24;
                                      
                                      
                                      
                                      
                                      
                                      
                                      
                                      contract TokenManager is ITokenController, IForwarder, AragonApp {
                                          using SafeMath for uint256;
                                      
                                          bytes32 public constant MINT_ROLE = keccak256("MINT_ROLE");
                                          bytes32 public constant ISSUE_ROLE = keccak256("ISSUE_ROLE");
                                          bytes32 public constant ASSIGN_ROLE = keccak256("ASSIGN_ROLE");
                                          bytes32 public constant REVOKE_VESTINGS_ROLE = keccak256("REVOKE_VESTINGS_ROLE");
                                          bytes32 public constant BURN_ROLE = keccak256("BURN_ROLE");
                                      
                                          uint256 public constant MAX_VESTINGS_PER_ADDRESS = 50;
                                      
                                          string private constant ERROR_CALLER_NOT_TOKEN = "TM_CALLER_NOT_TOKEN";
                                          string private constant ERROR_NO_VESTING = "TM_NO_VESTING";
                                          string private constant ERROR_TOKEN_CONTROLLER = "TM_TOKEN_CONTROLLER";
                                          string private constant ERROR_MINT_RECEIVER_IS_TM = "TM_MINT_RECEIVER_IS_TM";
                                          string private constant ERROR_VESTING_TO_TM = "TM_VESTING_TO_TM";
                                          string private constant ERROR_TOO_MANY_VESTINGS = "TM_TOO_MANY_VESTINGS";
                                          string private constant ERROR_WRONG_CLIFF_DATE = "TM_WRONG_CLIFF_DATE";
                                          string private constant ERROR_VESTING_NOT_REVOKABLE = "TM_VESTING_NOT_REVOKABLE";
                                          string private constant ERROR_REVOKE_TRANSFER_FROM_REVERTED = "TM_REVOKE_TRANSFER_FROM_REVERTED";
                                          string private constant ERROR_CAN_NOT_FORWARD = "TM_CAN_NOT_FORWARD";
                                          string private constant ERROR_BALANCE_INCREASE_NOT_ALLOWED = "TM_BALANCE_INC_NOT_ALLOWED";
                                          string private constant ERROR_ASSIGN_TRANSFER_FROM_REVERTED = "TM_ASSIGN_TRANSFER_FROM_REVERTED";
                                      
                                          struct TokenVesting {
                                              uint256 amount;
                                              uint64 start;
                                              uint64 cliff;
                                              uint64 vesting;
                                              bool revokable;
                                          }
                                      
                                          // Note that we COMPLETELY trust this MiniMeToken to not be malicious for proper operation of this contract
                                          MiniMeToken public token;
                                          uint256 public maxAccountTokens;
                                      
                                          // We are mimicing an array in the inner mapping, we use a mapping instead to make app upgrade more graceful
                                          mapping (address => mapping (uint256 => TokenVesting)) internal vestings;
                                          mapping (address => uint256) public vestingsLengths;
                                      
                                          // Other token specific events can be watched on the token address directly (avoids duplication)
                                          event NewVesting(address indexed receiver, uint256 vestingId, uint256 amount);
                                          event RevokeVesting(address indexed receiver, uint256 vestingId, uint256 nonVestedAmount);
                                      
                                          modifier onlyToken() {
                                              require(msg.sender == address(token), ERROR_CALLER_NOT_TOKEN);
                                              _;
                                          }
                                      
                                          modifier vestingExists(address _holder, uint256 _vestingId) {
                                              // TODO: it's not checking for gaps that may appear because of deletes in revokeVesting function
                                              require(_vestingId < vestingsLengths[_holder], ERROR_NO_VESTING);
                                              _;
                                          }
                                      
                                          /**
                                          * @notice Initialize Token Manager for `_token.symbol(): string`, whose tokens are `transferable ? 'not' : ''` transferable`_maxAccountTokens > 0 ? ' and limited to a maximum of ' + @tokenAmount(_token, _maxAccountTokens, false) + ' per account' : ''`
                                          * @param _token MiniMeToken address for the managed token (Token Manager instance must be already set as the token controller)
                                          * @param _transferable whether the token can be transferred by holders
                                          * @param _maxAccountTokens Maximum amount of tokens an account can have (0 for infinite tokens)
                                          */
                                          function initialize(
                                              MiniMeToken _token,
                                              bool _transferable,
                                              uint256 _maxAccountTokens
                                          )
                                              external
                                              onlyInit
                                          {
                                              initialized();
                                      
                                              require(_token.controller() == address(this), ERROR_TOKEN_CONTROLLER);
                                      
                                              token = _token;
                                              maxAccountTokens = _maxAccountTokens == 0 ? uint256(-1) : _maxAccountTokens;
                                      
                                              if (token.transfersEnabled() != _transferable) {
                                                  token.enableTransfers(_transferable);
                                              }
                                          }
                                      
                                          /**
                                          * @notice Mint `@tokenAmount(self.token(): address, _amount, false)` tokens for `_receiver`
                                          * @param _receiver The address receiving the tokens, cannot be the Token Manager itself (use `issue()` instead)
                                          * @param _amount Number of tokens minted
                                          */
                                          function mint(address _receiver, uint256 _amount) external authP(MINT_ROLE, arr(_receiver, _amount)) {
                                              require(_receiver != address(this), ERROR_MINT_RECEIVER_IS_TM);
                                              _mint(_receiver, _amount);
                                          }
                                      
                                          /**
                                          * @notice Mint `@tokenAmount(self.token(): address, _amount, false)` tokens for the Token Manager
                                          * @param _amount Number of tokens minted
                                          */
                                          function issue(uint256 _amount) external authP(ISSUE_ROLE, arr(_amount)) {
                                              _mint(address(this), _amount);
                                          }
                                      
                                          /**
                                          * @notice Assign `@tokenAmount(self.token(): address, _amount, false)` tokens to `_receiver` from the Token Manager's holdings
                                          * @param _receiver The address receiving the tokens
                                          * @param _amount Number of tokens transferred
                                          */
                                          function assign(address _receiver, uint256 _amount) external authP(ASSIGN_ROLE, arr(_receiver, _amount)) {
                                              _assign(_receiver, _amount);
                                          }
                                      
                                          /**
                                          * @notice Burn `@tokenAmount(self.token(): address, _amount, false)` tokens from `_holder`
                                          * @param _holder Holder of tokens being burned
                                          * @param _amount Number of tokens being burned
                                          */
                                          function burn(address _holder, uint256 _amount) external authP(BURN_ROLE, arr(_holder, _amount)) {
                                              // minime.destroyTokens() never returns false, only reverts on failure
                                              token.destroyTokens(_holder, _amount);
                                          }
                                      
                                          /**
                                          * @notice Assign `@tokenAmount(self.token(): address, _amount, false)` tokens to `_receiver` from the Token Manager's holdings with a `_revokable : 'revokable' : ''` vesting starting at `@formatDate(_start)`, cliff at `@formatDate(_cliff)` (first portion of tokens transferable), and completed vesting at `@formatDate(_vested)` (all tokens transferable)
                                          * @param _receiver The address receiving the tokens, cannot be Token Manager itself
                                          * @param _amount Number of tokens vested
                                          * @param _start Date the vesting calculations start
                                          * @param _cliff Date when the initial portion of tokens are transferable
                                          * @param _vested Date when all tokens are transferable
                                          * @param _revokable Whether the vesting can be revoked by the Token Manager
                                          */
                                          function assignVested(
                                              address _receiver,
                                              uint256 _amount,
                                              uint64 _start,
                                              uint64 _cliff,
                                              uint64 _vested,
                                              bool _revokable
                                          )
                                              external
                                              authP(ASSIGN_ROLE, arr(_receiver, _amount))
                                              returns (uint256)
                                          {
                                              require(_receiver != address(this), ERROR_VESTING_TO_TM);
                                              require(vestingsLengths[_receiver] < MAX_VESTINGS_PER_ADDRESS, ERROR_TOO_MANY_VESTINGS);
                                              require(_start <= _cliff && _cliff <= _vested, ERROR_WRONG_CLIFF_DATE);
                                      
                                              uint256 vestingId = vestingsLengths[_receiver]++;
                                              vestings[_receiver][vestingId] = TokenVesting(
                                                  _amount,
                                                  _start,
                                                  _cliff,
                                                  _vested,
                                                  _revokable
                                              );
                                      
                                              _assign(_receiver, _amount);
                                      
                                              emit NewVesting(_receiver, vestingId, _amount);
                                      
                                              return vestingId;
                                          }
                                      
                                          /**
                                          * @notice Revoke vesting #`_vestingId` from `_holder`, returning unvested tokens to the Token Manager
                                          * @param _holder Address whose vesting to revoke
                                          * @param _vestingId Numeric id of the vesting
                                          */
                                          function revokeVesting(address _holder, uint256 _vestingId)
                                              external
                                              authP(REVOKE_VESTINGS_ROLE, arr(_holder))
                                              vestingExists(_holder, _vestingId)
                                          {
                                              TokenVesting storage v = vestings[_holder][_vestingId];
                                              require(v.revokable, ERROR_VESTING_NOT_REVOKABLE);
                                      
                                              uint256 nonVested = _calculateNonVestedTokens(
                                                  v.amount,
                                                  getTimestamp(),
                                                  v.start,
                                                  v.cliff,
                                                  v.vesting
                                              );
                                      
                                              // To make vestingIds immutable over time, we just zero out the revoked vesting
                                              // Clearing this out also allows the token transfer back to the Token Manager to succeed
                                              delete vestings[_holder][_vestingId];
                                      
                                              // transferFrom always works as controller
                                              // onTransfer hook always allows if transfering to token controller
                                              require(token.transferFrom(_holder, address(this), nonVested), ERROR_REVOKE_TRANSFER_FROM_REVERTED);
                                      
                                              emit RevokeVesting(_holder, _vestingId, nonVested);
                                          }
                                      
                                          // ITokenController fns
                                          // `onTransfer()`, `onApprove()`, and `proxyPayment()` are callbacks from the MiniMe token
                                          // contract and are only meant to be called through the managed MiniMe token that gets assigned
                                          // during initialization.
                                      
                                          /*
                                          * @dev Notifies the controller about a token transfer allowing the controller to decide whether
                                          *      to allow it or react if desired (only callable from the token).
                                          *      Initialization check is implicitly provided by `onlyToken()`.
                                          * @param _from The origin of the transfer
                                          * @param _to The destination of the transfer
                                          * @param _amount The amount of the transfer
                                          * @return False if the controller does not authorize the transfer
                                          */
                                          function onTransfer(address _from, address _to, uint256 _amount) external onlyToken returns (bool) {
                                              return _isBalanceIncreaseAllowed(_to, _amount) && _transferableBalance(_from, getTimestamp()) >= _amount;
                                          }
                                      
                                          /**
                                          * @dev Notifies the controller about an approval allowing the controller to react if desired
                                          *      Initialization check is implicitly provided by `onlyToken()`.
                                          * @return False if the controller does not authorize the approval
                                          */
                                          function onApprove(address, address, uint) external onlyToken returns (bool) {
                                              return true;
                                          }
                                      
                                          /**
                                          * @dev Called when ether is sent to the MiniMe Token contract
                                          *      Initialization check is implicitly provided by `onlyToken()`.
                                          * @return True if the ether is accepted, false for it to throw
                                          */
                                          function proxyPayment(address) external payable onlyToken returns (bool) {
                                              return false;
                                          }
                                      
                                          // Forwarding fns
                                      
                                          function isForwarder() external pure returns (bool) {
                                              return true;
                                          }
                                      
                                          /**
                                          * @notice Execute desired action as a token holder
                                          * @dev IForwarder interface conformance. Forwards any token holder action.
                                          * @param _evmScript Script being executed
                                          */
                                          function forward(bytes _evmScript) public {
                                              require(canForward(msg.sender, _evmScript), ERROR_CAN_NOT_FORWARD);
                                              bytes memory input = new bytes(0); // TODO: Consider input for this
                                      
                                              // Add the managed token to the blacklist to disallow a token holder from executing actions
                                              // on the token controller's (this contract) behalf
                                              address[] memory blacklist = new address[](1);
                                              blacklist[0] = address(token);
                                      
                                              runScript(_evmScript, input, blacklist);
                                          }
                                      
                                          function canForward(address _sender, bytes) public view returns (bool) {
                                              return hasInitialized() && token.balanceOf(_sender) > 0;
                                          }
                                      
                                          // Getter fns
                                      
                                          function getVesting(
                                              address _recipient,
                                              uint256 _vestingId
                                          )
                                              public
                                              view
                                              vestingExists(_recipient, _vestingId)
                                              returns (
                                                  uint256 amount,
                                                  uint64 start,
                                                  uint64 cliff,
                                                  uint64 vesting,
                                                  bool revokable
                                              )
                                          {
                                              TokenVesting storage tokenVesting = vestings[_recipient][_vestingId];
                                              amount = tokenVesting.amount;
                                              start = tokenVesting.start;
                                              cliff = tokenVesting.cliff;
                                              vesting = tokenVesting.vesting;
                                              revokable = tokenVesting.revokable;
                                          }
                                      
                                          function spendableBalanceOf(address _holder) public view isInitialized returns (uint256) {
                                              return _transferableBalance(_holder, getTimestamp());
                                          }
                                      
                                          function transferableBalance(address _holder, uint256 _time) public view isInitialized returns (uint256) {
                                              return _transferableBalance(_holder, _time);
                                          }
                                      
                                          /**
                                          * @dev Disable recovery escape hatch for own token,
                                          *      as the it has the concept of issuing tokens without assigning them
                                          */
                                          function allowRecoverability(address _token) public view returns (bool) {
                                              return _token != address(token);
                                          }
                                      
                                          // Internal fns
                                      
                                          function _assign(address _receiver, uint256 _amount) internal {
                                              require(_isBalanceIncreaseAllowed(_receiver, _amount), ERROR_BALANCE_INCREASE_NOT_ALLOWED);
                                              // Must use transferFrom() as transfer() does not give the token controller full control
                                              require(token.transferFrom(address(this), _receiver, _amount), ERROR_ASSIGN_TRANSFER_FROM_REVERTED);
                                          }
                                      
                                          function _mint(address _receiver, uint256 _amount) internal {
                                              require(_isBalanceIncreaseAllowed(_receiver, _amount), ERROR_BALANCE_INCREASE_NOT_ALLOWED);
                                              token.generateTokens(_receiver, _amount); // minime.generateTokens() never returns false
                                          }
                                      
                                          function _isBalanceIncreaseAllowed(address _receiver, uint256 _inc) internal view returns (bool) {
                                              // Max balance doesn't apply to the token manager itself
                                              if (_receiver == address(this)) {
                                                  return true;
                                              }
                                              return token.balanceOf(_receiver).add(_inc) <= maxAccountTokens;
                                          }
                                      
                                          /**
                                          * @dev Calculate amount of non-vested tokens at a specifc time
                                          * @param tokens The total amount of tokens vested
                                          * @param time The time at which to check
                                          * @param start The date vesting started
                                          * @param cliff The cliff period
                                          * @param vested The fully vested date
                                          * @return The amount of non-vested tokens of a specific grant
                                          *  transferableTokens
                                          *   |                         _/--------   vestedTokens rect
                                          *   |                       _/
                                          *   |                     _/
                                          *   |                   _/
                                          *   |                 _/
                                          *   |                /
                                          *   |              .|
                                          *   |            .  |
                                          *   |          .    |
                                          *   |        .      |
                                          *   |      .        |
                                          *   |    .          |
                                          *   +===+===========+---------+----------> time
                                          *      Start       Cliff    Vested
                                          */
                                          function _calculateNonVestedTokens(
                                              uint256 tokens,
                                              uint256 time,
                                              uint256 start,
                                              uint256 cliff,
                                              uint256 vested
                                          )
                                              private
                                              pure
                                              returns (uint256)
                                          {
                                              // Shortcuts for before cliff and after vested cases.
                                              if (time >= vested) {
                                                  return 0;
                                              }
                                              if (time < cliff) {
                                                  return tokens;
                                              }
                                      
                                              // Interpolate all vested tokens.
                                              // As before cliff the shortcut returns 0, we can just calculate a value
                                              // in the vesting rect (as shown in above's figure)
                                      
                                              // vestedTokens = tokens * (time - start) / (vested - start)
                                              // In assignVesting we enforce start <= cliff <= vested
                                              // Here we shortcut time >= vested and time < cliff,
                                              // so no division by 0 is possible
                                              uint256 vestedTokens = tokens.mul(time.sub(start)) / vested.sub(start);
                                      
                                              // tokens - vestedTokens
                                              return tokens.sub(vestedTokens);
                                          }
                                      
                                          function _transferableBalance(address _holder, uint256 _time) internal view returns (uint256) {
                                              uint256 transferable = token.balanceOf(_holder);
                                      
                                              // This check is not strictly necessary for the current version of this contract, as
                                              // Token Managers now cannot assign vestings to themselves.
                                              // However, this was a possibility in the past, so in case there were vestings assigned to
                                              // themselves, this will still return the correct value (entire balance, as the Token
                                              // Manager does not have a spending limit on its own balance).
                                              if (_holder != address(this)) {
                                                  uint256 vestingsCount = vestingsLengths[_holder];
                                                  for (uint256 i = 0; i < vestingsCount; i++) {
                                                      TokenVesting storage v = vestings[_holder][i];
                                                      uint256 nonTransferable = _calculateNonVestedTokens(
                                                          v.amount,
                                                          _time,
                                                          v.start,
                                                          v.cliff,
                                                          v.vesting
                                                      );
                                                      transferable = transferable.sub(nonTransferable);
                                                  }
                                              }
                                      
                                              return transferable;
                                          }
                                      }