ETH Price: $2,923.97 (+0.09%)

Transaction Decoder

Block:
13895251 at Dec-28-2021 06:07:18 PM +UTC
Transaction Fee:
0.01738251164021735 ETH $50.83
Gas Used:
110,770 Gas / 156.924362555 Gwei

Account State Difference:

  Address   Before After State Difference Code
0xbF9257ea...18Ce30BFA
1.914008914512853141 Eth
Nonce: 5
1.896626402872635791 Eth
Nonce: 6
0.01738251164021735
(Ethermine)
2,041.142350632180900236 Eth2,041.142627557180900236 Eth0.000276925

Execution Trace

GnosisSafeProxy.6a761202( )
  • GnosisSafe.execTransaction( to=0x7Be8076f4EA4A4AD08075C2508e481d6C946D12b, value=3750000000000000000, data=0xAB834BAB0000000000000000000000007BE8076F4EA4A4AD08075C2508E481D6C946D12B000000000000000000000000DC4A23D309B5030B57713D6C4A5CEB7CDC6B927D00000000000000000000000026B350F462AE30EC1C48C36BA944AB66F06DAFEE0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000F87E31492FAF9A91B02EE0DEAAD50D51D56D5D4D000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007BE8076F4EA4A4AD08075C2508E481D6C946D12B00000000000000000000000026B350F462AE30EC1C48C36BA944AB66F06DAFEE00000000000000000000000000000000000000000000000000000000000000000000000000000000000000005B3256965E7C3CF26E11FCAF296DFC8807C01073000000000000000000000000F87E31492FAF9A91B02EE0DEAAD50D51D56D5D4D0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000FA000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000340AAD21B3B7000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000061CB4CA80000000000000000000000000000000000000000000000000000000000000000DAB6108B4DD134693F390F15E3C130E61C2EC160739E5CF8EC1D4C8527C79F4900000000000000000000000000000000000000000000000000000000000000FA000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000340AAD21B3B7000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000061CB31FB0000000000000000000000000000000000000000000000000000000062B1D8880CF453273210079E4C808499D5ACDD2213254FC8350CED00F955696D113809F90000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006A0000000000000000000000000000000000000000000000000000000000000074000000000000000000000000000000000000000000000000000000000000007E0000000000000000000000000000000000000000000000000000000000000088000000000000000000000000000000000000000000000000000000000000009200000000000000000000000000000000000000000000000000000000000000940000000000000000000000000000000000000000000000000000000000000001C000000000000000000000000000000000000000000000000000000000000001C057980C8247E00A8E8EDA9990DB98C1AA6A4DFF05F351F14500BD4018210361838EDD50A51663FD8FEFFB380EE2EF397BE11608B98ADF9904EACE0CF998C8551057980C8247E00A8E8EDA9990DB98C1AA6A4DFF05F351F14500BD4018210361838EDD50A51663FD8FEFFB380EE2EF397BE11608B98ADF9904EACE0CF998C85510000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006423B872DD0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000DC4A23D309B5030B57713D6C4A5CEB7CDC6B927D0000000000000000000000000000000E0000000000000000000000000000009600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006423B872DD00000000000000000000000026B350F462AE30EC1C48C36BA944AB66F06DAFEE00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000E0000000000000000000000000000009600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006400000000FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000064000000000000000000000000000000000000000000000000000000000000000000000000FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000, operation=0, safeTxGas=0, baseGas=0, gasPrice=0, gasToken=0x0000000000000000000000000000000000000000, refundReceiver=0x0000000000000000000000000000000000000000, signatures=0x000000000000000000000000BF9257EA392ED90E776F1F61EF2E45D18CE30BFA0000000000000000000000000000000000000000000000000000000000000000015DE64B0E6F08837C8E84D9D693F0862758E58117DC41D5F5F0799904FE8783A5408D8EEFAED9720A0F4ED4C781FB8E4A9FF33F08B91A8F3CE1982F943882191C1B )
    • Null: 0x000...001.6068ad1d( )
    • ETH 3.75 WyvernExchange.atomicMatch_( addrs=[0x7Be8076f4EA4A4AD08075C2508e481d6C946D12b, 0xDc4A23d309B5030b57713D6C4a5ceb7cDC6B927d, 0x26b350F462Ae30EC1c48c36ba944AB66F06dAFee, 0x0000000000000000000000000000000000000000, 0xF87E31492Faf9A91B02Ee0dEAAd50d51d56D5d4d, 0x0000000000000000000000000000000000000000, 0x0000000000000000000000000000000000000000, 0x7Be8076f4EA4A4AD08075C2508e481d6C946D12b, 0x26b350F462Ae30EC1c48c36ba944AB66F06dAFee, 0x0000000000000000000000000000000000000000, 0x5b3256965e7C3cF26E11FCAf296DfC8807C01073, 0xF87E31492Faf9A91B02Ee0dEAAd50d51d56D5d4d, 0x0000000000000000000000000000000000000000, 0x0000000000000000000000000000000000000000], uints=[250, 0, 0, 0, 3750000000000000000, 0, 1640713384, 0, 98925881340510982289351498220658216526926403118411119082323455224897264394057, 250, 0, 0, 0, 3750000000000000000, 0, 1640706555, 1655822472, 5859438768462034916448875906218483111965253319405206358899037455587625929209], feeMethodsSidesKindsHowToCalls=[1, 0, 0, 0, 1, 1, 0, 0], calldataBuy=0x23B872DD0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000DC4A23D309B5030B57713D6C4A5CEB7CDC6B927D0000000000000000000000000000000E00000000000000000000000000000096, calldataSell=0x23B872DD00000000000000000000000026B350F462AE30EC1C48C36BA944AB66F06DAFEE00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000E00000000000000000000000000000096, replacementPatternBuy=0x00000000FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000, replacementPatternSell=0x000000000000000000000000000000000000000000000000000000000000000000000000FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF0000000000000000000000000000000000000000000000000000000000000000, staticExtradataBuy=0x, staticExtradataSell=0x, vs=[28, 28], rssMetadata=[BXmAyCR+AKjo7amZDbmMGqak3/BfNR8UUAvUAYIQNhg=, OO3VClFmP9j+/7OA7i7zl74RYIuYrfmQTqzgz5mMhVE=, BXmAyCR+AKjo7amZDbmMGqak3/BfNR8UUAvUAYIQNhg=, OO3VClFmP9j+/7OA7i7zl74RYIuYrfmQTqzgz5mMhVE=, AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=] )
      • Null: 0x000...001.919b3d8d( )
        File 1 of 3: GnosisSafeProxy
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        
        /// @title IProxy - Helper interface to access masterCopy of the Proxy on-chain
        /// @author Richard Meissner - <[email protected]>
        interface IProxy {
            function masterCopy() external view returns (address);
        }
        
        /// @title GnosisSafeProxy - 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 GnosisSafeProxy {
            // singleton 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 singleton;
        
            /// @dev Constructor function sets address of singleton contract.
            /// @param _singleton Singleton address.
            constructor(address _singleton) {
                require(_singleton != address(0), "Invalid singleton address provided");
                singleton = _singleton;
            }
        
            /// @dev Fallback function forwards all transactions and returns all received return data.
            fallback() external payable {
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    let _singleton := and(sload(0), 0xffffffffffffffffffffffffffffffffffffffff)
                    // 0xa619486e == keccak("masterCopy()"). The value is right padded to 32-bytes with 0s
                    if eq(calldataload(0), 0xa619486e00000000000000000000000000000000000000000000000000000000) {
                        mstore(0, _singleton)
                        return(0, 0x20)
                    }
                    calldatacopy(0, 0, calldatasize())
                    let success := delegatecall(gas(), _singleton, 0, calldatasize(), 0, 0)
                    returndatacopy(0, 0, returndatasize())
                    if eq(success, 0) {
                        revert(0, returndatasize())
                    }
                    return(0, returndatasize())
                }
            }
        }
        
        /// @title Proxy Factory - Allows to create new proxy contact and execute a message call to the new proxy within one transaction.
        /// @author Stefan George - <[email protected]>
        contract GnosisSafeProxyFactory {
            event ProxyCreation(GnosisSafeProxy proxy, address singleton);
        
            /// @dev Allows to create new proxy contact and execute a message call to the new proxy within one transaction.
            /// @param singleton Address of singleton contract.
            /// @param data Payload for message call sent to new proxy contract.
            function createProxy(address singleton, bytes memory data) public returns (GnosisSafeProxy proxy) {
                proxy = new GnosisSafeProxy(singleton);
                if (data.length > 0)
                    // solhint-disable-next-line no-inline-assembly
                    assembly {
                        if eq(call(gas(), proxy, 0, add(data, 0x20), mload(data), 0, 0), 0) {
                            revert(0, 0)
                        }
                    }
                emit ProxyCreation(proxy, singleton);
            }
        
            /// @dev Allows to retrieve the runtime code of a deployed Proxy. This can be used to check that the expected Proxy was deployed.
            function proxyRuntimeCode() public pure returns (bytes memory) {
                return type(GnosisSafeProxy).runtimeCode;
            }
        
            /// @dev Allows to retrieve the creation code used for the Proxy deployment. With this it is easily possible to calculate predicted address.
            function proxyCreationCode() public pure returns (bytes memory) {
                return type(GnosisSafeProxy).creationCode;
            }
        
            /// @dev Allows to create new proxy contact using CREATE2 but it doesn't run the initializer.
            ///      This method is only meant as an utility to be called from other methods
            /// @param _singleton Address of singleton contract.
            /// @param initializer Payload for message call sent to new proxy contract.
            /// @param saltNonce Nonce that will be used to generate the salt to calculate the address of the new proxy contract.
            function deployProxyWithNonce(
                address _singleton,
                bytes memory initializer,
                uint256 saltNonce
            ) internal returns (GnosisSafeProxy proxy) {
                // If the initializer changes the proxy address should change too. Hashing the initializer data is cheaper than just concatinating it
                bytes32 salt = keccak256(abi.encodePacked(keccak256(initializer), saltNonce));
                bytes memory deploymentData = abi.encodePacked(type(GnosisSafeProxy).creationCode, uint256(uint160(_singleton)));
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    proxy := create2(0x0, add(0x20, deploymentData), mload(deploymentData), salt)
                }
                require(address(proxy) != address(0), "Create2 call failed");
            }
        
            /// @dev Allows to create new proxy contact and execute a message call to the new proxy within one transaction.
            /// @param _singleton Address of singleton contract.
            /// @param initializer Payload for message call sent to new proxy contract.
            /// @param saltNonce Nonce that will be used to generate the salt to calculate the address of the new proxy contract.
            function createProxyWithNonce(
                address _singleton,
                bytes memory initializer,
                uint256 saltNonce
            ) public returns (GnosisSafeProxy proxy) {
                proxy = deployProxyWithNonce(_singleton, initializer, saltNonce);
                if (initializer.length > 0)
                    // solhint-disable-next-line no-inline-assembly
                    assembly {
                        if eq(call(gas(), proxy, 0, add(initializer, 0x20), mload(initializer), 0, 0), 0) {
                            revert(0, 0)
                        }
                    }
                emit ProxyCreation(proxy, _singleton);
            }
        
            /// @dev Allows to create new proxy contact, execute a message call to the new proxy and call a specified callback within one transaction
            /// @param _singleton Address of singleton contract.
            /// @param initializer Payload for message call sent to new proxy contract.
            /// @param saltNonce Nonce that will be used to generate the salt to calculate the address of the new proxy contract.
            /// @param callback Callback that will be invoced after the new proxy contract has been successfully deployed and initialized.
            function createProxyWithCallback(
                address _singleton,
                bytes memory initializer,
                uint256 saltNonce,
                IProxyCreationCallback callback
            ) public returns (GnosisSafeProxy proxy) {
                uint256 saltNonceWithCallback = uint256(keccak256(abi.encodePacked(saltNonce, callback)));
                proxy = createProxyWithNonce(_singleton, initializer, saltNonceWithCallback);
                if (address(callback) != address(0)) callback.proxyCreated(proxy, _singleton, initializer, saltNonce);
            }
        
            /// @dev Allows to get the address for a new proxy contact created via `createProxyWithNonce`
            ///      This method is only meant for address calculation purpose when you use an initializer that would revert,
            ///      therefore the response is returned with a revert. When calling this method set `from` to the address of the proxy factory.
            /// @param _singleton Address of singleton contract.
            /// @param initializer Payload for message call sent to new proxy contract.
            /// @param saltNonce Nonce that will be used to generate the salt to calculate the address of the new proxy contract.
            function calculateCreateProxyWithNonceAddress(
                address _singleton,
                bytes calldata initializer,
                uint256 saltNonce
            ) external returns (GnosisSafeProxy proxy) {
                proxy = deployProxyWithNonce(_singleton, initializer, saltNonce);
                revert(string(abi.encodePacked(proxy)));
            }
        }
        
        interface IProxyCreationCallback {
            function proxyCreated(
                GnosisSafeProxy proxy,
                address _singleton,
                bytes calldata initializer,
                uint256 saltNonce
            ) external;
        }

        File 2 of 3: GnosisSafe
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        import "./base/ModuleManager.sol";
        import "./base/OwnerManager.sol";
        import "./base/FallbackManager.sol";
        import "./base/GuardManager.sol";
        import "./common/EtherPaymentFallback.sol";
        import "./common/Singleton.sol";
        import "./common/SignatureDecoder.sol";
        import "./common/SecuredTokenTransfer.sol";
        import "./common/StorageAccessible.sol";
        import "./interfaces/ISignatureValidator.sol";
        import "./external/GnosisSafeMath.sol";
        /// @title Gnosis Safe - A multisignature wallet with support for confirmations using signed messages based on ERC191.
        /// @author Stefan George - <[email protected]>
        /// @author Richard Meissner - <[email protected]>
        contract GnosisSafe is
            EtherPaymentFallback,
            Singleton,
            ModuleManager,
            OwnerManager,
            SignatureDecoder,
            SecuredTokenTransfer,
            ISignatureValidatorConstants,
            FallbackManager,
            StorageAccessible,
            GuardManager
        {
            using GnosisSafeMath for uint256;
            string public constant VERSION = "1.3.0";
            // keccak256(
            //     "EIP712Domain(uint256 chainId,address verifyingContract)"
            // );
            bytes32 private constant DOMAIN_SEPARATOR_TYPEHASH = 0x47e79534a245952e8b16893a336b85a3d9ea9fa8c573f3d803afb92a79469218;
            // keccak256(
            //     "SafeTx(address to,uint256 value,bytes data,uint8 operation,uint256 safeTxGas,uint256 baseGas,uint256 gasPrice,address gasToken,address refundReceiver,uint256 nonce)"
            // );
            bytes32 private constant SAFE_TX_TYPEHASH = 0xbb8310d486368db6bd6f849402fdd73ad53d316b5a4b2644ad6efe0f941286d8;
            event SafeSetup(address indexed initiator, address[] owners, uint256 threshold, address initializer, address fallbackHandler);
            event ApproveHash(bytes32 indexed approvedHash, address indexed owner);
            event SignMsg(bytes32 indexed msgHash);
            event ExecutionFailure(bytes32 txHash, uint256 payment);
            event ExecutionSuccess(bytes32 txHash, uint256 payment);
            uint256 public nonce;
            bytes32 private _deprecatedDomainSeparator;
            // Mapping to keep track of all message hashes that have been approve by ALL REQUIRED owners
            mapping(bytes32 => uint256) public signedMessages;
            // Mapping to keep track of all hashes (message or transaction) that have been approve by ANY owners
            mapping(address => mapping(bytes32 => uint256)) public approvedHashes;
            // This constructor ensures that this contract can only be used as a master copy for Proxy contracts
            constructor() {
                // By setting the threshold it is not possible to call setup anymore,
                // so we create a Safe with 0 owners and threshold 1.
                // This is an unusable Safe, perfect for the singleton
                threshold = 1;
            }
            /// @dev Setup function sets initial storage of contract.
            /// @param _owners List of Safe owners.
            /// @param _threshold Number of required confirmations for a Safe transaction.
            /// @param to Contract address for optional delegate call.
            /// @param data Data payload for optional delegate call.
            /// @param fallbackHandler Handler for fallback calls to this contract
            /// @param paymentToken Token that should be used for the payment (0 is ETH)
            /// @param payment Value that should be paid
            /// @param paymentReceiver Adddress that should receive the payment (or 0 if tx.origin)
            function setup(
                address[] calldata _owners,
                uint256 _threshold,
                address to,
                bytes calldata data,
                address fallbackHandler,
                address paymentToken,
                uint256 payment,
                address payable paymentReceiver
            ) external {
                // setupOwners checks if the Threshold is already set, therefore preventing that this method is called twice
                setupOwners(_owners, _threshold);
                if (fallbackHandler != address(0)) internalSetFallbackHandler(fallbackHandler);
                // As setupOwners can only be called if the contract has not been initialized we don't need a check for setupModules
                setupModules(to, data);
                if (payment > 0) {
                    // To avoid running into issues with EIP-170 we reuse the handlePayment function (to avoid adjusting code of that has been verified we do not adjust the method itself)
                    // baseGas = 0, gasPrice = 1 and gas = payment => amount = (payment + 0) * 1 = payment
                    handlePayment(payment, 0, 1, paymentToken, paymentReceiver);
                }
                emit SafeSetup(msg.sender, _owners, _threshold, to, fallbackHandler);
            }
            /// @dev Allows to execute a Safe transaction confirmed by required number of owners and then pays the account that submitted the transaction.
            ///      Note: The fees are always transferred, even if the user transaction fails.
            /// @param to Destination address of Safe transaction.
            /// @param value Ether value of Safe transaction.
            /// @param data Data payload of Safe transaction.
            /// @param operation Operation type of Safe transaction.
            /// @param safeTxGas Gas that should be used for the Safe transaction.
            /// @param baseGas Gas costs that are independent of the transaction execution(e.g. base transaction fee, signature check, payment of the refund)
            /// @param gasPrice Gas price that should be used for the payment calculation.
            /// @param gasToken Token address (or 0 if ETH) that is used for the payment.
            /// @param refundReceiver Address of receiver of gas payment (or 0 if tx.origin).
            /// @param signatures Packed signature data ({bytes32 r}{bytes32 s}{uint8 v})
            function execTransaction(
                address to,
                uint256 value,
                bytes calldata data,
                Enum.Operation operation,
                uint256 safeTxGas,
                uint256 baseGas,
                uint256 gasPrice,
                address gasToken,
                address payable refundReceiver,
                bytes memory signatures
            ) public payable virtual returns (bool success) {
                bytes32 txHash;
                // Use scope here to limit variable lifetime and prevent `stack too deep` errors
                {
                    bytes memory txHashData =
                        encodeTransactionData(
                            // Transaction info
                            to,
                            value,
                            data,
                            operation,
                            safeTxGas,
                            // Payment info
                            baseGas,
                            gasPrice,
                            gasToken,
                            refundReceiver,
                            // Signature info
                            nonce
                        );
                    // Increase nonce and execute transaction.
                    nonce++;
                    txHash = keccak256(txHashData);
                    checkSignatures(txHash, txHashData, signatures);
                }
                address guard = getGuard();
                {
                    if (guard != address(0)) {
                        Guard(guard).checkTransaction(
                            // Transaction info
                            to,
                            value,
                            data,
                            operation,
                            safeTxGas,
                            // Payment info
                            baseGas,
                            gasPrice,
                            gasToken,
                            refundReceiver,
                            // Signature info
                            signatures,
                            msg.sender
                        );
                    }
                }
                // We require some gas to emit the events (at least 2500) after the execution and some to perform code until the execution (500)
                // We also include the 1/64 in the check that is not send along with a call to counteract potential shortings because of EIP-150
                require(gasleft() >= ((safeTxGas * 64) / 63).max(safeTxGas + 2500) + 500, "GS010");
                // Use scope here to limit variable lifetime and prevent `stack too deep` errors
                {
                    uint256 gasUsed = gasleft();
                    // If the gasPrice is 0 we assume that nearly all available gas can be used (it is always more than safeTxGas)
                    // We only substract 2500 (compared to the 3000 before) to ensure that the amount passed is still higher than safeTxGas
                    success = execute(to, value, data, operation, gasPrice == 0 ? (gasleft() - 2500) : safeTxGas);
                    gasUsed = gasUsed.sub(gasleft());
                    // If no safeTxGas and no gasPrice was set (e.g. both are 0), then the internal tx is required to be successful
                    // This makes it possible to use `estimateGas` without issues, as it searches for the minimum gas where the tx doesn't revert
                    require(success || safeTxGas != 0 || gasPrice != 0, "GS013");
                    // We transfer the calculated tx costs to the tx.origin to avoid sending it to intermediate contracts that have made calls
                    uint256 payment = 0;
                    if (gasPrice > 0) {
                        payment = handlePayment(gasUsed, baseGas, gasPrice, gasToken, refundReceiver);
                    }
                    if (success) emit ExecutionSuccess(txHash, payment);
                    else emit ExecutionFailure(txHash, payment);
                }
                {
                    if (guard != address(0)) {
                        Guard(guard).checkAfterExecution(txHash, success);
                    }
                }
            }
            function handlePayment(
                uint256 gasUsed,
                uint256 baseGas,
                uint256 gasPrice,
                address gasToken,
                address payable refundReceiver
            ) private returns (uint256 payment) {
                // solhint-disable-next-line avoid-tx-origin
                address payable receiver = refundReceiver == address(0) ? payable(tx.origin) : refundReceiver;
                if (gasToken == address(0)) {
                    // For ETH we will only adjust the gas price to not be higher than the actual used gas price
                    payment = gasUsed.add(baseGas).mul(gasPrice < tx.gasprice ? gasPrice : tx.gasprice);
                    require(receiver.send(payment), "GS011");
                } else {
                    payment = gasUsed.add(baseGas).mul(gasPrice);
                    require(transferToken(gasToken, receiver, payment), "GS012");
                }
            }
            /**
             * @dev Checks whether the signature provided is valid for the provided data, hash. Will revert otherwise.
             * @param dataHash Hash of the data (could be either a message hash or transaction hash)
             * @param data That should be signed (this is passed to an external validator contract)
             * @param signatures Signature data that should be verified. Can be ECDSA signature, contract signature (EIP-1271) or approved hash.
             */
            function checkSignatures(
                bytes32 dataHash,
                bytes memory data,
                bytes memory signatures
            ) public view {
                // Load threshold to avoid multiple storage loads
                uint256 _threshold = threshold;
                // Check that a threshold is set
                require(_threshold > 0, "GS001");
                checkNSignatures(dataHash, data, signatures, _threshold);
            }
            /**
             * @dev Checks whether the signature provided is valid for the provided data, hash. Will revert otherwise.
             * @param dataHash Hash of the data (could be either a message hash or transaction hash)
             * @param data That should be signed (this is passed to an external validator contract)
             * @param signatures Signature data that should be verified. Can be ECDSA signature, contract signature (EIP-1271) or approved hash.
             * @param requiredSignatures Amount of required valid signatures.
             */
            function checkNSignatures(
                bytes32 dataHash,
                bytes memory data,
                bytes memory signatures,
                uint256 requiredSignatures
            ) public view {
                // Check that the provided signature data is not too short
                require(signatures.length >= requiredSignatures.mul(65), "GS020");
                // There cannot be an owner with address 0.
                address lastOwner = address(0);
                address currentOwner;
                uint8 v;
                bytes32 r;
                bytes32 s;
                uint256 i;
                for (i = 0; i < requiredSignatures; i++) {
                    (v, r, s) = signatureSplit(signatures, i);
                    if (v == 0) {
                        // If v is 0 then it is a contract signature
                        // When handling contract signatures the address of the contract is encoded into r
                        currentOwner = address(uint160(uint256(r)));
                        // Check that signature data pointer (s) is not pointing inside the static part of the signatures bytes
                        // This check is not completely accurate, since it is possible that more signatures than the threshold are send.
                        // Here we only check that the pointer is not pointing inside the part that is being processed
                        require(uint256(s) >= requiredSignatures.mul(65), "GS021");
                        // Check that signature data pointer (s) is in bounds (points to the length of data -> 32 bytes)
                        require(uint256(s).add(32) <= signatures.length, "GS022");
                        // Check if the contract signature is in bounds: start of data is s + 32 and end is start + signature length
                        uint256 contractSignatureLen;
                        // solhint-disable-next-line no-inline-assembly
                        assembly {
                            contractSignatureLen := mload(add(add(signatures, s), 0x20))
                        }
                        require(uint256(s).add(32).add(contractSignatureLen) <= signatures.length, "GS023");
                        // Check signature
                        bytes memory contractSignature;
                        // solhint-disable-next-line no-inline-assembly
                        assembly {
                            // The signature data for contract signatures is appended to the concatenated signatures and the offset is stored in s
                            contractSignature := add(add(signatures, s), 0x20)
                        }
                        require(ISignatureValidator(currentOwner).isValidSignature(data, contractSignature) == EIP1271_MAGIC_VALUE, "GS024");
                    } else if (v == 1) {
                        // If v is 1 then it is an approved hash
                        // When handling approved hashes the address of the approver is encoded into r
                        currentOwner = address(uint160(uint256(r)));
                        // Hashes are automatically approved by the sender of the message or when they have been pre-approved via a separate transaction
                        require(msg.sender == currentOwner || approvedHashes[currentOwner][dataHash] != 0, "GS025");
                    } else if (v > 30) {
                        // If v > 30 then default va (27,28) has been adjusted for eth_sign flow
                        // To support eth_sign and similar we adjust v and hash the messageHash with the Ethereum message prefix before applying ecrecover
                        currentOwner = ecrecover(keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
        32", dataHash)), v - 4, r, s);
                    } else {
                        // Default is the ecrecover flow with the provided data hash
                        // Use ecrecover with the messageHash for EOA signatures
                        currentOwner = ecrecover(dataHash, v, r, s);
                    }
                    require(currentOwner > lastOwner && owners[currentOwner] != address(0) && currentOwner != SENTINEL_OWNERS, "GS026");
                    lastOwner = currentOwner;
                }
            }
            /// @dev Allows to estimate a Safe transaction.
            ///      This method is only meant for estimation purpose, therefore the call will always revert and encode the result in the revert data.
            ///      Since the `estimateGas` function includes refunds, call this method to get an estimated of the costs that are deducted from the safe with `execTransaction`
            /// @param to Destination address of Safe transaction.
            /// @param value Ether value of Safe transaction.
            /// @param data Data payload of Safe transaction.
            /// @param operation Operation type of Safe transaction.
            /// @return Estimate without refunds and overhead fees (base transaction and payload data gas costs).
            /// @notice Deprecated in favor of common/StorageAccessible.sol and will be removed in next version.
            function requiredTxGas(
                address to,
                uint256 value,
                bytes calldata data,
                Enum.Operation operation
            ) external returns (uint256) {
                uint256 startGas = gasleft();
                // We don't provide an error message here, as we use it to return the estimate
                require(execute(to, value, data, operation, gasleft()));
                uint256 requiredGas = startGas - gasleft();
                // Convert response to string and return via error message
                revert(string(abi.encodePacked(requiredGas)));
            }
            /**
             * @dev Marks a hash as approved. This can be used to validate a hash that is used by a signature.
             * @param hashToApprove The hash that should be marked as approved for signatures that are verified by this contract.
             */
            function approveHash(bytes32 hashToApprove) external {
                require(owners[msg.sender] != address(0), "GS030");
                approvedHashes[msg.sender][hashToApprove] = 1;
                emit ApproveHash(hashToApprove, msg.sender);
            }
            /// @dev Returns the chain id used by this contract.
            function getChainId() public view returns (uint256) {
                uint256 id;
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    id := chainid()
                }
                return id;
            }
            function domainSeparator() public view returns (bytes32) {
                return keccak256(abi.encode(DOMAIN_SEPARATOR_TYPEHASH, getChainId(), this));
            }
            /// @dev Returns the bytes that are hashed to be signed by owners.
            /// @param to Destination address.
            /// @param value Ether value.
            /// @param data Data payload.
            /// @param operation Operation type.
            /// @param safeTxGas Gas that should be used for the safe transaction.
            /// @param baseGas Gas costs for that are independent of the transaction execution(e.g. base transaction fee, signature check, payment of the refund)
            /// @param gasPrice Maximum gas price that should be used for this transaction.
            /// @param gasToken Token address (or 0 if ETH) that is used for the payment.
            /// @param refundReceiver Address of receiver of gas payment (or 0 if tx.origin).
            /// @param _nonce Transaction nonce.
            /// @return Transaction hash bytes.
            function encodeTransactionData(
                address to,
                uint256 value,
                bytes calldata data,
                Enum.Operation operation,
                uint256 safeTxGas,
                uint256 baseGas,
                uint256 gasPrice,
                address gasToken,
                address refundReceiver,
                uint256 _nonce
            ) public view returns (bytes memory) {
                bytes32 safeTxHash =
                    keccak256(
                        abi.encode(
                            SAFE_TX_TYPEHASH,
                            to,
                            value,
                            keccak256(data),
                            operation,
                            safeTxGas,
                            baseGas,
                            gasPrice,
                            gasToken,
                            refundReceiver,
                            _nonce
                        )
                    );
                return abi.encodePacked(bytes1(0x19), bytes1(0x01), domainSeparator(), safeTxHash);
            }
            /// @dev Returns hash to be signed by owners.
            /// @param to Destination address.
            /// @param value Ether value.
            /// @param data Data payload.
            /// @param operation Operation type.
            /// @param safeTxGas Fas that should be used for the safe transaction.
            /// @param baseGas Gas costs for data used to trigger the safe transaction.
            /// @param gasPrice Maximum gas price that should be used for this transaction.
            /// @param gasToken Token address (or 0 if ETH) that is used for the payment.
            /// @param refundReceiver Address of receiver of gas payment (or 0 if tx.origin).
            /// @param _nonce Transaction nonce.
            /// @return Transaction hash.
            function getTransactionHash(
                address to,
                uint256 value,
                bytes calldata data,
                Enum.Operation operation,
                uint256 safeTxGas,
                uint256 baseGas,
                uint256 gasPrice,
                address gasToken,
                address refundReceiver,
                uint256 _nonce
            ) public view returns (bytes32) {
                return keccak256(encodeTransactionData(to, value, data, operation, safeTxGas, baseGas, gasPrice, gasToken, refundReceiver, _nonce));
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        import "../common/Enum.sol";
        /// @title Executor - A contract that can execute transactions
        /// @author Richard Meissner - <[email protected]>
        contract Executor {
            function execute(
                address to,
                uint256 value,
                bytes memory data,
                Enum.Operation operation,
                uint256 txGas
            ) internal returns (bool success) {
                if (operation == Enum.Operation.DelegateCall) {
                    // solhint-disable-next-line no-inline-assembly
                    assembly {
                        success := delegatecall(txGas, to, add(data, 0x20), mload(data), 0, 0)
                    }
                } else {
                    // solhint-disable-next-line no-inline-assembly
                    assembly {
                        success := call(txGas, to, value, add(data, 0x20), mload(data), 0, 0)
                    }
                }
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        import "../common/SelfAuthorized.sol";
        /// @title Fallback Manager - A contract that manages fallback calls made to this contract
        /// @author Richard Meissner - <[email protected]>
        contract FallbackManager is SelfAuthorized {
            event ChangedFallbackHandler(address handler);
            // keccak256("fallback_manager.handler.address")
            bytes32 internal constant FALLBACK_HANDLER_STORAGE_SLOT = 0x6c9a6c4a39284e37ed1cf53d337577d14212a4870fb976a4366c693b939918d5;
            function internalSetFallbackHandler(address handler) internal {
                bytes32 slot = FALLBACK_HANDLER_STORAGE_SLOT;
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    sstore(slot, handler)
                }
            }
            /// @dev Allows to add a contract to handle fallback calls.
            ///      Only fallback calls without value and with data will be forwarded.
            ///      This can only be done via a Safe transaction.
            /// @param handler contract to handle fallbacks calls.
            function setFallbackHandler(address handler) public authorized {
                internalSetFallbackHandler(handler);
                emit ChangedFallbackHandler(handler);
            }
            // solhint-disable-next-line payable-fallback,no-complex-fallback
            fallback() external {
                bytes32 slot = FALLBACK_HANDLER_STORAGE_SLOT;
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    let handler := sload(slot)
                    if iszero(handler) {
                        return(0, 0)
                    }
                    calldatacopy(0, 0, calldatasize())
                    // The msg.sender address is shifted to the left by 12 bytes to remove the padding
                    // Then the address without padding is stored right after the calldata
                    mstore(calldatasize(), shl(96, caller()))
                    // Add 20 bytes for the address appended add the end
                    let success := call(gas(), handler, 0, 0, add(calldatasize(), 20), 0, 0)
                    returndatacopy(0, 0, returndatasize())
                    if iszero(success) {
                        revert(0, returndatasize())
                    }
                    return(0, returndatasize())
                }
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        import "../common/Enum.sol";
        import "../common/SelfAuthorized.sol";
        interface Guard {
            function checkTransaction(
                address to,
                uint256 value,
                bytes memory data,
                Enum.Operation operation,
                uint256 safeTxGas,
                uint256 baseGas,
                uint256 gasPrice,
                address gasToken,
                address payable refundReceiver,
                bytes memory signatures,
                address msgSender
            ) external;
            function checkAfterExecution(bytes32 txHash, bool success) external;
        }
        /// @title Fallback Manager - A contract that manages fallback calls made to this contract
        /// @author Richard Meissner - <[email protected]>
        contract GuardManager is SelfAuthorized {
            event ChangedGuard(address guard);
            // keccak256("guard_manager.guard.address")
            bytes32 internal constant GUARD_STORAGE_SLOT = 0x4a204f620c8c5ccdca3fd54d003badd85ba500436a431f0cbda4f558c93c34c8;
            /// @dev Set a guard that checks transactions before execution
            /// @param guard The address of the guard to be used or the 0 address to disable the guard
            function setGuard(address guard) external authorized {
                bytes32 slot = GUARD_STORAGE_SLOT;
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    sstore(slot, guard)
                }
                emit ChangedGuard(guard);
            }
            function getGuard() internal view returns (address guard) {
                bytes32 slot = GUARD_STORAGE_SLOT;
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    guard := sload(slot)
                }
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        import "../common/Enum.sol";
        import "../common/SelfAuthorized.sol";
        import "./Executor.sol";
        /// @title Module Manager - A contract that manages modules that can execute transactions via this contract
        /// @author Stefan George - <[email protected]>
        /// @author Richard Meissner - <[email protected]>
        contract ModuleManager is SelfAuthorized, Executor {
            event EnabledModule(address module);
            event DisabledModule(address module);
            event ExecutionFromModuleSuccess(address indexed module);
            event ExecutionFromModuleFailure(address indexed module);
            address internal constant SENTINEL_MODULES = address(0x1);
            mapping(address => address) internal modules;
            function setupModules(address to, bytes memory data) internal {
                require(modules[SENTINEL_MODULES] == address(0), "GS100");
                modules[SENTINEL_MODULES] = SENTINEL_MODULES;
                if (to != address(0))
                    // Setup has to complete successfully or transaction fails.
                    require(execute(to, 0, data, Enum.Operation.DelegateCall, gasleft()), "GS000");
            }
            /// @dev Allows to add a module to the whitelist.
            ///      This can only be done via a Safe transaction.
            /// @notice Enables the module `module` for the Safe.
            /// @param module Module to be whitelisted.
            function enableModule(address module) public authorized {
                // Module address cannot be null or sentinel.
                require(module != address(0) && module != SENTINEL_MODULES, "GS101");
                // Module cannot be added twice.
                require(modules[module] == address(0), "GS102");
                modules[module] = modules[SENTINEL_MODULES];
                modules[SENTINEL_MODULES] = module;
                emit EnabledModule(module);
            }
            /// @dev Allows to remove a module from the whitelist.
            ///      This can only be done via a Safe transaction.
            /// @notice Disables the module `module` for the Safe.
            /// @param prevModule Module that pointed to the module to be removed in the linked list
            /// @param module Module to be removed.
            function disableModule(address prevModule, address module) public authorized {
                // Validate module address and check that it corresponds to module index.
                require(module != address(0) && module != SENTINEL_MODULES, "GS101");
                require(modules[prevModule] == module, "GS103");
                modules[prevModule] = modules[module];
                modules[module] = address(0);
                emit DisabledModule(module);
            }
            /// @dev Allows a Module to execute a Safe transaction without any further confirmations.
            /// @param to Destination address of module transaction.
            /// @param value Ether value of module transaction.
            /// @param data Data payload of module transaction.
            /// @param operation Operation type of module transaction.
            function execTransactionFromModule(
                address to,
                uint256 value,
                bytes memory data,
                Enum.Operation operation
            ) public virtual returns (bool success) {
                // Only whitelisted modules are allowed.
                require(msg.sender != SENTINEL_MODULES && modules[msg.sender] != address(0), "GS104");
                // Execute transaction without further confirmations.
                success = execute(to, value, data, operation, gasleft());
                if (success) emit ExecutionFromModuleSuccess(msg.sender);
                else emit ExecutionFromModuleFailure(msg.sender);
            }
            /// @dev Allows a Module to execute a Safe transaction without any further confirmations and return data
            /// @param to Destination address of module transaction.
            /// @param value Ether value of module transaction.
            /// @param data Data payload of module transaction.
            /// @param operation Operation type of module transaction.
            function execTransactionFromModuleReturnData(
                address to,
                uint256 value,
                bytes memory data,
                Enum.Operation operation
            ) public returns (bool success, bytes memory returnData) {
                success = execTransactionFromModule(to, value, data, operation);
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    // Load free memory location
                    let ptr := mload(0x40)
                    // We allocate memory for the return data by setting the free memory location to
                    // current free memory location + data size + 32 bytes for data size value
                    mstore(0x40, add(ptr, add(returndatasize(), 0x20)))
                    // Store the size
                    mstore(ptr, returndatasize())
                    // Store the data
                    returndatacopy(add(ptr, 0x20), 0, returndatasize())
                    // Point the return data to the correct memory location
                    returnData := ptr
                }
            }
            /// @dev Returns if an module is enabled
            /// @return True if the module is enabled
            function isModuleEnabled(address module) public view returns (bool) {
                return SENTINEL_MODULES != module && modules[module] != address(0);
            }
            /// @dev Returns array of modules.
            /// @param start Start of the page.
            /// @param pageSize Maximum number of modules that should be returned.
            /// @return array Array of modules.
            /// @return next Start of the next page.
            function getModulesPaginated(address start, uint256 pageSize) external view returns (address[] memory array, address next) {
                // Init array with max page size
                array = new address[](pageSize);
                // Populate return array
                uint256 moduleCount = 0;
                address currentModule = modules[start];
                while (currentModule != address(0x0) && currentModule != SENTINEL_MODULES && moduleCount < pageSize) {
                    array[moduleCount] = currentModule;
                    currentModule = modules[currentModule];
                    moduleCount++;
                }
                next = currentModule;
                // Set correct size of returned array
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    mstore(array, moduleCount)
                }
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        import "../common/SelfAuthorized.sol";
        /// @title OwnerManager - Manages a set of owners and a threshold to perform actions.
        /// @author Stefan George - <[email protected]>
        /// @author Richard Meissner - <[email protected]>
        contract OwnerManager is SelfAuthorized {
            event AddedOwner(address owner);
            event RemovedOwner(address owner);
            event ChangedThreshold(uint256 threshold);
            address internal constant SENTINEL_OWNERS = address(0x1);
            mapping(address => address) internal owners;
            uint256 internal ownerCount;
            uint256 internal threshold;
            /// @dev Setup function sets initial storage of contract.
            /// @param _owners List of Safe owners.
            /// @param _threshold Number of required confirmations for a Safe transaction.
            function setupOwners(address[] memory _owners, uint256 _threshold) internal {
                // Threshold can only be 0 at initialization.
                // Check ensures that setup function can only be called once.
                require(threshold == 0, "GS200");
                // Validate that threshold is smaller than number of added owners.
                require(_threshold <= _owners.length, "GS201");
                // There has to be at least one Safe owner.
                require(_threshold >= 1, "GS202");
                // Initializing Safe owners.
                address currentOwner = SENTINEL_OWNERS;
                for (uint256 i = 0; i < _owners.length; i++) {
                    // Owner address cannot be null.
                    address owner = _owners[i];
                    require(owner != address(0) && owner != SENTINEL_OWNERS && owner != address(this) && currentOwner != owner, "GS203");
                    // No duplicate owners allowed.
                    require(owners[owner] == address(0), "GS204");
                    owners[currentOwner] = owner;
                    currentOwner = owner;
                }
                owners[currentOwner] = SENTINEL_OWNERS;
                ownerCount = _owners.length;
                threshold = _threshold;
            }
            /// @dev Allows to add a new owner to the Safe and update the threshold at the same time.
            ///      This can only be done via a Safe transaction.
            /// @notice Adds the owner `owner` to the Safe and updates the threshold to `_threshold`.
            /// @param owner New owner address.
            /// @param _threshold New threshold.
            function addOwnerWithThreshold(address owner, uint256 _threshold) public authorized {
                // Owner address cannot be null, the sentinel or the Safe itself.
                require(owner != address(0) && owner != SENTINEL_OWNERS && owner != address(this), "GS203");
                // No duplicate owners allowed.
                require(owners[owner] == address(0), "GS204");
                owners[owner] = owners[SENTINEL_OWNERS];
                owners[SENTINEL_OWNERS] = owner;
                ownerCount++;
                emit AddedOwner(owner);
                // Change threshold if threshold was changed.
                if (threshold != _threshold) changeThreshold(_threshold);
            }
            /// @dev Allows to remove an owner from the Safe and update the threshold at the same time.
            ///      This can only be done via a Safe transaction.
            /// @notice Removes the owner `owner` from the Safe and updates the threshold to `_threshold`.
            /// @param prevOwner Owner that pointed to the owner to be removed in the linked list
            /// @param owner Owner address to be removed.
            /// @param _threshold New threshold.
            function removeOwner(
                address prevOwner,
                address owner,
                uint256 _threshold
            ) public authorized {
                // Only allow to remove an owner, if threshold can still be reached.
                require(ownerCount - 1 >= _threshold, "GS201");
                // Validate owner address and check that it corresponds to owner index.
                require(owner != address(0) && owner != SENTINEL_OWNERS, "GS203");
                require(owners[prevOwner] == owner, "GS205");
                owners[prevOwner] = owners[owner];
                owners[owner] = address(0);
                ownerCount--;
                emit RemovedOwner(owner);
                // Change threshold if threshold was changed.
                if (threshold != _threshold) changeThreshold(_threshold);
            }
            /// @dev Allows to swap/replace an owner from the Safe with another address.
            ///      This can only be done via a Safe transaction.
            /// @notice Replaces the owner `oldOwner` in the Safe with `newOwner`.
            /// @param prevOwner Owner that pointed to the owner to be replaced in the linked list
            /// @param oldOwner Owner address to be replaced.
            /// @param newOwner New owner address.
            function swapOwner(
                address prevOwner,
                address oldOwner,
                address newOwner
            ) public authorized {
                // Owner address cannot be null, the sentinel or the Safe itself.
                require(newOwner != address(0) && newOwner != SENTINEL_OWNERS && newOwner != address(this), "GS203");
                // No duplicate owners allowed.
                require(owners[newOwner] == address(0), "GS204");
                // Validate oldOwner address and check that it corresponds to owner index.
                require(oldOwner != address(0) && oldOwner != SENTINEL_OWNERS, "GS203");
                require(owners[prevOwner] == oldOwner, "GS205");
                owners[newOwner] = owners[oldOwner];
                owners[prevOwner] = newOwner;
                owners[oldOwner] = address(0);
                emit RemovedOwner(oldOwner);
                emit AddedOwner(newOwner);
            }
            /// @dev Allows to update the number of required confirmations by Safe owners.
            ///      This can only be done via a Safe transaction.
            /// @notice Changes the threshold of the Safe to `_threshold`.
            /// @param _threshold New threshold.
            function changeThreshold(uint256 _threshold) public authorized {
                // Validate that threshold is smaller than number of owners.
                require(_threshold <= ownerCount, "GS201");
                // There has to be at least one Safe owner.
                require(_threshold >= 1, "GS202");
                threshold = _threshold;
                emit ChangedThreshold(threshold);
            }
            function getThreshold() public view returns (uint256) {
                return threshold;
            }
            function isOwner(address owner) public view returns (bool) {
                return owner != SENTINEL_OWNERS && owners[owner] != address(0);
            }
            /// @dev Returns array of owners.
            /// @return Array of Safe owners.
            function getOwners() public view returns (address[] memory) {
                address[] memory array = new address[](ownerCount);
                // populate return array
                uint256 index = 0;
                address currentOwner = owners[SENTINEL_OWNERS];
                while (currentOwner != SENTINEL_OWNERS) {
                    array[index] = currentOwner;
                    currentOwner = owners[currentOwner];
                    index++;
                }
                return array;
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /// @title Enum - Collection of enums
        /// @author Richard Meissner - <[email protected]>
        contract Enum {
            enum Operation {Call, DelegateCall}
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /// @title EtherPaymentFallback - A contract that has a fallback to accept ether payments
        /// @author Richard Meissner - <[email protected]>
        contract EtherPaymentFallback {
            event SafeReceived(address indexed sender, uint256 value);
            /// @dev Fallback function accepts Ether transactions.
            receive() external payable {
                emit SafeReceived(msg.sender, msg.value);
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /// @title SecuredTokenTransfer - Secure token transfer
        /// @author Richard Meissner - <[email protected]>
        contract SecuredTokenTransfer {
            /// @dev Transfers a token and returns if it was a success
            /// @param token Token that should be transferred
            /// @param receiver Receiver to whom the token should be transferred
            /// @param amount The amount of tokens that should be transferred
            function transferToken(
                address token,
                address receiver,
                uint256 amount
            ) internal returns (bool transferred) {
                // 0xa9059cbb - keccack("transfer(address,uint256)")
                bytes memory data = abi.encodeWithSelector(0xa9059cbb, receiver, amount);
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    // We write the return value to scratch space.
                    // See https://docs.soliditylang.org/en/v0.7.6/internals/layout_in_memory.html#layout-in-memory
                    let success := call(sub(gas(), 10000), token, 0, add(data, 0x20), mload(data), 0, 0x20)
                    switch returndatasize()
                        case 0 {
                            transferred := success
                        }
                        case 0x20 {
                            transferred := iszero(or(iszero(success), iszero(mload(0))))
                        }
                        default {
                            transferred := 0
                        }
                }
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /// @title SelfAuthorized - authorizes current contract to perform actions
        /// @author Richard Meissner - <[email protected]>
        contract SelfAuthorized {
            function requireSelfCall() private view {
                require(msg.sender == address(this), "GS031");
            }
            modifier authorized() {
                // This is a function call as it minimized the bytecode size
                requireSelfCall();
                _;
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /// @title SignatureDecoder - Decodes signatures that a encoded as bytes
        /// @author Richard Meissner - <[email protected]>
        contract SignatureDecoder {
            /// @dev divides bytes signature into `uint8 v, bytes32 r, bytes32 s`.
            /// @notice Make sure to peform a bounds check for @param pos, to avoid out of bounds access on @param signatures
            /// @param pos which signature to read. A prior bounds check of this parameter should be performed, to avoid out of bounds access
            /// @param signatures concatenated rsv signatures
            function signatureSplit(bytes memory signatures, uint256 pos)
                internal
                pure
                returns (
                    uint8 v,
                    bytes32 r,
                    bytes32 s
                )
            {
                // The signature format is a compact form of:
                //   {bytes32 r}{bytes32 s}{uint8 v}
                // Compact means, uint8 is not padded to 32 bytes.
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    let signaturePos := mul(0x41, pos)
                    r := mload(add(signatures, add(signaturePos, 0x20)))
                    s := mload(add(signatures, add(signaturePos, 0x40)))
                    // Here we are loading the last 32 bytes, including 31 bytes
                    // of 's'. There is no 'mload8' to do this.
                    //
                    // 'byte' is not working due to the Solidity parser, so lets
                    // use the second best option, 'and'
                    v := and(mload(add(signatures, add(signaturePos, 0x41))), 0xff)
                }
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /// @title Singleton - Base for singleton contracts (should always be first super contract)
        ///         This contract is tightly coupled to our proxy contract (see `proxies/GnosisSafeProxy.sol`)
        /// @author Richard Meissner - <[email protected]>
        contract Singleton {
            // singleton always needs to be first declared variable, to ensure that it is at the same location as in the Proxy contract.
            // It should also always be ensured that the address is stored alone (uses a full word)
            address private singleton;
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /// @title StorageAccessible - generic base contract that allows callers to access all internal storage.
        /// @notice See https://github.com/gnosis/util-contracts/blob/bb5fe5fb5df6d8400998094fb1b32a178a47c3a1/contracts/StorageAccessible.sol
        contract StorageAccessible {
            /**
             * @dev Reads `length` bytes of storage in the currents contract
             * @param offset - the offset in the current contract's storage in words to start reading from
             * @param length - the number of words (32 bytes) of data to read
             * @return the bytes that were read.
             */
            function getStorageAt(uint256 offset, uint256 length) public view returns (bytes memory) {
                bytes memory result = new bytes(length * 32);
                for (uint256 index = 0; index < length; index++) {
                    // solhint-disable-next-line no-inline-assembly
                    assembly {
                        let word := sload(add(offset, index))
                        mstore(add(add(result, 0x20), mul(index, 0x20)), word)
                    }
                }
                return result;
            }
            /**
             * @dev Performs a delegetecall on a targetContract in the context of self.
             * Internally reverts execution to avoid side effects (making it static).
             *
             * This method reverts with data equal to `abi.encode(bool(success), bytes(response))`.
             * Specifically, the `returndata` after a call to this method will be:
             * `success:bool || response.length:uint256 || response:bytes`.
             *
             * @param targetContract Address of the contract containing the code to execute.
             * @param calldataPayload Calldata that should be sent to the target contract (encoded method name and arguments).
             */
            function simulateAndRevert(address targetContract, bytes memory calldataPayload) external {
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    let success := delegatecall(gas(), targetContract, add(calldataPayload, 0x20), mload(calldataPayload), 0, 0)
                    mstore(0x00, success)
                    mstore(0x20, returndatasize())
                    returndatacopy(0x40, 0, returndatasize())
                    revert(0, add(returndatasize(), 0x40))
                }
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /**
         * @title GnosisSafeMath
         * @dev Math operations with safety checks that revert on error
         * Renamed from SafeMath to GnosisSafeMath to avoid conflicts
         * TODO: remove once open zeppelin update to solc 0.5.0
         */
        library GnosisSafeMath {
            /**
             * @dev Multiplies two numbers, reverts on overflow.
             */
            function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                // benefit is lost if 'b' is also tested.
                // See: https://github.com/OpenZeppelin/openzeppelin-solidity/pull/522
                if (a == 0) {
                    return 0;
                }
                uint256 c = a * b;
                require(c / a == b);
                return c;
            }
            /**
             * @dev Subtracts two numbers, reverts on overflow (i.e. if subtrahend is greater than minuend).
             */
            function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                require(b <= a);
                uint256 c = a - b;
                return c;
            }
            /**
             * @dev Adds two numbers, reverts on overflow.
             */
            function add(uint256 a, uint256 b) internal pure returns (uint256) {
                uint256 c = a + b;
                require(c >= a);
                return c;
            }
            /**
             * @dev Returns the largest of two numbers.
             */
            function max(uint256 a, uint256 b) internal pure returns (uint256) {
                return a >= b ? a : b;
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        contract ISignatureValidatorConstants {
            // bytes4(keccak256("isValidSignature(bytes,bytes)")
            bytes4 internal constant EIP1271_MAGIC_VALUE = 0x20c13b0b;
        }
        abstract contract ISignatureValidator is ISignatureValidatorConstants {
            /**
             * @dev Should return whether the signature provided is valid for the provided data
             * @param _data Arbitrary length data signed on the behalf of address(this)
             * @param _signature Signature byte array associated with _data
             *
             * MUST return the bytes4 magic value 0x20c13b0b when function passes.
             * MUST NOT modify state (using STATICCALL for solc < 0.5, view modifier for solc > 0.5)
             * MUST allow external calls
             */
            function isValidSignature(bytes memory _data, bytes memory _signature) public view virtual returns (bytes4);
        }
        

        File 3 of 3: WyvernExchange
        pragma solidity ^0.4.13;
        
        library SafeMath {
        
          /**
          * @dev Multiplies two numbers, throws on overflow.
          */
          function mul(uint256 a, uint256 b) internal pure returns (uint256 c) {
            if (a == 0) {
              return 0;
            }
            c = a * b;
            assert(c / a == b);
            return c;
          }
        
          /**
          * @dev Integer division of two numbers, truncating the quotient.
          */
          function div(uint256 a, uint256 b) internal pure returns (uint256) {
            // assert(b > 0); // Solidity automatically throws 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 a / b;
          }
        
          /**
          * @dev Subtracts two numbers, throws on overflow (i.e. if subtrahend is greater than minuend).
          */
          function sub(uint256 a, uint256 b) internal pure returns (uint256) {
            assert(b <= a);
            return a - b;
          }
        
          /**
          * @dev Adds two numbers, throws on overflow.
          */
          function add(uint256 a, uint256 b) internal pure returns (uint256 c) {
            c = a + b;
            assert(c >= a);
            return c;
          }
        }
        
        contract Ownable {
          address public owner;
        
        
          event OwnershipRenounced(address indexed previousOwner);
          event OwnershipTransferred(
            address indexed previousOwner,
            address indexed newOwner
          );
        
        
          /**
           * @dev The Ownable constructor sets the original `owner` of the contract to the sender
           * account.
           */
          constructor() public {
            owner = msg.sender;
          }
        
          /**
           * @dev Throws if called by any account other than the owner.
           */
          modifier onlyOwner() {
            require(msg.sender == owner);
            _;
          }
        
          /**
           * @dev Allows the current owner to transfer control of the contract to a newOwner.
           * @param newOwner The address to transfer ownership to.
           */
          function transferOwnership(address newOwner) public onlyOwner {
            require(newOwner != address(0));
            emit OwnershipTransferred(owner, newOwner);
            owner = newOwner;
          }
        
          /**
           * @dev Allows the current owner to relinquish control of the contract.
           */
          function renounceOwnership() public onlyOwner {
            emit OwnershipRenounced(owner);
            owner = address(0);
          }
        }
        
        contract ERC20Basic {
          function totalSupply() public view returns (uint256);
          function balanceOf(address who) public view returns (uint256);
          function transfer(address to, uint256 value) public returns (bool);
          event Transfer(address indexed from, address indexed to, uint256 value);
        }
        
        contract ERC20 is ERC20Basic {
          function allowance(address owner, address spender)
            public view returns (uint256);
        
          function transferFrom(address from, address to, uint256 value)
            public returns (bool);
        
          function approve(address spender, uint256 value) public returns (bool);
          event Approval(
            address indexed owner,
            address indexed spender,
            uint256 value
          );
        }
        
        library ArrayUtils {
        
            /**
             * Replace bytes in an array with bytes in another array, guarded by a bitmask
             * Efficiency of this function is a bit unpredictable because of the EVM's word-specific model (arrays under 32 bytes will be slower)
             * 
             * @dev Mask must be the size of the byte array. A nonzero byte means the byte array can be changed.
             * @param array The original array
             * @param desired The target array
             * @param mask The mask specifying which bits can be changed
             * @return The updated byte array (the parameter will be modified inplace)
             */
            function guardedArrayReplace(bytes memory array, bytes memory desired, bytes memory mask)
                internal
                pure
            {
                require(array.length == desired.length);
                require(array.length == mask.length);
        
                uint words = array.length / 0x20;
                uint index = words * 0x20;
                assert(index / 0x20 == words);
                uint i;
        
                for (i = 0; i < words; i++) {
                    /* Conceptually: array[i] = (!mask[i] && array[i]) || (mask[i] && desired[i]), bitwise in word chunks. */
                    assembly {
                        let commonIndex := mul(0x20, add(1, i))
                        let maskValue := mload(add(mask, commonIndex))
                        mstore(add(array, commonIndex), or(and(not(maskValue), mload(add(array, commonIndex))), and(maskValue, mload(add(desired, commonIndex)))))
                    }
                }
        
                /* Deal with the last section of the byte array. */
                if (words > 0) {
                    /* This overlaps with bytes already set but is still more efficient than iterating through each of the remaining bytes individually. */
                    i = words;
                    assembly {
                        let commonIndex := mul(0x20, add(1, i))
                        let maskValue := mload(add(mask, commonIndex))
                        mstore(add(array, commonIndex), or(and(not(maskValue), mload(add(array, commonIndex))), and(maskValue, mload(add(desired, commonIndex)))))
                    }
                } else {
                    /* If the byte array is shorter than a word, we must unfortunately do the whole thing bytewise.
                       (bounds checks could still probably be optimized away in assembly, but this is a rare case) */
                    for (i = index; i < array.length; i++) {
                        array[i] = ((mask[i] ^ 0xff) & array[i]) | (mask[i] & desired[i]);
                    }
                }
            }
        
            /**
             * Test if two arrays are equal
             * Source: https://github.com/GNSPS/solidity-bytes-utils/blob/master/contracts/BytesLib.sol
             * 
             * @dev Arrays must be of equal length, otherwise will return false
             * @param a First array
             * @param b Second array
             * @return Whether or not all bytes in the arrays are equal
             */
            function arrayEq(bytes memory a, bytes memory b)
                internal
                pure
                returns (bool)
            {
                bool success = true;
        
                assembly {
                    let length := mload(a)
        
                    // if lengths don't match the arrays are not equal
                    switch eq(length, mload(b))
                    case 1 {
                        // cb is a circuit breaker in the for loop since there's
                        //  no said feature for inline assembly loops
                        // cb = 1 - don't breaker
                        // cb = 0 - break
                        let cb := 1
        
                        let mc := add(a, 0x20)
                        let end := add(mc, length)
        
                        for {
                            let cc := add(b, 0x20)
                        // the next line is the loop condition:
                        // while(uint(mc < end) + cb == 2)
                        } eq(add(lt(mc, end), cb), 2) {
                            mc := add(mc, 0x20)
                            cc := add(cc, 0x20)
                        } {
                            // if any of these checks fails then arrays are not equal
                            if iszero(eq(mload(mc), mload(cc))) {
                                // unsuccess:
                                success := 0
                                cb := 0
                            }
                        }
                    }
                    default {
                        // unsuccess:
                        success := 0
                    }
                }
        
                return success;
            }
        
            /**
             * Unsafe write byte array into a memory location
             *
             * @param index Memory location
             * @param source Byte array to write
             * @return End memory index
             */
            function unsafeWriteBytes(uint index, bytes source)
                internal
                pure
                returns (uint)
            {
                if (source.length > 0) {
                    assembly {
                        let length := mload(source)
                        let end := add(source, add(0x20, length))
                        let arrIndex := add(source, 0x20)
                        let tempIndex := index
                        for { } eq(lt(arrIndex, end), 1) {
                            arrIndex := add(arrIndex, 0x20)
                            tempIndex := add(tempIndex, 0x20)
                        } {
                            mstore(tempIndex, mload(arrIndex))
                        }
                        index := add(index, length)
                    }
                }
                return index;
            }
        
            /**
             * Unsafe write address into a memory location
             *
             * @param index Memory location
             * @param source Address to write
             * @return End memory index
             */
            function unsafeWriteAddress(uint index, address source)
                internal
                pure
                returns (uint)
            {
                uint conv = uint(source) << 0x60;
                assembly {
                    mstore(index, conv)
                    index := add(index, 0x14)
                }
                return index;
            }
        
            /**
             * Unsafe write uint into a memory location
             *
             * @param index Memory location
             * @param source uint to write
             * @return End memory index
             */
            function unsafeWriteUint(uint index, uint source)
                internal
                pure
                returns (uint)
            {
                assembly {
                    mstore(index, source)
                    index := add(index, 0x20)
                }
                return index;
            }
        
            /**
             * Unsafe write uint8 into a memory location
             *
             * @param index Memory location
             * @param source uint8 to write
             * @return End memory index
             */
            function unsafeWriteUint8(uint index, uint8 source)
                internal
                pure
                returns (uint)
            {
                assembly {
                    mstore8(index, source)
                    index := add(index, 0x1)
                }
                return index;
            }
        
        }
        
        contract ReentrancyGuarded {
        
            bool reentrancyLock = false;
        
            /* Prevent a contract function from being reentrant-called. */
            modifier reentrancyGuard {
                if (reentrancyLock) {
                    revert();
                }
                reentrancyLock = true;
                _;
                reentrancyLock = false;
            }
        
        }
        
        contract TokenRecipient {
            event ReceivedEther(address indexed sender, uint amount);
            event ReceivedTokens(address indexed from, uint256 value, address indexed token, bytes extraData);
        
            /**
             * @dev Receive tokens and generate a log event
             * @param from Address from which to transfer tokens
             * @param value Amount of tokens to transfer
             * @param token Address of token
             * @param extraData Additional data to log
             */
            function receiveApproval(address from, uint256 value, address token, bytes extraData) public {
                ERC20 t = ERC20(token);
                require(t.transferFrom(from, this, value));
                emit ReceivedTokens(from, value, token, extraData);
            }
        
            /**
             * @dev Receive Ether and generate a log event
             */
            function () payable public {
                emit ReceivedEther(msg.sender, msg.value);
            }
        }
        
        contract ExchangeCore is ReentrancyGuarded, Ownable {
        
            /* The token used to pay exchange fees. */
            ERC20 public exchangeToken;
        
            /* User registry. */
            ProxyRegistry public registry;
        
            /* Token transfer proxy. */
            TokenTransferProxy public tokenTransferProxy;
        
            /* Cancelled / finalized orders, by hash. */
            mapping(bytes32 => bool) public cancelledOrFinalized;
        
            /* Orders verified by on-chain approval (alternative to ECDSA signatures so that smart contracts can place orders directly). */
            mapping(bytes32 => bool) public approvedOrders;
        
            /* For split fee orders, minimum required protocol maker fee, in basis points. Paid to owner (who can change it). */
            uint public minimumMakerProtocolFee = 0;
        
            /* For split fee orders, minimum required protocol taker fee, in basis points. Paid to owner (who can change it). */
            uint public minimumTakerProtocolFee = 0;
        
            /* Recipient of protocol fees. */
            address public protocolFeeRecipient;
        
            /* Fee method: protocol fee or split fee. */
            enum FeeMethod { ProtocolFee, SplitFee }
        
            /* Inverse basis point. */
            uint public constant INVERSE_BASIS_POINT = 10000;
        
            /* An ECDSA signature. */ 
            struct Sig {
                /* v parameter */
                uint8 v;
                /* r parameter */
                bytes32 r;
                /* s parameter */
                bytes32 s;
            }
        
            /* An order on the exchange. */
            struct Order {
                /* Exchange address, intended as a versioning mechanism. */
                address exchange;
                /* Order maker address. */
                address maker;
                /* Order taker address, if specified. */
                address taker;
                /* Maker relayer fee of the order, unused for taker order. */
                uint makerRelayerFee;
                /* Taker relayer fee of the order, or maximum taker fee for a taker order. */
                uint takerRelayerFee;
                /* Maker protocol fee of the order, unused for taker order. */
                uint makerProtocolFee;
                /* Taker protocol fee of the order, or maximum taker fee for a taker order. */
                uint takerProtocolFee;
                /* Order fee recipient or zero address for taker order. */
                address feeRecipient;
                /* Fee method (protocol token or split fee). */
                FeeMethod feeMethod;
                /* Side (buy/sell). */
                SaleKindInterface.Side side;
                /* Kind of sale. */
                SaleKindInterface.SaleKind saleKind;
                /* Target. */
                address target;
                /* HowToCall. */
                AuthenticatedProxy.HowToCall howToCall;
                /* Calldata. */
                bytes calldata;
                /* Calldata replacement pattern, or an empty byte array for no replacement. */
                bytes replacementPattern;
                /* Static call target, zero-address for no static call. */
                address staticTarget;
                /* Static call extra data. */
                bytes staticExtradata;
                /* Token used to pay for the order, or the zero-address as a sentinel value for Ether. */
                address paymentToken;
                /* Base price of the order (in paymentTokens). */
                uint basePrice;
                /* Auction extra parameter - minimum bid increment for English auctions, starting/ending price difference. */
                uint extra;
                /* Listing timestamp. */
                uint listingTime;
                /* Expiration timestamp - 0 for no expiry. */
                uint expirationTime;
                /* Order salt, used to prevent duplicate hashes. */
                uint salt;
            }
            
            event OrderApprovedPartOne    (bytes32 indexed hash, address exchange, address indexed maker, address taker, uint makerRelayerFee, uint takerRelayerFee, uint makerProtocolFee, uint takerProtocolFee, address indexed feeRecipient, FeeMethod feeMethod, SaleKindInterface.Side side, SaleKindInterface.SaleKind saleKind, address target);
            event OrderApprovedPartTwo    (bytes32 indexed hash, AuthenticatedProxy.HowToCall howToCall, bytes calldata, bytes replacementPattern, address staticTarget, bytes staticExtradata, address paymentToken, uint basePrice, uint extra, uint listingTime, uint expirationTime, uint salt, bool orderbookInclusionDesired);
            event OrderCancelled          (bytes32 indexed hash);
            event OrdersMatched           (bytes32 buyHash, bytes32 sellHash, address indexed maker, address indexed taker, uint price, bytes32 indexed metadata);
        
            /**
             * @dev Change the minimum maker fee paid to the protocol (owner only)
             * @param newMinimumMakerProtocolFee New fee to set in basis points
             */
            function changeMinimumMakerProtocolFee(uint newMinimumMakerProtocolFee)
                public
                onlyOwner
            {
                minimumMakerProtocolFee = newMinimumMakerProtocolFee;
            }
        
            /**
             * @dev Change the minimum taker fee paid to the protocol (owner only)
             * @param newMinimumTakerProtocolFee New fee to set in basis points
             */
            function changeMinimumTakerProtocolFee(uint newMinimumTakerProtocolFee)
                public
                onlyOwner
            {
                minimumTakerProtocolFee = newMinimumTakerProtocolFee;
            }
        
            /**
             * @dev Change the protocol fee recipient (owner only)
             * @param newProtocolFeeRecipient New protocol fee recipient address
             */
            function changeProtocolFeeRecipient(address newProtocolFeeRecipient)
                public
                onlyOwner
            {
                protocolFeeRecipient = newProtocolFeeRecipient;
            }
        
            /**
             * @dev Transfer tokens
             * @param token Token to transfer
             * @param from Address to charge fees
             * @param to Address to receive fees
             * @param amount Amount of protocol tokens to charge
             */
            function transferTokens(address token, address from, address to, uint amount)
                internal
            {
                if (amount > 0) {
                    require(tokenTransferProxy.transferFrom(token, from, to, amount));
                }
            }
        
            /**
             * @dev Charge a fee in protocol tokens
             * @param from Address to charge fees
             * @param to Address to receive fees
             * @param amount Amount of protocol tokens to charge
             */
            function chargeProtocolFee(address from, address to, uint amount)
                internal
            {
                transferTokens(exchangeToken, from, to, amount);
            }
        
            /**
             * @dev Execute a STATICCALL (introduced with Ethereum Metropolis, non-state-modifying external call)
             * @param target Contract to call
             * @param calldata Calldata (appended to extradata)
             * @param extradata Base data for STATICCALL (probably function selector and argument encoding)
             * @return The result of the call (success or failure)
             */
            function staticCall(address target, bytes memory calldata, bytes memory extradata)
                public
                view
                returns (bool result)
            {
                bytes memory combined = new bytes(calldata.length + extradata.length);
                uint index;
                assembly {
                    index := add(combined, 0x20)
                }
                index = ArrayUtils.unsafeWriteBytes(index, extradata);
                ArrayUtils.unsafeWriteBytes(index, calldata);
                assembly {
                    result := staticcall(gas, target, add(combined, 0x20), mload(combined), mload(0x40), 0)
                }
                return result;
            }
        
            /**
             * Calculate size of an order struct when tightly packed
             *
             * @param order Order to calculate size of
             * @return Size in bytes
             */
            function sizeOf(Order memory order)
                internal
                pure
                returns (uint)
            {
                return ((0x14 * 7) + (0x20 * 9) + 4 + order.calldata.length + order.replacementPattern.length + order.staticExtradata.length);
            }
        
            /**
             * @dev Hash an order, returning the canonical order hash, without the message prefix
             * @param order Order to hash
             * @return Hash of order
             */
            function hashOrder(Order memory order)
                internal
                pure
                returns (bytes32 hash)
            {
                /* Unfortunately abi.encodePacked doesn't work here, stack size constraints. */
                uint size = sizeOf(order);
                bytes memory array = new bytes(size);
                uint index;
                assembly {
                    index := add(array, 0x20)
                }
                index = ArrayUtils.unsafeWriteAddress(index, order.exchange);
                index = ArrayUtils.unsafeWriteAddress(index, order.maker);
                index = ArrayUtils.unsafeWriteAddress(index, order.taker);
                index = ArrayUtils.unsafeWriteUint(index, order.makerRelayerFee);
                index = ArrayUtils.unsafeWriteUint(index, order.takerRelayerFee);
                index = ArrayUtils.unsafeWriteUint(index, order.makerProtocolFee);
                index = ArrayUtils.unsafeWriteUint(index, order.takerProtocolFee);
                index = ArrayUtils.unsafeWriteAddress(index, order.feeRecipient);
                index = ArrayUtils.unsafeWriteUint8(index, uint8(order.feeMethod));
                index = ArrayUtils.unsafeWriteUint8(index, uint8(order.side));
                index = ArrayUtils.unsafeWriteUint8(index, uint8(order.saleKind));
                index = ArrayUtils.unsafeWriteAddress(index, order.target);
                index = ArrayUtils.unsafeWriteUint8(index, uint8(order.howToCall));
                index = ArrayUtils.unsafeWriteBytes(index, order.calldata);
                index = ArrayUtils.unsafeWriteBytes(index, order.replacementPattern);
                index = ArrayUtils.unsafeWriteAddress(index, order.staticTarget);
                index = ArrayUtils.unsafeWriteBytes(index, order.staticExtradata);
                index = ArrayUtils.unsafeWriteAddress(index, order.paymentToken);
                index = ArrayUtils.unsafeWriteUint(index, order.basePrice);
                index = ArrayUtils.unsafeWriteUint(index, order.extra);
                index = ArrayUtils.unsafeWriteUint(index, order.listingTime);
                index = ArrayUtils.unsafeWriteUint(index, order.expirationTime);
                index = ArrayUtils.unsafeWriteUint(index, order.salt);
                assembly {
                    hash := keccak256(add(array, 0x20), size)
                }
                return hash;
            }
        
            /**
             * @dev Hash an order, returning the hash that a client must sign, including the standard message prefix
             * @param order Order to hash
             * @return Hash of message prefix and order hash per Ethereum format
             */
            function hashToSign(Order memory order)
                internal
                pure
                returns (bytes32)
            {
                return keccak256("\x19Ethereum Signed Message:\n32", hashOrder(order));
            }
        
            /**
             * @dev Assert an order is valid and return its hash
             * @param order Order to validate
             * @param sig ECDSA signature
             */
            function requireValidOrder(Order memory order, Sig memory sig)
                internal
                view
                returns (bytes32)
            {
                bytes32 hash = hashToSign(order);
                require(validateOrder(hash, order, sig));
                return hash;
            }
        
            /**
             * @dev Validate order parameters (does *not* check signature validity)
             * @param order Order to validate
             */
            function validateOrderParameters(Order memory order)
                internal
                view
                returns (bool)
            {
                /* Order must be targeted at this protocol version (this Exchange contract). */
                if (order.exchange != address(this)) {
                    return false;
                }
        
                /* Order must possess valid sale kind parameter combination. */
                if (!SaleKindInterface.validateParameters(order.saleKind, order.expirationTime)) {
                    return false;
                }
        
                /* If using the split fee method, order must have sufficient protocol fees. */
                if (order.feeMethod == FeeMethod.SplitFee && (order.makerProtocolFee < minimumMakerProtocolFee || order.takerProtocolFee < minimumTakerProtocolFee)) {
                    return false;
                }
        
                return true;
            }
        
            /**
             * @dev Validate a provided previously approved / signed order, hash, and signature.
             * @param hash Order hash (already calculated, passed to avoid recalculation)
             * @param order Order to validate
             * @param sig ECDSA signature
             */
            function validateOrder(bytes32 hash, Order memory order, Sig memory sig) 
                internal
                view
                returns (bool)
            {
                /* Not done in an if-conditional to prevent unnecessary ecrecover evaluation, which seems to happen even though it should short-circuit. */
        
                /* Order must have valid parameters. */
                if (!validateOrderParameters(order)) {
                    return false;
                }
        
                /* Order must have not been canceled or already filled. */
                if (cancelledOrFinalized[hash]) {
                    return false;
                }
                
                /* Order authentication. Order must be either:
                /* (a) previously approved */
                if (approvedOrders[hash]) {
                    return true;
                }
        
                /* or (b) ECDSA-signed by maker. */
                if (ecrecover(hash, sig.v, sig.r, sig.s) == order.maker) {
                    return true;
                }
        
                return false;
            }
        
            /**
             * @dev Approve an order and optionally mark it for orderbook inclusion. Must be called by the maker of the order
             * @param order Order to approve
             * @param orderbookInclusionDesired Whether orderbook providers should include the order in their orderbooks
             */
            function approveOrder(Order memory order, bool orderbookInclusionDesired)
                internal
            {
                /* CHECKS */
        
                /* Assert sender is authorized to approve order. */
                require(msg.sender == order.maker);
        
                /* Calculate order hash. */
                bytes32 hash = hashToSign(order);
        
                /* Assert order has not already been approved. */
                require(!approvedOrders[hash]);
        
                /* EFFECTS */
            
                /* Mark order as approved. */
                approvedOrders[hash] = true;
          
                /* Log approval event. Must be split in two due to Solidity stack size limitations. */
                {
                    emit OrderApprovedPartOne(hash, order.exchange, order.maker, order.taker, order.makerRelayerFee, order.takerRelayerFee, order.makerProtocolFee, order.takerProtocolFee, order.feeRecipient, order.feeMethod, order.side, order.saleKind, order.target);
                }
                {   
                    emit OrderApprovedPartTwo(hash, order.howToCall, order.calldata, order.replacementPattern, order.staticTarget, order.staticExtradata, order.paymentToken, order.basePrice, order.extra, order.listingTime, order.expirationTime, order.salt, orderbookInclusionDesired);
                }
            }
        
            /**
             * @dev Cancel an order, preventing it from being matched. Must be called by the maker of the order
             * @param order Order to cancel
             * @param sig ECDSA signature
             */
            function cancelOrder(Order memory order, Sig memory sig) 
                internal
            {
                /* CHECKS */
        
                /* Calculate order hash. */
                bytes32 hash = requireValidOrder(order, sig);
        
                /* Assert sender is authorized to cancel order. */
                require(msg.sender == order.maker);
          
                /* EFFECTS */
              
                /* Mark order as cancelled, preventing it from being matched. */
                cancelledOrFinalized[hash] = true;
        
                /* Log cancel event. */
                emit OrderCancelled(hash);
            }
        
            /**
             * @dev Calculate the current price of an order (convenience function)
             * @param order Order to calculate the price of
             * @return The current price of the order
             */
            function calculateCurrentPrice (Order memory order)
                internal  
                view
                returns (uint)
            {
                return SaleKindInterface.calculateFinalPrice(order.side, order.saleKind, order.basePrice, order.extra, order.listingTime, order.expirationTime);
            }
        
            /**
             * @dev Calculate the price two orders would match at, if in fact they would match (otherwise fail)
             * @param buy Buy-side order
             * @param sell Sell-side order
             * @return Match price
             */
            function calculateMatchPrice(Order memory buy, Order memory sell)
                view
                internal
                returns (uint)
            {
                /* Calculate sell price. */
                uint sellPrice = SaleKindInterface.calculateFinalPrice(sell.side, sell.saleKind, sell.basePrice, sell.extra, sell.listingTime, sell.expirationTime);
        
                /* Calculate buy price. */
                uint buyPrice = SaleKindInterface.calculateFinalPrice(buy.side, buy.saleKind, buy.basePrice, buy.extra, buy.listingTime, buy.expirationTime);
        
                /* Require price cross. */
                require(buyPrice >= sellPrice);
                
                /* Maker/taker priority. */
                return sell.feeRecipient != address(0) ? sellPrice : buyPrice;
            }
        
            /**
             * @dev Execute all ERC20 token / Ether transfers associated with an order match (fees and buyer => seller transfer)
             * @param buy Buy-side order
             * @param sell Sell-side order
             */
            function executeFundsTransfer(Order memory buy, Order memory sell)
                internal
                returns (uint)
            {
                /* Only payable in the special case of unwrapped Ether. */
                if (sell.paymentToken != address(0)) {
                    require(msg.value == 0);
                }
        
                /* Calculate match price. */
                uint price = calculateMatchPrice(buy, sell);
        
                /* If paying using a token (not Ether), transfer tokens. This is done prior to fee payments to that a seller will have tokens before being charged fees. */
                if (price > 0 && sell.paymentToken != address(0)) {
                    transferTokens(sell.paymentToken, buy.maker, sell.maker, price);
                }
        
                /* Amount that will be received by seller (for Ether). */
                uint receiveAmount = price;
        
                /* Amount that must be sent by buyer (for Ether). */
                uint requiredAmount = price;
        
                /* Determine maker/taker and charge fees accordingly. */
                if (sell.feeRecipient != address(0)) {
                    /* Sell-side order is maker. */
              
                    /* Assert taker fee is less than or equal to maximum fee specified by buyer. */
                    require(sell.takerRelayerFee <= buy.takerRelayerFee);
        
                    if (sell.feeMethod == FeeMethod.SplitFee) {
                        /* Assert taker fee is less than or equal to maximum fee specified by buyer. */
                        require(sell.takerProtocolFee <= buy.takerProtocolFee);
        
                        /* Maker fees are deducted from the token amount that the maker receives. Taker fees are extra tokens that must be paid by the taker. */
        
                        if (sell.makerRelayerFee > 0) {
                            uint makerRelayerFee = SafeMath.div(SafeMath.mul(sell.makerRelayerFee, price), INVERSE_BASIS_POINT);
                            if (sell.paymentToken == address(0)) {
                                receiveAmount = SafeMath.sub(receiveAmount, makerRelayerFee);
                                sell.feeRecipient.transfer(makerRelayerFee);
                            } else {
                                transferTokens(sell.paymentToken, sell.maker, sell.feeRecipient, makerRelayerFee);
                            }
                        }
        
                        if (sell.takerRelayerFee > 0) {
                            uint takerRelayerFee = SafeMath.div(SafeMath.mul(sell.takerRelayerFee, price), INVERSE_BASIS_POINT);
                            if (sell.paymentToken == address(0)) {
                                requiredAmount = SafeMath.add(requiredAmount, takerRelayerFee);
                                sell.feeRecipient.transfer(takerRelayerFee);
                            } else {
                                transferTokens(sell.paymentToken, buy.maker, sell.feeRecipient, takerRelayerFee);
                            }
                        }
        
                        if (sell.makerProtocolFee > 0) {
                            uint makerProtocolFee = SafeMath.div(SafeMath.mul(sell.makerProtocolFee, price), INVERSE_BASIS_POINT);
                            if (sell.paymentToken == address(0)) {
                                receiveAmount = SafeMath.sub(receiveAmount, makerProtocolFee);
                                protocolFeeRecipient.transfer(makerProtocolFee);
                            } else {
                                transferTokens(sell.paymentToken, sell.maker, protocolFeeRecipient, makerProtocolFee);
                            }
                        }
        
                        if (sell.takerProtocolFee > 0) {
                            uint takerProtocolFee = SafeMath.div(SafeMath.mul(sell.takerProtocolFee, price), INVERSE_BASIS_POINT);
                            if (sell.paymentToken == address(0)) {
                                requiredAmount = SafeMath.add(requiredAmount, takerProtocolFee);
                                protocolFeeRecipient.transfer(takerProtocolFee);
                            } else {
                                transferTokens(sell.paymentToken, buy.maker, protocolFeeRecipient, takerProtocolFee);
                            }
                        }
        
                    } else {
                        /* Charge maker fee to seller. */
                        chargeProtocolFee(sell.maker, sell.feeRecipient, sell.makerRelayerFee);
        
                        /* Charge taker fee to buyer. */
                        chargeProtocolFee(buy.maker, sell.feeRecipient, sell.takerRelayerFee);
                    }
                } else {
                    /* Buy-side order is maker. */
        
                    /* Assert taker fee is less than or equal to maximum fee specified by seller. */
                    require(buy.takerRelayerFee <= sell.takerRelayerFee);
        
                    if (sell.feeMethod == FeeMethod.SplitFee) {
                        /* The Exchange does not escrow Ether, so direct Ether can only be used to with sell-side maker / buy-side taker orders. */
                        require(sell.paymentToken != address(0));
        
                        /* Assert taker fee is less than or equal to maximum fee specified by seller. */
                        require(buy.takerProtocolFee <= sell.takerProtocolFee);
        
                        if (buy.makerRelayerFee > 0) {
                            makerRelayerFee = SafeMath.div(SafeMath.mul(buy.makerRelayerFee, price), INVERSE_BASIS_POINT);
                            transferTokens(sell.paymentToken, buy.maker, buy.feeRecipient, makerRelayerFee);
                        }
        
                        if (buy.takerRelayerFee > 0) {
                            takerRelayerFee = SafeMath.div(SafeMath.mul(buy.takerRelayerFee, price), INVERSE_BASIS_POINT);
                            transferTokens(sell.paymentToken, sell.maker, buy.feeRecipient, takerRelayerFee);
                        }
        
                        if (buy.makerProtocolFee > 0) {
                            makerProtocolFee = SafeMath.div(SafeMath.mul(buy.makerProtocolFee, price), INVERSE_BASIS_POINT);
                            transferTokens(sell.paymentToken, buy.maker, protocolFeeRecipient, makerProtocolFee);
                        }
        
                        if (buy.takerProtocolFee > 0) {
                            takerProtocolFee = SafeMath.div(SafeMath.mul(buy.takerProtocolFee, price), INVERSE_BASIS_POINT);
                            transferTokens(sell.paymentToken, sell.maker, protocolFeeRecipient, takerProtocolFee);
                        }
        
                    } else {
                        /* Charge maker fee to buyer. */
                        chargeProtocolFee(buy.maker, buy.feeRecipient, buy.makerRelayerFee);
              
                        /* Charge taker fee to seller. */
                        chargeProtocolFee(sell.maker, buy.feeRecipient, buy.takerRelayerFee);
                    }
                }
        
                if (sell.paymentToken == address(0)) {
                    /* Special-case Ether, order must be matched by buyer. */
                    require(msg.value >= requiredAmount);
                    sell.maker.transfer(receiveAmount);
                    /* Allow overshoot for variable-price auctions, refund difference. */
                    uint diff = SafeMath.sub(msg.value, requiredAmount);
                    if (diff > 0) {
                        buy.maker.transfer(diff);
                    }
                }
        
                /* This contract should never hold Ether, however, we cannot assert this, since it is impossible to prevent anyone from sending Ether e.g. with selfdestruct. */
        
                return price;
            }
        
            /**
             * @dev Return whether or not two orders can be matched with each other by basic parameters (does not check order signatures / calldata or perform static calls)
             * @param buy Buy-side order
             * @param sell Sell-side order
             * @return Whether or not the two orders can be matched
             */
            function ordersCanMatch(Order memory buy, Order memory sell)
                internal
                view
                returns (bool)
            {
                return (
                    /* Must be opposite-side. */
                    (buy.side == SaleKindInterface.Side.Buy && sell.side == SaleKindInterface.Side.Sell) &&     
                    /* Must use same fee method. */
                    (buy.feeMethod == sell.feeMethod) &&
                    /* Must use same payment token. */
                    (buy.paymentToken == sell.paymentToken) &&
                    /* Must match maker/taker addresses. */
                    (sell.taker == address(0) || sell.taker == buy.maker) &&
                    (buy.taker == address(0) || buy.taker == sell.maker) &&
                    /* One must be maker and the other must be taker (no bool XOR in Solidity). */
                    ((sell.feeRecipient == address(0) && buy.feeRecipient != address(0)) || (sell.feeRecipient != address(0) && buy.feeRecipient == address(0))) &&
                    /* Must match target. */
                    (buy.target == sell.target) &&
                    /* Must match howToCall. */
                    (buy.howToCall == sell.howToCall) &&
                    /* Buy-side order must be settleable. */
                    SaleKindInterface.canSettleOrder(buy.listingTime, buy.expirationTime) &&
                    /* Sell-side order must be settleable. */
                    SaleKindInterface.canSettleOrder(sell.listingTime, sell.expirationTime)
                );
            }
        
            /**
             * @dev Atomically match two orders, ensuring validity of the match, and execute all associated state transitions. Protected against reentrancy by a contract-global lock.
             * @param buy Buy-side order
             * @param buySig Buy-side order signature
             * @param sell Sell-side order
             * @param sellSig Sell-side order signature
             */
            function atomicMatch(Order memory buy, Sig memory buySig, Order memory sell, Sig memory sellSig, bytes32 metadata)
                internal
                reentrancyGuard
            {
                /* CHECKS */
              
                /* Ensure buy order validity and calculate hash if necessary. */
                bytes32 buyHash;
                if (buy.maker == msg.sender) {
                    require(validateOrderParameters(buy));
                } else {
                    buyHash = requireValidOrder(buy, buySig);
                }
        
                /* Ensure sell order validity and calculate hash if necessary. */
                bytes32 sellHash;
                if (sell.maker == msg.sender) {
                    require(validateOrderParameters(sell));
                } else {
                    sellHash = requireValidOrder(sell, sellSig);
                }
                
                /* Must be matchable. */
                require(ordersCanMatch(buy, sell));
        
                /* Target must exist (prevent malicious selfdestructs just prior to order settlement). */
                uint size;
                address target = sell.target;
                assembly {
                    size := extcodesize(target)
                }
                require(size > 0);
              
                /* Must match calldata after replacement, if specified. */ 
                if (buy.replacementPattern.length > 0) {
                  ArrayUtils.guardedArrayReplace(buy.calldata, sell.calldata, buy.replacementPattern);
                }
                if (sell.replacementPattern.length > 0) {
                  ArrayUtils.guardedArrayReplace(sell.calldata, buy.calldata, sell.replacementPattern);
                }
                require(ArrayUtils.arrayEq(buy.calldata, sell.calldata));
        
                /* Retrieve delegateProxy contract. */
                OwnableDelegateProxy delegateProxy = registry.proxies(sell.maker);
        
                /* Proxy must exist. */
                require(delegateProxy != address(0));
        
                /* Assert implementation. */
                require(delegateProxy.implementation() == registry.delegateProxyImplementation());
        
                /* Access the passthrough AuthenticatedProxy. */
                AuthenticatedProxy proxy = AuthenticatedProxy(delegateProxy);
        
                /* EFFECTS */
        
                /* Mark previously signed or approved orders as finalized. */
                if (msg.sender != buy.maker) {
                    cancelledOrFinalized[buyHash] = true;
                }
                if (msg.sender != sell.maker) {
                    cancelledOrFinalized[sellHash] = true;
                }
        
                /* INTERACTIONS */
        
                /* Execute funds transfer and pay fees. */
                uint price = executeFundsTransfer(buy, sell);
        
                /* Execute specified call through proxy. */
                require(proxy.proxy(sell.target, sell.howToCall, sell.calldata));
        
                /* Static calls are intentionally done after the effectful call so they can check resulting state. */
        
                /* Handle buy-side static call if specified. */
                if (buy.staticTarget != address(0)) {
                    require(staticCall(buy.staticTarget, sell.calldata, buy.staticExtradata));
                }
        
                /* Handle sell-side static call if specified. */
                if (sell.staticTarget != address(0)) {
                    require(staticCall(sell.staticTarget, sell.calldata, sell.staticExtradata));
                }
        
                /* Log match event. */
                emit OrdersMatched(buyHash, sellHash, sell.feeRecipient != address(0) ? sell.maker : buy.maker, sell.feeRecipient != address(0) ? buy.maker : sell.maker, price, metadata);
            }
        
        }
        
        contract Exchange is ExchangeCore {
        
            /**
             * @dev Call guardedArrayReplace - library function exposed for testing.
             */
            function guardedArrayReplace(bytes array, bytes desired, bytes mask)
                public
                pure
                returns (bytes)
            {
                ArrayUtils.guardedArrayReplace(array, desired, mask);
                return array;
            }
        
            /**
             * Test copy byte array
             *
             * @param arrToCopy Array to copy
             * @return byte array
             */
            function testCopy(bytes arrToCopy)
                public
                pure
                returns (bytes)
            {
                bytes memory arr = new bytes(arrToCopy.length);
                uint index;
                assembly {
                    index := add(arr, 0x20)
                }
                ArrayUtils.unsafeWriteBytes(index, arrToCopy);
                return arr;
            }
        
            /**
             * Test write address to bytes
             *
             * @param addr Address to write
             * @return byte array
             */
            function testCopyAddress(address addr)
                public
                pure
                returns (bytes)
            {
                bytes memory arr = new bytes(0x14);
                uint index;
                assembly {
                    index := add(arr, 0x20)
                }
                ArrayUtils.unsafeWriteAddress(index, addr);
                return arr;
            }
        
            /**
             * @dev Call calculateFinalPrice - library function exposed for testing.
             */
            function calculateFinalPrice(SaleKindInterface.Side side, SaleKindInterface.SaleKind saleKind, uint basePrice, uint extra, uint listingTime, uint expirationTime)
                public
                view
                returns (uint)
            {
                return SaleKindInterface.calculateFinalPrice(side, saleKind, basePrice, extra, listingTime, expirationTime);
            }
        
            /**
             * @dev Call hashOrder - Solidity ABI encoding limitation workaround, hopefully temporary.
             */
            function hashOrder_(
                address[7] addrs,
                uint[9] uints,
                FeeMethod feeMethod,
                SaleKindInterface.Side side,
                SaleKindInterface.SaleKind saleKind,
                AuthenticatedProxy.HowToCall howToCall,
                bytes calldata,
                bytes replacementPattern,
                bytes staticExtradata)
                public
                pure
                returns (bytes32)
            {
                return hashOrder(
                  Order(addrs[0], addrs[1], addrs[2], uints[0], uints[1], uints[2], uints[3], addrs[3], feeMethod, side, saleKind, addrs[4], howToCall, calldata, replacementPattern, addrs[5], staticExtradata, ERC20(addrs[6]), uints[4], uints[5], uints[6], uints[7], uints[8])
                );
            }
        
            /**
             * @dev Call hashToSign - Solidity ABI encoding limitation workaround, hopefully temporary.
             */
            function hashToSign_(
                address[7] addrs,
                uint[9] uints,
                FeeMethod feeMethod,
                SaleKindInterface.Side side,
                SaleKindInterface.SaleKind saleKind,
                AuthenticatedProxy.HowToCall howToCall,
                bytes calldata,
                bytes replacementPattern,
                bytes staticExtradata)
                public
                pure
                returns (bytes32)
            { 
                return hashToSign(
                  Order(addrs[0], addrs[1], addrs[2], uints[0], uints[1], uints[2], uints[3], addrs[3], feeMethod, side, saleKind, addrs[4], howToCall, calldata, replacementPattern, addrs[5], staticExtradata, ERC20(addrs[6]), uints[4], uints[5], uints[6], uints[7], uints[8])
                );
            }
        
            /**
             * @dev Call validateOrderParameters - Solidity ABI encoding limitation workaround, hopefully temporary.
             */
            function validateOrderParameters_ (
                address[7] addrs,
                uint[9] uints,
                FeeMethod feeMethod,
                SaleKindInterface.Side side,
                SaleKindInterface.SaleKind saleKind,
                AuthenticatedProxy.HowToCall howToCall,
                bytes calldata,
                bytes replacementPattern,
                bytes staticExtradata)
                view
                public
                returns (bool)
            {
                Order memory order = Order(addrs[0], addrs[1], addrs[2], uints[0], uints[1], uints[2], uints[3], addrs[3], feeMethod, side, saleKind, addrs[4], howToCall, calldata, replacementPattern, addrs[5], staticExtradata, ERC20(addrs[6]), uints[4], uints[5], uints[6], uints[7], uints[8]);
                return validateOrderParameters(
                  order
                );
            }
        
            /**
             * @dev Call validateOrder - Solidity ABI encoding limitation workaround, hopefully temporary.
             */
            function validateOrder_ (
                address[7] addrs,
                uint[9] uints,
                FeeMethod feeMethod,
                SaleKindInterface.Side side,
                SaleKindInterface.SaleKind saleKind,
                AuthenticatedProxy.HowToCall howToCall,
                bytes calldata,
                bytes replacementPattern,
                bytes staticExtradata,
                uint8 v,
                bytes32 r,
                bytes32 s)
                view
                public
                returns (bool)
            {
                Order memory order = Order(addrs[0], addrs[1], addrs[2], uints[0], uints[1], uints[2], uints[3], addrs[3], feeMethod, side, saleKind, addrs[4], howToCall, calldata, replacementPattern, addrs[5], staticExtradata, ERC20(addrs[6]), uints[4], uints[5], uints[6], uints[7], uints[8]);
                return validateOrder(
                  hashToSign(order),
                  order,
                  Sig(v, r, s)
                );
            }
        
            /**
             * @dev Call approveOrder - Solidity ABI encoding limitation workaround, hopefully temporary.
             */
            function approveOrder_ (
                address[7] addrs,
                uint[9] uints,
                FeeMethod feeMethod,
                SaleKindInterface.Side side,
                SaleKindInterface.SaleKind saleKind,
                AuthenticatedProxy.HowToCall howToCall,
                bytes calldata,
                bytes replacementPattern,
                bytes staticExtradata,
                bool orderbookInclusionDesired) 
                public
            {
                Order memory order = Order(addrs[0], addrs[1], addrs[2], uints[0], uints[1], uints[2], uints[3], addrs[3], feeMethod, side, saleKind, addrs[4], howToCall, calldata, replacementPattern, addrs[5], staticExtradata, ERC20(addrs[6]), uints[4], uints[5], uints[6], uints[7], uints[8]);
                return approveOrder(order, orderbookInclusionDesired);
            }
        
            /**
             * @dev Call cancelOrder - Solidity ABI encoding limitation workaround, hopefully temporary.
             */
            function cancelOrder_(
                address[7] addrs,
                uint[9] uints,
                FeeMethod feeMethod,
                SaleKindInterface.Side side,
                SaleKindInterface.SaleKind saleKind,
                AuthenticatedProxy.HowToCall howToCall,
                bytes calldata,
                bytes replacementPattern,
                bytes staticExtradata,
                uint8 v,
                bytes32 r,
                bytes32 s)
                public
            {
        
                return cancelOrder(
                  Order(addrs[0], addrs[1], addrs[2], uints[0], uints[1], uints[2], uints[3], addrs[3], feeMethod, side, saleKind, addrs[4], howToCall, calldata, replacementPattern, addrs[5], staticExtradata, ERC20(addrs[6]), uints[4], uints[5], uints[6], uints[7], uints[8]),
                  Sig(v, r, s)
                );
            }
        
            /**
             * @dev Call calculateCurrentPrice - Solidity ABI encoding limitation workaround, hopefully temporary.
             */
            function calculateCurrentPrice_(
                address[7] addrs,
                uint[9] uints,
                FeeMethod feeMethod,
                SaleKindInterface.Side side,
                SaleKindInterface.SaleKind saleKind,
                AuthenticatedProxy.HowToCall howToCall,
                bytes calldata,
                bytes replacementPattern,
                bytes staticExtradata)
                public
                view
                returns (uint)
            {
                return calculateCurrentPrice(
                  Order(addrs[0], addrs[1], addrs[2], uints[0], uints[1], uints[2], uints[3], addrs[3], feeMethod, side, saleKind, addrs[4], howToCall, calldata, replacementPattern, addrs[5], staticExtradata, ERC20(addrs[6]), uints[4], uints[5], uints[6], uints[7], uints[8])
                );
            }
        
            /**
             * @dev Call ordersCanMatch - Solidity ABI encoding limitation workaround, hopefully temporary.
             */
            function ordersCanMatch_(
                address[14] addrs,
                uint[18] uints,
                uint8[8] feeMethodsSidesKindsHowToCalls,
                bytes calldataBuy,
                bytes calldataSell,
                bytes replacementPatternBuy,
                bytes replacementPatternSell,
                bytes staticExtradataBuy,
                bytes staticExtradataSell)
                public
                view
                returns (bool)
            {
                Order memory buy = Order(addrs[0], addrs[1], addrs[2], uints[0], uints[1], uints[2], uints[3], addrs[3], FeeMethod(feeMethodsSidesKindsHowToCalls[0]), SaleKindInterface.Side(feeMethodsSidesKindsHowToCalls[1]), SaleKindInterface.SaleKind(feeMethodsSidesKindsHowToCalls[2]), addrs[4], AuthenticatedProxy.HowToCall(feeMethodsSidesKindsHowToCalls[3]), calldataBuy, replacementPatternBuy, addrs[5], staticExtradataBuy, ERC20(addrs[6]), uints[4], uints[5], uints[6], uints[7], uints[8]);
                Order memory sell = Order(addrs[7], addrs[8], addrs[9], uints[9], uints[10], uints[11], uints[12], addrs[10], FeeMethod(feeMethodsSidesKindsHowToCalls[4]), SaleKindInterface.Side(feeMethodsSidesKindsHowToCalls[5]), SaleKindInterface.SaleKind(feeMethodsSidesKindsHowToCalls[6]), addrs[11], AuthenticatedProxy.HowToCall(feeMethodsSidesKindsHowToCalls[7]), calldataSell, replacementPatternSell, addrs[12], staticExtradataSell, ERC20(addrs[13]), uints[13], uints[14], uints[15], uints[16], uints[17]);
                return ordersCanMatch(
                  buy,
                  sell
                );
            }
        
            /**
             * @dev Return whether or not two orders' calldata specifications can match
             * @param buyCalldata Buy-side order calldata
             * @param buyReplacementPattern Buy-side order calldata replacement mask
             * @param sellCalldata Sell-side order calldata
             * @param sellReplacementPattern Sell-side order calldata replacement mask
             * @return Whether the orders' calldata can be matched
             */
            function orderCalldataCanMatch(bytes buyCalldata, bytes buyReplacementPattern, bytes sellCalldata, bytes sellReplacementPattern)
                public
                pure
                returns (bool)
            {
                if (buyReplacementPattern.length > 0) {
                  ArrayUtils.guardedArrayReplace(buyCalldata, sellCalldata, buyReplacementPattern);
                }
                if (sellReplacementPattern.length > 0) {
                  ArrayUtils.guardedArrayReplace(sellCalldata, buyCalldata, sellReplacementPattern);
                }
                return ArrayUtils.arrayEq(buyCalldata, sellCalldata);
            }
        
            /**
             * @dev Call calculateMatchPrice - Solidity ABI encoding limitation workaround, hopefully temporary.
             */
            function calculateMatchPrice_(
                address[14] addrs,
                uint[18] uints,
                uint8[8] feeMethodsSidesKindsHowToCalls,
                bytes calldataBuy,
                bytes calldataSell,
                bytes replacementPatternBuy,
                bytes replacementPatternSell,
                bytes staticExtradataBuy,
                bytes staticExtradataSell)
                public
                view
                returns (uint)
            {
                Order memory buy = Order(addrs[0], addrs[1], addrs[2], uints[0], uints[1], uints[2], uints[3], addrs[3], FeeMethod(feeMethodsSidesKindsHowToCalls[0]), SaleKindInterface.Side(feeMethodsSidesKindsHowToCalls[1]), SaleKindInterface.SaleKind(feeMethodsSidesKindsHowToCalls[2]), addrs[4], AuthenticatedProxy.HowToCall(feeMethodsSidesKindsHowToCalls[3]), calldataBuy, replacementPatternBuy, addrs[5], staticExtradataBuy, ERC20(addrs[6]), uints[4], uints[5], uints[6], uints[7], uints[8]);
                Order memory sell = Order(addrs[7], addrs[8], addrs[9], uints[9], uints[10], uints[11], uints[12], addrs[10], FeeMethod(feeMethodsSidesKindsHowToCalls[4]), SaleKindInterface.Side(feeMethodsSidesKindsHowToCalls[5]), SaleKindInterface.SaleKind(feeMethodsSidesKindsHowToCalls[6]), addrs[11], AuthenticatedProxy.HowToCall(feeMethodsSidesKindsHowToCalls[7]), calldataSell, replacementPatternSell, addrs[12], staticExtradataSell, ERC20(addrs[13]), uints[13], uints[14], uints[15], uints[16], uints[17]);
                return calculateMatchPrice(
                  buy,
                  sell
                );
            }
        
            /**
             * @dev Call atomicMatch - Solidity ABI encoding limitation workaround, hopefully temporary.
             */
            function atomicMatch_(
                address[14] addrs,
                uint[18] uints,
                uint8[8] feeMethodsSidesKindsHowToCalls,
                bytes calldataBuy,
                bytes calldataSell,
                bytes replacementPatternBuy,
                bytes replacementPatternSell,
                bytes staticExtradataBuy,
                bytes staticExtradataSell,
                uint8[2] vs,
                bytes32[5] rssMetadata)
                public
                payable
            {
        
                return atomicMatch(
                  Order(addrs[0], addrs[1], addrs[2], uints[0], uints[1], uints[2], uints[3], addrs[3], FeeMethod(feeMethodsSidesKindsHowToCalls[0]), SaleKindInterface.Side(feeMethodsSidesKindsHowToCalls[1]), SaleKindInterface.SaleKind(feeMethodsSidesKindsHowToCalls[2]), addrs[4], AuthenticatedProxy.HowToCall(feeMethodsSidesKindsHowToCalls[3]), calldataBuy, replacementPatternBuy, addrs[5], staticExtradataBuy, ERC20(addrs[6]), uints[4], uints[5], uints[6], uints[7], uints[8]),
                  Sig(vs[0], rssMetadata[0], rssMetadata[1]),
                  Order(addrs[7], addrs[8], addrs[9], uints[9], uints[10], uints[11], uints[12], addrs[10], FeeMethod(feeMethodsSidesKindsHowToCalls[4]), SaleKindInterface.Side(feeMethodsSidesKindsHowToCalls[5]), SaleKindInterface.SaleKind(feeMethodsSidesKindsHowToCalls[6]), addrs[11], AuthenticatedProxy.HowToCall(feeMethodsSidesKindsHowToCalls[7]), calldataSell, replacementPatternSell, addrs[12], staticExtradataSell, ERC20(addrs[13]), uints[13], uints[14], uints[15], uints[16], uints[17]),
                  Sig(vs[1], rssMetadata[2], rssMetadata[3]),
                  rssMetadata[4]
                );
            }
        
        }
        
        contract WyvernExchange is Exchange {
        
            string public constant name = "Project Wyvern Exchange";
        
            string public constant version = "2.2";
        
            string public constant codename = "Lambton Worm";
        
            /**
             * @dev Initialize a WyvernExchange instance
             * @param registryAddress Address of the registry instance which this Exchange instance will use
             * @param tokenAddress Address of the token used for protocol fees
             */
            constructor (ProxyRegistry registryAddress, TokenTransferProxy tokenTransferProxyAddress, ERC20 tokenAddress, address protocolFeeAddress) public {
                registry = registryAddress;
                tokenTransferProxy = tokenTransferProxyAddress;
                exchangeToken = tokenAddress;
                protocolFeeRecipient = protocolFeeAddress;
                owner = msg.sender;
            }
        
        }
        
        library SaleKindInterface {
        
            /**
             * Side: buy or sell.
             */
            enum Side { Buy, Sell }
        
            /**
             * Currently supported kinds of sale: fixed price, Dutch auction. 
             * English auctions cannot be supported without stronger escrow guarantees.
             * Future interesting options: Vickrey auction, nonlinear Dutch auctions.
             */
            enum SaleKind { FixedPrice, DutchAuction }
        
            /**
             * @dev Check whether the parameters of a sale are valid
             * @param saleKind Kind of sale
             * @param expirationTime Order expiration time
             * @return Whether the parameters were valid
             */
            function validateParameters(SaleKind saleKind, uint expirationTime)
                pure
                internal
                returns (bool)
            {
                /* Auctions must have a set expiration date. */
                return (saleKind == SaleKind.FixedPrice || expirationTime > 0);
            }
        
            /**
             * @dev Return whether or not an order can be settled
             * @dev Precondition: parameters have passed validateParameters
             * @param listingTime Order listing time
             * @param expirationTime Order expiration time
             */
            function canSettleOrder(uint listingTime, uint expirationTime)
                view
                internal
                returns (bool)
            {
                return (listingTime < now) && (expirationTime == 0 || now < expirationTime);
            }
        
            /**
             * @dev Calculate the settlement price of an order
             * @dev Precondition: parameters have passed validateParameters.
             * @param side Order side
             * @param saleKind Method of sale
             * @param basePrice Order base price
             * @param extra Order extra price data
             * @param listingTime Order listing time
             * @param expirationTime Order expiration time
             */
            function calculateFinalPrice(Side side, SaleKind saleKind, uint basePrice, uint extra, uint listingTime, uint expirationTime)
                view
                internal
                returns (uint finalPrice)
            {
                if (saleKind == SaleKind.FixedPrice) {
                    return basePrice;
                } else if (saleKind == SaleKind.DutchAuction) {
                    uint diff = SafeMath.div(SafeMath.mul(extra, SafeMath.sub(now, listingTime)), SafeMath.sub(expirationTime, listingTime));
                    if (side == Side.Sell) {
                        /* Sell-side - start price: basePrice. End price: basePrice - extra. */
                        return SafeMath.sub(basePrice, diff);
                    } else {
                        /* Buy-side - start price: basePrice. End price: basePrice + extra. */
                        return SafeMath.add(basePrice, diff);
                    }
                }
            }
        
        }
        
        contract ProxyRegistry is Ownable {
        
            /* DelegateProxy implementation contract. Must be initialized. */
            address public delegateProxyImplementation;
        
            /* Authenticated proxies by user. */
            mapping(address => OwnableDelegateProxy) public proxies;
        
            /* Contracts pending access. */
            mapping(address => uint) public pending;
        
            /* Contracts allowed to call those proxies. */
            mapping(address => bool) public contracts;
        
            /* Delay period for adding an authenticated contract.
               This mitigates a particular class of potential attack on the Wyvern DAO (which owns this registry) - if at any point the value of assets held by proxy contracts exceeded the value of half the WYV supply (votes in the DAO),
               a malicious but rational attacker could buy half the Wyvern and grant themselves access to all the proxy contracts. A delay period renders this attack nonthreatening - given two weeks, if that happened, users would have
               plenty of time to notice and transfer their assets.
            */
            uint public DELAY_PERIOD = 2 weeks;
        
            /**
             * Start the process to enable access for specified contract. Subject to delay period.
             *
             * @dev ProxyRegistry owner only
             * @param addr Address to which to grant permissions
             */
            function startGrantAuthentication (address addr)
                public
                onlyOwner
            {
                require(!contracts[addr] && pending[addr] == 0);
                pending[addr] = now;
            }
        
            /**
             * End the process to nable access for specified contract after delay period has passed.
             *
             * @dev ProxyRegistry owner only
             * @param addr Address to which to grant permissions
             */
            function endGrantAuthentication (address addr)
                public
                onlyOwner
            {
                require(!contracts[addr] && pending[addr] != 0 && ((pending[addr] + DELAY_PERIOD) < now));
                pending[addr] = 0;
                contracts[addr] = true;
            }
        
            /**
             * Revoke access for specified contract. Can be done instantly.
             *
             * @dev ProxyRegistry owner only
             * @param addr Address of which to revoke permissions
             */    
            function revokeAuthentication (address addr)
                public
                onlyOwner
            {
                contracts[addr] = false;
            }
        
            /**
             * Register a proxy contract with this registry
             *
             * @dev Must be called by the user which the proxy is for, creates a new AuthenticatedProxy
             * @return New AuthenticatedProxy contract
             */
            function registerProxy()
                public
                returns (OwnableDelegateProxy proxy)
            {
                require(proxies[msg.sender] == address(0));
                proxy = new OwnableDelegateProxy(msg.sender, delegateProxyImplementation, abi.encodeWithSignature("initialize(address,address)", msg.sender, address(this)));
                proxies[msg.sender] = proxy;
                return proxy;
            }
        
        }
        
        contract TokenTransferProxy {
        
            /* Authentication registry. */
            ProxyRegistry public registry;
        
            /**
             * Call ERC20 `transferFrom`
             *
             * @dev Authenticated contract only
             * @param token ERC20 token address
             * @param from From address
             * @param to To address
             * @param amount Transfer amount
             */
            function transferFrom(address token, address from, address to, uint amount)
                public
                returns (bool)
            {
                require(registry.contracts(msg.sender));
                return ERC20(token).transferFrom(from, to, amount);
            }
        
        }
        
        contract OwnedUpgradeabilityStorage {
        
          // Current implementation
          address internal _implementation;
        
          // Owner of the contract
          address private _upgradeabilityOwner;
        
          /**
           * @dev Tells the address of the owner
           * @return the address of the owner
           */
          function upgradeabilityOwner() public view returns (address) {
            return _upgradeabilityOwner;
          }
        
          /**
           * @dev Sets the address of the owner
           */
          function setUpgradeabilityOwner(address newUpgradeabilityOwner) internal {
            _upgradeabilityOwner = newUpgradeabilityOwner;
          }
        
          /**
          * @dev Tells the address of the current implementation
          * @return address of the current implementation
          */
          function implementation() public view returns (address) {
            return _implementation;
          }
        
          /**
          * @dev Tells the proxy type (EIP 897)
          * @return Proxy type, 2 for forwarding proxy
          */
          function proxyType() public pure returns (uint256 proxyTypeId) {
            return 2;
          }
        }
        
        contract AuthenticatedProxy is TokenRecipient, OwnedUpgradeabilityStorage {
        
            /* Whether initialized. */
            bool initialized = false;
        
            /* Address which owns this proxy. */
            address public user;
        
            /* Associated registry with contract authentication information. */
            ProxyRegistry public registry;
        
            /* Whether access has been revoked. */
            bool public revoked;
        
            /* Delegate call could be used to atomically transfer multiple assets owned by the proxy contract with one order. */
            enum HowToCall { Call, DelegateCall }
        
            /* Event fired when the proxy access is revoked or unrevoked. */
            event Revoked(bool revoked);
        
            /**
             * Initialize an AuthenticatedProxy
             *
             * @param addrUser Address of user on whose behalf this proxy will act
             * @param addrRegistry Address of ProxyRegistry contract which will manage this proxy
             */
            function initialize (address addrUser, ProxyRegistry addrRegistry)
                public
            {
                require(!initialized);
                initialized = true;
                user = addrUser;
                registry = addrRegistry;
            }
        
            /**
             * Set the revoked flag (allows a user to revoke ProxyRegistry access)
             *
             * @dev Can be called by the user only
             * @param revoke Whether or not to revoke access
             */
            function setRevoke(bool revoke)
                public
            {
                require(msg.sender == user);
                revoked = revoke;
                emit Revoked(revoke);
            }
        
            /**
             * Execute a message call from the proxy contract
             *
             * @dev Can be called by the user, or by a contract authorized by the registry as long as the user has not revoked access
             * @param dest Address to which the call will be sent
             * @param howToCall Which kind of call to make
             * @param calldata Calldata to send
             * @return Result of the call (success or failure)
             */
            function proxy(address dest, HowToCall howToCall, bytes calldata)
                public
                returns (bool result)
            {
                require(msg.sender == user || (!revoked && registry.contracts(msg.sender)));
                if (howToCall == HowToCall.Call) {
                    result = dest.call(calldata);
                } else if (howToCall == HowToCall.DelegateCall) {
                    result = dest.delegatecall(calldata);
                }
                return result;
            }
        
            /**
             * Execute a message call and assert success
             * 
             * @dev Same functionality as `proxy`, just asserts the return value
             * @param dest Address to which the call will be sent
             * @param howToCall What kind of call to make
             * @param calldata Calldata to send
             */
            function proxyAssert(address dest, HowToCall howToCall, bytes calldata)
                public
            {
                require(proxy(dest, howToCall, calldata));
            }
        
        }
        
        contract Proxy {
        
          /**
          * @dev Tells the address of the implementation where every call will be delegated.
          * @return address of the implementation to which it will be delegated
          */
          function implementation() public view returns (address);
        
          /**
          * @dev Tells the type of proxy (EIP 897)
          * @return Type of proxy, 2 for upgradeable proxy
          */
          function proxyType() public pure returns (uint256 proxyTypeId);
        
          /**
          * @dev Fallback function allowing to perform a delegatecall to the given implementation.
          * This function will return whatever the implementation call returns
          */
          function () payable public {
            address _impl = implementation();
            require(_impl != address(0));
        
            assembly {
              let ptr := mload(0x40)
              calldatacopy(ptr, 0, calldatasize)
              let result := delegatecall(gas, _impl, ptr, calldatasize, 0, 0)
              let size := returndatasize
              returndatacopy(ptr, 0, size)
        
              switch result
              case 0 { revert(ptr, size) }
              default { return(ptr, size) }
            }
          }
        }
        
        contract OwnedUpgradeabilityProxy is Proxy, OwnedUpgradeabilityStorage {
          /**
          * @dev Event to show ownership has been transferred
          * @param previousOwner representing the address of the previous owner
          * @param newOwner representing the address of the new owner
          */
          event ProxyOwnershipTransferred(address previousOwner, address newOwner);
        
          /**
          * @dev This event will be emitted every time the implementation gets upgraded
          * @param implementation representing the address of the upgraded implementation
          */
          event Upgraded(address indexed implementation);
        
          /**
          * @dev Upgrades the implementation address
          * @param implementation representing the address of the new implementation to be set
          */
          function _upgradeTo(address implementation) internal {
            require(_implementation != implementation);
            _implementation = implementation;
            emit Upgraded(implementation);
          }
        
          /**
          * @dev Throws if called by any account other than the owner.
          */
          modifier onlyProxyOwner() {
            require(msg.sender == proxyOwner());
            _;
          }
        
          /**
           * @dev Tells the address of the proxy owner
           * @return the address of the proxy owner
           */
          function proxyOwner() public view returns (address) {
            return upgradeabilityOwner();
          }
        
          /**
           * @dev Allows the current owner to transfer control of the contract to a newOwner.
           * @param newOwner The address to transfer ownership to.
           */
          function transferProxyOwnership(address newOwner) public onlyProxyOwner {
            require(newOwner != address(0));
            emit ProxyOwnershipTransferred(proxyOwner(), newOwner);
            setUpgradeabilityOwner(newOwner);
          }
        
          /**
           * @dev Allows the upgradeability owner to upgrade the current implementation of the proxy.
           * @param implementation representing the address of the new implementation to be set.
           */
          function upgradeTo(address implementation) public onlyProxyOwner {
            _upgradeTo(implementation);
          }
        
          /**
           * @dev Allows the upgradeability owner to upgrade the current implementation of the proxy
           * and delegatecall the new implementation for initialization.
           * @param implementation representing the address of the new implementation to be set.
           * @param data represents the msg.data to bet sent in the low level call. This parameter may include the function
           * signature of the implementation to be called with the needed payload
           */
          function upgradeToAndCall(address implementation, bytes data) payable public onlyProxyOwner {
            upgradeTo(implementation);
            require(address(this).delegatecall(data));
          }
        }
        
        contract OwnableDelegateProxy is OwnedUpgradeabilityProxy {
        
            constructor(address owner, address initialImplementation, bytes calldata)
                public
            {
                setUpgradeabilityOwner(owner);
                _upgradeTo(initialImplementation);
                require(initialImplementation.delegatecall(calldata));
            }
        
        }