ETH Price: $1,946.04 (-2.09%)

Transaction Decoder

Block:
14794571 at May-17-2022 08:14:46 PM +UTC
Transaction Fee:
0.011999534156647876 ETH $23.35
Gas Used:
217,223 Gas / 55.240624412 Gwei

Emitted Events:

322 EmblemVault.Transfer( _from=0x8c1f5fbf19934c8cd6245e0eb83a9af7bb0d48dc, _to=[Sender] 0x2cf042aeca9bb4ee8bc939b50f09f94fa78897b6, _tokenId=17395860901457081 )
323 WyvernExchangeWithBulkCancellations.OrdersMatched( buyHash=0000000000000000000000000000000000000000000000000000000000000000, sellHash=E0D2756167FCA2CA816AFE7EA492F23DFFC21A8B13A20D9F2860036A32FA5D25, maker=0x8c1f5fbf19934c8cd6245e0eb83a9af7bb0d48dc, taker=[Sender] 0x2cf042aeca9bb4ee8bc939b50f09f94fa78897b6, price=1000000000000000000, metadata=0000000000000000000000000000000000000000000000000000000000000000 )

Account State Difference:

  Address   Before After State Difference Code
0x2cF042aE...FA78897b6
1.255325377165700354 Eth
Nonce: 74
0.243325843009052478 Eth
Nonce: 75
1.011999534156647876
0x5b325696...807C01073
(OpenSea: Wallet)
2,626.837812903756963951 Eth2,626.887812903756963951 Eth0.05
0x7f268357...42bB538E5
(F2Pool Old)
6,081.338760327282138832 Eth6,081.339086161782138832 Eth0.0003258345
0x82C7a8f7...78a34c6ab
0x8C1f5fBF...7Bb0D48DC 0.052751092586106508 Eth1.002751092586106508 Eth0.95

Execution Trace

ETH 1 WyvernExchangeWithBulkCancellations.atomicMatch_( addrs=[0x7f268357A8c2552623316e2562D90e642bB538E5, 0x2cF042aEca9BB4eE8Bc939b50F09F94FA78897b6, 0x8C1f5fBF19934C8cd6245e0EB83A9AF7Bb0D48DC, 0x0000000000000000000000000000000000000000, 0xBAf2127B49fC93CbcA6269FAdE0F7F31dF4c88a7, 0x0000000000000000000000000000000000000000, 0x0000000000000000000000000000000000000000, 0x7f268357A8c2552623316e2562D90e642bB538E5, 0x8C1f5fBF19934C8cd6245e0EB83A9AF7Bb0D48DC, 0x2cF042aEca9BB4eE8Bc939b50F09F94FA78897b6, 0x5b3256965e7C3cF26E11FCAf296DfC8807C01073, 0xBAf2127B49fC93CbcA6269FAdE0F7F31dF4c88a7, 0x0000000000000000000000000000000000000000, 0x0000000000000000000000000000000000000000], uints=[500, 0, 0, 0, 1000000000000000000, 0, 1652818371, 0, 89180267600738963846578425929557864803455672697030244594908276322634662263311, 500, 0, 0, 0, 1000000000000000000, 0, 1652818030, 1655496231, 54531183457638580376087274943502739914979644410966203774380262651745688549011], feeMethodsSidesKindsHowToCalls=[1, 0, 0, 1, 1, 1, 0, 1], calldataBuy=0xFB16A59500000000000000000000000000000000000000000000000000000000000000000000000000000000000000002CF042AECA9BB4EE8BC939B50F09F94FA78897B600000000000000000000000082C7A8F707110F5FBB16184A5933E9F78A34C6AB000000000000000000000000000000000000000000000000003DCD717D97ECB9000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000C00000000000000000000000000000000000000000000000000000000000000000, calldataSell=0xFB16A5950000000000000000000000008C1F5FBF19934C8CD6245E0EB83A9AF7BB0D48DC000000000000000000000000000000000000000000000000000000000000000000000000000000000000000082C7A8F707110F5FBB16184A5933E9F78A34C6AB000000000000000000000000000000000000000000000000003DCD717D97ECB9000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000C00000000000000000000000000000000000000000000000000000000000000000, replacementPatternBuy=0x00000000FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000, replacementPatternSell=0x000000000000000000000000000000000000000000000000000000000000000000000000FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000, staticExtradataBuy=0x, staticExtradataSell=0x, vs=[27, 27], rssMetadata=[24PJvAsgsAdTa2cTzH9aCfMjTj5JctJVzdc/f7oEROo=, YQbcVZ5Fv0CxJ7j4Z+ipG7GV1pC6qX9wJt7RNBzrt40=, 24PJvAsgsAdTa2cTzH9aCfMjTj5JctJVzdc/f7oEROo=, YQbcVZ5Fv0CxJ7j4Z+ipG7GV1pC6qX9wJt7RNBzrt40=, AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=] )
  • Null: 0x000...001.e0d27561( )
  • WyvernProxyRegistry.proxies( 0x8C1f5fBF19934C8cd6245e0EB83A9AF7Bb0D48DC ) => ( 0x9d2743610a5a333D3B997dcD155a4BDE736B29CB )
  • ETH 0.05 OpenSea: Wallet.CALL( )
  • ETH 0.95 0x8c1f5fbf19934c8cd6245e0eb83a9af7bb0d48dc.CALL( )
  • WyvernProxyRegistry.CALL( )
  • 0x9d2743610a5a333d3b997dcd155a4bde736b29cb.CALL( )
  • 0x9d2743610a5a333d3b997dcd155a4bde736b29cb.1b0f7ba9( )
    • AuthenticatedProxy.proxy( dest=0xBAf2127B49fC93CbcA6269FAdE0F7F31dF4c88a7, howToCall=1, calldata=0xFB16A5950000000000000000000000008C1F5FBF19934C8CD6245E0EB83A9AF7BB0D48DC0000000000000000000000002CF042AECA9BB4EE8BC939B50F09F94FA78897B600000000000000000000000082C7A8F707110F5FBB16184A5933E9F78A34C6AB000000000000000000000000000000000000000000000000003DCD717D97ECB9000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000C00000000000000000000000000000000000000000000000000000000000000000 ) => ( result=True )
      • WyvernProxyRegistry.contracts( 0x7f268357A8c2552623316e2562D90e642bB538E5 ) => ( True )
      • MerkleValidator.matchERC721UsingCriteria( ) => ( True )
        • EmblemVault.transferFrom( _from=0x8C1f5fBF19934C8cd6245e0EB83A9AF7Bb0D48DC, _to=0x2cF042aEca9BB4eE8Bc939b50F09F94FA78897b6, _tokenId=17395860901457081 )
          File 1 of 5: WyvernExchangeWithBulkCancellations
          pragma solidity 0.4.26;
          
          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
               * @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)
              {
                  return keccak256(a) == keccak256(b);
              }
          
              /**
               * 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 address into a memory location using entire word
               *
               * @param index Memory location
               * @param source uint to write
               * @return End memory index
               */
              function unsafeWriteAddressWord(uint index, address source)
                  internal
                  pure
                  returns (uint)
              {
                  assembly {
                      mstore(index, source)
                      index := add(index, 0x20)
                  }
                  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;
              }
          
              /**
               * Unsafe write uint8 into a memory location using entire word
               *
               * @param index Memory location
               * @param source uint to write
               * @return End memory index
               */
              function unsafeWriteUint8Word(uint index, uint8 source)
                  internal
                  pure
                  returns (uint)
              {
                  assembly {
                      mstore(index, source)
                      index := add(index, 0x20)
                  }
                  return index;
              }
          
              /**
               * Unsafe write bytes32 into a memory location using entire word
               *
               * @param index Memory location
               * @param source uint to write
               * @return End memory index
               */
              function unsafeWriteBytes32(uint index, bytes32 source)
                  internal
                  pure
                  returns (uint)
              {
                  assembly {
                      mstore(index, source)
                      index := add(index, 0x20)
                  }
                  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 {
              string public constant name = "Wyvern Exchange Contract";
              string public constant version = "2.3";
          
              // NOTE: these hashes are derived and verified in the constructor.
              bytes32 private constant _EIP_712_DOMAIN_TYPEHASH = 0x8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f;
              bytes32 private constant _NAME_HASH = 0x9a2ed463836165738cfa54208ff6e7847fd08cbaac309aac057086cb0a144d13;
              bytes32 private constant _VERSION_HASH = 0xe2fd538c762ee69cab09ccd70e2438075b7004dd87577dc3937e9fcc8174bb64;
              bytes32 private constant _ORDER_TYPEHASH = 0xdba08a88a748f356e8faf8578488343eab21b1741728779c9dcfdc782bc800f8;
          
              bytes4 private constant _EIP_1271_MAGIC_VALUE = 0x1626ba7e;
          
              //    // NOTE: chainId opcode is not supported in solidiy 0.4.x; here we hardcode as 1.
              // In order to protect against orders that are replayable across forked chains,
              // either the solidity version needs to be bumped up or it needs to be retrieved
              // from another contract.
              uint256 private constant _CHAIN_ID = 1;
          
              // Note: the domain separator is derived and verified in the constructor. */
              bytes32 public constant DOMAIN_SEPARATOR = 0x72982d92449bfb3d338412ce4738761aff47fb975ceb17a1bc3712ec716a5a68;
          
              /* 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). */
              /* Note that the maker's nonce at the time of approval **plus one** is stored in the mapping. */
              mapping(bytes32 => uint256) private _approvedOrdersByNonce;
          
              /* Track per-maker nonces that can be incremented by the maker to cancel orders in bulk. */
              // The current nonce for the maker represents the only valid nonce that can be signed by the maker
              // If a signature was signed with a nonce that's different from the one stored in nonces, it
              // will fail validation.
              mapping(address => uint256) public nonces;
          
              /* 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;
                  /* NOTE: uint nonce is an additional component of the order but is read from storage */
              }
          
              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);
              event NonceIncremented        (address indexed maker, uint newNonce);
          
              constructor () public {
                  require(keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)") == _EIP_712_DOMAIN_TYPEHASH);
                  require(keccak256(bytes(name)) == _NAME_HASH);
                  require(keccak256(bytes(version)) == _VERSION_HASH);
                  require(keccak256("Order(address exchange,address maker,address taker,uint256 makerRelayerFee,uint256 takerRelayerFee,uint256 makerProtocolFee,uint256 takerProtocolFee,address feeRecipient,uint8 feeMethod,uint8 side,uint8 saleKind,address target,uint8 howToCall,bytes calldata,bytes replacementPattern,address staticTarget,bytes staticExtradata,address paymentToken,uint256 basePrice,uint256 extra,uint256 listingTime,uint256 expirationTime,uint256 salt,uint256 nonce)") == _ORDER_TYPEHASH);
                  require(DOMAIN_SEPARATOR == _deriveDomainSeparator());
              }
          
              /**
               * @dev Derive the domain separator for EIP-712 signatures.
               * @return The domain separator.
               */
              function _deriveDomainSeparator() private view returns (bytes32) {
                  return keccak256(
                      abi.encode(
                          _EIP_712_DOMAIN_TYPEHASH, // keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)")
                          _NAME_HASH, // keccak256("Wyvern Exchange Contract")
                          _VERSION_HASH, // keccak256(bytes("2.3"))
                          _CHAIN_ID, // NOTE: this is fixed, need to use solidity 0.5+ or make external call to support!
                          address(this)
                      )
                  );
              }
          
              /**
               * Increment a particular maker's nonce, thereby invalidating all orders that were not signed
               * with the original nonce.
               */
              function incrementNonce() external {
                  uint newNonce = ++nonces[msg.sender];
                  emit NonceIncremented(msg.sender, newNonce);
              }
          
              /**
               * @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;
              }
          
              /**
               * @dev Hash an order, returning the canonical EIP-712 order hash without the domain separator
               * @param order Order to hash
               * @param nonce maker nonce to hash
               * @return Hash of order
               */
              function hashOrder(Order memory order, uint nonce)
                  internal
                  pure
                  returns (bytes32 hash)
              {
                  /* Unfortunately abi.encodePacked doesn't work here, stack size constraints. */
                  uint size = 800;
                  bytes memory array = new bytes(size);
                  uint index;
                  assembly {
                      index := add(array, 0x20)
                  }
                  index = ArrayUtils.unsafeWriteBytes32(index, _ORDER_TYPEHASH);
                  index = ArrayUtils.unsafeWriteAddressWord(index, order.exchange);
                  index = ArrayUtils.unsafeWriteAddressWord(index, order.maker);
                  index = ArrayUtils.unsafeWriteAddressWord(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.unsafeWriteAddressWord(index, order.feeRecipient);
                  index = ArrayUtils.unsafeWriteUint8Word(index, uint8(order.feeMethod));
                  index = ArrayUtils.unsafeWriteUint8Word(index, uint8(order.side));
                  index = ArrayUtils.unsafeWriteUint8Word(index, uint8(order.saleKind));
                  index = ArrayUtils.unsafeWriteAddressWord(index, order.target);
                  index = ArrayUtils.unsafeWriteUint8Word(index, uint8(order.howToCall));
                  index = ArrayUtils.unsafeWriteBytes32(index, keccak256(order.calldata));
                  index = ArrayUtils.unsafeWriteBytes32(index, keccak256(order.replacementPattern));
                  index = ArrayUtils.unsafeWriteAddressWord(index, order.staticTarget);
                  index = ArrayUtils.unsafeWriteBytes32(index, keccak256(order.staticExtradata));
                  index = ArrayUtils.unsafeWriteAddressWord(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);
                  index = ArrayUtils.unsafeWriteUint(index, nonce);
                  assembly {
                      hash := keccak256(add(array, 0x20), size)
                  }
                  return hash;
              }
          
              /**
               * @dev Hash an order, returning the hash that a client must sign via EIP-712 including the message prefix
               * @param order Order to hash
               * @param nonce Nonce to hash
               * @return Hash of message prefix and order hash per Ethereum format
               */
              function hashToSign(Order memory order, uint nonce)
                  internal
                  pure
                  returns (bytes32)
              {
                  return keccak256(
                      abi.encodePacked("\x19\x01", DOMAIN_SEPARATOR, hashOrder(order, nonce))
                  );
              }
          
              /**
               * @dev Assert an order is valid and return its hash
               * @param order Order to validate
               * @param nonce Nonce to validate
               * @param sig ECDSA signature
               */
              function requireValidOrder(Order memory order, Sig memory sig, uint nonce)
                  internal
                  view
                  returns (bytes32)
              {
                  bytes32 hash = hashToSign(order, nonce);
                  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 have a maker. */
                  if (order.maker == address(0)) {
                      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;
                  }
          
                  /* Return true if order has been previously approved with the current nonce */
                  uint approvedOrderNoncePlusOne = _approvedOrdersByNonce[hash];
                  if (approvedOrderNoncePlusOne != 0) {
                      return approvedOrderNoncePlusOne == nonces[order.maker] + 1;
                  }
          
                  /* Prevent signature malleability and non-standard v values. */
                  if (uint256(sig.s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
                      return false;
                  }
                  if (sig.v != 27 && sig.v != 28) {
                      return false;
                  }
          
                  /* recover via ECDSA, signed by maker (already verified as non-zero). */
                  if (ecrecover(hash, sig.v, sig.r, sig.s) == order.maker) {
                      return true;
                  }
          
                  /* fallback — attempt EIP-1271 isValidSignature check. */
                  return _tryContractSignature(order.maker, hash, sig);
              }
          
              function _tryContractSignature(address orderMaker, bytes32 hash, Sig memory sig) internal view returns (bool) {
                  bytes memory isValidSignatureData = abi.encodeWithSelector(
                      _EIP_1271_MAGIC_VALUE,
                      hash,
                      abi.encodePacked(sig.r, sig.s, sig.v)
                  );
          
                  bytes4 result;
          
                  // NOTE: solidity 0.4.x does not support STATICCALL outside of assembly
                  assembly {
                      let success := staticcall(           // perform a staticcall
                          gas,                             // forward all available gas
                          orderMaker,                      // call the order maker
                          add(isValidSignatureData, 0x20), // calldata offset comes after length
                          mload(isValidSignatureData),     // load calldata length
                          0,                               // do not use memory for return data
                          0                                // do not use memory for return data
                      )
          
                      if iszero(success) {                     // if the call fails
                          returndatacopy(0, 0, returndatasize) // copy returndata buffer to memory
                          revert(0, returndatasize)            // revert + pass through revert data
                      }
          
                      if eq(returndatasize, 0x20) {  // if returndata == 32 (one word)
                          returndatacopy(0, 0, 0x20) // copy return data to memory in scratch space
                          result := mload(0)         // load return data from memory to the stack
                      }
                  }
          
                  return result == _EIP_1271_MAGIC_VALUE;
              }
          
              /**
               * @dev Determine if an order has been approved. Note that the order may not still
               * be valid in cases where the maker's nonce has been incremented.
               * @param hash Hash of the order
               * @return whether or not the order was approved.
               */
              function approvedOrders(bytes32 hash) public view returns (bool approved) {
                  return _approvedOrdersByNonce[hash] != 0;
              }
          
              /**
               * @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, nonces[order.maker]);
          
                  /* Assert order has not already been approved. */
                  require(_approvedOrdersByNonce[hash] == 0);
          
                  /* EFFECTS */
          
                  /* Mark order as approved. */
                  _approvedOrdersByNonce[hash] = nonces[order.maker] + 1;
          
                  /* 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 nonce Nonce to cancel
               * @param sig ECDSA signature
               */
              function cancelOrder(Order memory order, Sig memory sig, uint nonce)
                  internal
              {
                  /* CHECKS */
          
                  /* Calculate order hash. */
                  bytes32 hash = requireValidOrder(order, sig, nonce);
          
                  /* 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 = _requireValidOrderWithNonce(buy, buySig);
                  }
          
                  /* Ensure sell order validity and calculate hash if necessary. */
                  bytes32 sellHash;
                  if (sell.maker == msg.sender) {
                      require(validateOrderParameters(sell));
                  } else {
                      sellHash = _requireValidOrderWithNonce(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));
          
                  /* 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);
          
                  /* Assert implementation. */
                  require(delegateProxy.implementation() == registry.delegateProxyImplementation());
          
                  /* 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);
              }
          
              function _requireValidOrderWithNonce(Order memory order, Sig memory sig) internal view returns (bytes32) {
                  return requireValidOrder(order, sig, nonces[order.maker]);
              }
          }
          
          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;
              }
          
              /**
               * @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
                  view
                  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]),
                    nonces[addrs[1]]
                  );
              }
          
              /**
               * @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
                  view
                  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]),
                    nonces[addrs[1]]
                  );
              }
          
              /**
               * @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, nonces[order.maker]),
                    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
              {
                  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 cancelOrder(
                    order,
                    Sig(v, r, s),
                    nonces[order.maker]
                  );
              }
          
              /**
               * @dev Call cancelOrder, supplying a specific nonce — enables cancelling orders
               that were signed with nonces greater than the current nonce.
               */
              function cancelOrderWithNonce_(
                  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,
                  uint nonce)
                  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 cancelOrder(
                    order,
                    Sig(v, r, s),
                    nonce
                  );
              }
          
              /**
               * @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 WyvernExchangeWithBulkCancellations is Exchange {
              string public constant codename = "Bulk Smash";
          
              /**
               * @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));
              }
          
          }

          File 2 of 5: EmblemVault
          // File: browser/github/0xcert/ethereum-erc721/src/contracts/ownership/ownable.sol
          
          pragma solidity 0.6.2;
          
          /**
           * @dev The contract has an owner address, and provides basic authorization control whitch
           * simplifies the implementation of user permissions. This contract is based on the source code at:
           * https://github.com/OpenZeppelin/openzeppelin-solidity/blob/master/contracts/ownership/Ownable.sol
           */
          contract Ownable
          {
          
            /**
             * @dev Error constants.
             */
            string public constant NOT_CURRENT_OWNER = "018001";
            string public constant CANNOT_TRANSFER_TO_ZERO_ADDRESS = "018002";
          
            /**
             * @dev Current owner address.
             */
            address public owner;
          
            /**
             * @dev An event which is triggered when the owner is changed.
             * @param previousOwner The address of the previous owner.
             * @param newOwner The address of the new owner.
             */
            event OwnershipTransferred(
              address indexed previousOwner,
              address indexed newOwner
            );
          
            /**
             * @dev The 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, NOT_CURRENT_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), CANNOT_TRANSFER_TO_ZERO_ADDRESS);
              emit OwnershipTransferred(owner, _newOwner);
              owner = _newOwner;
            }
          
          }
          
          // File: browser/github/0xcert/ethereum-erc721/src/contracts/tokens/erc721-enumerable.sol
          
          pragma solidity 0.6.2;
          
          /**
           * @dev Optional enumeration extension for ERC-721 non-fungible token standard.
           * See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md.
           */
          interface ERC721Enumerable
          {
          
            /**
             * @dev Returns a count of valid NFTs tracked by this contract, where each one of them has an
             * assigned and queryable owner not equal to the zero address.
             * @return Total supply of NFTs.
             */
            function totalSupply()
              external
              view
              returns (uint256);
          
            /**
             * @dev Returns the token identifier for the `_index`th NFT. Sort order is not specified.
             * @param _index A counter less than `totalSupply()`.
             * @return Token id.
             */
            function tokenByIndex(
              uint256 _index
            )
              external
              view
              returns (uint256);
          
            /**
             * @dev Returns the token identifier for the `_index`th NFT assigned to `_owner`. Sort order is
             * not specified. It throws if `_index` >= `balanceOf(_owner)` or if `_owner` is the zero address,
             * representing invalid NFTs.
             * @param _owner An address where we are interested in NFTs owned by them.
             * @param _index A counter less than `balanceOf(_owner)`.
             * @return Token id.
             */
            function tokenOfOwnerByIndex(
              address _owner,
              uint256 _index
            )
              external
              view
              returns (uint256);
          
          }
          
          // File: browser/github/0xcert/ethereum-erc721/src/contracts/tokens/erc721-metadata.sol
          
          pragma solidity 0.6.2;
          
          /**
           * @dev Optional metadata extension for ERC-721 non-fungible token standard.
           * See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md.
           */
          interface ERC721Metadata
          {
          
            /**
             * @dev Returns a descriptive name for a collection of NFTs in this contract.
             * @return _name Representing name.
             */
            function name()
              external
              view
              returns (string memory _name);
          
            /**
             * @dev Returns a abbreviated name for a collection of NFTs in this contract.
             * @return _symbol Representing symbol.
             */
            function symbol()
              external
              view
              returns (string memory _symbol);
          
            /**
             * @dev Returns a distinct Uniform Resource Identifier (URI) for a given asset. It Throws if
             * `_tokenId` is not a valid NFT. URIs are defined in RFC3986. The URI may point to a JSON file
             * that conforms to the "ERC721 Metadata JSON Schema".
             * @return URI of _tokenId.
             */
            function tokenURI(uint256 _tokenId)
              external
              view
              returns (string memory);
          
          }
          
          // File: browser/github/0xcert/ethereum-erc721/src/contracts/utils/address-utils.sol
          
          pragma solidity 0.6.2;
          
          /**
           * @dev Utility library of inline functions on addresses.
           * @notice Based on:
           * https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/Address.sol
           * Requires EIP-1052.
           */
          library AddressUtils
          {
          
            /**
             * @dev Returns whether the target address is a contract.
             * @param _addr Address to check.
             * @return addressCheck True if _addr is a contract, false if not.
             */
            function isContract(
              address _addr
            )
              internal
              view
              returns (bool addressCheck)
            {
              // This method relies in extcodesize, which returns 0 for contracts in
              // construction, since the code is only stored at the end of the
              // constructor execution.
          
              // According to EIP-1052, 0x0 is the value returned for not-yet created accounts
              // and 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470 is returned
              // for accounts without code, i.e. `keccak256('')`
              bytes32 codehash;
              bytes32 accountHash = 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470;
              assembly { codehash := extcodehash(_addr) } // solhint-disable-line
              addressCheck = (codehash != 0x0 && codehash != accountHash);
            }
          
          }
          
          // File: browser/github/0xcert/ethereum-erc721/src/contracts/utils/erc165.sol
          
          pragma solidity 0.6.2;
          
          /**
           * @dev A standard for detecting smart contract interfaces. 
           * See: https://eips.ethereum.org/EIPS/eip-165.
           */
          interface ERC165
          {
          
            /**
             * @dev Checks if the smart contract includes a specific interface.
             * @notice This function uses less than 30,000 gas.
             * @param _interfaceID The interface identifier, as specified in ERC-165.
             * @return True if _interfaceID is supported, false otherwise.
             */
            function supportsInterface(
              bytes4 _interfaceID
            )
              external
              view
              returns (bool);
              
          }
          
          // File: browser/github/0xcert/ethereum-erc721/src/contracts/utils/supports-interface.sol
          
          pragma solidity 0.6.2;
          
          
          /**
           * @dev Implementation of standard for detect smart contract interfaces.
           */
          contract SupportsInterface is
            ERC165
          {
          
            /**
             * @dev Mapping of supported intefraces.
             * @notice You must not set element 0xffffffff to true.
             */
            mapping(bytes4 => bool) internal supportedInterfaces;
          
            /**
             * @dev Contract constructor.
             */
            constructor()
              public
            {
              supportedInterfaces[0x01ffc9a7] = true; // ERC165
            }
          
            /**
             * @dev Function to check which interfaces are suported by this contract.
             * @param _interfaceID Id of the interface.
             * @return True if _interfaceID is supported, false otherwise.
             */
            function supportsInterface(
              bytes4 _interfaceID
            )
              external
              override
              view
              returns (bool)
            {
              return supportedInterfaces[_interfaceID];
            }
          
          }
          
          // File: browser/github/0xcert/ethereum-erc721/src/contracts/math/safe-math.sol
          
          pragma solidity 0.6.2;
          
          /**
           * @dev Math operations with safety checks that throw on error. This contract is based on the
           * source code at:
           * https://github.com/OpenZeppelin/openzeppelin-solidity/blob/master/contracts/math/SafeMath.sol.
           */
          library SafeMath
          {
            /**
             * List of revert message codes. Implementing dApp should handle showing the correct message.
             * Based on 0xcert framework error codes.
             */
            string constant OVERFLOW = "008001";
            string constant SUBTRAHEND_GREATER_THEN_MINUEND = "008002";
            string constant DIVISION_BY_ZERO = "008003";
          
            /**
             * @dev Multiplies two numbers, reverts on overflow.
             * @param _factor1 Factor number.
             * @param _factor2 Factor number.
             * @return product The product of the two factors.
             */
            function mul(
              uint256 _factor1,
              uint256 _factor2
            )
              internal
              pure
              returns (uint256 product)
            {
              // 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 (_factor1 == 0)
              {
                return 0;
              }
          
              product = _factor1 * _factor2;
              require(product / _factor1 == _factor2, OVERFLOW);
            }
          
            /**
             * @dev Integer division of two numbers, truncating the quotient, reverts on division by zero.
             * @param _dividend Dividend number.
             * @param _divisor Divisor number.
             * @return quotient The quotient.
             */
            function div(
              uint256 _dividend,
              uint256 _divisor
            )
              internal
              pure
              returns (uint256 quotient)
            {
              // Solidity automatically asserts when dividing by 0, using all gas.
              require(_divisor > 0, DIVISION_BY_ZERO);
              quotient = _dividend / _divisor;
              // assert(_dividend == _divisor * quotient + _dividend % _divisor); // There is no case in which this doesn't hold.
            }
          
            /**
             * @dev Substracts two numbers, throws on overflow (i.e. if subtrahend is greater than minuend).
             * @param _minuend Minuend number.
             * @param _subtrahend Subtrahend number.
             * @return difference Difference.
             */
            function sub(
              uint256 _minuend,
              uint256 _subtrahend
            )
              internal
              pure
              returns (uint256 difference)
            {
              require(_subtrahend <= _minuend, SUBTRAHEND_GREATER_THEN_MINUEND);
              difference = _minuend - _subtrahend;
            }
          
            /**
             * @dev Adds two numbers, reverts on overflow.
             * @param _addend1 Number.
             * @param _addend2 Number.
             * @return sum Sum.
             */
            function add(
              uint256 _addend1,
              uint256 _addend2
            )
              internal
              pure
              returns (uint256 sum)
            {
              sum = _addend1 + _addend2;
              require(sum >= _addend1, OVERFLOW);
            }
          
            /**
              * @dev Divides two numbers and returns the remainder (unsigned integer modulo), reverts when
              * dividing by zero.
              * @param _dividend Number.
              * @param _divisor Number.
              * @return remainder Remainder.
              */
            function mod(
              uint256 _dividend,
              uint256 _divisor
            )
              internal
              pure
              returns (uint256 remainder)
            {
              require(_divisor != 0, DIVISION_BY_ZERO);
              remainder = _dividend % _divisor;
            }
          
          }
          
          // File: browser/github/0xcert/ethereum-erc721/src/contracts/tokens/erc721-token-receiver.sol
          
          pragma solidity 0.6.2;
          
          /**
           * @dev ERC-721 interface for accepting safe transfers.
           * See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md.
           */
          interface ERC721TokenReceiver
          {
          
            /**
             * @dev Handle the receipt of a NFT. The ERC721 smart contract calls this function on the
             * recipient after a `transfer`. This function MAY throw to revert and reject the transfer. Return
             * of other than the magic value MUST result in the transaction being reverted.
             * Returns `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))` unless throwing.
             * @notice The contract address is always the message sender. A wallet/broker/auction application
             * MUST implement the wallet interface if it will accept safe transfers.
             * @param _operator The address which called `safeTransferFrom` function.
             * @param _from The address which previously owned the token.
             * @param _tokenId The NFT identifier which is being transferred.
             * @param _data Additional data with no specified format.
             * @return Returns `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`.
             */
            function onERC721Received(
              address _operator,
              address _from,
              uint256 _tokenId,
              bytes calldata _data
            )
              external
              returns(bytes4);
          
          }
          
          // File: browser/github/0xcert/ethereum-erc721/src/contracts/tokens/erc721.sol
          
          pragma solidity 0.6.2;
          
          /**
           * @dev ERC-721 non-fungible token standard.
           * See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md.
           */
          interface ERC721
          {
          
            /**
             * @dev Emits when ownership of any NFT changes by any mechanism. This event emits when NFTs are
             * created (`from` == 0) and destroyed (`to` == 0). Exception: during contract creation, any
             * number of NFTs may be created and assigned without emitting Transfer. At the time of any
             * transfer, the approved address for that NFT (if any) is reset to none.
             */
            event Transfer(
              address indexed _from,
              address indexed _to,
              uint256 indexed _tokenId
            );
          
            /**
             * @dev This emits when the approved address for an NFT is changed or reaffirmed. The zero
             * address indicates there is no approved address. When a Transfer event emits, this also
             * indicates that the approved address for that NFT (if any) is reset to none.
             */
            event Approval(
              address indexed _owner,
              address indexed _approved,
              uint256 indexed _tokenId
            );
          
            /**
             * @dev This emits when an operator is enabled or disabled for an owner. The operator can manage
             * all NFTs of the owner.
             */
            event ApprovalForAll(
              address indexed _owner,
              address indexed _operator,
              bool _approved
            );
          
            /**
             * @dev Transfers the ownership of an NFT from one address to another address.
             * @notice Throws unless `msg.sender` is the current owner, an authorized operator, or the
             * approved address for this NFT. Throws if `_from` is not the current owner. Throws if `_to` is
             * the zero address. Throws if `_tokenId` is not a valid NFT. When transfer is complete, this
             * function checks if `_to` is a smart contract (code size > 0). If so, it calls
             * `onERC721Received` on `_to` and throws if the return value is not
             * `bytes4(keccak256("onERC721Received(address,uint256,bytes)"))`.
             * @param _from The current owner of the NFT.
             * @param _to The new owner.
             * @param _tokenId The NFT to transfer.
             * @param _data Additional data with no specified format, sent in call to `_to`.
             */
            function safeTransferFrom(
              address _from,
              address _to,
              uint256 _tokenId,
              bytes calldata _data
            )
              external;
          
            /**
             * @dev Transfers the ownership of an NFT from one address to another address.
             * @notice This works identically to the other function with an extra data parameter, except this
             * function just sets data to ""
             * @param _from The current owner of the NFT.
             * @param _to The new owner.
             * @param _tokenId The NFT to transfer.
             */
            function safeTransferFrom(
              address _from,
              address _to,
              uint256 _tokenId
            )
              external;
          
            /**
             * @dev Throws unless `msg.sender` is the current owner, an authorized operator, or the approved
             * address for this NFT. Throws if `_from` is not the current owner. Throws if `_to` is the zero
             * address. Throws if `_tokenId` is not a valid NFT.
             * @notice The caller is responsible to confirm that `_to` is capable of receiving NFTs or else
             * they mayb be permanently lost.
             * @param _from The current owner of the NFT.
             * @param _to The new owner.
             * @param _tokenId The NFT to transfer.
             */
            function transferFrom(
              address _from,
              address _to,
              uint256 _tokenId
            )
              external;
          
            /**
             * @dev Set or reaffirm the approved address for an NFT.
             * @notice The zero address indicates there is no approved address. Throws unless `msg.sender` is
             * the current NFT owner, or an authorized operator of the current owner.
             * @param _approved The new approved NFT controller.
             * @param _tokenId The NFT to approve.
             */
            function approve(
              address _approved,
              uint256 _tokenId
            )
              external;
          
            /**
             * @dev Enables or disables approval for a third party ("operator") to manage all of
             * `msg.sender`'s assets. It also emits the ApprovalForAll event.
             * @notice The contract MUST allow multiple operators per owner.
             * @param _operator Address to add to the set of authorized operators.
             * @param _approved True if the operators is approved, false to revoke approval.
             */
            function setApprovalForAll(
              address _operator,
              bool _approved
            )
              external;
          
            /**
             * @dev Returns the number of NFTs owned by `_owner`. NFTs assigned to the zero address are
             * considered invalid, and this function throws for queries about the zero address.
             * @param _owner Address for whom to query the balance.
             * @return Balance of _owner.
             */
            function balanceOf(
              address _owner
            )
              external
              view
              returns (uint256);
          
            /**
             * @dev Returns the address of the owner of the NFT. NFTs assigned to zero address are considered
             * invalid, and queries about them do throw.
             * @param _tokenId The identifier for an NFT.
             * @return Address of _tokenId owner.
             */
            function ownerOf(
              uint256 _tokenId
            )
              external
              view
              returns (address);
          
            /**
             * @dev Get the approved address for a single NFT.
             * @notice Throws if `_tokenId` is not a valid NFT.
             * @param _tokenId The NFT to find the approved address for.
             * @return Address that _tokenId is approved for.
             */
            function getApproved(
              uint256 _tokenId
            )
              external
              view
              returns (address);
          
            /**
             * @dev Returns true if `_operator` is an approved operator for `_owner`, false otherwise.
             * @param _owner The address that owns the NFTs.
             * @param _operator The address that acts on behalf of the owner.
             * @return True if approved for all, false otherwise.
             */
            function isApprovedForAll(
              address _owner,
              address _operator
            )
              external
              view
              returns (bool);
          
          }
          
          // File: browser/github/0xcert/ethereum-erc721/src/contracts/tokens/nf-token.sol
          
          pragma solidity 0.6.2;
          
          
          
          
          
          
          /**
           * @dev Implementation of ERC-721 non-fungible token standard.
           */
          contract NFToken is
            ERC721,
            SupportsInterface
          {
            using SafeMath for uint256;
            using AddressUtils for address;
          
            /**
             * List of revert message codes. Implementing dApp should handle showing the correct message.
             * Based on 0xcert framework error codes.
             */
            string constant ZERO_ADDRESS = "003001";
            string constant NOT_VALID_NFT = "003002";
            string constant NOT_OWNER_OR_OPERATOR = "003003";
            string constant NOT_OWNER_APPROWED_OR_OPERATOR = "003004";
            string constant NOT_ABLE_TO_RECEIVE_NFT = "003005";
            string constant NFT_ALREADY_EXISTS = "003006";
            string constant NOT_OWNER = "003007";
            string constant IS_OWNER = "003008";
          
            /**
             * @dev Magic value of a smart contract that can recieve NFT.
             * Equal to: bytes4(keccak256("onERC721Received(address,address,uint256,bytes)")).
             */
            bytes4 internal constant MAGIC_ON_ERC721_RECEIVED = 0x150b7a02;
          
            /**
             * @dev A mapping from NFT ID to the address that owns it.
             */
            mapping (uint256 => address) internal idToOwner;
          
            /**
             * @dev Mapping from NFT ID to approved address.
             */
            mapping (uint256 => address) internal idToApproval;
          
             /**
             * @dev Mapping from owner address to count of his tokens.
             */
            mapping (address => uint256) private ownerToNFTokenCount;
          
            /**
             * @dev Mapping from owner address to mapping of operator addresses.
             */
            mapping (address => mapping (address => bool)) internal ownerToOperators;
          
            /**
             * @dev Emits when ownership of any NFT changes by any mechanism. This event emits when NFTs are
             * created (`from` == 0) and destroyed (`to` == 0). Exception: during contract creation, any
             * number of NFTs may be created and assigned without emitting Transfer. At the time of any
             * transfer, the approved address for that NFT (if any) is reset to none.
             * @param _from Sender of NFT (if address is zero address it indicates token creation).
             * @param _to Receiver of NFT (if address is zero address it indicates token destruction).
             * @param _tokenId The NFT that got transfered.
             */
            event Transfer(
              address indexed _from,
              address indexed _to,
              uint256 indexed _tokenId
            );
          
            /**
             * @dev This emits when the approved address for an NFT is changed or reaffirmed. The zero
             * address indicates there is no approved address. When a Transfer event emits, this also
             * indicates that the approved address for that NFT (if any) is reset to none.
             * @param _owner Owner of NFT.
             * @param _approved Address that we are approving.
             * @param _tokenId NFT which we are approving.
             */
            event Approval(
              address indexed _owner,
              address indexed _approved,
              uint256 indexed _tokenId
            );
          
            /**
             * @dev This emits when an operator is enabled or disabled for an owner. The operator can manage
             * all NFTs of the owner.
             * @param _owner Owner of NFT.
             * @param _operator Address to which we are setting operator rights.
             * @param _approved Status of operator rights(true if operator rights are given and false if
             * revoked).
             */
            event ApprovalForAll(
              address indexed _owner,
              address indexed _operator,
              bool _approved
            );
          
            /**
             * @dev Guarantees that the msg.sender is an owner or operator of the given NFT.
             * @param _tokenId ID of the NFT to validate.
             */
            modifier canOperate(
              uint256 _tokenId
            )
            {
              address tokenOwner = idToOwner[_tokenId];
              require(tokenOwner == msg.sender || ownerToOperators[tokenOwner][msg.sender], NOT_OWNER_OR_OPERATOR);
              _;
            }
          
            /**
             * @dev Guarantees that the msg.sender is allowed to transfer NFT.
             * @param _tokenId ID of the NFT to transfer.
             */
            modifier canTransfer(
              uint256 _tokenId
            )
            {
              address tokenOwner = idToOwner[_tokenId];
              require(
                tokenOwner == msg.sender
                || idToApproval[_tokenId] == msg.sender
                || ownerToOperators[tokenOwner][msg.sender],
                NOT_OWNER_APPROWED_OR_OPERATOR
              );
              _;
            }
          
            /**
             * @dev Guarantees that _tokenId is a valid Token.
             * @param _tokenId ID of the NFT to validate.
             */
            modifier validNFToken(
              uint256 _tokenId
            )
            {
              require(idToOwner[_tokenId] != address(0), NOT_VALID_NFT);
              _;
            }
          
            /**
             * @dev Contract constructor.
             */
            constructor()
              public
            {
              supportedInterfaces[0x80ac58cd] = true; // ERC721
            }
          
            /**
             * @dev Transfers the ownership of an NFT from one address to another address. This function can
             * be changed to payable.
             * @notice Throws unless `msg.sender` is the current owner, an authorized operator, or the
             * approved address for this NFT. Throws if `_from` is not the current owner. Throws if `_to` is
             * the zero address. Throws if `_tokenId` is not a valid NFT. When transfer is complete, this
             * function checks if `_to` is a smart contract (code size > 0). If so, it calls
             * `onERC721Received` on `_to` and throws if the return value is not
             * `bytes4(keccak256("onERC721Received(address,uint256,bytes)"))`.
             * @param _from The current owner of the NFT.
             * @param _to The new owner.
             * @param _tokenId The NFT to transfer.
             * @param _data Additional data with no specified format, sent in call to `_to`.
             */
            function safeTransferFrom(
              address _from,
              address _to,
              uint256 _tokenId,
              bytes calldata _data
            )
              external
              override
            {
              _safeTransferFrom(_from, _to, _tokenId, _data);
            }
          
            /**
             * @dev Transfers the ownership of an NFT from one address to another address. This function can
             * be changed to payable.
             * @notice This works identically to the other function with an extra data parameter, except this
             * function just sets data to ""
             * @param _from The current owner of the NFT.
             * @param _to The new owner.
             * @param _tokenId The NFT to transfer.
             */
            function safeTransferFrom(
              address _from,
              address _to,
              uint256 _tokenId
            )
              external
              override
            {
              _safeTransferFrom(_from, _to, _tokenId, "");
            }
          
            /**
             * @dev Throws unless `msg.sender` is the current owner, an authorized operator, or the approved
             * address for this NFT. Throws if `_from` is not the current owner. Throws if `_to` is the zero
             * address. Throws if `_tokenId` is not a valid NFT. This function can be changed to payable.
             * @notice The caller is responsible to confirm that `_to` is capable of receiving NFTs or else
             * they maybe be permanently lost.
             * @param _from The current owner of the NFT.
             * @param _to The new owner.
             * @param _tokenId The NFT to transfer.
             */
            function transferFrom(
              address _from,
              address _to,
              uint256 _tokenId
            )
              external
              override
              canTransfer(_tokenId)
              validNFToken(_tokenId)
            {
              address tokenOwner = idToOwner[_tokenId];
              require(tokenOwner == _from, NOT_OWNER);
              require(_to != address(0), ZERO_ADDRESS);
          
              _transfer(_to, _tokenId);
            }
          
            /**
             * @dev Set or reaffirm the approved address for an NFT. This function can be changed to payable.
             * @notice The zero address indicates there is no approved address. Throws unless `msg.sender` is
             * the current NFT owner, or an authorized operator of the current owner.
             * @param _approved Address to be approved for the given NFT ID.
             * @param _tokenId ID of the token to be approved.
             */
            function approve(
              address _approved,
              uint256 _tokenId
            )
              external
              override
              canOperate(_tokenId)
              validNFToken(_tokenId)
            {
              address tokenOwner = idToOwner[_tokenId];
              require(_approved != tokenOwner, IS_OWNER);
          
              idToApproval[_tokenId] = _approved;
              emit Approval(tokenOwner, _approved, _tokenId);
            }
          
            /**
             * @dev Enables or disables approval for a third party ("operator") to manage all of
             * `msg.sender`'s assets. It also emits the ApprovalForAll event.
             * @notice This works even if sender doesn't own any tokens at the time.
             * @param _operator Address to add to the set of authorized operators.
             * @param _approved True if the operators is approved, false to revoke approval.
             */
            function setApprovalForAll(
              address _operator,
              bool _approved
            )
              external
              override
            {
              ownerToOperators[msg.sender][_operator] = _approved;
              emit ApprovalForAll(msg.sender, _operator, _approved);
            }
          
            /**
             * @dev Returns the number of NFTs owned by `_owner`. NFTs assigned to the zero address are
             * considered invalid, and this function throws for queries about the zero address.
             * @param _owner Address for whom to query the balance.
             * @return Balance of _owner.
             */
            function balanceOf(
              address _owner
            )
              external
              override
              view
              returns (uint256)
            {
              require(_owner != address(0), ZERO_ADDRESS);
              return _getOwnerNFTCount(_owner);
            }
          
            /**
             * @dev Returns the address of the owner of the NFT. NFTs assigned to zero address are considered
             * invalid, and queries about them do throw.
             * @param _tokenId The identifier for an NFT.
             * @return _owner Address of _tokenId owner.
             */
            function ownerOf(
              uint256 _tokenId
            )
              external
              override
              view
              returns (address _owner)
            {
              _owner = idToOwner[_tokenId];
              require(_owner != address(0), NOT_VALID_NFT);
            }
          
            /**
             * @dev Get the approved address for a single NFT.
             * @notice Throws if `_tokenId` is not a valid NFT.
             * @param _tokenId ID of the NFT to query the approval of.
             * @return Address that _tokenId is approved for.
             */
            function getApproved(
              uint256 _tokenId
            )
              external
              override
              view
              validNFToken(_tokenId)
              returns (address)
            {
              return idToApproval[_tokenId];
            }
          
            /**
             * @dev Checks if `_operator` is an approved operator for `_owner`.
             * @param _owner The address that owns the NFTs.
             * @param _operator The address that acts on behalf of the owner.
             * @return True if approved for all, false otherwise.
             */
            function isApprovedForAll(
              address _owner,
              address _operator
            )
              external
              override
              view
              returns (bool)
            {
              return ownerToOperators[_owner][_operator];
            }
          
            /**
             * @dev Actually preforms the transfer.
             * @notice Does NO checks.
             * @param _to Address of a new owner.
             * @param _tokenId The NFT that is being transferred.
             */
            function _transfer(
              address _to,
              uint256 _tokenId
            )
              internal
            {
              address from = idToOwner[_tokenId];
              _clearApproval(_tokenId);
          
              _removeNFToken(from, _tokenId);
              _addNFToken(_to, _tokenId);
          
              emit Transfer(from, _to, _tokenId);
            }
          
            /**
             * @dev Mints a new NFT.
             * @notice This is an internal function which should be called from user-implemented external
             * mint function. Its purpose is to show and properly initialize data structures when using this
             * implementation.
             * @param _to The address that will own the minted NFT.
             * @param _tokenId of the NFT to be minted by the msg.sender.
             */
            function _mint(
              address _to,
              uint256 _tokenId
            )
              internal
              virtual
            {
              require(_to != address(0), ZERO_ADDRESS);
              require(idToOwner[_tokenId] == address(0), NFT_ALREADY_EXISTS);
          
              _addNFToken(_to, _tokenId);
          
              emit Transfer(address(0), _to, _tokenId);
            }
          
            /**
             * @dev Burns a NFT.
             * @notice This is an internal function which should be called from user-implemented external burn
             * function. Its purpose is to show and properly initialize data structures when using this
             * implementation. Also, note that this burn implementation allows the minter to re-mint a burned
             * NFT.
             * @param _tokenId ID of the NFT to be burned.
             */
            function _burn(
              uint256 _tokenId
            )
              internal
              virtual
              validNFToken(_tokenId)
            {
              address tokenOwner = idToOwner[_tokenId];
              _clearApproval(_tokenId);
              _removeNFToken(tokenOwner, _tokenId);
              emit Transfer(tokenOwner, address(0), _tokenId);
            }
          
            /**
             * @dev Removes a NFT from owner.
             * @notice Use and override this function with caution. Wrong usage can have serious consequences.
             * @param _from Address from wich we want to remove the NFT.
             * @param _tokenId Which NFT we want to remove.
             */
            function _removeNFToken(
              address _from,
              uint256 _tokenId
            )
              internal
              virtual
            {
              require(idToOwner[_tokenId] == _from, NOT_OWNER);
              ownerToNFTokenCount[_from] = ownerToNFTokenCount[_from] - 1;
              delete idToOwner[_tokenId];
            }
          
            /**
             * @dev Assignes a new NFT to owner.
             * @notice Use and override this function with caution. Wrong usage can have serious consequences.
             * @param _to Address to wich we want to add the NFT.
             * @param _tokenId Which NFT we want to add.
             */
            function _addNFToken(
              address _to,
              uint256 _tokenId
            )
              internal
              virtual
            {
              require(idToOwner[_tokenId] == address(0), NFT_ALREADY_EXISTS);
          
              idToOwner[_tokenId] = _to;
              ownerToNFTokenCount[_to] = ownerToNFTokenCount[_to].add(1);
            }
          
            /**
             * @dev Helper function that gets NFT count of owner. This is needed for overriding in enumerable
             * extension to remove double storage (gas optimization) of owner nft count.
             * @param _owner Address for whom to query the count.
             * @return Number of _owner NFTs.
             */
            function _getOwnerNFTCount(
              address _owner
            )
              internal
              virtual
              view
              returns (uint256)
            {
              return ownerToNFTokenCount[_owner];
            }
          
            /**
             * @dev Actually perform the safeTransferFrom.
             * @param _from The current owner of the NFT.
             * @param _to The new owner.
             * @param _tokenId The NFT to transfer.
             * @param _data Additional data with no specified format, sent in call to `_to`.
             */
            function _safeTransferFrom(
              address _from,
              address _to,
              uint256 _tokenId,
              bytes memory _data
            )
              private
              canTransfer(_tokenId)
              validNFToken(_tokenId)
            {
              address tokenOwner = idToOwner[_tokenId];
              require(tokenOwner == _from, NOT_OWNER);
              require(_to != address(0), ZERO_ADDRESS);
          
              _transfer(_to, _tokenId);
          
              if (_to.isContract())
              {
                bytes4 retval = ERC721TokenReceiver(_to).onERC721Received(msg.sender, _from, _tokenId, _data);
                require(retval == MAGIC_ON_ERC721_RECEIVED, NOT_ABLE_TO_RECEIVE_NFT);
              }
            }
          
            /**
             * @dev Clears the current approval of a given NFT ID.
             * @param _tokenId ID of the NFT to be transferred.
             */
            function _clearApproval(
              uint256 _tokenId
            )
              private
            {
              if (idToApproval[_tokenId] != address(0))
              {
                delete idToApproval[_tokenId];
              }
            }
          
          }
          
          // File: browser/github/0xcert/ethereum-erc721/src/contracts/tokens/nf-token-enumerable-metadata.sol
          
          pragma solidity 0.6.2;
          
          
          
          
          /**
           * @dev Optional metadata implementation for ERC-721 non-fungible token standard.
           */
          abstract contract NFTokenEnumerableMetadata is
              NFToken,
              ERC721Metadata,
              ERC721Enumerable
          {
          
            /**
             * @dev A descriptive name for a collection of NFTs.
             */
            string internal nftName;
          
            /**
             * @dev An abbreviated name for NFTokens.
             */
            string internal nftSymbol;
            
              /**
             * @dev An uri to represent the metadata for this contract.
             */
            string internal nftContractMetadataUri;
          
            /**
             * @dev Mapping from NFT ID to metadata uri.
             */
            mapping (uint256 => string) internal idToUri;
            
            /**
             * @dev Mapping from NFT ID to encrypted value.
             */
            mapping (uint256 => string) internal idToPayload;
          
            /**
             * @dev Contract constructor.
             * @notice When implementing this contract don't forget to set nftName and nftSymbol.
             */
            constructor()
              public
            {
              supportedInterfaces[0x5b5e139f] = true; // ERC721Metadata
              supportedInterfaces[0x780e9d63] = true; // ERC721Enumerable
            }
          
            /**
             * @dev Returns a descriptive name for a collection of NFTokens.
             * @return _name Representing name.
             */
            function name()
              external
              override
              view
              returns (string memory _name)
            {
              _name = nftName;
            }
          
            /**
             * @dev Returns an abbreviated name for NFTokens.
             * @return _symbol Representing symbol.
             */
            function symbol()
              external
              override
              view
              returns (string memory _symbol)
            {
              _symbol = nftSymbol;
            }
          
            /**
             * @dev A distinct URI (RFC 3986) for a given NFT.
             * @param _tokenId Id for which we want uri.
             * @return URI of _tokenId.
             */
            function tokenURI(
              uint256 _tokenId
            )
              external
              override
              view
              validNFToken(_tokenId)
              returns (string memory)
            {
              return idToUri[_tokenId];
            }
            
              /**
             * @dev A distinct URI (RFC 3986) for a given NFT.
             * @param _tokenId Id for which we want uri.
             * @return URI of _tokenId.
             */
            function tokenPayload(
              uint256 _tokenId
            )
              external
              view
              validNFToken(_tokenId)
              returns (string memory)
            {
              return idToPayload[_tokenId];
            }
          
            /**
             * @dev Set a distinct URI (RFC 3986) for a given NFT ID.
             * @notice This is an internal function which should be called from user-implemented external
             * function. Its purpose is to show and properly initialize data structures when using this
             * implementation.
             * @param _tokenId Id for which we want URI.
             * @param _uri String representing RFC 3986 URI.
             */
            function _setTokenUri(
              uint256 _tokenId,
              string memory _uri
            )
              internal
              validNFToken(_tokenId)
            {
              idToUri[_tokenId] = _uri;
            }
            
          function _setTokenPayload(
              uint256 _tokenId,
              string memory _uri
            )
              internal
              validNFToken(_tokenId)
            {
              idToPayload[_tokenId] = _uri;
            }
            
            /**
             * List of revert message codes. Implementing dApp should handle showing the correct message.
             * Based on 0xcert framework error codes.
             */
            string constant INVALID_INDEX = "005007";
          
            /**
             * @dev Array of all NFT IDs.
             */
            uint256[] internal tokens;
          
            /**
             * @dev Mapping from token ID to its index in global tokens array.
             */
            mapping(uint256 => uint256) internal idToIndex;
          
            /**
             * @dev Mapping from owner to list of owned NFT IDs.
             */
            mapping(address => uint256[]) internal ownerToIds;
          
            /**
             * @dev Mapping from NFT ID to its index in the owner tokens list.
             */
            mapping(uint256 => uint256) internal idToOwnerIndex;
            
            /**
             * @dev Returns the count of all existing NFTokens.
             * @return Total supply of NFTs.
             */
            function totalSupply()
              external
              override
              view
              returns (uint256)
            {
              return tokens.length;
            }
          
            /**
             * @dev Returns NFT ID by its index.
             * @param _index A counter less than `totalSupply()`.
             * @return Token id.
             */
            function tokenByIndex(
              uint256 _index
            )
              external
              override
              view
              returns (uint256)
            {
              require(_index < tokens.length, INVALID_INDEX);
              return tokens[_index];
            }
          
            /**
             * @dev returns the n-th NFT ID from a list of owner's tokens.
             * @param _owner Token owner's address.
             * @param _index Index number representing n-th token in owner's list of tokens.
             * @return Token id.
             */
            function tokenOfOwnerByIndex(
              address _owner,
              uint256 _index
            )
              external
              override
              view
              returns (uint256)
            {
              require(_index < ownerToIds[_owner].length, INVALID_INDEX);
              return ownerToIds[_owner][_index];
            }
          
            /**
             * @dev Mints a new NFT.
             * @notice This is an internal function which should be called from user-implemented external
             * mint function. Its purpose is to show and properly initialize data structures when using this
             * implementation.
             * @param _to The address that will own the minted NFT.
             * @param _tokenId of the NFT to be minted by the msg.sender.
             */
            function _mint(
              address _to,
              uint256 _tokenId
            )
              internal
              override
              virtual
            {
              super._mint(_to, _tokenId);
              tokens.push(_tokenId);
              idToIndex[_tokenId] = tokens.length - 1;
            }
          
            /**
             * @dev Burns a NFT.
             * @notice This is an internal function which should be called from user-implemented external
             * burn function. Its purpose is to show and properly initialize data structures when using this
             * implementation. Also, note that this burn implementation allows the minter to re-mint a burned
             * NFT.
             * @param _tokenId ID of the NFT to be burned.
             */
            function _burn(
              uint256 _tokenId
            )
              internal
              override
              virtual
            {
              super._burn(_tokenId);
              
              if (bytes(idToUri[_tokenId]).length != 0)
              {
                delete idToUri[_tokenId];
              }
              
              if (bytes(idToPayload[_tokenId]).length != 0)
              {
                delete idToPayload[_tokenId];
              }
              
              uint256 tokenIndex = idToIndex[_tokenId];
              uint256 lastTokenIndex = tokens.length - 1;
              uint256 lastToken = tokens[lastTokenIndex];
          
              tokens[tokenIndex] = lastToken;
          
              tokens.pop();
              // This wastes gas if you are burning the last token but saves a little gas if you are not.
              idToIndex[lastToken] = tokenIndex;
              idToIndex[_tokenId] = 0;
            }
          
            /**
             * @dev Removes a NFT from an address.
             * @notice Use and override this function with caution. Wrong usage can have serious consequences.
             * @param _from Address from wich we want to remove the NFT.
             * @param _tokenId Which NFT we want to remove.
             */
            function _removeNFToken(
              address _from,
              uint256 _tokenId
            )
              internal
              override
              virtual
            {
              require(idToOwner[_tokenId] == _from, NOT_OWNER);
              delete idToOwner[_tokenId];
          
              uint256 tokenToRemoveIndex = idToOwnerIndex[_tokenId];
              uint256 lastTokenIndex = ownerToIds[_from].length - 1;
          
              if (lastTokenIndex != tokenToRemoveIndex)
              {
                uint256 lastToken = ownerToIds[_from][lastTokenIndex];
                ownerToIds[_from][tokenToRemoveIndex] = lastToken;
                idToOwnerIndex[lastToken] = tokenToRemoveIndex;
              }
          
              ownerToIds[_from].pop();
            }
          
            /**
             * @dev Assignes a new NFT to an address.
             * @notice Use and override this function with caution. Wrong usage can have serious consequences.
             * @param _to Address to wich we want to add the NFT.
             * @param _tokenId Which NFT we want to add.
             */
            function _addNFToken(
              address _to,
              uint256 _tokenId
            )
              internal
              override
              virtual
            {
              require(idToOwner[_tokenId] == address(0), NFT_ALREADY_EXISTS);
              idToOwner[_tokenId] = _to;
          
              ownerToIds[_to].push(_tokenId);
              idToOwnerIndex[_tokenId] = ownerToIds[_to].length - 1;
            }
          
            /**
             * @dev Helper function that gets NFT count of owner. This is needed for overriding in enumerable
             * extension to remove double storage(gas optimization) of owner nft count.
             * @param _owner Address for whom to query the count.
             * @return Number of _owner NFTs.
             */
            function _getOwnerNFTCount(
              address _owner
            )
              internal
              override
              virtual
              view
              returns (uint256)
            {
              return ownerToIds[_owner].length;
            }
          
          }
          
          // File: browser/EmblemVault_v2.sol
          
          pragma experimental ABIEncoderV2;
          pragma solidity 0.6.2;
          
          
          
          /**
           * @dev This is an example contract implementation of NFToken with metadata extension.
           */
          contract EmblemVault is
            NFTokenEnumerableMetadata,
            Ownable
          {
          
            /**
             * @dev Contract constructor. Sets metadata extension `name` and `symbol`.
             */
            constructor() public {
              nftName = "Emblem Vault V2";
              nftSymbol = "Emblem.pro";
            }
            
            function changeName(string calldata name, string calldata symbol) external onlyOwner {
                nftName = name;
                nftSymbol = symbol;
            }
          
            /**
             * @dev Mints a new NFT.
             * @param _to The address that will own the minted NFT.
             * @param _tokenId of the NFT to be minted by the msg.sender.
             * @param _uri String representing RFC 3986 URI.
             */
            function mint( address _to, uint256 _tokenId, string calldata _uri, string calldata _payload) external onlyOwner {
              super._mint(_to, _tokenId);
              super._setTokenUri(_tokenId, _uri);
              super._setTokenPayload(_tokenId, _payload);
            }
            
            function burn(uint256 _tokenId) external canTransfer(_tokenId) {
              super._burn(_tokenId);
            }
            
            function contractURI() public view returns (string memory) {
              return nftContractMetadataUri;
            }
            
            event UpdatedContractURI(string _from, string _to);
            function updateContractURI(string memory uri) public onlyOwner {
              emit UpdatedContractURI(nftContractMetadataUri, uri);
              nftContractMetadataUri = uri;
            }
            
            function getOwnerNFTCount(address _owner) public view returns (uint256) {
                return NFTokenEnumerableMetadata._getOwnerNFTCount(_owner);
            }
            
            function updateTokenUri(
              uint256 _tokenId,
              string memory _uri
            )
              public
              validNFToken(_tokenId)
              onlyOwner
            {
              idToUri[_tokenId] = _uri;
            }
            
            
          
          }

          File 3 of 5: WyvernProxyRegistry
          pragma solidity ^0.4.13;
          
          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
            );
          }
          
          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 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 WyvernProxyRegistry is ProxyRegistry {
          
              string public constant name = "Project Wyvern Proxy Registry";
          
              /* Whether the initial auth address has been set. */
              bool public initialAddressSet = false;
          
              constructor ()
                  public
              {
                  delegateProxyImplementation = new AuthenticatedProxy();
              }
          
              /** 
               * Grant authentication to the initial Exchange protocol contract
               *
               * @dev No delay, can only be called once - after that the standard registry process with a delay must be used
               * @param authAddress Address of the contract to grant authentication
               */
              function grantInitialAuthentication (address authAddress)
                  onlyOwner
                  public
              {
                  require(!initialAddressSet);
                  initialAddressSet = true;
                  contracts[authAddress] = true;
              }
          
          }
          
          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));
              }
          
          }

          File 4 of 5: AuthenticatedProxy
          pragma solidity ^0.4.13;
          
          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
            );
          }
          
          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 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 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));
              }
          
          }

          File 5 of 5: MerkleValidator
          pragma solidity 0.8.11;
          
          interface IERC721 {
              function safeTransferFrom(address from, address to, uint256 tokenId) external;
              function transferFrom(address from, address to, uint256 tokenId) external;
          }
          
          interface IERC1155 {
              function safeTransferFrom(address from, address to, uint256 tokenId, uint256 amount, bytes calldata data) external;
          }
          
          /// @title MerkleValidator enables matching trait-based and collection-based orders for ERC721 and ERC1155 tokens.
          /// @author 0age
          /// @dev This contract is intended to be called during atomicMatch_ via DELEGATECALL.
          contract MerkleValidator {
              /// @dev InvalidProof is thrown on invalid proofs.
              error InvalidProof();
          
              /// @dev UnnecessaryProof is thrown in cases where a proof is supplied without a valid root to match against (root = 0)
              error UnnecessaryProof();
          
              /// @dev Match an ERC721 order, ensuring that the supplied proof demonstrates inclusion of the tokenId in the associated merkle root.
              /// @param from The account to transfer the ERC721 token from — this token must first be approved on the seller's AuthenticatedProxy contract.
              /// @param to The account to transfer the ERC721 token to.
              /// @param token The ERC721 token to transfer.
              /// @param tokenId The ERC721 tokenId to transfer.
              /// @param root A merkle root derived from each valid tokenId — set to 0 to indicate a collection-level or tokenId-specific order.
              /// @param proof A proof that the supplied tokenId is contained within the associated merkle root. Must be length 0 if root is not set.
              /// @return A boolean indicating a successful match and transfer.
              function matchERC721UsingCriteria(
                  address from,
                  address to,
                  IERC721 token,
                  uint256 tokenId,
                  bytes32 root,
                  bytes32[] calldata proof
              ) external returns (bool) {
              	// Proof verification is performed when there's a non-zero root.
              	if (root != bytes32(0)) {
              		_verifyProof(tokenId, root, proof);
              	} else if (proof.length != 0) {
              		// A root of zero should never have a proof.
              		revert UnnecessaryProof();
              	}
          
              	// Transfer the token.
                  token.transferFrom(from, to, tokenId);
          
                  return true;
              }
          
              /// @dev Match an ERC721 order using `safeTransferFrom`, ensuring that the supplied proof demonstrates inclusion of the tokenId in the associated merkle root.
              /// @param from The account to transfer the ERC721 token from — this token must first be approved on the seller's AuthenticatedProxy contract.
              /// @param to The account to transfer the ERC721 token to.
              /// @param token The ERC721 token to transfer.
              /// @param tokenId The ERC721 tokenId to transfer.
              /// @param root A merkle root derived from each valid tokenId — set to 0 to indicate a collection-level or tokenId-specific order.
              /// @param proof A proof that the supplied tokenId is contained within the associated merkle root. Must be length 0 if root is not set.
              /// @return A boolean indicating a successful match and transfer.
              function matchERC721WithSafeTransferUsingCriteria(
                  address from,
                  address to,
                  IERC721 token,
                  uint256 tokenId,
                  bytes32 root,
                  bytes32[] calldata proof
              ) external returns (bool) {
                  // Proof verification is performed when there's a non-zero root.
                  if (root != bytes32(0)) {
                      _verifyProof(tokenId, root, proof);
                  } else if (proof.length != 0) {
                      // A root of zero should never have a proof.
                      revert UnnecessaryProof();
                  }
          
                  // Transfer the token.
                  token.safeTransferFrom(from, to, tokenId);
          
                  return true;
              }
          
              /// @dev Match an ERC1155 order, ensuring that the supplied proof demonstrates inclusion of the tokenId in the associated merkle root.
              /// @param from The account to transfer the ERC1155 token from — this token must first be approved on the seller's AuthenticatedProxy contract.
              /// @param to The account to transfer the ERC1155 token to.
              /// @param token The ERC1155 token to transfer.
              /// @param tokenId The ERC1155 tokenId to transfer.
              /// @param amount The amount of ERC1155 tokens with the given tokenId to transfer.
              /// @param root A merkle root derived from each valid tokenId — set to 0 to indicate a collection-level or tokenId-specific order.
              /// @param proof A proof that the supplied tokenId is contained within the associated merkle root. Must be length 0 if root is not set.
              /// @return A boolean indicating a successful match and transfer.
              function matchERC1155UsingCriteria(
                  address from,
                  address to,
                  IERC1155 token,
                  uint256 tokenId,
                  uint256 amount,
                  bytes32 root,
                  bytes32[] calldata proof
              ) external returns (bool) {
                  // Proof verification is performed when there's a non-zero root.
                  if (root != bytes32(0)) {
                      _verifyProof(tokenId, root, proof);
                  } else if (proof.length != 0) {
                      // A root of zero should never have a proof.
                      revert UnnecessaryProof();
                  }
          
                  // Transfer the token.
                  token.safeTransferFrom(from, to, tokenId, amount, "");
          
                  return true;
              }
          
              /// @dev Ensure that a given tokenId is contained within a supplied merkle root using a supplied proof.
              /// @param leaf The tokenId.
              /// @param root A merkle root derived from each valid tokenId.
              /// @param proof A proof that the supplied tokenId is contained within the associated merkle root.
              function _verifyProof(
                  uint256 leaf,
                  bytes32 root,
                  bytes32[] memory proof
              ) private pure {
                  bytes32 computedHash = bytes32(leaf);
                  for (uint256 i = 0; i < proof.length; i++) {
                      bytes32 proofElement = proof[i];
                      if (computedHash <= proofElement) {
                          // Hash(current computed hash + current element of the proof)
                          computedHash = _efficientHash(computedHash, proofElement);
                      } else {
                          // Hash(current element of the proof + current computed hash)
                          computedHash = _efficientHash(proofElement, computedHash);
                      }
                  }
                  if (computedHash != root) {
                      revert InvalidProof();
                  }
              }
          
              /// @dev Efficiently hash two bytes32 elements using memory scratch space.
              /// @param a The first element included in the hash.
              /// @param b The second element included in the hash.
              /// @return value The resultant hash of the two bytes32 elements.
              function _efficientHash(
                  bytes32 a,
                  bytes32 b
              ) private pure returns (bytes32 value) {
                  assembly {
                      mstore(0x00, a)
                      mstore(0x20, b)
                      value := keccak256(0x00, 0x40)
                  }
              }
          }