ETH Price: $2,352.51 (+18.20%)

Transaction Decoder

Block:
22047683 at Mar-14-2025 09:04:47 PM +UTC
Transaction Fee:
0.000093107741942464 ETH $0.22
Gas Used:
112,208 Gas / 0.829778108 Gwei

Account State Difference:

  Address   Before After State Difference Code
(Titan Builder)
17.309763442620329691 Eth17.309794890490535211 Eth0.00003144787020552
0xc7f7932A...6e75aa030
0.023123395939158402 Eth
Nonce: 360
0.023030288197215938 Eth
Nonce: 361
0.000093107741942464

Execution Trace

NightCard.reveal( tokenIDs=[3165] )
  • Rebels.mint( to=0xc7f7932A296806125e28838eec0e3366e75aa030, tokenIDs=[4134] )
    • CustomizationSelectorURIRenderer.beforeTokenTransfer( from=0x0000000000000000000000000000000000000000, to=0xc7f7932A296806125e28838eec0e3366e75aa030, id=4134 )
      File 1 of 3: NightCard
      // SPDX-License-Identifier: MIT
      /*
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@                                               @@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@                                                   @@@@@@@@@@@@@@@@@@@@@
      @@@@@                                                     @@@@@@@@@@@@@@@@@@@@@@
      @@@   ,@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@          @@@@@@@@@@@@@@@@@@@@@@@
      @#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@     @@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@  @@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@            @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@            @@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@            @@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@            @@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@            @@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@               @@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      */
      pragma solidity ^0.8.4;
      import "@openzeppelin/contracts/access/Ownable.sol";
      import "erc721a/contracts/ERC721A.sol";
      import "./mint/IRebelsMintAuthorizer.sol";
      import "./render/IRebelsRenderer.sol";
      abstract contract RevealInterface {
        function mint(address to, uint256[] calldata tokenIDs) external virtual;
      }
      contract NightCard is ERC721A, Ownable {
        uint256 immutable public maxSupply;
        address public rendererAddress;
        address public mintAuthorizerAddress;
        address public revealContractAddress;
        string public contractURI;
        uint256 private _numAvailableTokens;
        mapping(uint256 => uint256) private _availableTokens;
        constructor(
          string memory name_,
          string memory symbol_,
          uint256 maxSupply_
        ) ERC721A(name_, symbol_) {
          maxSupply = maxSupply_;
          _numAvailableTokens = maxSupply_;
        }
        function tokenURI(uint256 id) public view override returns (string memory) {
          require(rendererAddress != address(0), "Renderer address unset");
          require(_exists(id), "URI query for nonexistent token");
          IRebelsRenderer renderer = IRebelsRenderer(rendererAddress);
          return renderer.tokenURI(id);
        }
        function mint(uint256 number, bytes32[] calldata proof) external payable {
          require(tx.origin == msg.sender, "Trying to mint from a contract");
          require(mintAuthorizerAddress != address(0), "Mint authorizer address unset");
          IRebelsMintAuthorizer mintAuthorizer = IRebelsMintAuthorizer(mintAuthorizerAddress);
          mintAuthorizer.authorizeMint(msg.sender, msg.value, number, proof);
          _mint(msg.sender, number);
          require(_totalMinted() <= maxSupply, "Trying to mint more than max supply");
        }
        function reveal(uint256[] calldata tokenIDs) external {
          require(tx.origin == msg.sender, "Trying to reveal from a contract");
          require(revealContractAddress != address(0), "Reveal contract address unset");
          uint256[] memory newTokenIDs = new uint256[](tokenIDs.length);
          for (uint256 i = 0; i < tokenIDs.length; ++i) {
            require(msg.sender == ownerOf(tokenIDs[i]), "Reveal from incorrect owner");
            _burn(tokenIDs[i]);
            newTokenIDs[i] = _getRandomAvailableTokenId();
            _numAvailableTokens -= 1;
          }
          RevealInterface revealContract = RevealInterface(revealContractAddress);
          revealContract.mint(msg.sender, newTokenIDs);
        }
        function setRendererAddress(address rendererAddress_) external onlyOwner {
          rendererAddress = rendererAddress_;
        }
        function setMintAuthorizerAddress(address mintAuthorizerAddress_) external onlyOwner {
          mintAuthorizerAddress = mintAuthorizerAddress_;
        }
        function setRevealContractAddress(address revealContractAddress_) external onlyOwner {
          revealContractAddress = revealContractAddress_;
        }
        function setContractURI(string memory contractURI_) external onlyOwner {
          contractURI = contractURI_;
        }
        function withdraw() external onlyOwner {
          uint256 balance = address(this).balance;
          payable(msg.sender).transfer(balance);
        }
        function _startTokenId() internal pure override returns (uint256) {
          // 1 -> 13370 looks better.
          return 1;
        }
        function _getRandomAvailableTokenId() private returns (uint256) {
          uint256 randomNum = uint256(keccak256(abi.encode(
              tx.origin, tx.gasprice, block.number, block.timestamp,
              block.difficulty, block.coinbase, blockhash(block.number - 1),
              address(this), _numAvailableTokens)));
          uint256 randomIndex = randomNum % _numAvailableTokens;
          return _getAvailableTokenAtIndex(randomIndex);
        }
        // Adapted from CryptoPhunksV2/ERC721R.
        function _getAvailableTokenAtIndex(uint256 indexToUse) private returns (uint256) {
          uint256 valAtIndex = _availableTokens[indexToUse];
          uint256 result;
          if (valAtIndex == 0) {
            // This means the index itself is still an available token.
            result = indexToUse;
          } else {
            // This means the index itself is not an available token, but the val at
            // that index is.
            result = valAtIndex;
          }
          uint256 lastIndex = _numAvailableTokens - 1;
          if (indexToUse != lastIndex) {
            // Replace the value at indexToUse, now that it's been used. Replace it
            // with the data from the last index in the array, since we are going to
            // decrease the array size afterwards.
            uint256 lastValInArray = _availableTokens[lastIndex];
            if (lastValInArray == 0) {
              // This means the index itself is still an available token.
              _availableTokens[indexToUse] = lastIndex;
            } else {
              // This means the index itself is not an available token, but the val
              // at that index is.
              _availableTokens[indexToUse] = lastValInArray;
              // Gas refund courtsey of @dievardump.
              delete _availableTokens[lastIndex];
            }
          }
          return result;
        }
      }
      // 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
      // ERC721A Contracts v4.0.0
      // Creator: Chiru Labs
      pragma solidity ^0.8.4;
      import './IERC721A.sol';
      /**
       * @dev ERC721 token receiver interface.
       */
      interface ERC721A__IERC721Receiver {
          function onERC721Received(
              address operator,
              address from,
              uint256 tokenId,
              bytes calldata data
          ) external returns (bytes4);
      }
      /**
       * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
       * the Metadata extension. Built to optimize for lower gas during batch mints.
       *
       * Assumes serials are sequentially minted starting at _startTokenId() (defaults to 0, e.g. 0, 1, 2, 3..).
       *
       * Assumes that an owner cannot have more than 2**64 - 1 (max value of uint64) of supply.
       *
       * Assumes that the maximum token id cannot exceed 2**256 - 1 (max value of uint256).
       */
      contract ERC721A is IERC721A {
          // 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 tokenId of the next token 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`
          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 => address) private _tokenApprovals;
          // Mapping from owner to operator approvals
          mapping(address => mapping(address => bool)) private _operatorApprovals;
          constructor(string memory name_, string memory symbol_) {
              _name = name_;
              _symbol = symbol_;
              _currentIndex = _startTokenId();
          }
          /**
           * @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 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 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 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 returns (uint256) {
              return _burnCounter;
          }
          /**
           * @dev See {IERC165-supportsInterface}.
           */
          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: 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.
          }
          /**
           * @dev See {IERC721-balanceOf}.
           */
          function balanceOf(address owner) public view 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 auxillary 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 auxillary 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 {
              uint256 packed = _packedAddressData[owner];
              uint256 auxCasted;
              assembly { // Cast aux without masking.
                  auxCasted := aux
              }
              packed = (packed & BITMASK_AUX_COMPLEMENT) | (auxCasted << BITPOS_AUX);
              _packedAddressData[owner] = packed;
          }
          /**
           * 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 ownership that has an address and is not burned
                              // before an ownership that does not have an address and is not burned.
                              // Hence, curr will not underflow.
                              //
                              // We can directly compare the packed value.
                              // If the address is zero, packed is zero.
                              while (packed == 0) {
                                  packed = _packedOwnerships[--curr];
                              }
                              return packed;
                          }
                      }
              }
              revert OwnerQueryForNonexistentToken();
          }
          /**
           * 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;
          }
          /**
           * Returns the unpacked `TokenOwnership` struct at `index`.
           */
          function _ownershipAt(uint256 index) internal view returns (TokenOwnership memory) {
              return _unpackedOwnership(_packedOwnerships[index]);
          }
          /**
           * @dev Initializes the ownership slot minted at `index` for efficiency purposes.
           */
          function _initializeOwnershipAt(uint256 index) internal {
              if (_packedOwnerships[index] == 0) {
                  _packedOwnerships[index] = _packedOwnershipOf(index);
              }
          }
          /**
           * Gas spent here starts off proportional to the maximum mint batch size.
           * It gradually moves to O(1) as tokens get transferred around in the collection over time.
           */
          function _ownershipOf(uint256 tokenId) internal view returns (TokenOwnership memory) {
              return _unpackedOwnership(_packedOwnershipOf(tokenId));
          }
          /**
           * @dev See {IERC721-ownerOf}.
           */
          function ownerOf(uint256 tokenId) public view override returns (address) {
              return address(uint160(_packedOwnershipOf(tokenId)));
          }
          /**
           * @dev See {IERC721Metadata-name}.
           */
          function name() public view virtual override returns (string memory) {
              return _name;
          }
          /**
           * @dev See {IERC721Metadata-symbol}.
           */
          function symbol() public view virtual override returns (string memory) {
              return _symbol;
          }
          /**
           * @dev See {IERC721Metadata-tokenURI}.
           */
          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, can be overriden in child contracts.
           */
          function _baseURI() internal view virtual returns (string memory) {
              return '';
          }
          /**
           * @dev Casts the address to uint256 without masking.
           */
          function _addressToUint256(address value) private pure returns (uint256 result) {
              assembly {
                  result := value
              }
          }
          /**
           * @dev Casts the boolean to uint256 without branching.
           */
          function _boolToUint256(bool value) private pure returns (uint256 result) {
              assembly {
                  result := value
              }
          }
          /**
           * @dev See {IERC721-approve}.
           */
          function approve(address to, uint256 tokenId) public override {
              address owner = address(uint160(_packedOwnershipOf(tokenId)));
              if (to == owner) revert ApprovalToCurrentOwner();
              if (_msgSenderERC721A() != owner)
                  if (!isApprovedForAll(owner, _msgSenderERC721A())) {
                      revert ApprovalCallerNotOwnerNorApproved();
                  }
              _tokenApprovals[tokenId] = to;
              emit Approval(owner, to, tokenId);
          }
          /**
           * @dev See {IERC721-getApproved}.
           */
          function getApproved(uint256 tokenId) public view override returns (address) {
              if (!_exists(tokenId)) revert ApprovalQueryForNonexistentToken();
              return _tokenApprovals[tokenId];
          }
          /**
           * @dev See {IERC721-setApprovalForAll}.
           */
          function setApprovalForAll(address operator, bool approved) public virtual override {
              if (operator == _msgSenderERC721A()) revert ApproveToCaller();
              _operatorApprovals[_msgSenderERC721A()][operator] = approved;
              emit ApprovalForAll(_msgSenderERC721A(), operator, approved);
          }
          /**
           * @dev See {IERC721-isApprovedForAll}.
           */
          function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
              return _operatorApprovals[owner][operator];
          }
          /**
           * @dev See {IERC721-transferFrom}.
           */
          function transferFrom(
              address from,
              address to,
              uint256 tokenId
          ) public virtual override {
              _transfer(from, to, tokenId);
          }
          /**
           * @dev See {IERC721-safeTransferFrom}.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId
          ) public virtual override {
              safeTransferFrom(from, to, tokenId, '');
          }
          /**
           * @dev See {IERC721-safeTransferFrom}.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId,
              bytes memory _data
          ) public virtual override {
              _transfer(from, to, tokenId);
              if (to.code.length != 0)
                  if (!_checkContractOnERC721Received(from, to, tokenId, _data)) {
                      revert TransferToNonERC721ReceiverImplementer();
                  }
          }
          /**
           * @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 (`_mint`),
           */
          function _exists(uint256 tokenId) internal view returns (bool) {
              return
                  _startTokenId() <= tokenId &&
                  tokenId < _currentIndex && // If within bounds,
                  _packedOwnerships[tokenId] & BITMASK_BURNED == 0; // and not burned.
          }
          /**
           * @dev Equivalent to `_safeMint(to, quantity, '')`.
           */
          function _safeMint(address to, uint256 quantity) internal {
              _safeMint(to, 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.
           *
           * Emits a {Transfer} event.
           */
          function _safeMint(
              address to,
              uint256 quantity,
              bytes memory _data
          ) internal {
              uint256 startTokenId = _currentIndex;
              if (to == address(0)) revert MintToZeroAddress();
              if (quantity == 0) revert MintZeroQuantity();
              _beforeTokenTransfers(address(0), to, startTokenId, quantity);
              // Overflows are incredibly unrealistic.
              // balance or numberMinted overflow if current value of either + quantity > 1.8e19 (2**64) - 1
              // updatedIndex overflows if _currentIndex + quantity > 1.2e77 (2**256) - 1
              unchecked {
                  // Updates:
                  // - `balance += quantity`.
                  // - `numberMinted += quantity`.
                  //
                  // We can directly add to the balance and number minted.
                  _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] =
                      _addressToUint256(to) |
                      (block.timestamp << BITPOS_START_TIMESTAMP) |
                      (_boolToUint256(quantity == 1) << BITPOS_NEXT_INITIALIZED);
                  uint256 updatedIndex = startTokenId;
                  uint256 end = updatedIndex + quantity;
                  if (to.code.length != 0) {
                      do {
                          emit Transfer(address(0), to, updatedIndex);
                          if (!_checkContractOnERC721Received(address(0), to, updatedIndex++, _data)) {
                              revert TransferToNonERC721ReceiverImplementer();
                          }
                      } while (updatedIndex < end);
                      // Reentrancy protection
                      if (_currentIndex != startTokenId) revert();
                  } else {
                      do {
                          emit Transfer(address(0), to, updatedIndex++);
                      } while (updatedIndex < end);
                  }
                  _currentIndex = updatedIndex;
              }
              _afterTokenTransfers(address(0), to, startTokenId, quantity);
          }
          /**
           * @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.
           */
          function _mint(address to, uint256 quantity) internal {
              uint256 startTokenId = _currentIndex;
              if (to == address(0)) revert MintToZeroAddress();
              if (quantity == 0) revert MintZeroQuantity();
              _beforeTokenTransfers(address(0), to, startTokenId, quantity);
              // Overflows are incredibly unrealistic.
              // balance or numberMinted overflow if current value of either + quantity > 1.8e19 (2**64) - 1
              // updatedIndex overflows if _currentIndex + quantity > 1.2e77 (2**256) - 1
              unchecked {
                  // Updates:
                  // - `balance += quantity`.
                  // - `numberMinted += quantity`.
                  //
                  // We can directly add to the balance and number minted.
                  _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] =
                      _addressToUint256(to) |
                      (block.timestamp << BITPOS_START_TIMESTAMP) |
                      (_boolToUint256(quantity == 1) << BITPOS_NEXT_INITIALIZED);
                  uint256 updatedIndex = startTokenId;
                  uint256 end = updatedIndex + quantity;
                  do {
                      emit Transfer(address(0), to, updatedIndex++);
                  } while (updatedIndex < end);
                  _currentIndex = updatedIndex;
              }
              _afterTokenTransfers(address(0), to, startTokenId, quantity);
          }
          /**
           * @dev Transfers `tokenId` from `from` to `to`.
           *
           * Requirements:
           *
           * - `to` cannot be the zero address.
           * - `tokenId` token must be owned by `from`.
           *
           * Emits a {Transfer} event.
           */
          function _transfer(
              address from,
              address to,
              uint256 tokenId
          ) private {
              uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);
              if (address(uint160(prevOwnershipPacked)) != from) revert TransferFromIncorrectOwner();
              bool isApprovedOrOwner = (_msgSenderERC721A() == from ||
                  isApprovedForAll(from, _msgSenderERC721A()) ||
                  getApproved(tokenId) == _msgSenderERC721A());
              if (!isApprovedOrOwner) revert TransferCallerNotOwnerNorApproved();
              if (to == address(0)) revert TransferToZeroAddress();
              _beforeTokenTransfers(from, to, tokenId, 1);
              // Clear approvals from the previous owner.
              delete _tokenApprovals[tokenId];
              // 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] =
                      _addressToUint256(to) |
                      (block.timestamp << BITPOS_START_TIMESTAMP) |
                      BITMASK_NEXT_INITIALIZED;
                  // 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 `_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));
              if (approvalCheck) {
                  bool isApprovedOrOwner = (_msgSenderERC721A() == from ||
                      isApprovedForAll(from, _msgSenderERC721A()) ||
                      getApproved(tokenId) == _msgSenderERC721A());
                  if (!isApprovedOrOwner) revert TransferCallerNotOwnerNorApproved();
              }
              _beforeTokenTransfers(from, address(0), tokenId, 1);
              // Clear approvals from the previous owner.
              delete _tokenApprovals[tokenId];
              // 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] =
                      _addressToUint256(from) |
                      (block.timestamp << BITPOS_START_TIMESTAMP) |
                      BITMASK_BURNED | 
                      BITMASK_NEXT_INITIALIZED;
                  // 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++;
              }
          }
          /**
           * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target contract.
           *
           * @param from address representing the previous owner of the given token ID
           * @param to target address that will receive the tokens
           * @param tokenId uint256 ID of the token to be transferred
           * @param _data bytes optional data to send along with the call
           * @return bool whether the call correctly returned the expected magic value
           */
          function _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))
                      }
                  }
              }
          }
          /**
           * @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 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 returns (string memory ptr) {
              assembly {
                  // The maximum value of a uint256 contains 78 digits (1 byte per digit), 
                  // but we allocate 128 bytes to keep the free memory pointer 32-byte word aliged.
                  // We will need 1 32-byte word to store the length, 
                  // and 3 32-byte words to store a maximum of 78 digits. Total: 32 + 3 * 32 = 128.
                  ptr := add(mload(0x40), 128)
                  // Update the free memory pointer to allocate.
                  mstore(0x40, ptr)
                  // Cache the end of the memory to calculate the length later.
                  let end := ptr
                  // We write the string from the rightmost digit to the leftmost digit.
                  // The following is essentially a do-while loop that also handles the zero case.
                  // Costs a bit more than early returning for the zero case,
                  // but cheaper in terms of deployment and overall runtime costs.
                  for { 
                      // Initialize and perform the first pass without check.
                      let temp := value
                      // Move the pointer 1 byte leftwards to point to an empty character slot.
                      ptr := sub(ptr, 1)
                      // Write the character to the pointer. 48 is the ASCII index of '0'.
                      mstore8(ptr, add(48, mod(temp, 10)))
                      temp := div(temp, 10)
                  } temp { 
                      // Keep dividing `temp` until zero.
                      temp := div(temp, 10)
                  } { // Body of the for loop.
                      ptr := sub(ptr, 1)
                      mstore8(ptr, add(48, mod(temp, 10)))
                  }
                  
                  let length := sub(end, ptr)
                  // Move the pointer 32 bytes leftwards to make room for the length.
                  ptr := sub(ptr, 32)
                  // Store the length.
                  mstore(ptr, length)
              }
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.4;
      interface IRebelsMintAuthorizer {
        function authorizeMint(
          address sender,
          uint256 value,
          uint256 number,
          bytes32[] memory senderData
        ) external;
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.4;
      import "@openzeppelin/contracts/interfaces/IERC165.sol";
      interface IRebelsRenderer is IERC165 {
        function tokenURI(uint256 id) external view returns (string memory);
        function beforeTokenTransfer(address from, address to, uint256 id) external;
      }
      // 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
      // ERC721A Contracts v4.0.0
      // Creator: Chiru Labs
      pragma solidity ^0.8.4;
      /**
       * @dev Interface of an ERC721A compliant contract.
       */
      interface IERC721A {
          /**
           * The caller must own the token or be an approved operator.
           */
          error ApprovalCallerNotOwnerNorApproved();
          /**
           * The token does not exist.
           */
          error ApprovalQueryForNonexistentToken();
          /**
           * The caller cannot approve to their own address.
           */
          error ApproveToCaller();
          /**
           * The caller cannot approve to the current owner.
           */
          error ApprovalToCurrentOwner();
          /**
           * 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();
          struct TokenOwnership {
              // The address of the owner.
              address addr;
              // Keeps track of the start time of ownership with minimal overhead for tokenomics.
              uint64 startTimestamp;
              // Whether the token has been burned.
              bool burned;
          }
          /**
           * @dev Returns the total amount of tokens stored by the contract.
           *
           * Burned tokens are calculated here, use `_totalMinted()` if you want to count just minted tokens.
           */
          function totalSupply() external view returns (uint256);
          // ==============================
          //            IERC165
          // ==============================
          /**
           * @dev Returns true if this contract implements the interface defined by
           * `interfaceId`. See the corresponding
           * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
           * to learn more about how these ids are created.
           *
           * This function call must use less than 30 000 gas.
           */
          function supportsInterface(bytes4 interfaceId) external view returns (bool);
          // ==============================
          //            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`.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must exist and be owned by `from`.
           * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
           * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
           *
           * Emits a {Transfer} event.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId,
              bytes calldata data
          ) external;
          /**
           * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
           * are aware of the ERC721 protocol to prevent tokens from being forever locked.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must exist and be owned by `from`.
           * - If the caller is not `from`, it must 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
          ) external;
          /**
           * @dev Transfers `tokenId` token from `from` to `to`.
           *
           * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must be owned by `from`.
           * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
           *
           * Emits a {Transfer} event.
           */
          function transferFrom(
              address from,
              address to,
              uint256 tokenId
          ) external;
          /**
           * @dev Gives permission to `to` to transfer `tokenId` token to another account.
           * The approval is cleared when the token is transferred.
           *
           * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
           *
           * Requirements:
           *
           * - The caller must own the token or be an approved operator.
           * - `tokenId` must exist.
           *
           * Emits an {Approval} event.
           */
          function approve(address to, uint256 tokenId) external;
          /**
           * @dev Approve or remove `operator` as an operator for the caller.
           * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
           *
           * Requirements:
           *
           * - The `operator` cannot be the caller.
           *
           * Emits an {ApprovalForAll} event.
           */
          function setApprovalForAll(address operator, bool _approved) external;
          /**
           * @dev Returns the account approved for `tokenId` token.
           *
           * Requirements:
           *
           * - `tokenId` must exist.
           */
          function getApproved(uint256 tokenId) external view returns (address operator);
          /**
           * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
           *
           * See {setApprovalForAll}
           */
          function isApprovedForAll(address owner, address operator) external view returns (bool);
          // ==============================
          //        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);
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts v4.4.1 (interfaces/IERC165.sol)
      pragma solidity ^0.8.0;
      import "../utils/introspection/IERC165.sol";
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
      pragma solidity ^0.8.0;
      /**
       * @dev Interface of the ERC165 standard, as defined in the
       * https://eips.ethereum.org/EIPS/eip-165[EIP].
       *
       * Implementers can declare support of contract interfaces, which can then be
       * queried by others ({ERC165Checker}).
       *
       * For an implementation, see {ERC165}.
       */
      interface IERC165 {
          /**
           * @dev Returns true if this contract implements the interface defined by
           * `interfaceId`. See the corresponding
           * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
           * to learn more about how these ids are created.
           *
           * This function call must use less than 30 000 gas.
           */
          function supportsInterface(bytes4 interfaceId) external view returns (bool);
      }
      

      File 2 of 3: Rebels
      // SPDX-License-Identifier: MIT
      /*
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@                                               @@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@                                                   @@@@@@@@@@@@@@@@@@@@@
      @@@@@                                                     @@@@@@@@@@@@@@@@@@@@@@
      @@@   ,@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@          @@@@@@@@@@@@@@@@@@@@@@@
      @#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@     @@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@  @@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@            @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@            @@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@            @@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@            @@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@            @@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@             @@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@               @@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
      */
      pragma solidity ^0.8.4;
      import "@openzeppelin/contracts/access/Ownable.sol";
      import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
      import "./render/IRebelsRenderer.sol";
      contract Rebels is ERC721, Ownable {
        uint256 immutable public maxSupply;
        uint256 public totalSupply;
        address public rendererAddress;
        address public minterAddress;
        string public contractURI;
        bytes32 public provenanceHash;
        constructor(
          string memory name_,
          string memory symbol_,
          uint256 maxSupply_
        ) ERC721(name_, symbol_) {
          maxSupply = maxSupply_;
        }
        function tokenURI(uint256 id) public view override returns (string memory) {
          require(rendererAddress != address(0), "Renderer address unset");
          require(_exists(id), "URI query for nonexistent token");
          IRebelsRenderer renderer = IRebelsRenderer(rendererAddress);
          return renderer.tokenURI(id);
        }
        function mint(address to, uint256[] memory tokenIDs) external {
          require(msg.sender == minterAddress, "Minting from invalid address");
          for (uint256 i = 0; i < tokenIDs.length; ++i) {
            totalSupply += 1;
            _mint(to, tokenIDs[i]);
          }
          require(totalSupply <= maxSupply, "Trying to mint more than max supply");
        }
        function setRendererAddress(address rendererAddress_) external onlyOwner {
          rendererAddress = rendererAddress_;
        }
        function setMinterAddress(address minterAddress_) external onlyOwner {
          minterAddress = minterAddress_;
        }
        function setContractURI(string memory contractURI_) external onlyOwner {
          contractURI = contractURI_;
        }
        function setProvenanceHash(bytes32 provenanceHash_) external onlyOwner {
          provenanceHash = provenanceHash_;
        }
        function _beforeTokenTransfer(address from, address to, uint256 id) internal override {
          if (rendererAddress == address(0)) {
            return;
          }
          IRebelsRenderer renderer = IRebelsRenderer(rendererAddress);
          renderer.beforeTokenTransfer(from, to, id);
        }
      }
      // 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
      // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/ERC721.sol)
      pragma solidity ^0.8.0;
      import "./IERC721.sol";
      import "./IERC721Receiver.sol";
      import "./extensions/IERC721Metadata.sol";
      import "../../utils/Address.sol";
      import "../../utils/Context.sol";
      import "../../utils/Strings.sol";
      import "../../utils/introspection/ERC165.sol";
      /**
       * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
       * the Metadata extension, but not including the Enumerable extension, which is available separately as
       * {ERC721Enumerable}.
       */
      contract ERC721 is Context, ERC165, IERC721, IERC721Metadata {
          using Address for address;
          using Strings for uint256;
          // Token name
          string private _name;
          // Token symbol
          string private _symbol;
          // Mapping from token ID to owner address
          mapping(uint256 => address) private _owners;
          // Mapping owner address to token count
          mapping(address => uint256) private _balances;
          // Mapping from token ID to approved address
          mapping(uint256 => address) private _tokenApprovals;
          // Mapping from owner to operator approvals
          mapping(address => mapping(address => bool)) private _operatorApprovals;
          /**
           * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
           */
          constructor(string memory name_, string memory symbol_) {
              _name = name_;
              _symbol = symbol_;
          }
          /**
           * @dev See {IERC165-supportsInterface}.
           */
          function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
              return
                  interfaceId == type(IERC721).interfaceId ||
                  interfaceId == type(IERC721Metadata).interfaceId ||
                  super.supportsInterface(interfaceId);
          }
          /**
           * @dev See {IERC721-balanceOf}.
           */
          function balanceOf(address owner) public view virtual override returns (uint256) {
              require(owner != address(0), "ERC721: balance query for the zero address");
              return _balances[owner];
          }
          /**
           * @dev See {IERC721-ownerOf}.
           */
          function ownerOf(uint256 tokenId) public view virtual override returns (address) {
              address owner = _owners[tokenId];
              require(owner != address(0), "ERC721: owner query for nonexistent token");
              return owner;
          }
          /**
           * @dev See {IERC721Metadata-name}.
           */
          function name() public view virtual override returns (string memory) {
              return _name;
          }
          /**
           * @dev See {IERC721Metadata-symbol}.
           */
          function symbol() public view virtual override returns (string memory) {
              return _symbol;
          }
          /**
           * @dev See {IERC721Metadata-tokenURI}.
           */
          function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
              require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
              string memory baseURI = _baseURI();
              return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
          }
          /**
           * @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, can be overridden in child contracts.
           */
          function _baseURI() internal view virtual returns (string memory) {
              return "";
          }
          /**
           * @dev See {IERC721-approve}.
           */
          function approve(address to, uint256 tokenId) public virtual override {
              address owner = ERC721.ownerOf(tokenId);
              require(to != owner, "ERC721: approval to current owner");
              require(
                  _msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                  "ERC721: approve caller is not owner nor approved for all"
              );
              _approve(to, tokenId);
          }
          /**
           * @dev See {IERC721-getApproved}.
           */
          function getApproved(uint256 tokenId) public view virtual override returns (address) {
              require(_exists(tokenId), "ERC721: approved query for nonexistent token");
              return _tokenApprovals[tokenId];
          }
          /**
           * @dev See {IERC721-setApprovalForAll}.
           */
          function setApprovalForAll(address operator, bool approved) public virtual override {
              _setApprovalForAll(_msgSender(), operator, approved);
          }
          /**
           * @dev See {IERC721-isApprovedForAll}.
           */
          function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
              return _operatorApprovals[owner][operator];
          }
          /**
           * @dev See {IERC721-transferFrom}.
           */
          function transferFrom(
              address from,
              address to,
              uint256 tokenId
          ) public virtual override {
              //solhint-disable-next-line max-line-length
              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
              _transfer(from, to, tokenId);
          }
          /**
           * @dev See {IERC721-safeTransferFrom}.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId
          ) public virtual override {
              safeTransferFrom(from, to, tokenId, "");
          }
          /**
           * @dev See {IERC721-safeTransferFrom}.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId,
              bytes memory _data
          ) public virtual override {
              require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
              _safeTransfer(from, to, tokenId, _data);
          }
          /**
           * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
           * are aware of the ERC721 protocol to prevent tokens from being forever locked.
           *
           * `_data` is additional data, it has no specified format and it is sent in call to `to`.
           *
           * This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
           * implement alternative mechanisms to perform token transfer, such as signature-based.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must exist and be owned by `from`.
           * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
           *
           * Emits a {Transfer} event.
           */
          function _safeTransfer(
              address from,
              address to,
              uint256 tokenId,
              bytes memory _data
          ) internal virtual {
              _transfer(from, to, tokenId);
              require(_checkOnERC721Received(from, to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
          }
          /**
           * @dev Returns whether `tokenId` exists.
           *
           * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
           *
           * Tokens start existing when they are minted (`_mint`),
           * and stop existing when they are burned (`_burn`).
           */
          function _exists(uint256 tokenId) internal view virtual returns (bool) {
              return _owners[tokenId] != address(0);
          }
          /**
           * @dev Returns whether `spender` is allowed to manage `tokenId`.
           *
           * Requirements:
           *
           * - `tokenId` must exist.
           */
          function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
              require(_exists(tokenId), "ERC721: operator query for nonexistent token");
              address owner = ERC721.ownerOf(tokenId);
              return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender);
          }
          /**
           * @dev Safely mints `tokenId` and transfers it to `to`.
           *
           * Requirements:
           *
           * - `tokenId` must not exist.
           * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
           *
           * Emits a {Transfer} event.
           */
          function _safeMint(address to, uint256 tokenId) internal virtual {
              _safeMint(to, tokenId, "");
          }
          /**
           * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
           * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
           */
          function _safeMint(
              address to,
              uint256 tokenId,
              bytes memory _data
          ) internal virtual {
              _mint(to, tokenId);
              require(
                  _checkOnERC721Received(address(0), to, tokenId, _data),
                  "ERC721: transfer to non ERC721Receiver implementer"
              );
          }
          /**
           * @dev Mints `tokenId` and transfers it to `to`.
           *
           * WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
           *
           * Requirements:
           *
           * - `tokenId` must not exist.
           * - `to` cannot be the zero address.
           *
           * Emits a {Transfer} event.
           */
          function _mint(address to, uint256 tokenId) internal virtual {
              require(to != address(0), "ERC721: mint to the zero address");
              require(!_exists(tokenId), "ERC721: token already minted");
              _beforeTokenTransfer(address(0), to, tokenId);
              _balances[to] += 1;
              _owners[tokenId] = to;
              emit Transfer(address(0), to, tokenId);
              _afterTokenTransfer(address(0), to, tokenId);
          }
          /**
           * @dev Destroys `tokenId`.
           * The approval is cleared when the token is burned.
           *
           * Requirements:
           *
           * - `tokenId` must exist.
           *
           * Emits a {Transfer} event.
           */
          function _burn(uint256 tokenId) internal virtual {
              address owner = ERC721.ownerOf(tokenId);
              _beforeTokenTransfer(owner, address(0), tokenId);
              // Clear approvals
              _approve(address(0), tokenId);
              _balances[owner] -= 1;
              delete _owners[tokenId];
              emit Transfer(owner, address(0), tokenId);
              _afterTokenTransfer(owner, address(0), tokenId);
          }
          /**
           * @dev Transfers `tokenId` from `from` to `to`.
           *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
           *
           * Requirements:
           *
           * - `to` cannot be the zero address.
           * - `tokenId` token must be owned by `from`.
           *
           * Emits a {Transfer} event.
           */
          function _transfer(
              address from,
              address to,
              uint256 tokenId
          ) internal virtual {
              require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
              require(to != address(0), "ERC721: transfer to the zero address");
              _beforeTokenTransfer(from, to, tokenId);
              // Clear approvals from the previous owner
              _approve(address(0), tokenId);
              _balances[from] -= 1;
              _balances[to] += 1;
              _owners[tokenId] = to;
              emit Transfer(from, to, tokenId);
              _afterTokenTransfer(from, to, tokenId);
          }
          /**
           * @dev Approve `to` to operate on `tokenId`
           *
           * Emits a {Approval} event.
           */
          function _approve(address to, uint256 tokenId) internal virtual {
              _tokenApprovals[tokenId] = to;
              emit Approval(ERC721.ownerOf(tokenId), to, tokenId);
          }
          /**
           * @dev Approve `operator` to operate on all of `owner` tokens
           *
           * Emits a {ApprovalForAll} event.
           */
          function _setApprovalForAll(
              address owner,
              address operator,
              bool approved
          ) internal virtual {
              require(owner != operator, "ERC721: approve to caller");
              _operatorApprovals[owner][operator] = approved;
              emit ApprovalForAll(owner, operator, approved);
          }
          /**
           * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
           * The call is not executed if the target address is not a contract.
           *
           * @param from address representing the previous owner of the given token ID
           * @param to target address that will receive the tokens
           * @param tokenId uint256 ID of the token to be transferred
           * @param _data bytes optional data to send along with the call
           * @return bool whether the call correctly returned the expected magic value
           */
          function _checkOnERC721Received(
              address from,
              address to,
              uint256 tokenId,
              bytes memory _data
          ) private returns (bool) {
              if (to.isContract()) {
                  try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, _data) returns (bytes4 retval) {
                      return retval == IERC721Receiver.onERC721Received.selector;
                  } catch (bytes memory reason) {
                      if (reason.length == 0) {
                          revert("ERC721: transfer to non ERC721Receiver implementer");
                      } else {
                          assembly {
                              revert(add(32, reason), mload(reason))
                          }
                      }
                  }
              } else {
                  return true;
              }
          }
          /**
           * @dev Hook that is called before any token transfer. This includes minting
           * and burning.
           *
           * Calling conditions:
           *
           * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
           * transferred to `to`.
           * - When `from` is zero, `tokenId` will be minted for `to`.
           * - When `to` is zero, ``from``'s `tokenId` will be burned.
           * - `from` and `to` are never both zero.
           *
           * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
           */
          function _beforeTokenTransfer(
              address from,
              address to,
              uint256 tokenId
          ) internal virtual {}
          /**
           * @dev Hook that is called after any transfer of tokens. This includes
           * minting and burning.
           *
           * Calling conditions:
           *
           * - when `from` and `to` are both non-zero.
           * - `from` and `to` are never both zero.
           *
           * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
           */
          function _afterTokenTransfer(
              address from,
              address to,
              uint256 tokenId
          ) internal virtual {}
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.4;
      import "@openzeppelin/contracts/interfaces/IERC165.sol";
      interface IRebelsRenderer is IERC165 {
        function tokenURI(uint256 id) external view returns (string memory);
        function beforeTokenTransfer(address from, address to, uint256 id) external;
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
      pragma solidity ^0.8.0;
      /**
       * @dev Provides information about the current execution context, including the
       * sender of the transaction and its data. While these are generally available
       * via msg.sender and msg.data, they should not be accessed in such a direct
       * manner, since when dealing with meta-transactions the account sending and
       * paying for execution may not be the actual sender (as far as an application
       * is concerned).
       *
       * This contract is only required for intermediate, library-like contracts.
       */
      abstract contract Context {
          function _msgSender() internal view virtual returns (address) {
              return msg.sender;
          }
          function _msgData() internal view virtual returns (bytes calldata) {
              return msg.data;
          }
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721.sol)
      pragma solidity ^0.8.0;
      import "../../utils/introspection/IERC165.sol";
      /**
       * @dev Required interface of an ERC721 compliant contract.
       */
      interface IERC721 is IERC165 {
          /**
           * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
           */
          event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
          /**
           * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
           */
          event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
          /**
           * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
           */
          event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
          /**
           * @dev Returns the number of tokens in ``owner``'s account.
           */
          function balanceOf(address owner) external view returns (uint256 balance);
          /**
           * @dev Returns the owner of the `tokenId` token.
           *
           * Requirements:
           *
           * - `tokenId` must exist.
           */
          function ownerOf(uint256 tokenId) external view returns (address owner);
          /**
           * @dev Safely transfers `tokenId` token from `from` to `to`.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must exist and be owned by `from`.
           * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
           * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
           *
           * Emits a {Transfer} event.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId,
              bytes calldata data
          ) external;
          /**
           * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
           * are aware of the ERC721 protocol to prevent tokens from being forever locked.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must exist and be owned by `from`.
           * - If the caller is not `from`, it must 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
          ) external;
          /**
           * @dev Transfers `tokenId` token from `from` to `to`.
           *
           * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must be owned by `from`.
           * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
           *
           * Emits a {Transfer} event.
           */
          function transferFrom(
              address from,
              address to,
              uint256 tokenId
          ) external;
          /**
           * @dev Gives permission to `to` to transfer `tokenId` token to another account.
           * The approval is cleared when the token is transferred.
           *
           * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
           *
           * Requirements:
           *
           * - The caller must own the token or be an approved operator.
           * - `tokenId` must exist.
           *
           * Emits an {Approval} event.
           */
          function approve(address to, uint256 tokenId) external;
          /**
           * @dev Approve or remove `operator` as an operator for the caller.
           * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
           *
           * Requirements:
           *
           * - The `operator` cannot be the caller.
           *
           * Emits an {ApprovalForAll} event.
           */
          function setApprovalForAll(address operator, bool _approved) external;
          /**
           * @dev Returns the account approved for `tokenId` token.
           *
           * Requirements:
           *
           * - `tokenId` must exist.
           */
          function getApproved(uint256 tokenId) external view returns (address operator);
          /**
           * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
           *
           * See {setApprovalForAll}
           */
          function isApprovedForAll(address owner, address operator) external view returns (bool);
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol)
      pragma solidity ^0.8.0;
      /**
       * @title ERC721 token receiver interface
       * @dev Interface for any contract that wants to support safeTransfers
       * from ERC721 asset contracts.
       */
      interface IERC721Receiver {
          /**
           * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
           * by `operator` from `from`, this function is called.
           *
           * It must return its Solidity selector to confirm the token transfer.
           * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
           *
           * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
           */
          function onERC721Received(
              address operator,
              address from,
              uint256 tokenId,
              bytes calldata data
          ) external returns (bytes4);
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
      pragma solidity ^0.8.0;
      import "../IERC721.sol";
      /**
       * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
       * @dev See https://eips.ethereum.org/EIPS/eip-721
       */
      interface IERC721Metadata is IERC721 {
          /**
           * @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);
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v4.5.0) (utils/Address.sol)
      pragma solidity ^0.8.1;
      /**
       * @dev Collection of functions related to the address type
       */
      library Address {
          /**
           * @dev Returns true if `account` is a contract.
           *
           * [IMPORTANT]
           * ====
           * It is unsafe to assume that an address for which this function returns
           * false is an externally-owned account (EOA) and not a contract.
           *
           * Among others, `isContract` will return false for the following
           * types of addresses:
           *
           *  - an externally-owned account
           *  - a contract in construction
           *  - an address where a contract will be created
           *  - an address where a contract lived, but was destroyed
           * ====
           *
           * [IMPORTANT]
           * ====
           * You shouldn't rely on `isContract` to protect against flash loan attacks!
           *
           * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
           * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
           * constructor.
           * ====
           */
          function isContract(address account) internal view returns (bool) {
              // This method relies on extcodesize/address.code.length, which returns 0
              // for contracts in construction, since the code is only stored at the end
              // of the constructor execution.
              return account.code.length > 0;
          }
          /**
           * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
           * `recipient`, forwarding all available gas and reverting on errors.
           *
           * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
           * of certain opcodes, possibly making contracts go over the 2300 gas limit
           * imposed by `transfer`, making them unable to receive funds via
           * `transfer`. {sendValue} removes this limitation.
           *
           * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
           *
           * IMPORTANT: because control is transferred to `recipient`, care must be
           * taken to not create reentrancy vulnerabilities. Consider using
           * {ReentrancyGuard} or the
           * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
           */
          function sendValue(address payable recipient, uint256 amount) internal {
              require(address(this).balance >= amount, "Address: insufficient balance");
              (bool success, ) = recipient.call{value: amount}("");
              require(success, "Address: unable to send value, recipient may have reverted");
          }
          /**
           * @dev Performs a Solidity function call using a low level `call`. A
           * plain `call` is an unsafe replacement for a function call: use this
           * function instead.
           *
           * If `target` reverts with a revert reason, it is bubbled up by this
           * function (like regular Solidity function calls).
           *
           * Returns the raw returned data. To convert to the expected return value,
           * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
           *
           * Requirements:
           *
           * - `target` must be a contract.
           * - calling `target` with `data` must not revert.
           *
           * _Available since v3.1._
           */
          function functionCall(address target, bytes memory data) internal returns (bytes memory) {
              return functionCall(target, data, "Address: low-level call failed");
          }
          /**
           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
           * `errorMessage` as a fallback revert reason when `target` reverts.
           *
           * _Available since v3.1._
           */
          function functionCall(
              address target,
              bytes memory data,
              string memory errorMessage
          ) internal returns (bytes memory) {
              return functionCallWithValue(target, data, 0, errorMessage);
          }
          /**
           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
           * but also transferring `value` wei to `target`.
           *
           * Requirements:
           *
           * - the calling contract must have an ETH balance of at least `value`.
           * - the called Solidity function must be `payable`.
           *
           * _Available since v3.1._
           */
          function functionCallWithValue(
              address target,
              bytes memory data,
              uint256 value
          ) internal returns (bytes memory) {
              return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
          }
          /**
           * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
           * with `errorMessage` as a fallback revert reason when `target` reverts.
           *
           * _Available since v3.1._
           */
          function functionCallWithValue(
              address target,
              bytes memory data,
              uint256 value,
              string memory errorMessage
          ) internal returns (bytes memory) {
              require(address(this).balance >= value, "Address: insufficient balance for call");
              require(isContract(target), "Address: call to non-contract");
              (bool success, bytes memory returndata) = target.call{value: value}(data);
              return verifyCallResult(success, returndata, errorMessage);
          }
          /**
           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
           * but performing a static call.
           *
           * _Available since v3.3._
           */
          function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
              return functionStaticCall(target, data, "Address: low-level static call failed");
          }
          /**
           * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
           * but performing a static call.
           *
           * _Available since v3.3._
           */
          function functionStaticCall(
              address target,
              bytes memory data,
              string memory errorMessage
          ) internal view returns (bytes memory) {
              require(isContract(target), "Address: static call to non-contract");
              (bool success, bytes memory returndata) = target.staticcall(data);
              return verifyCallResult(success, returndata, errorMessage);
          }
          /**
           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
           * but performing a delegate call.
           *
           * _Available since v3.4._
           */
          function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
              return functionDelegateCall(target, data, "Address: low-level delegate call failed");
          }
          /**
           * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
           * but performing a delegate call.
           *
           * _Available since v3.4._
           */
          function functionDelegateCall(
              address target,
              bytes memory data,
              string memory errorMessage
          ) internal returns (bytes memory) {
              require(isContract(target), "Address: delegate call to non-contract");
              (bool success, bytes memory returndata) = target.delegatecall(data);
              return verifyCallResult(success, returndata, errorMessage);
          }
          /**
           * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
           * revert reason using the provided one.
           *
           * _Available since v4.3._
           */
          function verifyCallResult(
              bool success,
              bytes memory returndata,
              string memory errorMessage
          ) internal pure returns (bytes memory) {
              if (success) {
                  return returndata;
              } else {
                  // Look for revert reason and bubble it up if present
                  if (returndata.length > 0) {
                      // The easiest way to bubble the revert reason is using memory via assembly
                      assembly {
                          let returndata_size := mload(returndata)
                          revert(add(32, returndata), returndata_size)
                      }
                  } else {
                      revert(errorMessage);
                  }
              }
          }
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts v4.4.1 (utils/Strings.sol)
      pragma solidity ^0.8.0;
      /**
       * @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);
          }
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
      pragma solidity ^0.8.0;
      import "./IERC165.sol";
      /**
       * @dev Implementation of the {IERC165} interface.
       *
       * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
       * for the additional interface id that will be supported. For example:
       *
       * ```solidity
       * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
       *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
       * }
       * ```
       *
       * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
       */
      abstract contract ERC165 is IERC165 {
          /**
           * @dev See {IERC165-supportsInterface}.
           */
          function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
              return interfaceId == type(IERC165).interfaceId;
          }
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
      pragma solidity ^0.8.0;
      /**
       * @dev Interface of the ERC165 standard, as defined in the
       * https://eips.ethereum.org/EIPS/eip-165[EIP].
       *
       * Implementers can declare support of contract interfaces, which can then be
       * queried by others ({ERC165Checker}).
       *
       * For an implementation, see {ERC165}.
       */
      interface IERC165 {
          /**
           * @dev Returns true if this contract implements the interface defined by
           * `interfaceId`. See the corresponding
           * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
           * to learn more about how these ids are created.
           *
           * This function call must use less than 30 000 gas.
           */
          function supportsInterface(bytes4 interfaceId) external view returns (bool);
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts v4.4.1 (interfaces/IERC165.sol)
      pragma solidity ^0.8.0;
      import "../utils/introspection/IERC165.sol";
      

      File 3 of 3: CustomizationSelectorURIRenderer
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts v4.4.1 (interfaces/IERC165.sol)
      pragma solidity ^0.8.0;
      import "../utils/introspection/IERC165.sol";
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/IERC721.sol)
      pragma solidity ^0.8.0;
      import "../../utils/introspection/IERC165.sol";
      /**
       * @dev Required interface of an ERC721 compliant contract.
       */
      interface IERC721 is IERC165 {
          /**
           * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
           */
          event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
          /**
           * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
           */
          event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
          /**
           * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
           */
          event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
          /**
           * @dev Returns the number of tokens in ``owner``'s account.
           */
          function balanceOf(address owner) external view returns (uint256 balance);
          /**
           * @dev Returns the owner of the `tokenId` token.
           *
           * Requirements:
           *
           * - `tokenId` must exist.
           */
          function ownerOf(uint256 tokenId) external view returns (address owner);
          /**
           * @dev Safely transfers `tokenId` token from `from` to `to`.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must exist and be owned by `from`.
           * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
           * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
           *
           * Emits a {Transfer} event.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId,
              bytes calldata data
          ) external;
          /**
           * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
           * are aware of the ERC721 protocol to prevent tokens from being forever locked.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must exist and be owned by `from`.
           * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}.
           * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
           *
           * Emits a {Transfer} event.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId
          ) external;
          /**
           * @dev Transfers `tokenId` token from `from` to `to`.
           *
           * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must be owned by `from`.
           * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
           *
           * Emits a {Transfer} event.
           */
          function transferFrom(
              address from,
              address to,
              uint256 tokenId
          ) external;
          /**
           * @dev Gives permission to `to` to transfer `tokenId` token to another account.
           * The approval is cleared when the token is transferred.
           *
           * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
           *
           * Requirements:
           *
           * - The caller must own the token or be an approved operator.
           * - `tokenId` must exist.
           *
           * Emits an {Approval} event.
           */
          function approve(address to, uint256 tokenId) external;
          /**
           * @dev Approve or remove `operator` as an operator for the caller.
           * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
           *
           * Requirements:
           *
           * - The `operator` cannot be the caller.
           *
           * Emits an {ApprovalForAll} event.
           */
          function setApprovalForAll(address operator, bool _approved) external;
          /**
           * @dev Returns the account approved for `tokenId` token.
           *
           * Requirements:
           *
           * - `tokenId` must exist.
           */
          function getApproved(uint256 tokenId) external view returns (address operator);
          /**
           * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
           *
           * See {setApprovalForAll}
           */
          function isApprovedForAll(address owner, address operator) external view returns (bool);
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
      pragma solidity ^0.8.0;
      import "./IERC165.sol";
      /**
       * @dev Implementation of the {IERC165} interface.
       *
       * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
       * for the additional interface id that will be supported. For example:
       *
       * ```solidity
       * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
       *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
       * }
       * ```
       *
       * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
       */
      abstract contract ERC165 is IERC165 {
          /**
           * @dev See {IERC165-supportsInterface}.
           */
          function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
              return interfaceId == type(IERC165).interfaceId;
          }
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
      pragma solidity ^0.8.0;
      /**
       * @dev Interface of the ERC165 standard, as defined in the
       * https://eips.ethereum.org/EIPS/eip-165[EIP].
       *
       * Implementers can declare support of contract interfaces, which can then be
       * queried by others ({ERC165Checker}).
       *
       * For an implementation, see {ERC165}.
       */
      interface IERC165 {
          /**
           * @dev Returns true if this contract implements the interface defined by
           * `interfaceId`. See the corresponding
           * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
           * to learn more about how these ids are created.
           *
           * This function call must use less than 30 000 gas.
           */
          function supportsInterface(bytes4 interfaceId) external view returns (bool);
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
      pragma solidity ^0.8.0;
      /**
       * @dev String operations.
       */
      library Strings {
          bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
          uint8 private constant _ADDRESS_LENGTH = 20;
          /**
           * @dev Converts a `uint256` to its ASCII `string` decimal representation.
           */
          function toString(uint256 value) internal pure returns (string memory) {
              // Inspired by OraclizeAPI's implementation - MIT licence
              // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
              if (value == 0) {
                  return "0";
              }
              uint256 temp = value;
              uint256 digits;
              while (temp != 0) {
                  digits++;
                  temp /= 10;
              }
              bytes memory buffer = new bytes(digits);
              while (value != 0) {
                  digits -= 1;
                  buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                  value /= 10;
              }
              return string(buffer);
          }
          /**
           * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
           */
          function toHexString(uint256 value) internal pure returns (string memory) {
              if (value == 0) {
                  return "0x00";
              }
              uint256 temp = value;
              uint256 length = 0;
              while (temp != 0) {
                  length++;
                  temp >>= 8;
              }
              return toHexString(value, length);
          }
          /**
           * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
           */
          function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
              bytes memory buffer = new bytes(2 * length + 2);
              buffer[0] = "0";
              buffer[1] = "x";
              for (uint256 i = 2 * length + 1; i > 1; --i) {
                  buffer[i] = _HEX_SYMBOLS[value & 0xf];
                  value >>= 4;
              }
              require(value == 0, "Strings: hex length insufficient");
              return string(buffer);
          }
          /**
           * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
           */
          function toHexString(address addr) internal pure returns (string memory) {
              return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.4;
      import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
      import "@openzeppelin/contracts/utils/Strings.sol";
      import "@openzeppelin/contracts/utils/introspection/ERC165.sol";
      import { LibBitmap } from "solady/src/utils/LibBitmap.sol";
      import "./IRebelsRenderer.sol";
      contract CustomizationSelectorURIRenderer is IRebelsRenderer, ERC165 {
          using LibBitmap for LibBitmap.Bitmap;
          string public normalModeBaseURI;
          string public nightModeBaseURI;
          string public ultraModeBaseURI;
          IERC721 public rebelsNFT;
          // Bit maps to store night and ultra mode status for each token
          LibBitmap.Bitmap nightModeEnabled;
          LibBitmap.Bitmap ultraModeEnabled;
          constructor(string memory normalModeBaseURI_, string memory nightModeBaseURI_, string memory ultraModeBaseURI_, address nftAddress) {
              require(nftAddress != address(0), "NFT address cannot be the zero address");
              normalModeBaseURI = normalModeBaseURI_;
              nightModeBaseURI = nightModeBaseURI_;
              ultraModeBaseURI = ultraModeBaseURI_;
              rebelsNFT = IERC721(nftAddress);
          }
          function tokenURI(uint256 id) external view override returns (string memory) {
              string memory idStr = Strings.toString(id);
              string memory suffix = ".json";
              if (getNightMode(id)) {
                  suffix = "-night.json";
                  return string(abi.encodePacked(nightModeBaseURI, idStr, suffix));
              } else if (getUltraMode(id)) {
                  suffix = "-ultra.json";
                  return string(abi.encodePacked(ultraModeBaseURI, idStr, suffix));
              }
              return string(abi.encodePacked(normalModeBaseURI, idStr, suffix));
          }
          function beforeTokenTransfer(address from, address to, uint256 id) external pure override {}
          function supportsInterface(bytes4 interfaceId) public view override(ERC165, IERC165) returns (bool) {
              return interfaceId == type(IRebelsRenderer).interfaceId || super.supportsInterface(interfaceId);
          }
          function setNightMode(uint256 id) external {
              require(rebelsNFT.ownerOf(id) == msg.sender, "Not token owner");
              nightModeEnabled.set(id);
              if (getUltraMode(id)) {
                  ultraModeEnabled.unset(id);
              }
          }
          function unsetNightMode(uint256 id) external {
              require(rebelsNFT.ownerOf(id) == msg.sender, "Not token owner");
              nightModeEnabled.unset(id);
          }
          function setUltraMode(uint256 id) external {
              require(rebelsNFT.ownerOf(id) == msg.sender, "Not token owner");
              ultraModeEnabled.set(id);
              if (nightModeEnabled.get(id)) {
                  nightModeEnabled.unset(id);
              }
          }
          function unsetUltraMode(uint256 id) external {
              require(rebelsNFT.ownerOf(id) == msg.sender, "Not token owner");
              ultraModeEnabled.unset(id);
          }
          function getNightMode(uint256 id) public view returns (bool) {
              return nightModeEnabled.get(id);
          }
          function getUltraMode(uint256 id) public view returns (bool) {
              return ultraModeEnabled.get(id);
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.4;
      import "@openzeppelin/contracts/interfaces/IERC165.sol";
      interface IRebelsRenderer is IERC165 {
        function tokenURI(uint256 id) external view returns (string memory);
        function beforeTokenTransfer(address from, address to, uint256 id) external;
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.4;
      /// @notice Library for bit twiddling and boolean operations.
      /// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/LibBit.sol)
      /// @author Inspired by (https://graphics.stanford.edu/~seander/bithacks.html)
      library LibBit {
          /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
          /*                  BIT TWIDDLING OPERATIONS                  */
          /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
          /// @dev Find last set.
          /// Returns the index of the most significant bit of `x`,
          /// counting from the least significant bit position.
          /// If `x` is zero, returns 256.
          /// Equivalent to `log2(x)`, but without reverting for the zero case.
          function fls(uint256 x) internal pure returns (uint256 r) {
              /// @solidity memory-safe-assembly
              assembly {
                  r := shl(8, iszero(x))
                  r := or(r, shl(7, lt(0xffffffffffffffffffffffffffffffff, x)))
                  r := or(r, shl(6, lt(0xffffffffffffffff, shr(r, x))))
                  r := or(r, shl(5, lt(0xffffffff, shr(r, x))))
                  // For the remaining 32 bits, use a De Bruijn lookup.
                  x := shr(r, x)
                  x := or(x, shr(1, x))
                  x := or(x, shr(2, x))
                  x := or(x, shr(4, x))
                  x := or(x, shr(8, x))
                  x := or(x, shr(16, x))
                  // forgefmt: disable-next-item
                  r := or(r, byte(shr(251, mul(x, shl(224, 0x07c4acdd))),
                      0x0009010a0d15021d0b0e10121619031e080c141c0f111807131b17061a05041f))
              }
          }
          /// @dev Count leading zeros.
          /// Returns the number of zeros preceding the most significant one bit.
          /// If `x` is zero, returns 256.
          function clz(uint256 x) internal pure returns (uint256 r) {
              /// @solidity memory-safe-assembly
              assembly {
                  let t := add(iszero(x), 255)
                  r := shl(7, lt(0xffffffffffffffffffffffffffffffff, x))
                  r := or(r, shl(6, lt(0xffffffffffffffff, shr(r, x))))
                  r := or(r, shl(5, lt(0xffffffff, shr(r, x))))
                  // For the remaining 32 bits, use a De Bruijn lookup.
                  x := shr(r, x)
                  x := or(x, shr(1, x))
                  x := or(x, shr(2, x))
                  x := or(x, shr(4, x))
                  x := or(x, shr(8, x))
                  x := or(x, shr(16, x))
                  // forgefmt: disable-next-item
                  r := sub(t, or(r, byte(shr(251, mul(x, shl(224, 0x07c4acdd))),
                      0x0009010a0d15021d0b0e10121619031e080c141c0f111807131b17061a05041f)))
              }
          }
          /// @dev Find first set.
          /// Returns the index of the least significant bit of `x`,
          /// counting from the least significant bit position.
          /// If `x` is zero, returns 256.
          /// Equivalent to `ctz` (count trailing zeros), which gives
          /// the number of zeros following the least significant one bit.
          function ffs(uint256 x) internal pure returns (uint256 r) {
              /// @solidity memory-safe-assembly
              assembly {
                  r := shl(8, iszero(x))
                  // Isolate the least significant bit.
                  x := and(x, add(not(x), 1))
                  r := or(r, shl(7, lt(0xffffffffffffffffffffffffffffffff, x)))
                  r := or(r, shl(6, lt(0xffffffffffffffff, shr(r, x))))
                  r := or(r, shl(5, lt(0xffffffff, shr(r, x))))
                  // For the remaining 32 bits, use a De Bruijn lookup.
                  // forgefmt: disable-next-item
                  r := or(r, byte(shr(251, mul(shr(r, x), shl(224, 0x077cb531))), 
                      0x00011c021d0e18031e16140f191104081f1b0d17151310071a0c12060b050a09))
              }
          }
          /// @dev Returns the number of set bits in `x`.
          function popCount(uint256 x) internal pure returns (uint256 c) {
              /// @solidity memory-safe-assembly
              assembly {
                  let max := not(0)
                  let isMax := eq(x, max)
                  x := sub(x, and(shr(1, x), div(max, 3)))
                  x := add(and(x, div(max, 5)), and(shr(2, x), div(max, 5)))
                  x := and(add(x, shr(4, x)), div(max, 17))
                  c := or(shl(8, isMax), shr(248, mul(x, div(max, 255))))
              }
          }
          /// @dev Returns whether `x` is a power of 2.
          function isPo2(uint256 x) internal pure returns (bool result) {
              /// @solidity memory-safe-assembly
              assembly {
                  // Equivalent to `x && !(x & (x - 1))`.
                  result := iszero(add(and(x, sub(x, 1)), iszero(x)))
              }
          }
          /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
          /*                     BOOLEAN OPERATIONS                     */
          /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
          /// @dev Returns `x & y`.
          function and(bool x, bool y) internal pure returns (bool z) {
              /// @solidity memory-safe-assembly
              assembly {
                  z := and(x, y)
              }
          }
          /// @dev Returns `x | y`.
          function or(bool x, bool y) internal pure returns (bool z) {
              /// @solidity memory-safe-assembly
              assembly {
                  z := or(x, y)
              }
          }
          /// @dev Returns a non-zero number if `b` is true, else 0.
          /// If `b` is from plain Solidity, the non-zero number will be 1.
          function toUint(bool b) internal pure returns (uint256 z) {
              /// @solidity memory-safe-assembly
              assembly {
                  z := b
              }
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.4;
      import "./LibBit.sol";
      /// @notice Library for storage of packed unsigned booleans.
      /// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/LibBitmap.sol)
      /// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/LibBitmap.sol)
      /// @author Modified from Solidity-Bits (https://github.com/estarriolvetch/solidity-bits/blob/main/contracts/BitMaps.sol)
      library LibBitmap {
          /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
          /*                         CONSTANTS                          */
          /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
          /// @dev The constant returned when a bitmap scan does not find a result.
          uint256 internal constant NOT_FOUND = type(uint256).max;
          /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
          /*                          STRUCTS                           */
          /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
          /// @dev A bitmap in storage.
          struct Bitmap {
              mapping(uint256 => uint256) map;
          }
          /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
          /*                         OPERATIONS                         */
          /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
          /// @dev Returns the boolean value of the bit at `index` in `bitmap`.
          function get(Bitmap storage bitmap, uint256 index) internal view returns (bool isSet) {
              // It is better to set `isSet` to either 0 or 1, than zero vs non-zero.
              // Both cost the same amount of gas, but the former allows the returned value
              // to be reused without cleaning the upper bits.
              uint256 b = (bitmap.map[index >> 8] >> (index & 0xff)) & 1;
              /// @solidity memory-safe-assembly
              assembly {
                  isSet := b
              }
          }
          /// @dev Updates the bit at `index` in `bitmap` to true.
          function set(Bitmap storage bitmap, uint256 index) internal {
              bitmap.map[index >> 8] |= (1 << (index & 0xff));
          }
          /// @dev Updates the bit at `index` in `bitmap` to false.
          function unset(Bitmap storage bitmap, uint256 index) internal {
              bitmap.map[index >> 8] &= ~(1 << (index & 0xff));
          }
          /// @dev Flips the bit at `index` in `bitmap`.
          /// Returns the boolean result of the flipped bit.
          function toggle(Bitmap storage bitmap, uint256 index) internal returns (bool newIsSet) {
              /// @solidity memory-safe-assembly
              assembly {
                  mstore(0x00, shr(8, index))
                  mstore(0x20, bitmap.slot)
                  let storageSlot := keccak256(0x00, 0x40)
                  let shift := and(index, 0xff)
                  let storageValue := sload(storageSlot)
                  let mask := shl(shift, 1)
                  storageValue := xor(storageValue, mask)
                  // It makes sense to return the `newIsSet`,
                  // as it allow us to skip an additional warm `sload`,
                  // and it costs minimal gas (about 15),
                  // which may be optimized away if the returned value is unused.
                  newIsSet := iszero(iszero(and(storageValue, mask)))
                  sstore(storageSlot, storageValue)
              }
          }
          /// @dev Updates the bit at `index` in `bitmap` to `shouldSet`.
          function setTo(Bitmap storage bitmap, uint256 index, bool shouldSet) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  mstore(0x20, bitmap.slot)
                  mstore(0x00, shr(8, index))
                  let storageSlot := keccak256(0x00, 0x40)
                  let storageValue := sload(storageSlot)
                  let shift := and(index, 0xff)
                  sstore(
                      storageSlot,
                      // Unsets the bit at `shift` via `and`, then sets its new value via `or`.
                      or(and(storageValue, not(shl(shift, 1))), shl(shift, iszero(iszero(shouldSet))))
                  )
              }
          }
          /// @dev Consecutively sets `amount` of bits starting from the bit at `start`.
          function setBatch(Bitmap storage bitmap, uint256 start, uint256 amount) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  let max := not(0)
                  let shift := and(start, 0xff)
                  mstore(0x20, bitmap.slot)
                  mstore(0x00, shr(8, start))
                  if iszero(lt(add(shift, amount), 257)) {
                      let storageSlot := keccak256(0x00, 0x40)
                      sstore(storageSlot, or(sload(storageSlot), shl(shift, max)))
                      let bucket := add(mload(0x00), 1)
                      let bucketEnd := add(mload(0x00), shr(8, add(amount, shift)))
                      amount := and(add(amount, shift), 0xff)
                      shift := 0
                      for {} iszero(eq(bucket, bucketEnd)) { bucket := add(bucket, 1) } {
                          mstore(0x00, bucket)
                          sstore(keccak256(0x00, 0x40), max)
                      }
                      mstore(0x00, bucket)
                  }
                  let storageSlot := keccak256(0x00, 0x40)
                  sstore(storageSlot, or(sload(storageSlot), shl(shift, shr(sub(256, amount), max))))
              }
          }
          /// @dev Consecutively unsets `amount` of bits starting from the bit at `start`.
          function unsetBatch(Bitmap storage bitmap, uint256 start, uint256 amount) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  let shift := and(start, 0xff)
                  mstore(0x20, bitmap.slot)
                  mstore(0x00, shr(8, start))
                  if iszero(lt(add(shift, amount), 257)) {
                      let storageSlot := keccak256(0x00, 0x40)
                      sstore(storageSlot, and(sload(storageSlot), not(shl(shift, not(0)))))
                      let bucket := add(mload(0x00), 1)
                      let bucketEnd := add(mload(0x00), shr(8, add(amount, shift)))
                      amount := and(add(amount, shift), 0xff)
                      shift := 0
                      for {} iszero(eq(bucket, bucketEnd)) { bucket := add(bucket, 1) } {
                          mstore(0x00, bucket)
                          sstore(keccak256(0x00, 0x40), 0)
                      }
                      mstore(0x00, bucket)
                  }
                  let storageSlot := keccak256(0x00, 0x40)
                  sstore(
                      storageSlot, and(sload(storageSlot), not(shl(shift, shr(sub(256, amount), not(0)))))
                  )
              }
          }
          /// @dev Returns number of set bits within a range by
          /// scanning `amount` of bits starting from the bit at `start`.
          function popCount(Bitmap storage bitmap, uint256 start, uint256 amount)
              internal
              view
              returns (uint256 count)
          {
              unchecked {
                  uint256 bucket = start >> 8;
                  uint256 shift = start & 0xff;
                  if (!(amount + shift < 257)) {
                      count = LibBit.popCount(bitmap.map[bucket] >> shift);
                      uint256 bucketEnd = bucket + ((amount + shift) >> 8);
                      amount = (amount + shift) & 0xff;
                      shift = 0;
                      for (++bucket; bucket != bucketEnd; ++bucket) {
                          count += LibBit.popCount(bitmap.map[bucket]);
                      }
                  }
                  count += LibBit.popCount((bitmap.map[bucket] >> shift) << (256 - amount));
              }
          }
          /// @dev Returns the index of the most significant set bit before the bit at `before`.
          /// If no set bit is found, returns `NOT_FOUND`.
          function findLastSet(Bitmap storage bitmap, uint256 before)
              internal
              view
              returns (uint256 setBitIndex)
          {
              uint256 bucket;
              uint256 bucketBits;
              /// @solidity memory-safe-assembly
              assembly {
                  setBitIndex := not(0)
                  bucket := shr(8, before)
                  mstore(0x00, bucket)
                  mstore(0x20, bitmap.slot)
                  let offset := and(0xff, not(before)) // `256 - (255 & before) - 1`.
                  bucketBits := shr(offset, shl(offset, sload(keccak256(0x00, 0x40))))
                  if iszero(bucketBits) {
                      for {} bucket {} {
                          bucket := add(bucket, setBitIndex) // `sub(bucket, 1)`.
                          mstore(0x00, bucket)
                          bucketBits := sload(keccak256(0x00, 0x40))
                          if bucketBits { break }
                      }
                  }
              }
              if (bucketBits != 0) {
                  setBitIndex = (bucket << 8) | LibBit.fls(bucketBits);
                  /// @solidity memory-safe-assembly
                  assembly {
                      setBitIndex := or(setBitIndex, sub(0, gt(setBitIndex, before)))
                  }
              }
          }
      }