ETH Price: $2,282.91 (+9.12%)

Transaction Decoder

Block:
15837152 at Oct-27-2022 04:54:35 AM +UTC
Transaction Fee:
0.004835017987369572 ETH $11.04
Gas Used:
414,314 Gas / 11.669936298 Gwei

Emitted Events:

185 VOXVOT_BlindVox.Transfer( from=0xad829e03aeea9a3f7861f4053fd0ff44043c6fa3, to=[Receiver] BlurSwap, tokenId=4752 )
186 0x000000000000ad05ccc4f10045630fb830b95127.0x61cbb2a3dee0b6064c2e681aadd61677fb4ef319f0b547508d495626f5a62f64( 0x61cbb2a3dee0b6064c2e681aadd61677fb4ef319f0b547508d495626f5a62f64, 0x00000000000000000000000039da41747a83aee658334415666f3ef92dd0d541, 0x000000000000000000000000ad829e03aeea9a3f7861f4053fd0ff44043c6fa3, 0000000000000000000000000000000000000000000000000000000000000080, 7c4de40991890a5e3696c44cd235c0f60781dfdcd274a57db7971ab8a3415976, 0000000000000000000000000000000000000000000000000000000000000260, af392fc82a97ce57f99606c6c6abb62033712847850e4f714eac50b98dabd17b, 000000000000000000000000ad829e03aeea9a3f7861f4053fd0ff44043c6fa3, 0000000000000000000000000000000000000000000000000000000000000001, 00000000000000000000000000000000006411739da1c40b106f8511de5d1fac, 000000000000000000000000b83c3ca6e22ef50ec13dc56b6d0729aef6b4546e, 0000000000000000000000000000000000000000000000000000000000001290, 0000000000000000000000000000000000000000000000000000000000000001, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000083734dd0b08000, 00000000000000000000000000000000000000000000000000000000635a0d6e, 00000000000000000000000000000000000000000000000000000000636347f0, 00000000000000000000000000000000000000000000000000000000000001a0, 00000000000000000000000000000000a6161932f615e87edba0265b2695953d, 00000000000000000000000000000000000000000000000000000000000001c0, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 00000000000000000000000039da41747a83aee658334415666f3ef92dd0d541, 0000000000000000000000000000000000000000000000000000000000000000, 00000000000000000000000000000000006411739da1c40b106f8511de5d1fac, 000000000000000000000000b83c3ca6e22ef50ec13dc56b6d0729aef6b4546e, 0000000000000000000000000000000000000000000000000000000000001290, 0000000000000000000000000000000000000000000000000000000000000001, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000083734dd0b08000, 00000000000000000000000000000000000000000000000000000000635a00ee, 00000000000000000000000000000000000000000000000000000000635a1d0e, 00000000000000000000000000000000000000000000000000000000000001a0, 000000000000000000000000000000006c472235ea3c5b41d78d8840d042c311, 00000000000000000000000000000000000000000000000000000000000001c0, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000 )
187 VOXVOT_BlindVox.Transfer( from=[Receiver] BlurSwap, to=[Sender] 0x9eb0b9744545746428ae65f30b8f562fe10e1f11, tokenId=4752 )
188 VOXVOT_BlindVox.Transfer( from=0xad829e03aeea9a3f7861f4053fd0ff44043c6fa3, to=[Receiver] BlurSwap, tokenId=4753 )
189 0x000000000000ad05ccc4f10045630fb830b95127.0x61cbb2a3dee0b6064c2e681aadd61677fb4ef319f0b547508d495626f5a62f64( 0x61cbb2a3dee0b6064c2e681aadd61677fb4ef319f0b547508d495626f5a62f64, 0x00000000000000000000000039da41747a83aee658334415666f3ef92dd0d541, 0x000000000000000000000000ad829e03aeea9a3f7861f4053fd0ff44043c6fa3, 0000000000000000000000000000000000000000000000000000000000000080, 066ec127d6fafa9b403742046e23f365d3a573080bd0aafc588f866e492c9b26, 0000000000000000000000000000000000000000000000000000000000000260, 52f74c65687303af955c7f6b2ff4ef1834e81f9b8d4bc766e9fd7b6116057ef3, 000000000000000000000000ad829e03aeea9a3f7861f4053fd0ff44043c6fa3, 0000000000000000000000000000000000000000000000000000000000000001, 00000000000000000000000000000000006411739da1c40b106f8511de5d1fac, 000000000000000000000000b83c3ca6e22ef50ec13dc56b6d0729aef6b4546e, 0000000000000000000000000000000000000000000000000000000000001291, 0000000000000000000000000000000000000000000000000000000000000001, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000083734dd0b08000, 00000000000000000000000000000000000000000000000000000000635a0d6e, 00000000000000000000000000000000000000000000000000000000636347f0, 00000000000000000000000000000000000000000000000000000000000001a0, 0000000000000000000000000000000085ed15015bf3e36cc252c5c93209604e, 00000000000000000000000000000000000000000000000000000000000001c0, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 00000000000000000000000039da41747a83aee658334415666f3ef92dd0d541, 0000000000000000000000000000000000000000000000000000000000000000, 00000000000000000000000000000000006411739da1c40b106f8511de5d1fac, 000000000000000000000000b83c3ca6e22ef50ec13dc56b6d0729aef6b4546e, 0000000000000000000000000000000000000000000000000000000000001291, 0000000000000000000000000000000000000000000000000000000000000001, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000083734dd0b08000, 00000000000000000000000000000000000000000000000000000000635a00ee, 00000000000000000000000000000000000000000000000000000000635a1d0e, 00000000000000000000000000000000000000000000000000000000000001a0, 00000000000000000000000000000000e2f55edefc4af20473d59989a5537ebe, 00000000000000000000000000000000000000000000000000000000000001c0, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000 )
190 VOXVOT_BlindVox.Transfer( from=[Receiver] BlurSwap, to=[Sender] 0x9eb0b9744545746428ae65f30b8f562fe10e1f11, tokenId=4753 )

Account State Difference:

  Address   Before After State Difference Code
0x00000000...830B95127
(Blur.io: Marketplace)
(MEV Builder: 0x473...dFc)
12.069141783130791744 Eth12.069763254130791744 Eth0.000621471
0x9eb0b974...FE10e1F11
0.191749032224078298 Eth
Nonce: 2666
0.112914014236708726 Eth
Nonce: 2667
0.078835017987369572
0xaD829e03...4043C6FA3 0.301367633065006554 Eth0.375367633065006554 Eth0.074
0xB83C3CA6...ef6b4546E

Execution Trace

ETH 0.074 BlurSwap.batchBuyWithETH( tradeDetails= )
  • 0x3a574bac669f3b1cb54b92ccbaefbafd07054d96.b1283e77( )
  • ETH 0.074 0x1e7e05af7de55b69b72953e569bfe99bed8bb68a.2936d751( )
    • ETH 0.037 Blur.io: Marketplace.9a1fc3a7( )
      • ETH 0.037 0x031aa05da8bf778dfc36d8d25ca68cbb2fc447c6.9a1fc3a7( )
        • ETH 0.037 0x4c2bbdbeccae1c492c681158a46eae498a05627b.9c7bf938( )
        • Null: 0x000...001.acb11b38( )
        • 0x3a35a3102b5c6bd1e4d3237248be071ef53c8331.874516cd( )
        • 0x00000000006411739da1c40b106f8511de5d1fac.0813a766( )
        • ETH 0.037 0xad829e03aeea9a3f7861f4053fd0ff44043c6fa3.CALL( )
        • Blur: Execution Delegate.789f93f6( )
          • VOXVOT_BlindVox.safeTransferFrom( from=0xaD829e03AEea9A3f7861f4053fd0ff44043C6FA3, to=0x39da41747a83aeE658334415666f3EF92DD0D541, tokenId=4752 )
            • BlurSwap.onERC721Received( 0x00000000000111AbE46ff893f3B2fdF1F759a8A8, 0xaD829e03AEea9A3f7861f4053fd0ff44043C6FA3, 4752, 0x )
            • VOXVOT_BlindVox.ownerOf( tokenId=4752 ) => ( 0x39da41747a83aeE658334415666f3EF92DD0D541 )
            • VOXVOT_BlindVox.transferFrom( from=0x39da41747a83aeE658334415666f3EF92DD0D541, to=0x9eb0b9744545746428ae65f30b8f562FE10e1F11, tokenId=4752 )
            • ETH 0.037 Blur.io: Marketplace.9a1fc3a7( )
              • ETH 0.037 0x031aa05da8bf778dfc36d8d25ca68cbb2fc447c6.9a1fc3a7( )
                • ETH 0.037 0x4c2bbdbeccae1c492c681158a46eae498a05627b.9c7bf938( )
                • Null: 0x000...001.acb11b38( )
                • 0x3a35a3102b5c6bd1e4d3237248be071ef53c8331.874516cd( )
                • 0x00000000006411739da1c40b106f8511de5d1fac.0813a766( )
                • ETH 0.037 0xad829e03aeea9a3f7861f4053fd0ff44043c6fa3.CALL( )
                • Blur: Execution Delegate.789f93f6( )
                  • VOXVOT_BlindVox.safeTransferFrom( from=0xaD829e03AEea9A3f7861f4053fd0ff44043C6FA3, to=0x39da41747a83aeE658334415666f3EF92DD0D541, tokenId=4753 )
                    • BlurSwap.onERC721Received( 0x00000000000111AbE46ff893f3B2fdF1F759a8A8, 0xaD829e03AEea9A3f7861f4053fd0ff44043C6FA3, 4753, 0x )
                    • VOXVOT_BlindVox.ownerOf( tokenId=4753 ) => ( 0x39da41747a83aeE658334415666f3EF92DD0D541 )
                    • VOXVOT_BlindVox.transferFrom( from=0x39da41747a83aeE658334415666f3EF92DD0D541, to=0x9eb0b9744545746428ae65f30b8f562FE10e1F11, tokenId=4753 )
                      File 1 of 2: BlurSwap
                      // SPDX-License-Identifier: MIT
                      pragma solidity 0.8.13;
                      import "@openzeppelin/contracts/access/Ownable.sol";
                      import "./utils/ReentrancyGuard.sol";
                      import "./markets/MarketRegistry.sol";
                      import "./SpecialTransferHelper.sol";
                      import "./interfaces/IERC20.sol";
                      import "./interfaces/IERC721.sol";
                      import "./interfaces/IERC1155.sol";
                      contract BlurSwap is SpecialTransferHelper, Ownable, ReentrancyGuard {
                          struct OpenseaTrades {
                              uint256 value;
                              bytes tradeData;
                          }
                          struct ERC20Details {
                              address[] tokenAddrs;
                              uint256[] amounts;
                          }
                          struct ERC1155Details {
                              address tokenAddr;
                              uint256[] ids;
                              uint256[] amounts;
                          }
                          struct ConverstionDetails {
                              bytes conversionData;
                          }
                          struct AffiliateDetails {
                              address affiliate;
                              bool isActive;
                          }
                          struct SponsoredMarket {
                              uint256 marketId;
                              bool isActive;
                          }
                          address public constant GOV = 0xcD0313FD7CCa5648d2948c42C320Ba50CD0E6cB6;
                          address public guardian;
                          address public converter;
                          address public punkProxy;
                          uint256 public baseFees;
                          bool public openForTrades;
                          bool public openForFreeTrades;
                          MarketRegistry public marketRegistry;
                          AffiliateDetails[] public affiliates;
                          SponsoredMarket[] public sponsoredMarkets;
                          modifier isOpenForTrades() {
                              require(openForTrades, "trades not allowed");
                              _;
                          }
                          modifier isOpenForFreeTrades() {
                              require(openForFreeTrades, "free trades not allowed");
                              _;
                          }
                          constructor(address _marketRegistry, address _guardian) {
                              marketRegistry = MarketRegistry(_marketRegistry);
                              guardian = _guardian;
                              baseFees = 0;
                              openForTrades = true;
                              openForFreeTrades = true;
                          }
                          function setUp() external onlyOwner {
                              // Create CryptoPunk Proxy
                              IWrappedPunk(0xb7F7F6C52F2e2fdb1963Eab30438024864c313F6).registerProxy();
                              punkProxy = IWrappedPunk(0xb7F7F6C52F2e2fdb1963Eab30438024864c313F6).proxyInfo(address(this));
                              // approve wrapped mooncats rescue to Acclimated​MoonCats contract
                              IERC721(0x7C40c393DC0f283F318791d746d894DdD3693572).setApprovalForAll(0xc3f733ca98E0daD0386979Eb96fb1722A1A05E69, true);
                          }
                          // @audit This function is used to approve specific tokens to specific market contracts with high volume.
                          // This is done in very rare cases for the gas optimization purposes. 
                          function setOneTimeApproval(IERC20 token, address operator, uint256 amount) external onlyOwner {
                              token.approve(operator, amount);
                          }
                          function updateGuardian(address _guardian) external onlyOwner {
                              guardian = _guardian;
                          }
                          function addAffiliate(address _affiliate) external onlyOwner {
                              affiliates.push(AffiliateDetails(_affiliate, true));
                          }
                          function updateAffiliate(uint256 _affiliateIndex, address _affiliate, bool _IsActive) external onlyOwner {
                              affiliates[_affiliateIndex] = AffiliateDetails(_affiliate, _IsActive);
                          }
                          function addSponsoredMarket(uint256 _marketId) external onlyOwner {
                              sponsoredMarkets.push(SponsoredMarket(_marketId, true));
                          }
                          function updateSponsoredMarket(uint256 _marketIndex, uint256 _marketId, bool _isActive) external onlyOwner {
                              sponsoredMarkets[_marketIndex] = SponsoredMarket(_marketId, _isActive);
                          }
                          function setBaseFees(uint256 _baseFees) external onlyOwner {
                              baseFees = _baseFees;
                          }
                          function setOpenForTrades(bool _openForTrades) external onlyOwner {
                              openForTrades = _openForTrades;
                          }
                          function setOpenForFreeTrades(bool _openForFreeTrades) external onlyOwner {
                              openForFreeTrades = _openForFreeTrades;
                          }
                          // @audit we will setup a system that will monitor the contract for any leftover
                          // assets. In case any asset is leftover, the system should be able to trigger this
                          // function to close all the trades until the leftover assets are rescued.
                          function closeAllTrades() external {
                              require(_msgSender() == guardian);
                              openForTrades = false;
                              openForFreeTrades = false;
                          }
                          function setConverter(address _converter) external onlyOwner {
                              converter = _converter;
                          }
                          function setMarketRegistry(MarketRegistry _marketRegistry) external onlyOwner {
                              marketRegistry = _marketRegistry;
                          }
                          function _transferEth(address _to, uint256 _amount) internal {
                              bool callStatus;
                              assembly {
                                  // Transfer the ETH and store if it succeeded or not.
                                  callStatus := call(gas(), _to, _amount, 0, 0, 0, 0)
                              }
                              require(callStatus, "_transferEth: Eth transfer failed");
                          }
                          function _collectFee(uint256[2] memory feeDetails) internal {
                              require(feeDetails[1] >= baseFees, "Insufficient fee");
                              if (feeDetails[1] > 0) {
                                  AffiliateDetails memory affiliateDetails = affiliates[feeDetails[0]];
                                  affiliateDetails.isActive
                                      ? _transferEth(affiliateDetails.affiliate, feeDetails[1])
                                      : _transferEth(GOV, feeDetails[1]);
                              }
                          }
                          function _checkCallResult(bool _success) internal pure {
                              if (!_success) {
                                  // Copy revert reason from call
                                  assembly {
                                      returndatacopy(0, 0, returndatasize())
                                      revert(0, returndatasize())
                                  }
                              }
                          }
                          function _transferFromHelper(
                              ERC20Details memory erc20Details,
                              SpecialTransferHelper.ERC721Details[] memory erc721Details,
                              ERC1155Details[] memory erc1155Details
                          ) internal {
                              // transfer ERC20 tokens from the sender to this contract
                              for (uint256 i = 0; i < erc20Details.tokenAddrs.length; i++) {
                                  erc20Details.tokenAddrs[i].call(abi.encodeWithSelector(0x23b872dd, msg.sender, address(this), erc20Details.amounts[i]));
                              }
                              // transfer ERC721 tokens from the sender to this contract
                              for (uint256 i = 0; i < erc721Details.length; i++) {
                                  // accept CryptoPunks
                                  if (erc721Details[i].tokenAddr == 0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB) {
                                      _acceptCryptoPunk(erc721Details[i]);
                                  }
                                  // accept Mooncat
                                  else if (erc721Details[i].tokenAddr == 0x60cd862c9C687A9dE49aecdC3A99b74A4fc54aB6) {
                                      _acceptMoonCat(erc721Details[i]);
                                  }
                                  // default
                                  else {
                                      for (uint256 j = 0; j < erc721Details[i].ids.length; j++) {
                                          IERC721(erc721Details[i].tokenAddr).transferFrom(
                                              _msgSender(),
                                              address(this),
                                              erc721Details[i].ids[j]
                                          );
                                      }
                                  }
                              }
                              // transfer ERC1155 tokens from the sender to this contract
                              for (uint256 i = 0; i < erc1155Details.length; i++) {
                                  IERC1155(erc1155Details[i].tokenAddr).safeBatchTransferFrom(
                                      _msgSender(),
                                      address(this),
                                      erc1155Details[i].ids,
                                      erc1155Details[i].amounts,
                                      ""
                                  );
                              }
                          }
                          function _conversionHelper(
                              ConverstionDetails[] memory _converstionDetails
                          ) internal {
                              for (uint256 i = 0; i < _converstionDetails.length; i++) {
                                  // convert to desired asset
                                  (bool success, ) = converter.delegatecall(_converstionDetails[i].conversionData);
                                  // check if the call passed successfully
                                  _checkCallResult(success);
                              }
                          }
                          function _trade(
                              MarketRegistry.TradeDetails[] memory _tradeDetails
                          ) internal {
                              for (uint256 i = 0; i < _tradeDetails.length; i++) {
                                  // get market details
                                  (address _proxy, bool _isLib, bool _isActive) = marketRegistry.markets(_tradeDetails[i].marketId);
                                  // market should be active
                                  require(_isActive, "_trade: InActive Market");
                                  // execute trade
                                  if (_proxy == 0x7Be8076f4EA4A4AD08075C2508e481d6C946D12b || _proxy == 0x7f268357A8c2552623316e2562D90e642bB538E5) {
                                      _proxy.call{value:_tradeDetails[i].value}(_tradeDetails[i].tradeData);
                                  } else {
                                      (bool success, ) = _isLib
                                          ? _proxy.delegatecall(_tradeDetails[i].tradeData)
                                          : _proxy.call{value:_tradeDetails[i].value}(_tradeDetails[i].tradeData);
                                      // check if the call passed successfully
                                      _checkCallResult(success);
                                  }
                              }
                          }
                          // function _tradeSponsored(
                          //     MarketRegistry.TradeDetails[] memory _tradeDetails,
                          //     uint256 sponsoredMarketId
                          // ) internal returns (bool isSponsored) {
                          //     for (uint256 i = 0; i < _tradeDetails.length; i++) {
                          //         // check if the trade is for the sponsored market
                          //         if (_tradeDetails[i].marketId == sponsoredMarketId) {
                          //             isSponsored = true;
                          //         }
                          //         // get market details
                          //         (address _proxy, bool _isLib, bool _isActive) = marketRegistry.markets(_tradeDetails[i].marketId);
                          //         // market should be active
                          //         require(_isActive, "_trade: InActive Market");
                          //         // execute trade
                          //         if (_proxy == 0x7Be8076f4EA4A4AD08075C2508e481d6C946D12b) {
                          //             _proxy.call{value:_tradeDetails[i].value}(_tradeDetails[i].tradeData);
                          //         } else {
                          //             (bool success, ) = _isLib
                          //                 ? _proxy.delegatecall(_tradeDetails[i].tradeData)
                          //                 : _proxy.call{value:_tradeDetails[i].value}(_tradeDetails[i].tradeData);
                          //             // check if the call passed successfully
                          //             _checkCallResult(success);
                          //         }
                          //     }
                          // }
                          function _returnDust(address[] memory _tokens) internal {
                              // return remaining ETH (if any)
                              assembly {
                                  if gt(selfbalance(), 0) {
                                      let callStatus := call(
                                          gas(),
                                          caller(),
                                          selfbalance(),
                                          0,
                                          0,
                                          0,
                                          0
                                      )
                                  }
                              }
                              // return remaining tokens (if any)
                              for (uint256 i = 0; i < _tokens.length; i++) {
                                  if (IERC20(_tokens[i]).balanceOf(address(this)) > 0) {
                                      _tokens[i].call(abi.encodeWithSelector(0xa9059cbb, msg.sender, IERC20(_tokens[i]).balanceOf(address(this))));
                                  }
                              }
                          }
                          function batchBuyFromOpenSea(
                              OpenseaTrades[] memory openseaTrades
                          ) payable external nonReentrant {
                              // execute trades
                              for (uint256 i = 0; i < openseaTrades.length; i++) {
                                  // execute trade
                                  address(0x7Be8076f4EA4A4AD08075C2508e481d6C946D12b).call{value:openseaTrades[i].value}(openseaTrades[i].tradeData);
                              }
                              // return remaining ETH (if any)
                              assembly {
                                  if gt(selfbalance(), 0) {
                                      let callStatus := call(
                                          gas(),
                                          caller(),
                                          selfbalance(),
                                          0,
                                          0,
                                          0,
                                          0
                                      )
                                  }
                              }
                          }
                          
                          function batchBuyWithETH(
                              MarketRegistry.TradeDetails[] memory tradeDetails
                          ) payable external nonReentrant {
                              // execute trades
                              _trade(tradeDetails);
                              // return remaining ETH (if any)
                              assembly {
                                  if gt(selfbalance(), 0) {
                                      let callStatus := call(
                                          gas(),
                                          caller(),
                                          selfbalance(),
                                          0,
                                          0,
                                          0,
                                          0
                                      )
                                  }
                              }
                          }
                          function batchBuyWithERC20s(
                              ERC20Details memory erc20Details,
                              MarketRegistry.TradeDetails[] memory tradeDetails,
                              ConverstionDetails[] memory converstionDetails,
                              address[] memory dustTokens
                          ) payable external nonReentrant {
                              // transfer ERC20 tokens from the sender to this contract
                              for (uint256 i = 0; i < erc20Details.tokenAddrs.length; i++) {
                                  erc20Details.tokenAddrs[i].call(abi.encodeWithSelector(0x23b872dd, msg.sender, address(this), erc20Details.amounts[i]));
                              }
                              // Convert any assets if needed
                              _conversionHelper(converstionDetails);
                              // execute trades
                              _trade(tradeDetails);
                              // return dust tokens (if any)
                              _returnDust(dustTokens);
                          }
                          // swaps any combination of ERC-20/721/1155
                          // User needs to approve assets before invoking swap
                          // WARNING: DO NOT SEND TOKENS TO THIS FUNCTION DIRECTLY!!!
                          function multiAssetSwap(
                              ERC20Details memory erc20Details,
                              SpecialTransferHelper.ERC721Details[] memory erc721Details,
                              ERC1155Details[] memory erc1155Details,
                              ConverstionDetails[] memory converstionDetails,
                              MarketRegistry.TradeDetails[] memory tradeDetails,
                              address[] memory dustTokens,
                              uint256[2] memory feeDetails    // [affiliateIndex, ETH fee in Wei]
                          ) payable external isOpenForTrades nonReentrant {
                              // collect fees
                              _collectFee(feeDetails);
                              // transfer all tokens
                              _transferFromHelper(
                                  erc20Details,
                                  erc721Details,
                                  erc1155Details
                              );
                              // Convert any assets if needed
                              _conversionHelper(converstionDetails);
                              // execute trades
                              _trade(tradeDetails);
                              // return dust tokens (if any)
                              _returnDust(dustTokens);
                          }
                          // Utility function that is used for free swaps for sponsored markets
                          // WARNING: DO NOT SEND TOKENS TO THIS FUNCTION DIRECTLY!!! 
                          // function multiAssetSwapWithoutFee(
                          //     ERC20Details memory erc20Details,
                          //     SpecialTransferHelper.ERC721Details[] memory erc721Details,
                          //     ERC1155Details[] memory erc1155Details,
                          //     ConverstionDetails[] memory converstionDetails,
                          //     MarketRegistry.TradeDetails[] memory tradeDetails,
                          //     address[] memory dustTokens,
                          //     uint256 sponsoredMarketIndex
                          // ) payable external isOpenForFreeTrades nonReentrant {
                          //     // fetch the marketId of the sponsored market
                          //     SponsoredMarket memory sponsoredMarket = sponsoredMarkets[sponsoredMarketIndex];
                          //     // check if the market is active
                          //     require(sponsoredMarket.isActive, "multiAssetSwapWithoutFee: InActive sponsored market");
                      // 
                          //     // transfer all tokens
                          //     _transferFromHelper(
                          //         erc20Details,
                          //         erc721Details,
                          //         erc1155Details
                          //     );
                      // 
                          //     // Convert any assets if needed
                          //     _conversionHelper(converstionDetails);
                      // 
                          //     // execute trades
                          //     bool isSponsored = _tradeSponsored(tradeDetails, sponsoredMarket.marketId);
                      // 
                          //     // check if the trades include the sponsored market
                          //     require(isSponsored, "multiAssetSwapWithoutFee: trades do not include sponsored market");
                      // 
                          //     // return dust tokens (if any)
                          //     _returnDust(dustTokens);
                          // }
                          function onERC1155Received(
                              address,
                              address,
                              uint256,
                              uint256,
                              bytes calldata
                          ) public virtual returns (bytes4) {
                              return this.onERC1155Received.selector;
                          }
                          function onERC1155BatchReceived(
                              address,
                              address,
                              uint256[] calldata,
                              uint256[] calldata,
                              bytes calldata
                          ) public virtual returns (bytes4) {
                              return this.onERC1155BatchReceived.selector;
                          }
                          function onERC721Received(
                              address,
                              address,
                              uint256,
                              bytes calldata
                          ) external virtual returns (bytes4) {
                              return 0x150b7a02;
                          }
                          // Used by ERC721BasicToken.sol
                          function onERC721Received(
                              address,
                              uint256,
                              bytes calldata
                          ) external virtual returns (bytes4) {
                              return 0xf0b9e5ba;
                          }
                          function supportsInterface(bytes4 interfaceId)
                              external
                              virtual
                              view
                              returns (bool)
                          {
                              return interfaceId == this.supportsInterface.selector;
                          }
                          receive() external payable {}
                          // Emergency function: In case any ETH get stuck in the contract unintentionally
                          // Only owner can retrieve the asset balance to a recipient address
                          function rescueETH(address recipient) onlyOwner external {
                              _transferEth(recipient, address(this).balance);
                          }
                          // Emergency function: In case any ERC20 tokens get stuck in the contract unintentionally
                          // Only owner can retrieve the asset balance to a recipient address
                          function rescueERC20(address asset, address recipient) onlyOwner external { 
                              asset.call(abi.encodeWithSelector(0xa9059cbb, recipient, IERC20(asset).balanceOf(address(this))));
                          }
                          // Emergency function: In case any ERC721 tokens get stuck in the contract unintentionally
                          // Only owner can retrieve the asset balance to a recipient address
                          function rescueERC721(address asset, uint256[] calldata ids, address recipient) onlyOwner external {
                              for (uint256 i = 0; i < ids.length; i++) {
                                  IERC721(asset).transferFrom(address(this), recipient, ids[i]);
                              }
                          }
                          // Emergency function: In case any ERC1155 tokens get stuck in the contract unintentionally
                          // Only owner can retrieve the asset balance to a recipient address
                          function rescueERC1155(address asset, uint256[] calldata ids, uint256[] calldata amounts, address recipient) onlyOwner external {
                              for (uint256 i = 0; i < ids.length; i++) {
                                  IERC1155(asset).safeTransferFrom(address(this), recipient, ids[i], amounts[i], "");
                              }
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts v4.4.1 (access/Ownable.sol)
                      pragma solidity ^0.8.0;
                      import "../utils/Context.sol";
                      /**
                       * @dev Contract module which provides a basic access control mechanism, where
                       * there is an account (an owner) that can be granted exclusive access to
                       * specific functions.
                       *
                       * By default, the owner account will be the one that deploys the contract. This
                       * can later be changed with {transferOwnership}.
                       *
                       * This module is used through inheritance. It will make available the modifier
                       * `onlyOwner`, which can be applied to your functions to restrict their use to
                       * the owner.
                       */
                      abstract contract Ownable is Context {
                          address private _owner;
                          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                          /**
                           * @dev Initializes the contract setting the deployer as the initial owner.
                           */
                          constructor() {
                              _transferOwnership(_msgSender());
                          }
                          /**
                           * @dev Returns the address of the current owner.
                           */
                          function owner() public view virtual returns (address) {
                              return _owner;
                          }
                          /**
                           * @dev Throws if called by any account other than the owner.
                           */
                          modifier onlyOwner() {
                              require(owner() == _msgSender(), "Ownable: caller is not the owner");
                              _;
                          }
                          /**
                           * @dev Leaves the contract without owner. It will not be possible to call
                           * `onlyOwner` functions anymore. Can only be called by the current owner.
                           *
                           * NOTE: Renouncing ownership will leave the contract without an owner,
                           * thereby removing any functionality that is only available to the owner.
                           */
                          function renounceOwnership() public virtual onlyOwner {
                              _transferOwnership(address(0));
                          }
                          /**
                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                           * Can only be called by the current owner.
                           */
                          function transferOwnership(address newOwner) public virtual onlyOwner {
                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                              _transferOwnership(newOwner);
                          }
                          /**
                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                           * Internal function without access restriction.
                           */
                          function _transferOwnership(address newOwner) internal virtual {
                              address oldOwner = _owner;
                              _owner = newOwner;
                              emit OwnershipTransferred(oldOwner, newOwner);
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity 0.8.13;
                      /// @notice Gas optimized reentrancy protection for smart contracts.
                      /// @author Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/security/ReentrancyGuard.sol)
                      abstract contract ReentrancyGuard {
                          uint256 private reentrancyStatus = 1;
                          modifier nonReentrant() {
                              require(reentrancyStatus == 1, "REENTRANCY");
                              reentrancyStatus = 2;
                              _;
                              reentrancyStatus = 1;
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity 0.8.13;
                      import "@openzeppelin/contracts/access/Ownable.sol";
                      contract MarketRegistry is Ownable {
                          struct TradeDetails {
                              uint256 marketId;
                              uint256 value;
                              bytes tradeData;
                          }
                          struct Market {
                              address proxy;
                              bool isLib;
                              bool isActive;
                          }
                          Market[] public markets;
                          constructor(address[] memory proxies, bool[] memory isLibs) {
                              for (uint256 i = 0; i < proxies.length; i++) {
                                  markets.push(Market(proxies[i], isLibs[i], true));
                              }
                          }
                          function addMarket(address proxy, bool isLib) external onlyOwner {
                              markets.push(Market(proxy, isLib, true));
                          }
                          function setMarketStatus(uint256 marketId, bool newStatus) external onlyOwner {
                              Market storage market = markets[marketId];
                              market.isActive = newStatus;
                          }
                          function setMarketProxy(uint256 marketId, address newProxy, bool isLib) external onlyOwner {
                              Market storage market = markets[marketId];
                              market.proxy = newProxy;
                              market.isLib = isLib;
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity 0.8.13;
                      import "@openzeppelin/contracts/utils/Context.sol";
                      import "./interfaces/ICryptoPunks.sol";
                      import "./interfaces/IWrappedPunk.sol";
                      import "./interfaces/IMoonCatsRescue.sol";
                      contract SpecialTransferHelper is Context {
                          struct ERC721Details {
                              address tokenAddr;
                              address[] to;
                              uint256[] ids;
                          }
                          function _uintToBytes5(uint256 id)
                              internal
                              pure
                              returns (bytes5 slicedDataBytes5)
                          {
                              bytes memory _bytes = new bytes(32);
                              assembly {
                                  mstore(add(_bytes, 32), id)
                              }
                              bytes memory tempBytes;
                              assembly {
                                  // Get a location of some free memory and store it in tempBytes as
                                  // Solidity does for memory variables.
                                  tempBytes := mload(0x40)
                                  // The first word of the slice result is potentially a partial
                                  // word read from the original array. To read it, we calculate
                                  // the length of that partial word and start copying that many
                                  // bytes into the array. The first word we copy will start with
                                  // data we don't care about, but the last `lengthmod` bytes will
                                  // land at the beginning of the contents of the new array. When
                                  // we're done copying, we overwrite the full first word with
                                  // the actual length of the slice.
                                  let lengthmod := and(5, 31)
                                  // The multiplication in the next line is necessary
                                  // because when slicing multiples of 32 bytes (lengthmod == 0)
                                  // the following copy loop was copying the origin's length
                                  // and then ending prematurely not copying everything it should.
                                  let mc := add(add(tempBytes, lengthmod), mul(0x20, iszero(lengthmod)))
                                  let end := add(mc, 5)
                                  for {
                                      // The multiplication in the next line has the same exact purpose
                                      // as the one above.
                                      let cc := add(add(add(_bytes, lengthmod), mul(0x20, iszero(lengthmod))), 27)
                                  } lt(mc, end) {
                                      mc := add(mc, 0x20)
                                      cc := add(cc, 0x20)
                                  } {
                                      mstore(mc, mload(cc))
                                  }
                                  mstore(tempBytes, 5)
                                  //update free-memory pointer
                                  //allocating the array padded to 32 bytes like the compiler does now
                                  mstore(0x40, and(add(mc, 31), not(31)))
                              }
                              assembly {
                                  slicedDataBytes5 := mload(add(tempBytes, 32))
                              }
                          }
                          function _acceptMoonCat(ERC721Details memory erc721Details) internal {
                              for (uint256 i = 0; i < erc721Details.ids.length; i++) {
                                  bytes5 catId = _uintToBytes5(erc721Details.ids[i]);
                                  address owner = IMoonCatsRescue(erc721Details.tokenAddr).catOwners(catId);
                                  require(owner == _msgSender(), "_acceptMoonCat: invalid mooncat owner");
                                  IMoonCatsRescue(erc721Details.tokenAddr).acceptAdoptionOffer(catId);
                              }
                          }
                          function _transferMoonCat(ERC721Details memory erc721Details) internal {
                              for (uint256 i = 0; i < erc721Details.ids.length; i++) {
                                  IMoonCatsRescue(erc721Details.tokenAddr).giveCat(_uintToBytes5(erc721Details.ids[i]), erc721Details.to[i]);
                              }
                          }
                          function _acceptCryptoPunk(ERC721Details memory erc721Details) internal {
                              for (uint256 i = 0; i < erc721Details.ids.length; i++) {    
                                  address owner = ICryptoPunks(erc721Details.tokenAddr).punkIndexToAddress(erc721Details.ids[i]);
                                  require(owner == _msgSender(), "_acceptCryptoPunk: invalid punk owner");
                                  ICryptoPunks(erc721Details.tokenAddr).buyPunk(erc721Details.ids[i]);
                              }
                          }
                          function _transferCryptoPunk(ERC721Details memory erc721Details) internal {
                              for (uint256 i = 0; i < erc721Details.ids.length; i++) {
                                  ICryptoPunks(erc721Details.tokenAddr).transferPunk(erc721Details.to[i], erc721Details.ids[i]);
                              }
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity 0.8.13;
                      interface IERC20 {
                          /**
                              * @dev Returns the amount of tokens owned by `account`.
                              */
                          function balanceOf(address account) external view returns (uint256);
                          /**
                              * @dev Moves `amount` tokens from the caller's account to `recipient`.
                              *
                              * Returns a boolean value indicating whether the operation succeeded.
                              *
                              * Emits a {Transfer} event.
                              */
                          function transfer(address recipient, uint256 amount) external returns (bool);
                          /**
                           * @dev Moves `amount` tokens from `sender` to `recipient` using the
                           * allowance mechanism. `amount` is then deducted from the caller's
                           * allowance.
                           *
                           * Returns a boolean value indicating whether the operation succeeded.
                           *
                           * Emits a {Transfer} event.
                           */
                          function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
                          /**
                           * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
                           *
                           * Returns a boolean value indicating whether the operation succeeded.
                           *
                           * IMPORTANT: Beware that changing an allowance with this method brings the risk
                           * that someone may use both the old and the new allowance by unfortunate
                           * transaction ordering. One possible solution to mitigate this race
                           * condition is to first reduce the spender's allowance to 0 and set the
                           * desired value afterwards:
                           * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                           *
                           * Emits an {Approval} event.
                           */
                          function approve(address spender, uint256 amount) external returns (bool);
                          /**
                           * @dev Returns the remaining number of tokens that `spender` will be
                           * allowed to spend on behalf of `owner` through {transferFrom}. This is
                           * zero by default.
                           *
                           * This value changes when {approve} or {transferFrom} are called.
                           */
                          function allowance(address owner, address spender) external view returns (uint256);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity 0.8.13;
                      interface IERC721 {
                          /// @notice Transfer ownership of an NFT -- THE CALLER IS RESPONSIBLE
                          ///  TO CONFIRM THAT `_to` IS CAPABLE OF RECEIVING NFTS OR ELSE
                          ///  THEY MAY BE PERMANENTLY LOST
                          /// @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.
                          /// @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 payable;
                          function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory _data) external;
                          
                          function setApprovalForAll(address operator, bool approved) external;
                          function approve(address to, uint256 tokenId) external;
                          
                          function isApprovedForAll(address owner, address operator) external view returns (bool);
                          function balanceOf(address _owner) external view returns (uint256);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity 0.8.13;
                      interface IERC1155 {
                          function safeTransferFrom(
                              address from,
                              address to,
                              uint256 id,
                              uint256 amount,
                              bytes memory data
                          ) external;
                          function safeBatchTransferFrom(
                              address from,
                              address to,
                              uint256[] memory ids,
                              uint256[] memory amounts,
                              bytes memory data
                          ) external;
                          function balanceOf(address _owner, uint256 _id) external view returns (uint256);
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Provides information about the current execution context, including the
                       * sender of the transaction and its data. While these are generally available
                       * via msg.sender and msg.data, they should not be accessed in such a direct
                       * manner, since when dealing with meta-transactions the account sending and
                       * paying for execution may not be the actual sender (as far as an application
                       * is concerned).
                       *
                       * This contract is only required for intermediate, library-like contracts.
                       */
                      abstract contract Context {
                          function _msgSender() internal view virtual returns (address) {
                              return msg.sender;
                          }
                          function _msgData() internal view virtual returns (bytes calldata) {
                              return msg.data;
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity 0.8.13;
                      interface ICryptoPunks {
                          function punkIndexToAddress(uint index) external view returns(address owner);
                          function offerPunkForSaleToAddress(uint punkIndex, uint minSalePriceInWei, address toAddress) external;
                          function buyPunk(uint punkIndex) external payable;
                          function transferPunk(address to, uint punkIndex) external;
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity 0.8.13;
                      interface IWrappedPunk {
                          /**
                           * @dev Mints a wrapped punk
                           */
                          function mint(uint256 punkIndex) external;
                          /**
                           * @dev Burns a specific wrapped punk
                           */
                          function burn(uint256 punkIndex) external;
                          
                          /**
                           * @dev Registers proxy
                           */
                          function registerProxy() external;
                          /**
                           * @dev Gets proxy address
                           */
                          function proxyInfo(address user) external view returns (address);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity 0.8.13;
                      interface IMoonCatsRescue {
                          function acceptAdoptionOffer(bytes5 catId) payable external;
                          function makeAdoptionOfferToAddress(bytes5 catId, uint price, address to) external;
                          function giveCat(bytes5 catId, address to) external;
                          function catOwners(bytes5 catId) external view returns(address);
                          function rescueOrder(uint256 rescueIndex) external view returns(bytes5 catId);
                      }
                      

                      File 2 of 2: VOXVOT_BlindVox
                      //SPDX-License-Identifier: MIT
                      // File: https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/security/ReentrancyGuard.sol
                      
                      
                      // OpenZeppelin Contracts v4.4.1 (security/ReentrancyGuard.sol)
                      
                      pragma solidity ^0.8.0;
                      
                      /**
                       * @dev Contract module that helps prevent reentrant calls to a function.
                       *
                       * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
                       * available, which can be applied to functions to make sure there are no nested
                       * (reentrant) calls to them.
                       *
                       * Note that because there is a single `nonReentrant` guard, functions marked as
                       * `nonReentrant` may not call one another. This can be worked around by making
                       * those functions `private`, and then adding `external` `nonReentrant` entry
                       * points to them.
                       *
                       * TIP: If you would like to learn more about reentrancy and alternative ways
                       * to protect against it, check out our blog post
                       * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
                       */
                      abstract contract ReentrancyGuard {
                          // Booleans are more expensive than uint256 or any type that takes up a full
                          // word because each write operation emits an extra SLOAD to first read the
                          // slot's contents, replace the bits taken up by the boolean, and then write
                          // back. This is the compiler's defense against contract upgrades and
                          // pointer aliasing, and it cannot be disabled.
                      
                          // The values being non-zero value makes deployment a bit more expensive,
                          // but in exchange the refund on every call to nonReentrant will be lower in
                          // amount. Since refunds are capped to a percentage of the total
                          // transaction's gas, it is best to keep them low in cases like this one, to
                          // increase the likelihood of the full refund coming into effect.
                          uint256 private constant _NOT_ENTERED = 1;
                          uint256 private constant _ENTERED = 2;
                      
                          uint256 private _status;
                      
                          constructor() {
                              _status = _NOT_ENTERED;
                          }
                      
                          /**
                           * @dev Prevents a contract from calling itself, directly or indirectly.
                           * Calling a `nonReentrant` function from another `nonReentrant`
                           * function is not supported. It is possible to prevent this from happening
                           * by making the `nonReentrant` function external, and making it call a
                           * `private` function that does the actual work.
                           */
                          modifier nonReentrant() {
                              _nonReentrantBefore();
                              _;
                              _nonReentrantAfter();
                          }
                      
                          function _nonReentrantBefore() private {
                              // On the first call to nonReentrant, _status will be _NOT_ENTERED
                              require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
                      
                              // Any calls to nonReentrant after this point will fail
                              _status = _ENTERED;
                          }
                      
                          function _nonReentrantAfter() private {
                              // By storing the original value once again, a refund is triggered (see
                              // https://eips.ethereum.org/EIPS/eip-2200)
                              _status = _NOT_ENTERED;
                          }
                      
                          /**
                           * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
                           * `nonReentrant` function in the call stack.
                           */
                          function _reentrancyGuardEntered() internal view returns (bool) {
                              return _status == _ENTERED;
                          }
                      }
                      
                      // File: https://github.com/chiru-labs/ERC721A/blob/main/contracts/IERC721A.sol
                      
                      
                      // ERC721A Contracts v4.2.3
                      // Creator: Chiru Labs
                      
                      pragma solidity ^0.8.4;
                      
                      /**
                       * @dev Interface of ERC721A.
                       */
                      interface IERC721A {
                          /**
                           * The caller must own the token or be an approved operator.
                           */
                          error ApprovalCallerNotOwnerNorApproved();
                      
                          /**
                           * The token does not exist.
                           */
                          error ApprovalQueryForNonexistentToken();
                      
                          /**
                           * Cannot query the balance for the zero address.
                           */
                          error BalanceQueryForZeroAddress();
                      
                          /**
                           * Cannot mint to the zero address.
                           */
                          error MintToZeroAddress();
                      
                          /**
                           * The quantity of tokens minted must be more than zero.
                           */
                          error MintZeroQuantity();
                      
                          /**
                           * The token does not exist.
                           */
                          error OwnerQueryForNonexistentToken();
                      
                          /**
                           * The caller must own the token or be an approved operator.
                           */
                          error TransferCallerNotOwnerNorApproved();
                      
                          /**
                           * The token must be owned by `from`.
                           */
                          error TransferFromIncorrectOwner();
                      
                          /**
                           * Cannot safely transfer to a contract that does not implement the
                           * ERC721Receiver interface.
                           */
                          error TransferToNonERC721ReceiverImplementer();
                      
                          /**
                           * Cannot transfer to the zero address.
                           */
                          error TransferToZeroAddress();
                      
                          /**
                           * The token does not exist.
                           */
                          error URIQueryForNonexistentToken();
                      
                          /**
                           * The `quantity` minted with ERC2309 exceeds the safety limit.
                           */
                          error MintERC2309QuantityExceedsLimit();
                      
                          /**
                           * The `extraData` cannot be set on an unintialized ownership slot.
                           */
                          error OwnershipNotInitializedForExtraData();
                      
                          // =============================================================
                          //                            STRUCTS
                          // =============================================================
                      
                          struct TokenOwnership {
                              // The address of the owner.
                              address addr;
                              // Stores the start time of ownership with minimal overhead for tokenomics.
                              uint64 startTimestamp;
                              // Whether the token has been burned.
                              bool burned;
                              // Arbitrary data similar to `startTimestamp` that can be set via {_extraData}.
                              uint24 extraData;
                          }
                      
                          // =============================================================
                          //                         TOKEN COUNTERS
                          // =============================================================
                      
                          /**
                           * @dev Returns the total number of tokens in existence.
                           * Burned tokens will reduce the count.
                           * To get the total number of tokens minted, please see {_totalMinted}.
                           */
                          function totalSupply() external view returns (uint256);
                      
                          // =============================================================
                          //                            IERC165
                          // =============================================================
                      
                          /**
                           * @dev Returns true if this contract implements the interface defined by
                           * `interfaceId`. See the corresponding
                           * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
                           * to learn more about how these ids are created.
                           *
                           * This function call must use less than 30000 gas.
                           */
                          function supportsInterface(bytes4 interfaceId) external view returns (bool);
                      
                          // =============================================================
                          //                            IERC721
                          // =============================================================
                      
                          /**
                           * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
                           */
                          event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
                      
                          /**
                           * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
                           */
                          event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
                      
                          /**
                           * @dev Emitted when `owner` enables or disables
                           * (`approved`) `operator` to manage all of its assets.
                           */
                          event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
                      
                          /**
                           * @dev Returns the number of tokens in `owner`'s account.
                           */
                          function balanceOf(address owner) external view returns (uint256 balance);
                      
                          /**
                           * @dev Returns the owner of the `tokenId` token.
                           *
                           * Requirements:
                           *
                           * - `tokenId` must exist.
                           */
                          function ownerOf(uint256 tokenId) external view returns (address owner);
                      
                          /**
                           * @dev Safely transfers `tokenId` token from `from` to `to`,
                           * checking first that contract recipients are aware of the ERC721 protocol
                           * to prevent tokens from being forever locked.
                           *
                           * Requirements:
                           *
                           * - `from` cannot be the zero address.
                           * - `to` cannot be the zero address.
                           * - `tokenId` token must exist and be owned by `from`.
                           * - If the caller is not `from`, it must be have been allowed to move
                           * this token by either {approve} or {setApprovalForAll}.
                           * - If `to` refers to a smart contract, it must implement
                           * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                           *
                           * Emits a {Transfer} event.
                           */
                          function safeTransferFrom(
                              address from,
                              address to,
                              uint256 tokenId,
                              bytes calldata data
                          ) external payable;
                      
                          /**
                           * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
                           */
                          function safeTransferFrom(
                              address from,
                              address to,
                              uint256 tokenId
                          ) external payable;
                      
                          /**
                           * @dev Transfers `tokenId` from `from` to `to`.
                           *
                           * WARNING: Usage of this method is discouraged, use {safeTransferFrom}
                           * whenever possible.
                           *
                           * Requirements:
                           *
                           * - `from` cannot be the zero address.
                           * - `to` cannot be the zero address.
                           * - `tokenId` token must be owned by `from`.
                           * - If the caller is not `from`, it must be approved to move this token
                           * by either {approve} or {setApprovalForAll}.
                           *
                           * Emits a {Transfer} event.
                           */
                          function transferFrom(
                              address from,
                              address to,
                              uint256 tokenId
                          ) external payable;
                      
                          /**
                           * @dev Gives permission to `to` to transfer `tokenId` token to another account.
                           * The approval is cleared when the token is transferred.
                           *
                           * Only a single account can be approved at a time, so approving the
                           * zero address clears previous approvals.
                           *
                           * Requirements:
                           *
                           * - The caller must own the token or be an approved operator.
                           * - `tokenId` must exist.
                           *
                           * Emits an {Approval} event.
                           */
                          function approve(address to, uint256 tokenId) external payable;
                      
                          /**
                           * @dev Approve or remove `operator` as an operator for the caller.
                           * Operators can call {transferFrom} or {safeTransferFrom}
                           * for any token owned by the caller.
                           *
                           * Requirements:
                           *
                           * - The `operator` cannot be the caller.
                           *
                           * Emits an {ApprovalForAll} event.
                           */
                          function setApprovalForAll(address operator, bool _approved) external;
                      
                          /**
                           * @dev Returns the account approved for `tokenId` token.
                           *
                           * Requirements:
                           *
                           * - `tokenId` must exist.
                           */
                          function getApproved(uint256 tokenId) external view returns (address operator);
                      
                          /**
                           * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
                           *
                           * See {setApprovalForAll}.
                           */
                          function isApprovedForAll(address owner, address operator) external view returns (bool);
                      
                          // =============================================================
                          //                        IERC721Metadata
                          // =============================================================
                      
                          /**
                           * @dev Returns the token collection name.
                           */
                          function name() external view returns (string memory);
                      
                          /**
                           * @dev Returns the token collection symbol.
                           */
                          function symbol() external view returns (string memory);
                      
                          /**
                           * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
                           */
                          function tokenURI(uint256 tokenId) external view returns (string memory);
                      
                          // =============================================================
                          //                           IERC2309
                          // =============================================================
                      
                          /**
                           * @dev Emitted when tokens in `fromTokenId` to `toTokenId`
                           * (inclusive) is transferred from `from` to `to`, as defined in the
                           * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard.
                           *
                           * See {_mintERC2309} for more details.
                           */
                          event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to);
                      }
                      
                      // File: https://github.com/chiru-labs/ERC721A/blob/main/contracts/ERC721A.sol
                      
                      
                      // ERC721A Contracts v4.2.3
                      // Creator: Chiru Labs
                      
                      pragma solidity ^0.8.4;
                      
                      
                      /**
                       * @dev Interface of ERC721 token receiver.
                       */
                      interface ERC721A__IERC721Receiver {
                          function onERC721Received(
                              address operator,
                              address from,
                              uint256 tokenId,
                              bytes calldata data
                          ) external returns (bytes4);
                      }
                      
                      /**
                       * @title ERC721A
                       *
                       * @dev Implementation of the [ERC721](https://eips.ethereum.org/EIPS/eip-721)
                       * Non-Fungible Token Standard, including the Metadata extension.
                       * Optimized for lower gas during batch mints.
                       *
                       * Token IDs are minted in sequential order (e.g. 0, 1, 2, 3, ...)
                       * starting from `_startTokenId()`.
                       *
                       * Assumptions:
                       *
                       * - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply.
                       * - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256).
                       */
                      contract ERC721A is IERC721A {
                          // Bypass for a `--via-ir` bug (https://github.com/chiru-labs/ERC721A/pull/364).
                          struct TokenApprovalRef {
                              address value;
                          }
                      
                          // =============================================================
                          //                           CONSTANTS
                          // =============================================================
                      
                          // Mask of an entry in packed address data.
                          uint256 private constant _BITMASK_ADDRESS_DATA_ENTRY = (1 << 64) - 1;
                      
                          // The bit position of `numberMinted` in packed address data.
                          uint256 private constant _BITPOS_NUMBER_MINTED = 64;
                      
                          // The bit position of `numberBurned` in packed address data.
                          uint256 private constant _BITPOS_NUMBER_BURNED = 128;
                      
                          // The bit position of `aux` in packed address data.
                          uint256 private constant _BITPOS_AUX = 192;
                      
                          // Mask of all 256 bits in packed address data except the 64 bits for `aux`.
                          uint256 private constant _BITMASK_AUX_COMPLEMENT = (1 << 192) - 1;
                      
                          // The bit position of `startTimestamp` in packed ownership.
                          uint256 private constant _BITPOS_START_TIMESTAMP = 160;
                      
                          // The bit mask of the `burned` bit in packed ownership.
                          uint256 private constant _BITMASK_BURNED = 1 << 224;
                      
                          // The bit position of the `nextInitialized` bit in packed ownership.
                          uint256 private constant _BITPOS_NEXT_INITIALIZED = 225;
                      
                          // The bit mask of the `nextInitialized` bit in packed ownership.
                          uint256 private constant _BITMASK_NEXT_INITIALIZED = 1 << 225;
                      
                          // The bit position of `extraData` in packed ownership.
                          uint256 private constant _BITPOS_EXTRA_DATA = 232;
                      
                          // Mask of all 256 bits in a packed ownership except the 24 bits for `extraData`.
                          uint256 private constant _BITMASK_EXTRA_DATA_COMPLEMENT = (1 << 232) - 1;
                      
                          // The mask of the lower 160 bits for addresses.
                          uint256 private constant _BITMASK_ADDRESS = (1 << 160) - 1;
                      
                          // The maximum `quantity` that can be minted with {_mintERC2309}.
                          // This limit is to prevent overflows on the address data entries.
                          // For a limit of 5000, a total of 3.689e15 calls to {_mintERC2309}
                          // is required to cause an overflow, which is unrealistic.
                          uint256 private constant _MAX_MINT_ERC2309_QUANTITY_LIMIT = 5000;
                      
                          // The `Transfer` event signature is given by:
                          // `keccak256(bytes("Transfer(address,address,uint256)"))`.
                          bytes32 private constant _TRANSFER_EVENT_SIGNATURE =
                              0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef;
                      
                          // =============================================================
                          //                            STORAGE
                          // =============================================================
                      
                          // The next token ID to be minted.
                          uint256 private _currentIndex;
                      
                          // The number of tokens burned.
                          uint256 private _burnCounter;
                      
                          // Token name
                          string private _name;
                      
                          // Token symbol
                          string private _symbol;
                      
                          // Mapping from token ID to ownership details
                          // An empty struct value does not necessarily mean the token is unowned.
                          // See {_packedOwnershipOf} implementation for details.
                          //
                          // Bits Layout:
                          // - [0..159]   `addr`
                          // - [160..223] `startTimestamp`
                          // - [224]      `burned`
                          // - [225]      `nextInitialized`
                          // - [232..255] `extraData`
                          mapping(uint256 => uint256) private _packedOwnerships;
                      
                          // Mapping owner address to address data.
                          //
                          // Bits Layout:
                          // - [0..63]    `balance`
                          // - [64..127]  `numberMinted`
                          // - [128..191] `numberBurned`
                          // - [192..255] `aux`
                          mapping(address => uint256) private _packedAddressData;
                      
                          // Mapping from token ID to approved address.
                          mapping(uint256 => TokenApprovalRef) private _tokenApprovals;
                      
                          // Mapping from owner to operator approvals
                          mapping(address => mapping(address => bool)) private _operatorApprovals;
                      
                          // =============================================================
                          //                          CONSTRUCTOR
                          // =============================================================
                      
                          constructor(string memory name_, string memory symbol_) {
                              _name = name_;
                              _symbol = symbol_;
                              _currentIndex = _startTokenId();
                          }
                      
                          // =============================================================
                          //                   TOKEN COUNTING OPERATIONS
                          // =============================================================
                      
                          /**
                           * @dev Returns the starting token ID.
                           * To change the starting token ID, please override this function.
                           */
                          function _startTokenId() internal view virtual returns (uint256) {
                              return 0;
                          }
                      
                          /**
                           * @dev Returns the next token ID to be minted.
                           */
                          function _nextTokenId() internal view virtual returns (uint256) {
                              return _currentIndex;
                          }
                      
                          /**
                           * @dev Returns the total number of tokens in existence.
                           * Burned tokens will reduce the count.
                           * To get the total number of tokens minted, please see {_totalMinted}.
                           */
                          function totalSupply() public view virtual override returns (uint256) {
                              // Counter underflow is impossible as _burnCounter cannot be incremented
                              // more than `_currentIndex - _startTokenId()` times.
                              unchecked {
                                  return _currentIndex - _burnCounter - _startTokenId();
                              }
                          }
                      
                          /**
                           * @dev Returns the total amount of tokens minted in the contract.
                           */
                          function _totalMinted() internal view virtual returns (uint256) {
                              // Counter underflow is impossible as `_currentIndex` does not decrement,
                              // and it is initialized to `_startTokenId()`.
                              unchecked {
                                  return _currentIndex - _startTokenId();
                              }
                          }
                      
                          /**
                           * @dev Returns the total number of tokens burned.
                           */
                          function _totalBurned() internal view virtual returns (uint256) {
                              return _burnCounter;
                          }
                      
                          // =============================================================
                          //                    ADDRESS DATA OPERATIONS
                          // =============================================================
                      
                          /**
                           * @dev Returns the number of tokens in `owner`'s account.
                           */
                          function balanceOf(address owner) public view virtual override returns (uint256) {
                              if (owner == address(0)) revert BalanceQueryForZeroAddress();
                              return _packedAddressData[owner] & _BITMASK_ADDRESS_DATA_ENTRY;
                          }
                      
                          /**
                           * Returns the number of tokens minted by `owner`.
                           */
                          function _numberMinted(address owner) internal view returns (uint256) {
                              return (_packedAddressData[owner] >> _BITPOS_NUMBER_MINTED) & _BITMASK_ADDRESS_DATA_ENTRY;
                          }
                      
                          /**
                           * Returns the number of tokens burned by or on behalf of `owner`.
                           */
                          function _numberBurned(address owner) internal view returns (uint256) {
                              return (_packedAddressData[owner] >> _BITPOS_NUMBER_BURNED) & _BITMASK_ADDRESS_DATA_ENTRY;
                          }
                      
                          /**
                           * Returns the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
                           */
                          function _getAux(address owner) internal view returns (uint64) {
                              return uint64(_packedAddressData[owner] >> _BITPOS_AUX);
                          }
                      
                          /**
                           * Sets the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
                           * If there are multiple variables, please pack them into a uint64.
                           */
                          function _setAux(address owner, uint64 aux) internal virtual {
                              uint256 packed = _packedAddressData[owner];
                              uint256 auxCasted;
                              // Cast `aux` with assembly to avoid redundant masking.
                              assembly {
                                  auxCasted := aux
                              }
                              packed = (packed & _BITMASK_AUX_COMPLEMENT) | (auxCasted << _BITPOS_AUX);
                              _packedAddressData[owner] = packed;
                          }
                      
                          // =============================================================
                          //                            IERC165
                          // =============================================================
                      
                          /**
                           * @dev Returns true if this contract implements the interface defined by
                           * `interfaceId`. See the corresponding
                           * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
                           * to learn more about how these ids are created.
                           *
                           * This function call must use less than 30000 gas.
                           */
                          function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                              // The interface IDs are constants representing the first 4 bytes
                              // of the XOR of all function selectors in the interface.
                              // See: [ERC165](https://eips.ethereum.org/EIPS/eip-165)
                              // (e.g. `bytes4(i.functionA.selector ^ i.functionB.selector ^ ...)`)
                              return
                                  interfaceId == 0x01ffc9a7 || // ERC165 interface ID for ERC165.
                                  interfaceId == 0x80ac58cd || // ERC165 interface ID for ERC721.
                                  interfaceId == 0x5b5e139f; // ERC165 interface ID for ERC721Metadata.
                          }
                      
                          // =============================================================
                          //                        IERC721Metadata
                          // =============================================================
                      
                          /**
                           * @dev Returns the token collection name.
                           */
                          function name() public view virtual override returns (string memory) {
                              return _name;
                          }
                      
                          /**
                           * @dev Returns the token collection symbol.
                           */
                          function symbol() public view virtual override returns (string memory) {
                              return _symbol;
                          }
                      
                          /**
                           * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
                           */
                          function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
                              if (!_exists(tokenId)) revert URIQueryForNonexistentToken();
                      
                              string memory baseURI = _baseURI();
                              return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : '';
                          }
                      
                          /**
                           * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
                           * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
                           * by default, it can be overridden in child contracts.
                           */
                          function _baseURI() internal view virtual returns (string memory) {
                              return '';
                          }
                      
                          // =============================================================
                          //                     OWNERSHIPS OPERATIONS
                          // =============================================================
                      
                          /**
                           * @dev Returns the owner of the `tokenId` token.
                           *
                           * Requirements:
                           *
                           * - `tokenId` must exist.
                           */
                          function ownerOf(uint256 tokenId) public view virtual override returns (address) {
                              return address(uint160(_packedOwnershipOf(tokenId)));
                          }
                      
                          /**
                           * @dev Gas spent here starts off proportional to the maximum mint batch size.
                           * It gradually moves to O(1) as tokens get transferred around over time.
                           */
                          function _ownershipOf(uint256 tokenId) internal view virtual returns (TokenOwnership memory) {
                              return _unpackedOwnership(_packedOwnershipOf(tokenId));
                          }
                      
                          /**
                           * @dev Returns the unpacked `TokenOwnership` struct at `index`.
                           */
                          function _ownershipAt(uint256 index) internal view virtual returns (TokenOwnership memory) {
                              return _unpackedOwnership(_packedOwnerships[index]);
                          }
                      
                          /**
                           * @dev Initializes the ownership slot minted at `index` for efficiency purposes.
                           */
                          function _initializeOwnershipAt(uint256 index) internal virtual {
                              if (_packedOwnerships[index] == 0) {
                                  _packedOwnerships[index] = _packedOwnershipOf(index);
                              }
                          }
                      
                          /**
                           * Returns the packed ownership data of `tokenId`.
                           */
                          function _packedOwnershipOf(uint256 tokenId) private view returns (uint256) {
                              uint256 curr = tokenId;
                      
                              unchecked {
                                  if (_startTokenId() <= curr)
                                      if (curr < _currentIndex) {
                                          uint256 packed = _packedOwnerships[curr];
                                          // If not burned.
                                          if (packed & _BITMASK_BURNED == 0) {
                                              // Invariant:
                                              // There will always be an initialized ownership slot
                                              // (i.e. `ownership.addr != address(0) && ownership.burned == false`)
                                              // before an unintialized ownership slot
                                              // (i.e. `ownership.addr == address(0) && ownership.burned == false`)
                                              // Hence, `curr` will not underflow.
                                              //
                                              // We can directly compare the packed value.
                                              // If the address is zero, packed will be zero.
                                              while (packed == 0) {
                                                  packed = _packedOwnerships[--curr];
                                              }
                                              return packed;
                                          }
                                      }
                              }
                              revert OwnerQueryForNonexistentToken();
                          }
                      
                          /**
                           * @dev Returns the unpacked `TokenOwnership` struct from `packed`.
                           */
                          function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) {
                              ownership.addr = address(uint160(packed));
                              ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP);
                              ownership.burned = packed & _BITMASK_BURNED != 0;
                              ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA);
                          }
                      
                          /**
                           * @dev Packs ownership data into a single uint256.
                           */
                          function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) {
                              assembly {
                                  // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
                                  owner := and(owner, _BITMASK_ADDRESS)
                                  // `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`.
                                  result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags))
                              }
                          }
                      
                          /**
                           * @dev Returns the `nextInitialized` flag set if `quantity` equals 1.
                           */
                          function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) {
                              // For branchless setting of the `nextInitialized` flag.
                              assembly {
                                  // `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`.
                                  result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1))
                              }
                          }
                      
                          // =============================================================
                          //                      APPROVAL OPERATIONS
                          // =============================================================
                      
                          /**
                           * @dev Gives permission to `to` to transfer `tokenId` token to another account.
                           * The approval is cleared when the token is transferred.
                           *
                           * Only a single account can be approved at a time, so approving the
                           * zero address clears previous approvals.
                           *
                           * Requirements:
                           *
                           * - The caller must own the token or be an approved operator.
                           * - `tokenId` must exist.
                           *
                           * Emits an {Approval} event.
                           */
                          function approve(address to, uint256 tokenId) public payable virtual override {
                              address owner = ownerOf(tokenId);
                      
                              if (_msgSenderERC721A() != owner)
                                  if (!isApprovedForAll(owner, _msgSenderERC721A())) {
                                      revert ApprovalCallerNotOwnerNorApproved();
                                  }
                      
                              _tokenApprovals[tokenId].value = to;
                              emit Approval(owner, to, tokenId);
                          }
                      
                          /**
                           * @dev Returns the account approved for `tokenId` token.
                           *
                           * Requirements:
                           *
                           * - `tokenId` must exist.
                           */
                          function getApproved(uint256 tokenId) public view virtual override returns (address) {
                              if (!_exists(tokenId)) revert ApprovalQueryForNonexistentToken();
                      
                              return _tokenApprovals[tokenId].value;
                          }
                      
                          /**
                           * @dev Approve or remove `operator` as an operator for the caller.
                           * Operators can call {transferFrom} or {safeTransferFrom}
                           * for any token owned by the caller.
                           *
                           * Requirements:
                           *
                           * - The `operator` cannot be the caller.
                           *
                           * Emits an {ApprovalForAll} event.
                           */
                          function setApprovalForAll(address operator, bool approved) public virtual override {
                              _operatorApprovals[_msgSenderERC721A()][operator] = approved;
                              emit ApprovalForAll(_msgSenderERC721A(), operator, approved);
                          }
                      
                          /**
                           * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
                           *
                           * See {setApprovalForAll}.
                           */
                          function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
                              return _operatorApprovals[owner][operator];
                          }
                      
                          /**
                           * @dev Returns whether `tokenId` exists.
                           *
                           * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
                           *
                           * Tokens start existing when they are minted. See {_mint}.
                           */
                          function _exists(uint256 tokenId) internal view virtual returns (bool) {
                              return
                                  _startTokenId() <= tokenId &&
                                  tokenId < _currentIndex && // If within bounds,
                                  _packedOwnerships[tokenId] & _BITMASK_BURNED == 0; // and not burned.
                          }
                      
                          /**
                           * @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`.
                           */
                          function _isSenderApprovedOrOwner(
                              address approvedAddress,
                              address owner,
                              address msgSender
                          ) private pure returns (bool result) {
                              assembly {
                                  // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
                                  owner := and(owner, _BITMASK_ADDRESS)
                                  // Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean.
                                  msgSender := and(msgSender, _BITMASK_ADDRESS)
                                  // `msgSender == owner || msgSender == approvedAddress`.
                                  result := or(eq(msgSender, owner), eq(msgSender, approvedAddress))
                              }
                          }
                      
                          /**
                           * @dev Returns the storage slot and value for the approved address of `tokenId`.
                           */
                          function _getApprovedSlotAndAddress(uint256 tokenId)
                              private
                              view
                              returns (uint256 approvedAddressSlot, address approvedAddress)
                          {
                              TokenApprovalRef storage tokenApproval = _tokenApprovals[tokenId];
                              // The following is equivalent to `approvedAddress = _tokenApprovals[tokenId].value`.
                              assembly {
                                  approvedAddressSlot := tokenApproval.slot
                                  approvedAddress := sload(approvedAddressSlot)
                              }
                          }
                      
                          // =============================================================
                          //                      TRANSFER OPERATIONS
                          // =============================================================
                      
                          /**
                           * @dev Transfers `tokenId` from `from` to `to`.
                           *
                           * Requirements:
                           *
                           * - `from` cannot be the zero address.
                           * - `to` cannot be the zero address.
                           * - `tokenId` token must be owned by `from`.
                           * - If the caller is not `from`, it must be approved to move this token
                           * by either {approve} or {setApprovalForAll}.
                           *
                           * Emits a {Transfer} event.
                           */
                          function transferFrom(
                              address from,
                              address to,
                              uint256 tokenId
                          ) public payable virtual override {
                              uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);
                      
                              if (address(uint160(prevOwnershipPacked)) != from) revert TransferFromIncorrectOwner();
                      
                              (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);
                      
                              // The nested ifs save around 20+ gas over a compound boolean condition.
                              if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
                                  if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved();
                      
                              if (to == address(0)) revert TransferToZeroAddress();
                      
                              _beforeTokenTransfers(from, to, tokenId, 1);
                      
                              // Clear approvals from the previous owner.
                              assembly {
                                  if approvedAddress {
                                      // This is equivalent to `delete _tokenApprovals[tokenId]`.
                                      sstore(approvedAddressSlot, 0)
                                  }
                              }
                      
                              // Underflow of the sender's balance is impossible because we check for
                              // ownership above and the recipient's balance can't realistically overflow.
                              // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
                              unchecked {
                                  // We can directly increment and decrement the balances.
                                  --_packedAddressData[from]; // Updates: `balance -= 1`.
                                  ++_packedAddressData[to]; // Updates: `balance += 1`.
                      
                                  // Updates:
                                  // - `address` to the next owner.
                                  // - `startTimestamp` to the timestamp of transfering.
                                  // - `burned` to `false`.
                                  // - `nextInitialized` to `true`.
                                  _packedOwnerships[tokenId] = _packOwnershipData(
                                      to,
                                      _BITMASK_NEXT_INITIALIZED | _nextExtraData(from, to, prevOwnershipPacked)
                                  );
                      
                                  // If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
                                  if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
                                      uint256 nextTokenId = tokenId + 1;
                                      // If the next slot's address is zero and not burned (i.e. packed value is zero).
                                      if (_packedOwnerships[nextTokenId] == 0) {
                                          // If the next slot is within bounds.
                                          if (nextTokenId != _currentIndex) {
                                              // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
                                              _packedOwnerships[nextTokenId] = prevOwnershipPacked;
                                          }
                                      }
                                  }
                              }
                      
                              emit Transfer(from, to, tokenId);
                              _afterTokenTransfers(from, to, tokenId, 1);
                          }
                      
                          /**
                           * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
                           */
                          function safeTransferFrom(
                              address from,
                              address to,
                              uint256 tokenId
                          ) public payable virtual override {
                              safeTransferFrom(from, to, tokenId, '');
                          }
                      
                          /**
                           * @dev Safely transfers `tokenId` token from `from` to `to`.
                           *
                           * Requirements:
                           *
                           * - `from` cannot be the zero address.
                           * - `to` cannot be the zero address.
                           * - `tokenId` token must exist and be owned by `from`.
                           * - If the caller is not `from`, it must be approved to move this token
                           * by either {approve} or {setApprovalForAll}.
                           * - If `to` refers to a smart contract, it must implement
                           * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                           *
                           * Emits a {Transfer} event.
                           */
                          function safeTransferFrom(
                              address from,
                              address to,
                              uint256 tokenId,
                              bytes memory _data
                          ) public payable virtual override {
                              transferFrom(from, to, tokenId);
                              if (to.code.length != 0)
                                  if (!_checkContractOnERC721Received(from, to, tokenId, _data)) {
                                      revert TransferToNonERC721ReceiverImplementer();
                                  }
                          }
                      
                          /**
                           * @dev Hook that is called before a set of serially-ordered token IDs
                           * are about to be transferred. This includes minting.
                           * And also called before burning one token.
                           *
                           * `startTokenId` - the first token ID to be transferred.
                           * `quantity` - the amount to be transferred.
                           *
                           * Calling conditions:
                           *
                           * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
                           * transferred to `to`.
                           * - When `from` is zero, `tokenId` will be minted for `to`.
                           * - When `to` is zero, `tokenId` will be burned by `from`.
                           * - `from` and `to` are never both zero.
                           */
                          function _beforeTokenTransfers(
                              address from,
                              address to,
                              uint256 startTokenId,
                              uint256 quantity
                          ) internal virtual {}
                      
                          /**
                           * @dev Hook that is called after a set of serially-ordered token IDs
                           * have been transferred. This includes minting.
                           * And also called after one token has been burned.
                           *
                           * `startTokenId` - the first token ID to be transferred.
                           * `quantity` - the amount to be transferred.
                           *
                           * Calling conditions:
                           *
                           * - When `from` and `to` are both non-zero, `from`'s `tokenId` has been
                           * transferred to `to`.
                           * - When `from` is zero, `tokenId` has been minted for `to`.
                           * - When `to` is zero, `tokenId` has been burned by `from`.
                           * - `from` and `to` are never both zero.
                           */
                          function _afterTokenTransfers(
                              address from,
                              address to,
                              uint256 startTokenId,
                              uint256 quantity
                          ) internal virtual {}
                      
                          /**
                           * @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract.
                           *
                           * `from` - Previous owner of the given token ID.
                           * `to` - Target address that will receive the token.
                           * `tokenId` - Token ID to be transferred.
                           * `_data` - Optional data to send along with the call.
                           *
                           * Returns whether the call correctly returned the expected magic value.
                           */
                          function _checkContractOnERC721Received(
                              address from,
                              address to,
                              uint256 tokenId,
                              bytes memory _data
                          ) private returns (bool) {
                              try ERC721A__IERC721Receiver(to).onERC721Received(_msgSenderERC721A(), from, tokenId, _data) returns (
                                  bytes4 retval
                              ) {
                                  return retval == ERC721A__IERC721Receiver(to).onERC721Received.selector;
                              } catch (bytes memory reason) {
                                  if (reason.length == 0) {
                                      revert TransferToNonERC721ReceiverImplementer();
                                  } else {
                                      assembly {
                                          revert(add(32, reason), mload(reason))
                                      }
                                  }
                              }
                          }
                      
                          // =============================================================
                          //                        MINT OPERATIONS
                          // =============================================================
                      
                          /**
                           * @dev Mints `quantity` tokens and transfers them to `to`.
                           *
                           * Requirements:
                           *
                           * - `to` cannot be the zero address.
                           * - `quantity` must be greater than 0.
                           *
                           * Emits a {Transfer} event for each mint.
                           */
                          function _mint(address to, uint256 quantity) internal virtual {
                              uint256 startTokenId = _currentIndex;
                              if (quantity == 0) revert MintZeroQuantity();
                      
                              _beforeTokenTransfers(address(0), to, startTokenId, quantity);
                      
                              // Overflows are incredibly unrealistic.
                              // `balance` and `numberMinted` have a maximum limit of 2**64.
                              // `tokenId` has a maximum limit of 2**256.
                              unchecked {
                                  // Updates:
                                  // - `balance += quantity`.
                                  // - `numberMinted += quantity`.
                                  //
                                  // We can directly add to the `balance` and `numberMinted`.
                                  _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);
                      
                                  // Updates:
                                  // - `address` to the owner.
                                  // - `startTimestamp` to the timestamp of minting.
                                  // - `burned` to `false`.
                                  // - `nextInitialized` to `quantity == 1`.
                                  _packedOwnerships[startTokenId] = _packOwnershipData(
                                      to,
                                      _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
                                  );
                      
                                  uint256 toMasked;
                                  uint256 end = startTokenId + quantity;
                      
                                  // Use assembly to loop and emit the `Transfer` event for gas savings.
                                  // The duplicated `log4` removes an extra check and reduces stack juggling.
                                  // The assembly, together with the surrounding Solidity code, have been
                                  // delicately arranged to nudge the compiler into producing optimized opcodes.
                                  assembly {
                                      // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
                                      toMasked := and(to, _BITMASK_ADDRESS)
                                      // Emit the `Transfer` event.
                                      log4(
                                          0, // Start of data (0, since no data).
                                          0, // End of data (0, since no data).
                                          _TRANSFER_EVENT_SIGNATURE, // Signature.
                                          0, // `address(0)`.
                                          toMasked, // `to`.
                                          startTokenId // `tokenId`.
                                      )
                      
                                      // The `iszero(eq(,))` check ensures that large values of `quantity`
                                      // that overflows uint256 will make the loop run out of gas.
                                      // The compiler will optimize the `iszero` away for performance.
                                      for {
                                          let tokenId := add(startTokenId, 1)
                                      } iszero(eq(tokenId, end)) {
                                          tokenId := add(tokenId, 1)
                                      } {
                                          // Emit the `Transfer` event. Similar to above.
                                          log4(0, 0, _TRANSFER_EVENT_SIGNATURE, 0, toMasked, tokenId)
                                      }
                                  }
                                  if (toMasked == 0) revert MintToZeroAddress();
                      
                                  _currentIndex = end;
                              }
                              _afterTokenTransfers(address(0), to, startTokenId, quantity);
                          }
                      
                          /**
                           * @dev Mints `quantity` tokens and transfers them to `to`.
                           *
                           * This function is intended for efficient minting only during contract creation.
                           *
                           * It emits only one {ConsecutiveTransfer} as defined in
                           * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309),
                           * instead of a sequence of {Transfer} event(s).
                           *
                           * Calling this function outside of contract creation WILL make your contract
                           * non-compliant with the ERC721 standard.
                           * For full ERC721 compliance, substituting ERC721 {Transfer} event(s) with the ERC2309
                           * {ConsecutiveTransfer} event is only permissible during contract creation.
                           *
                           * Requirements:
                           *
                           * - `to` cannot be the zero address.
                           * - `quantity` must be greater than 0.
                           *
                           * Emits a {ConsecutiveTransfer} event.
                           */
                          function _mintERC2309(address to, uint256 quantity) internal virtual {
                              uint256 startTokenId = _currentIndex;
                              if (to == address(0)) revert MintToZeroAddress();
                              if (quantity == 0) revert MintZeroQuantity();
                              if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) revert MintERC2309QuantityExceedsLimit();
                      
                              _beforeTokenTransfers(address(0), to, startTokenId, quantity);
                      
                              // Overflows are unrealistic due to the above check for `quantity` to be below the limit.
                              unchecked {
                                  // Updates:
                                  // - `balance += quantity`.
                                  // - `numberMinted += quantity`.
                                  //
                                  // We can directly add to the `balance` and `numberMinted`.
                                  _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);
                      
                                  // Updates:
                                  // - `address` to the owner.
                                  // - `startTimestamp` to the timestamp of minting.
                                  // - `burned` to `false`.
                                  // - `nextInitialized` to `quantity == 1`.
                                  _packedOwnerships[startTokenId] = _packOwnershipData(
                                      to,
                                      _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
                                  );
                      
                                  emit ConsecutiveTransfer(startTokenId, startTokenId + quantity - 1, address(0), to);
                      
                                  _currentIndex = startTokenId + quantity;
                              }
                              _afterTokenTransfers(address(0), to, startTokenId, quantity);
                          }
                      
                          /**
                           * @dev Safely mints `quantity` tokens and transfers them to `to`.
                           *
                           * Requirements:
                           *
                           * - If `to` refers to a smart contract, it must implement
                           * {IERC721Receiver-onERC721Received}, which is called for each safe transfer.
                           * - `quantity` must be greater than 0.
                           *
                           * See {_mint}.
                           *
                           * Emits a {Transfer} event for each mint.
                           */
                          function _safeMint(
                              address to,
                              uint256 quantity,
                              bytes memory _data
                          ) internal virtual {
                              _mint(to, quantity);
                      
                              unchecked {
                                  if (to.code.length != 0) {
                                      uint256 end = _currentIndex;
                                      uint256 index = end - quantity;
                                      do {
                                          if (!_checkContractOnERC721Received(address(0), to, index++, _data)) {
                                              revert TransferToNonERC721ReceiverImplementer();
                                          }
                                      } while (index < end);
                                      // Reentrancy protection.
                                      if (_currentIndex != end) revert();
                                  }
                              }
                          }
                      
                          /**
                           * @dev Equivalent to `_safeMint(to, quantity, '')`.
                           */
                          function _safeMint(address to, uint256 quantity) internal virtual {
                              _safeMint(to, quantity, '');
                          }
                      
                          // =============================================================
                          //                        BURN OPERATIONS
                          // =============================================================
                      
                          /**
                           * @dev Equivalent to `_burn(tokenId, false)`.
                           */
                          function _burn(uint256 tokenId) internal virtual {
                              _burn(tokenId, false);
                          }
                      
                          /**
                           * @dev Destroys `tokenId`.
                           * The approval is cleared when the token is burned.
                           *
                           * Requirements:
                           *
                           * - `tokenId` must exist.
                           *
                           * Emits a {Transfer} event.
                           */
                          function _burn(uint256 tokenId, bool approvalCheck) internal virtual {
                              uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);
                      
                              address from = address(uint160(prevOwnershipPacked));
                      
                              (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);
                      
                              if (approvalCheck) {
                                  // The nested ifs save around 20+ gas over a compound boolean condition.
                                  if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
                                      if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved();
                              }
                      
                              _beforeTokenTransfers(from, address(0), tokenId, 1);
                      
                              // Clear approvals from the previous owner.
                              assembly {
                                  if approvedAddress {
                                      // This is equivalent to `delete _tokenApprovals[tokenId]`.
                                      sstore(approvedAddressSlot, 0)
                                  }
                              }
                      
                              // Underflow of the sender's balance is impossible because we check for
                              // ownership above and the recipient's balance can't realistically overflow.
                              // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
                              unchecked {
                                  // Updates:
                                  // - `balance -= 1`.
                                  // - `numberBurned += 1`.
                                  //
                                  // We can directly decrement the balance, and increment the number burned.
                                  // This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`.
                                  _packedAddressData[from] += (1 << _BITPOS_NUMBER_BURNED) - 1;
                      
                                  // Updates:
                                  // - `address` to the last owner.
                                  // - `startTimestamp` to the timestamp of burning.
                                  // - `burned` to `true`.
                                  // - `nextInitialized` to `true`.
                                  _packedOwnerships[tokenId] = _packOwnershipData(
                                      from,
                                      (_BITMASK_BURNED | _BITMASK_NEXT_INITIALIZED) | _nextExtraData(from, address(0), prevOwnershipPacked)
                                  );
                      
                                  // If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
                                  if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
                                      uint256 nextTokenId = tokenId + 1;
                                      // If the next slot's address is zero and not burned (i.e. packed value is zero).
                                      if (_packedOwnerships[nextTokenId] == 0) {
                                          // If the next slot is within bounds.
                                          if (nextTokenId != _currentIndex) {
                                              // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
                                              _packedOwnerships[nextTokenId] = prevOwnershipPacked;
                                          }
                                      }
                                  }
                              }
                      
                              emit Transfer(from, address(0), tokenId);
                              _afterTokenTransfers(from, address(0), tokenId, 1);
                      
                              // Overflow not possible, as _burnCounter cannot be exceed _currentIndex times.
                              unchecked {
                                  _burnCounter++;
                              }
                          }
                      
                          // =============================================================
                          //                     EXTRA DATA OPERATIONS
                          // =============================================================
                      
                          /**
                           * @dev Directly sets the extra data for the ownership data `index`.
                           */
                          function _setExtraDataAt(uint256 index, uint24 extraData) internal virtual {
                              uint256 packed = _packedOwnerships[index];
                              if (packed == 0) revert OwnershipNotInitializedForExtraData();
                              uint256 extraDataCasted;
                              // Cast `extraData` with assembly to avoid redundant masking.
                              assembly {
                                  extraDataCasted := extraData
                              }
                              packed = (packed & _BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << _BITPOS_EXTRA_DATA);
                              _packedOwnerships[index] = packed;
                          }
                      
                          /**
                           * @dev Called during each token transfer to set the 24bit `extraData` field.
                           * Intended to be overridden by the cosumer contract.
                           *
                           * `previousExtraData` - the value of `extraData` before transfer.
                           *
                           * Calling conditions:
                           *
                           * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
                           * transferred to `to`.
                           * - When `from` is zero, `tokenId` will be minted for `to`.
                           * - When `to` is zero, `tokenId` will be burned by `from`.
                           * - `from` and `to` are never both zero.
                           */
                          function _extraData(
                              address from,
                              address to,
                              uint24 previousExtraData
                          ) internal view virtual returns (uint24) {}
                      
                          /**
                           * @dev Returns the next extra data for the packed ownership data.
                           * The returned result is shifted into position.
                           */
                          function _nextExtraData(
                              address from,
                              address to,
                              uint256 prevOwnershipPacked
                          ) private view returns (uint256) {
                              uint24 extraData = uint24(prevOwnershipPacked >> _BITPOS_EXTRA_DATA);
                              return uint256(_extraData(from, to, extraData)) << _BITPOS_EXTRA_DATA;
                          }
                      
                          // =============================================================
                          //                       OTHER OPERATIONS
                          // =============================================================
                      
                          /**
                           * @dev Returns the message sender (defaults to `msg.sender`).
                           *
                           * If you are writing GSN compatible contracts, you need to override this function.
                           */
                          function _msgSenderERC721A() internal view virtual returns (address) {
                              return msg.sender;
                          }
                      
                          /**
                           * @dev Converts a uint256 to its ASCII string decimal representation.
                           */
                          function _toString(uint256 value) internal pure virtual returns (string memory str) {
                              assembly {
                                  // The maximum value of a uint256 contains 78 digits (1 byte per digit), but
                                  // we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned.
                                  // We will need 1 word for the trailing zeros padding, 1 word for the length,
                                  // and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0.
                                  let m := add(mload(0x40), 0xa0)
                                  // Update the free memory pointer to allocate.
                                  mstore(0x40, m)
                                  // Assign the `str` to the end.
                                  str := sub(m, 0x20)
                                  // Zeroize the slot after the string.
                                  mstore(str, 0)
                      
                                  // Cache the end of the memory to calculate the length later.
                                  let end := str
                      
                                  // We write the string from rightmost digit to leftmost digit.
                                  // The following is essentially a do-while loop that also handles the zero case.
                                  // prettier-ignore
                                  for { let temp := value } 1 {} {
                                      str := sub(str, 1)
                                      // Write the character to the pointer.
                                      // The ASCII index of the '0' character is 48.
                                      mstore8(str, add(48, mod(temp, 10)))
                                      // Keep dividing `temp` until zero.
                                      temp := div(temp, 10)
                                      // prettier-ignore
                                      if iszero(temp) { break }
                                  }
                      
                                  let length := sub(end, str)
                                  // Move the pointer 32 bytes leftwards to make room for the length.
                                  str := sub(str, 0x20)
                                  // Store the length.
                                  mstore(str, length)
                              }
                          }
                      }
                      
                      // File: https://github.com/chiru-labs/ERC721A/blob/main/contracts/extensions/IERC721AQueryable.sol
                      
                      
                      // ERC721A Contracts v4.2.3
                      // Creator: Chiru Labs
                      
                      pragma solidity ^0.8.4;
                      
                      
                      /**
                       * @dev Interface of ERC721AQueryable.
                       */
                      interface IERC721AQueryable is IERC721A {
                          /**
                           * Invalid query range (`start` >= `stop`).
                           */
                          error InvalidQueryRange();
                      
                          /**
                           * @dev Returns the `TokenOwnership` struct at `tokenId` without reverting.
                           *
                           * If the `tokenId` is out of bounds:
                           *
                           * - `addr = address(0)`
                           * - `startTimestamp = 0`
                           * - `burned = false`
                           * - `extraData = 0`
                           *
                           * If the `tokenId` is burned:
                           *
                           * - `addr = <Address of owner before token was burned>`
                           * - `startTimestamp = <Timestamp when token was burned>`
                           * - `burned = true`
                           * - `extraData = <Extra data when token was burned>`
                           *
                           * Otherwise:
                           *
                           * - `addr = <Address of owner>`
                           * - `startTimestamp = <Timestamp of start of ownership>`
                           * - `burned = false`
                           * - `extraData = <Extra data at start of ownership>`
                           */
                          function explicitOwnershipOf(uint256 tokenId) external view returns (TokenOwnership memory);
                      
                          /**
                           * @dev Returns an array of `TokenOwnership` structs at `tokenIds` in order.
                           * See {ERC721AQueryable-explicitOwnershipOf}
                           */
                          function explicitOwnershipsOf(uint256[] memory tokenIds) external view returns (TokenOwnership[] memory);
                      
                          /**
                           * @dev Returns an array of token IDs owned by `owner`,
                           * in the range [`start`, `stop`)
                           * (i.e. `start <= tokenId < stop`).
                           *
                           * This function allows for tokens to be queried if the collection
                           * grows too big for a single call of {ERC721AQueryable-tokensOfOwner}.
                           *
                           * Requirements:
                           *
                           * - `start < stop`
                           */
                          function tokensOfOwnerIn(
                              address owner,
                              uint256 start,
                              uint256 stop
                          ) external view returns (uint256[] memory);
                      
                          /**
                           * @dev Returns an array of token IDs owned by `owner`.
                           *
                           * This function scans the ownership mapping and is O(`totalSupply`) in complexity.
                           * It is meant to be called off-chain.
                           *
                           * See {ERC721AQueryable-tokensOfOwnerIn} for splitting the scan into
                           * multiple smaller scans if the collection is large enough to cause
                           * an out-of-gas error (10K collections should be fine).
                           */
                          function tokensOfOwner(address owner) external view returns (uint256[] memory);
                      }
                      
                      // File: https://github.com/chiru-labs/ERC721A/blob/main/contracts/extensions/ERC721AQueryable.sol
                      
                      
                      // ERC721A Contracts v4.2.3
                      // Creator: Chiru Labs
                      
                      pragma solidity ^0.8.4;
                      
                      
                      
                      /**
                       * @title ERC721AQueryable.
                       *
                       * @dev ERC721A subclass with convenience query functions.
                       */
                      abstract contract ERC721AQueryable is ERC721A, IERC721AQueryable {
                          /**
                           * @dev Returns the `TokenOwnership` struct at `tokenId` without reverting.
                           *
                           * If the `tokenId` is out of bounds:
                           *
                           * - `addr = address(0)`
                           * - `startTimestamp = 0`
                           * - `burned = false`
                           * - `extraData = 0`
                           *
                           * If the `tokenId` is burned:
                           *
                           * - `addr = <Address of owner before token was burned>`
                           * - `startTimestamp = <Timestamp when token was burned>`
                           * - `burned = true`
                           * - `extraData = <Extra data when token was burned>`
                           *
                           * Otherwise:
                           *
                           * - `addr = <Address of owner>`
                           * - `startTimestamp = <Timestamp of start of ownership>`
                           * - `burned = false`
                           * - `extraData = <Extra data at start of ownership>`
                           */
                          function explicitOwnershipOf(uint256 tokenId) public view virtual override returns (TokenOwnership memory) {
                              TokenOwnership memory ownership;
                              if (tokenId < _startTokenId() || tokenId >= _nextTokenId()) {
                                  return ownership;
                              }
                              ownership = _ownershipAt(tokenId);
                              if (ownership.burned) {
                                  return ownership;
                              }
                              return _ownershipOf(tokenId);
                          }
                      
                          /**
                           * @dev Returns an array of `TokenOwnership` structs at `tokenIds` in order.
                           * See {ERC721AQueryable-explicitOwnershipOf}
                           */
                          function explicitOwnershipsOf(uint256[] calldata tokenIds)
                              external
                              view
                              virtual
                              override
                              returns (TokenOwnership[] memory)
                          {
                              unchecked {
                                  uint256 tokenIdsLength = tokenIds.length;
                                  TokenOwnership[] memory ownerships = new TokenOwnership[](tokenIdsLength);
                                  for (uint256 i; i != tokenIdsLength; ++i) {
                                      ownerships[i] = explicitOwnershipOf(tokenIds[i]);
                                  }
                                  return ownerships;
                              }
                          }
                      
                          /**
                           * @dev Returns an array of token IDs owned by `owner`,
                           * in the range [`start`, `stop`)
                           * (i.e. `start <= tokenId < stop`).
                           *
                           * This function allows for tokens to be queried if the collection
                           * grows too big for a single call of {ERC721AQueryable-tokensOfOwner}.
                           *
                           * Requirements:
                           *
                           * - `start < stop`
                           */
                          function tokensOfOwnerIn(
                              address owner,
                              uint256 start,
                              uint256 stop
                          ) external view virtual override returns (uint256[] memory) {
                              unchecked {
                                  if (start >= stop) revert InvalidQueryRange();
                                  uint256 tokenIdsIdx;
                                  uint256 stopLimit = _nextTokenId();
                                  // Set `start = max(start, _startTokenId())`.
                                  if (start < _startTokenId()) {
                                      start = _startTokenId();
                                  }
                                  // Set `stop = min(stop, stopLimit)`.
                                  if (stop > stopLimit) {
                                      stop = stopLimit;
                                  }
                                  uint256 tokenIdsMaxLength = balanceOf(owner);
                                  // Set `tokenIdsMaxLength = min(balanceOf(owner), stop - start)`,
                                  // to cater for cases where `balanceOf(owner)` is too big.
                                  if (start < stop) {
                                      uint256 rangeLength = stop - start;
                                      if (rangeLength < tokenIdsMaxLength) {
                                          tokenIdsMaxLength = rangeLength;
                                      }
                                  } else {
                                      tokenIdsMaxLength = 0;
                                  }
                                  uint256[] memory tokenIds = new uint256[](tokenIdsMaxLength);
                                  if (tokenIdsMaxLength == 0) {
                                      return tokenIds;
                                  }
                                  // We need to call `explicitOwnershipOf(start)`,
                                  // because the slot at `start` may not be initialized.
                                  TokenOwnership memory ownership = explicitOwnershipOf(start);
                                  address currOwnershipAddr;
                                  // If the starting slot exists (i.e. not burned), initialize `currOwnershipAddr`.
                                  // `ownership.address` will not be zero, as `start` is clamped to the valid token ID range.
                                  if (!ownership.burned) {
                                      currOwnershipAddr = ownership.addr;
                                  }
                                  for (uint256 i = start; i != stop && tokenIdsIdx != tokenIdsMaxLength; ++i) {
                                      ownership = _ownershipAt(i);
                                      if (ownership.burned) {
                                          continue;
                                      }
                                      if (ownership.addr != address(0)) {
                                          currOwnershipAddr = ownership.addr;
                                      }
                                      if (currOwnershipAddr == owner) {
                                          tokenIds[tokenIdsIdx++] = i;
                                      }
                                  }
                                  // Downsize the array to fit.
                                  assembly {
                                      mstore(tokenIds, tokenIdsIdx)
                                  }
                                  return tokenIds;
                              }
                          }
                      
                          /**
                           * @dev Returns an array of token IDs owned by `owner`.
                           *
                           * This function scans the ownership mapping and is O(`totalSupply`) in complexity.
                           * It is meant to be called off-chain.
                           *
                           * See {ERC721AQueryable-tokensOfOwnerIn} for splitting the scan into
                           * multiple smaller scans if the collection is large enough to cause
                           * an out-of-gas error (10K collections should be fine).
                           */
                          function tokensOfOwner(address owner) external view virtual override returns (uint256[] memory) {
                              unchecked {
                                  uint256 tokenIdsIdx;
                                  address currOwnershipAddr;
                                  uint256 tokenIdsLength = balanceOf(owner);
                                  uint256[] memory tokenIds = new uint256[](tokenIdsLength);
                                  TokenOwnership memory ownership;
                                  for (uint256 i = _startTokenId(); tokenIdsIdx != tokenIdsLength; ++i) {
                                      ownership = _ownershipAt(i);
                                      if (ownership.burned) {
                                          continue;
                                      }
                                      if (ownership.addr != address(0)) {
                                          currOwnershipAddr = ownership.addr;
                                      }
                                      if (currOwnershipAddr == owner) {
                                          tokenIds[tokenIdsIdx++] = i;
                                      }
                                  }
                                  return tokenIds;
                              }
                          }
                      }
                      
                      // File: contracts/VOXVOTBlindVox.sol
                      
                      
                      // File: https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/Context.sol
                      
                      
                      // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
                      
                      pragma solidity ^0.8.0;
                      
                      
                      
                      
                      
                      /**
                       * @dev Provides information about the current execution context, including the
                       * sender of the transaction and its data. While these are generally available
                       * via msg.sender and msg.data, they should not be accessed in such a direct
                       * manner, since when dealing with meta-transactions the account sending and
                       * paying for execution may not be the actual sender (as far as an application
                       * is concerned).
                       *
                       * This contract is only required for intermediate, library-like contracts.
                       */
                      abstract contract Context {
                          function _msgSender() internal view virtual returns (address) {
                              return msg.sender;
                          }
                      
                          function _msgData() internal view virtual returns (bytes calldata) {
                              return msg.data;
                          }
                      }
                      
                      // File: https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/security/Pausable.sol
                      
                      
                      // OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)
                      
                      pragma solidity ^0.8.0;
                      
                      
                      /**
                       * @dev Contract module which allows children to implement an emergency stop
                       * mechanism that can be triggered by an authorized account.
                       *
                       * This module is used through inheritance. It will make available the
                       * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
                       * the functions of your contract. Note that they will not be pausable by
                       * simply including this module, only once the modifiers are put in place.
                       */
                      abstract contract Pausable is Context {
                          /**
                           * @dev Emitted when the pause is triggered by `account`.
                           */
                          event Paused(address account);
                      
                          /**
                           * @dev Emitted when the pause is lifted by `account`.
                           */
                          event Unpaused(address account);
                      
                          bool private _paused;
                      
                          /**
                           * @dev Initializes the contract in unpaused state.
                           */
                          constructor() {
                              _paused = false;
                          }
                      
                          /**
                           * @dev Modifier to make a function callable only when the contract is not paused.
                           *
                           * Requirements:
                           *
                           * - The contract must not be paused.
                           */
                          modifier whenNotPaused() {
                              _requireNotPaused();
                              _;
                          }
                      
                          /**
                           * @dev Modifier to make a function callable only when the contract is paused.
                           *
                           * Requirements:
                           *
                           * - The contract must be paused.
                           */
                          modifier whenPaused() {
                              _requirePaused();
                              _;
                          }
                      
                          /**
                           * @dev Returns true if the contract is paused, and false otherwise.
                           */
                          function paused() public view virtual returns (bool) {
                              return _paused;
                          }
                      
                          /**
                           * @dev Throws if the contract is paused.
                           */
                          function _requireNotPaused() internal view virtual {
                              require(!paused(), "Pausable: paused");
                          }
                      
                          /**
                           * @dev Throws if the contract is not paused.
                           */
                          function _requirePaused() internal view virtual {
                              require(paused(), "Pausable: not paused");
                          }
                      
                          /**
                           * @dev Triggers stopped state.
                           *
                           * Requirements:
                           *
                           * - The contract must not be paused.
                           */
                          function _pause() internal virtual whenNotPaused {
                              _paused = true;
                              emit Paused(_msgSender());
                          }
                      
                          /**
                           * @dev Returns to normal state.
                           *
                           * Requirements:
                           *
                           * - The contract must be paused.
                           */
                          function _unpause() internal virtual whenPaused {
                              _paused = false;
                              emit Unpaused(_msgSender());
                          }
                      }
                      
                      
                      // File: @openzeppelin/contracts/access/Ownable.sol
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Contract module which provides a basic access control mechanism, where
                       * there is an account (an owner) that can be granted exclusive access to
                       * specific functions.
                       *
                       * By default, the owner account will be the one that deploys the contract. This
                       * can later be changed with {transferOwnership}.
                       *
                       * This module is used through inheritance. It will make available the modifier
                       * `onlyOwner`, which can be applied to your functions to restrict their use to
                       * the owner.
                       */
                      abstract contract Ownable is Context {
                          address private _owner;
                      
                          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                      
                          /**
                           * @dev Initializes the contract setting the deployer as the initial owner.
                           */
                          constructor() {
                              _setOwner(_msgSender());
                          }
                      
                          /**
                           * @dev Returns the address of the current owner.
                           */
                          function owner() public view virtual returns (address) {
                              return _owner;
                          }
                      
                          /**
                           * @dev Throws if called by any account other than the owner.
                           */
                          modifier onlyOwner() {
                              require(owner() == _msgSender(), "Ownable: caller is not the owner");
                              _;
                          }
                      
                          /**
                           * @dev Leaves the contract without owner. It will not be possible to call
                           * `onlyOwner` functions anymore. Can only be called by the current owner.
                           *
                           * NOTE: Renouncing ownership will leave the contract without an owner,
                           * thereby removing any functionality that is only available to the owner.
                           */
                          function renounceOwnership() public virtual onlyOwner {
                              _setOwner(address(0));
                          }
                      
                          /**
                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                           * Can only be called by the current owner.
                           */
                          function transferOwnership(address newOwner) public virtual onlyOwner {
                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                              _setOwner(newOwner);
                          }
                      
                          function _setOwner(address newOwner) private {
                              address oldOwner = _owner;
                              _owner = newOwner;
                              emit OwnershipTransferred(oldOwner, newOwner);
                          }
                      }
                      
                      
                      
                      pragma solidity ^0.8.0;
                      
                      /**
                       * @dev These functions deal with verification of Merkle Trees proofs.
                       *
                       * The proofs can be generated using the JavaScript library
                       * https://github.com/miguelmota/merkletreejs[merkletreejs].
                       * Note: the hashing algorithm should be keccak256 and pair sorting should be enabled.
                       *
                       * See `test/utils/cryptography/MerkleProof.test.js` for some examples.
                       *
                       * WARNING: You should avoid using leaf values that are 64 bytes long prior to
                       * hashing, or use a hash function other than keccak256 for hashing leaves.
                       * This is because the concatenation of a sorted pair of internal nodes in
                       * the merkle tree could be reinterpreted as a leaf value.
                       */
                      library MerkleProof {
                          /**
                           * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
                           * defined by `root`. For this, a `proof` must be provided, containing
                           * sibling hashes on the branch from the leaf to the root of the tree. Each
                           * pair of leaves and each pair of pre-images are assumed to be sorted.
                           */
                          function verify(
                              bytes32[] memory proof,
                              bytes32 root,
                              bytes32 leaf
                          ) internal pure returns (bool) {
                              return processProof(proof, leaf) == root;
                          }
                      
                          /**
                           * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
                           * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
                           * hash matches the root of the tree. When processing the proof, the pairs
                           * of leafs & pre-images are assumed to be sorted.
                           *
                           * _Available since v4.4._
                           */
                          function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {
                              bytes32 computedHash = leaf;
                              for (uint256 i = 0; i < proof.length; i++) {
                                  computedHash = _hashPair(computedHash, proof[i]);
                              }
                              return computedHash;
                          }
                      
                          /**
                           * @dev Returns true if a `leafs` can be proved to be a part of a Merkle tree
                           * defined by `root`. For this, `proofs` for each leaf must be provided, containing
                           * sibling hashes on the branch from the leaf to the root of the tree. Then
                           * 'proofFlag' designates the nodes needed for the multi proof.
                           *
                           * _Available since v4.7._
                           */
                          function multiProofVerify(
                              bytes32 root,
                              bytes32[] memory leafs,
                              bytes32[] memory proofs,
                              bool[] memory proofFlag
                          ) internal pure returns (bool) {
                              return processMultiProof(leafs, proofs, proofFlag) == root;
                          }
                      
                          /**
                           * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
                           * from `leaf` using the multi proof as `proofFlag`. A multi proof is
                           * valid if the final hash matches the root of the tree.
                           *
                           * _Available since v4.7._
                           */
                          function processMultiProof(
                              bytes32[] memory leafs,
                              bytes32[] memory proofs,
                              bool[] memory proofFlag
                          ) internal pure returns (bytes32 merkleRoot) {
                              // This function rebuild the root hash by traversing the tree up from the leaves. The root is rebuilt by
                              // consuming and producing values on a queue. The queue starts with the `leafs` array, then goes onto the
                              // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
                              // the merkle tree.
                              uint256 leafsLen = leafs.length;
                              uint256 proofsLen = proofs.length;
                              uint256 totalHashes = proofFlag.length;
                      
                              // Check proof validity.
                              require(leafsLen + proofsLen - 1 == totalHashes, "MerkleProof: invalid multiproof");
                      
                              // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
                              // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
                              bytes32[] memory hashes = new bytes32[](totalHashes);
                              uint256 leafPos = 0;
                              uint256 hashPos = 0;
                              uint256 proofPos = 0;
                              // At each step, we compute the next hash using two values:
                              // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
                              //   get the next hash.
                              // - depending on the flag, either another value for the "main queue" (merging branches) or an element from the
                              //   `proofs` array.
                              for (uint256 i = 0; i < totalHashes; i++) {
                                  bytes32 a = leafPos < leafsLen ? leafs[leafPos++] : hashes[hashPos++];
                                  bytes32 b = proofFlag[i] ? leafPos < leafsLen ? leafs[leafPos++] : hashes[hashPos++] : proofs[proofPos++];
                                  hashes[i] = _hashPair(a, b);
                              }
                      
                              return hashes[totalHashes - 1];
                          }
                      
                          function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) {
                              return a < b ? _efficientHash(a, b) : _efficientHash(b, a);
                          }
                      
                          function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) {
                              /// @solidity memory-safe-assembly
                              assembly {
                                  mstore(0x00, a)
                                  mstore(0x20, b)
                                  value := keccak256(0x00, 0x40)
                              }
                          }
                      }
                      
                      /**
                       * @dev String operations.
                       */
                      library Strings {
                          bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
                      
                          /**
                           * @dev Converts a `uint256` to its ASCII `string` decimal representation.
                           */
                          function toString(uint256 value) internal pure returns (string memory) {
                              // Inspired by OraclizeAPI's implementation - MIT licence
                              // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
                      
                              if (value == 0) {
                                  return "0";
                              }
                              uint256 temp = value;
                              uint256 digits;
                              while (temp != 0) {
                                  digits++;
                                  temp /= 10;
                              }
                              bytes memory buffer = new bytes(digits);
                              while (value != 0) {
                                  digits -= 1;
                                  buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                                  value /= 10;
                              }
                              return string(buffer);
                          }
                      
                          /**
                           * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
                           */
                          function toHexString(uint256 value) internal pure returns (string memory) {
                              if (value == 0) {
                                  return "0x00";
                              }
                              uint256 temp = value;
                              uint256 length = 0;
                              while (temp != 0) {
                                  length++;
                                  temp >>= 8;
                              }
                              return toHexString(value, length);
                          }
                      
                          /**
                           * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
                           */
                          function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
                              bytes memory buffer = new bytes(2 * length + 2);
                              buffer[0] = "0";
                              buffer[1] = "x";
                              for (uint256 i = 2 * length + 1; i > 1; --i) {
                                  buffer[i] = _HEX_SYMBOLS[value & 0xf];
                                  value >>= 4;
                              }
                              require(value == 0, "Strings: hex length insufficient");
                              return string(buffer);
                          }
                      }
                      
                      //custom reverts
                      error NotOwner();
                      error NotOpenable();
                      error NoBotMint();
                      error AlreadyMinted();
                      error InvalidAddr();
                      error NonexistsToken();
                      error SoldOut();
                      error InvalidInput();
                      error ExcessMint();
                      error IsPublicMint();
                      error IsWhiteListMint();
                      
                      pragma solidity >=0.7.0 <0.9.0;
                      
                      abstract contract voxvotNFT {
                          function openVox(address _to, uint256 _tokenID) public virtual;
                      }
                      
                      //tested contract
                      contract VOXVOT_BlindVox is ERC721AQueryable, Ownable, Pausable, ReentrancyGuard{
                        using Strings for uint256;
                      
                        string baseURI;
                        string public baseExtension = ".json";
                        uint256 public maxSupply = 6666;
                        uint256 public WLMintlimit;
                        uint256 public publicMintlimit;
                        mapping (address => uint256) public WLMintCount;
                        mapping (address => uint256) public publicMintCount;
                        address private NftContract;
                        uint256 public totalMints;
                      
                        //state
                        bool public isWhitelistMint = false;
                        bool public isOpenable = false;
                      
                        //merkle proof
                        bytes32 private rootHash;
                      
                        constructor(
                          string memory _name,
                          string memory _symbol,
                          string memory _baseUri
                        ) ERC721A(_name, _symbol) {
                            setBaseUri(_baseUri);
                        }
                      
                        function _startTokenId() internal view virtual override returns (uint256) {
                              return 1;
                        }
                      
                        function _baseURI() internal view virtual override returns (string memory) {
                              return baseURI;
                          }
                      
                        function tokenURI(uint256 tokenId) public view virtual override returns (string memory)
                        {
                          if (!_exists(tokenId)) revert NonexistsToken();
                          string memory currentBaseURI = _baseURI();
                          return bytes(currentBaseURI).length > 0
                              ? string(abi.encodePacked(currentBaseURI, tokenId.toString(), baseExtension))
                              : "";
                        }
                      
                        function openVox(uint256 tokenid) public nonReentrant() {
                            if(!isOpenable) revert NotOpenable();
                            if(msg.sender != ownerOf(tokenid)) revert NotOwner();
                            voxvotNFT nftcontract = voxvotNFT(NftContract);
                            _burn(tokenid, true);
                            nftcontract.openVox(msg.sender, tokenid);
                        }
                      
                        function openVoxes(uint256[] calldata tokenids) external {
                            for (uint256 i; i < tokenids.length; ) {
                              openVox(tokenids[i]);
                              unchecked { ++i; }
                            }
                        }
                      
                        function whitelistMint(bytes32[] calldata proof) external payable whenNotPaused {
                            if(!isWhitelistMint) revert IsPublicMint();
                            if (WLMintCount[msg.sender] + 2 > WLMintlimit || 2 + totalMints > maxSupply) revert ExcessMint();
                            bytes32 leaf = keccak256(abi.encodePacked(msg.sender));
                            if (!MerkleProof.verify(proof, rootHash, leaf)) revert InvalidAddr();
                            totalMints += 2;
                            WLMintCount[msg.sender] += 2;
                            _mint(msg.sender,2);
                        }
                      
                        function mintBlindVox(uint256 amount) external payable whenNotPaused {
                            if (isWhitelistMint) revert IsWhiteListMint();
                            if (tx.origin != msg.sender) revert NoBotMint();
                            if (publicMintCount[msg.sender] + amount > publicMintlimit || amount + totalMints > maxSupply) revert ExcessMint();
                            totalMints += amount;
                            publicMintCount[msg.sender] += amount;
                            _safeMint(msg.sender,amount);
                        }
                      
                        //-----air drop-----
                        function preMint(address[] calldata listedAddr, uint256[] calldata sendAmounts) external onlyOwner {
                            if (listedAddr.length != sendAmounts.length || listedAddr.length == 0) revert InvalidInput();
                            
                            for (uint256 i; i < listedAddr.length; ) {
                              totalMints += sendAmounts[i];
                              _mint(listedAddr[i], sendAmounts[i]);
                              unchecked { ++i; }
                            }
                        }
                      
                        //-----only owner-----
                        function ownerMint(uint256 amount) external onlyOwner {
                            if(amount + totalMints > maxSupply) revert ExcessMint();
                            totalMints += amount;
                            _mint(msg.sender,amount);
                        }
                      
                        function setBaseUri(string memory _newBaseUri) public onlyOwner {
                            baseURI = _newBaseUri;
                        }
                      
                        function setRootHash(bytes32 _newHash) external onlyOwner {
                            rootHash = _newHash;
                        }
                      
                        function setMaxSupply(uint256 _newSupply) external onlyOwner {
                            if(_newSupply > maxSupply) revert InvalidInput();
                            maxSupply = _newSupply;
                        }
                      
                        function setWLMintLimit(uint256 _newLimit) external onlyOwner {
                            WLMintlimit = _newLimit;
                        }
                      
                        function setPublicMintLimit(uint256 _newLimit) external onlyOwner {
                            publicMintlimit = _newLimit;
                        }
                      
                        function setNftContract(address _newAddr) external onlyOwner {
                            NftContract = _newAddr;
                        }
                      
                        function setMintStatus() external onlyOwner {
                            if(isWhitelistMint){
                                isWhitelistMint = false;
                            } else {
                                isWhitelistMint = true;
                            }
                        }
                      
                        function setIsOpenable() external onlyOwner {
                            if(!isOpenable){
                                isOpenable = true;
                            }
                        }
                      
                        function pause() external onlyOwner {
                      	_pause();
                        }
                      
                      	function unpause() external onlyOwner {
                      	_unpause();
                        }
                      
                      
                      }