Token

Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;

/** ****************************************************************************
 * @notice Interface for contracts using VRF randomness
 * *****************************************************************************
 * @dev PURPOSE
 *
 * @dev Reggie the Random Oracle (not his real job) wants to provide randomness
 * @dev to Vera the verifier in such a way that Vera can be sure he's not
 * @dev making his output up to suit himself. Reggie provides Vera a public key
 * @dev to which he knows the secret key. Each time Vera provides a seed to
 * @dev Reggie, he gives back a value which is computed completely
 * @dev deterministically from the seed and the secret key.
 *
 * @dev Reggie provides a proof by which Vera can verify that the output was
 * @dev correctly computed once Reggie tells it to her, but without that proof,
 * @dev the output is indistinguishable to her from a uniform random sample
 * @dev from the output space.
 *
 * @dev The purpose of this contract is to make it easy for unrelated contracts
 * @dev to talk to Vera the verifier about the work Reggie is doing, to provide
 * @dev simple access to a verifiable source of randomness. It ensures 2 things:
 * @dev 1. The fulfillment came from the VRFCoordinator
 * @dev 2. The consumer contract implements fulfillRandomWords.
 * *****************************************************************************
 * @dev USAGE
 *
 * @dev Calling contracts must inherit from VRFConsumerBase, and can
 * @dev initialize VRFConsumerBase's attributes in their constructor as
 * @dev shown:
 *
 * @dev   contract VRFConsumer {
 * @dev     constructor(<other arguments>, address _vrfCoordinator, address _link)
 * @dev       VRFConsumerBase(_vrfCoordinator) public {
 * @dev         <initialization with other arguments goes here>
 * @dev       }
 * @dev   }
 *
 * @dev The oracle will have given you an ID for the VRF keypair they have
 * @dev committed to (let's call it keyHash). Create subscription, fund it
 * @dev and your consumer contract as a consumer of it (see VRFCoordinatorInterface
 * @dev subscription management functions).
 * @dev Call requestRandomWords(keyHash, subId, minimumRequestConfirmations,
 * @dev callbackGasLimit, numWords),
 * @dev see (VRFCoordinatorInterface for a description of the arguments).
 *
 * @dev Once the VRFCoordinator has received and validated the oracle's response
 * @dev to your request, it will call your contract's fulfillRandomWords method.
 *
 * @dev The randomness argument to fulfillRandomWords is a set of random words
 * @dev generated from your requestId and the blockHash of the request.
 *
 * @dev If your contract could have concurrent requests open, you can use the
 * @dev requestId returned from requestRandomWords to track which response is associated
 * @dev with which randomness request.
 * @dev See "SECURITY CONSIDERATIONS" for principles to keep in mind,
 * @dev if your contract could have multiple requests in flight simultaneously.
 *
 * @dev Colliding `requestId`s are cryptographically impossible as long as seeds
 * @dev differ.
 *
 * *****************************************************************************
 * @dev SECURITY CONSIDERATIONS
 *
 * @dev A method with the ability to call your fulfillRandomness method directly
 * @dev could spoof a VRF response with any random value, so it's critical that
 * @dev it cannot be directly called by anything other than this base contract
 * @dev (specifically, by the VRFConsumerBase.rawFulfillRandomness method).
 *
 * @dev For your users to trust that your contract's random behavior is free
 * @dev from malicious interference, it's best if you can write it so that all
 * @dev behaviors implied by a VRF response are executed *during* your
 * @dev fulfillRandomness method. If your contract must store the response (or
 * @dev anything derived from it) and use it later, you must ensure that any
 * @dev user-significant behavior which depends on that stored value cannot be
 * @dev manipulated by a subsequent VRF request.
 *
 * @dev Similarly, both miners and the VRF oracle itself have some influence
 * @dev over the order in which VRF responses appear on the blockchain, so if
 * @dev your contract could have multiple VRF requests in flight simultaneously,
 * @dev you must ensure that the order in which the VRF responses arrive cannot
 * @dev be used to manipulate your contract's user-significant behavior.
 *
 * @dev Since the block hash of the block which contains the requestRandomness
 * @dev call is mixed into the input to the VRF *last*, a sufficiently powerful
 * @dev miner could, in principle, fork the blockchain to evict the block
 * @dev containing the request, forcing the request to be included in a
 * @dev different block with a different hash, and therefore a different input
 * @dev to the VRF. However, such an attack would incur a substantial economic
 * @dev cost. This cost scales with the number of blocks the VRF oracle waits
 * @dev until it calls responds to a request. It is for this reason that
 * @dev that you can signal to an oracle you'd like them to wait longer before
 * @dev responding to the request (however this is not enforced in the contract
 * @dev and so remains effective only in the case of unmodified oracle software).
 */
abstract contract VRFConsumerBaseV2 {
  error OnlyCoordinatorCanFulfill(address have, address want);
  address private immutable vrfCoordinator;

  /**
   * @param _vrfCoordinator address of VRFCoordinator contract
   */
  constructor(address _vrfCoordinator) {
    vrfCoordinator = _vrfCoordinator;
  }

  /**
   * @notice fulfillRandomness handles the VRF response. Your contract must
   * @notice implement it. See "SECURITY CONSIDERATIONS" above for important
   * @notice principles to keep in mind when implementing your fulfillRandomness
   * @notice method.
   *
   * @dev VRFConsumerBaseV2 expects its subcontracts to have a method with this
   * @dev signature, and will call it once it has verified the proof
   * @dev associated with the randomness. (It is triggered via a call to
   * @dev rawFulfillRandomness, below.)
   *
   * @param requestId The Id initially returned by requestRandomness
   * @param randomWords the VRF output expanded to the requested number of words
   */
  function fulfillRandomWords(uint256 requestId, uint256[] memory randomWords) internal virtual;

  // rawFulfillRandomness is called by VRFCoordinator when it receives a valid VRF
  // proof. rawFulfillRandomness then calls fulfillRandomness, after validating
  // the origin of the call
  function rawFulfillRandomWords(uint256 requestId, uint256[] memory randomWords) external {
    if (msg.sender != vrfCoordinator) {
      revert OnlyCoordinatorCanFulfill(msg.sender, vrfCoordinator);
    }
    fulfillRandomWords(requestId, randomWords);
  }
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

interface VRFCoordinatorV2Interface {
  /**
   * @notice Get configuration relevant for making requests
   * @return minimumRequestConfirmations global min for request confirmations
   * @return maxGasLimit global max for request gas limit
   * @return s_provingKeyHashes list of registered key hashes
   */
  function getRequestConfig()
    external
    view
    returns (
      uint16,
      uint32,
      bytes32[] memory
    );

  /**
   * @notice Request a set of random words.
   * @param keyHash - Corresponds to a particular oracle job which uses
   * that key for generating the VRF proof. Different keyHash's have different gas price
   * ceilings, so you can select a specific one to bound your maximum per request cost.
   * @param subId  - The ID of the VRF subscription. Must be funded
   * with the minimum subscription balance required for the selected keyHash.
   * @param minimumRequestConfirmations - How many blocks you'd like the
   * oracle to wait before responding to the request. See SECURITY CONSIDERATIONS
   * for why you may want to request more. The acceptable range is
   * [minimumRequestBlockConfirmations, 200].
   * @param callbackGasLimit - How much gas you'd like to receive in your
   * fulfillRandomWords callback. Note that gasleft() inside fulfillRandomWords
   * may be slightly less than this amount because of gas used calling the function
   * (argument decoding etc.), so you may need to request slightly more than you expect
   * to have inside fulfillRandomWords. The acceptable range is
   * [0, maxGasLimit]
   * @param numWords - The number of uint256 random values you'd like to receive
   * in your fulfillRandomWords callback. Note these numbers are expanded in a
   * secure way by the VRFCoordinator from a single random value supplied by the oracle.
   * @return requestId - A unique identifier of the request. Can be used to match
   * a request to a response in fulfillRandomWords.
   */
  function requestRandomWords(
    bytes32 keyHash,
    uint64 subId,
    uint16 minimumRequestConfirmations,
    uint32 callbackGasLimit,
    uint32 numWords
  ) external returns (uint256 requestId);

  /**
   * @notice Create a VRF subscription.
   * @return subId - A unique subscription id.
   * @dev You can manage the consumer set dynamically with addConsumer/removeConsumer.
   * @dev Note to fund the subscription, use transferAndCall. For example
   * @dev  LINKTOKEN.transferAndCall(
   * @dev    address(COORDINATOR),
   * @dev    amount,
   * @dev    abi.encode(subId));
   */
  function createSubscription() external returns (uint64 subId);

  /**
   * @notice Get a VRF subscription.
   * @param subId - ID of the subscription
   * @return balance - LINK balance of the subscription in juels.
   * @return reqCount - number of requests for this subscription, determines fee tier.
   * @return owner - owner of the subscription.
   * @return consumers - list of consumer address which are able to use this subscription.
   */
  function getSubscription(uint64 subId)
    external
    view
    returns (
      uint96 balance,
      uint64 reqCount,
      address owner,
      address[] memory consumers
    );

  /**
   * @notice Request subscription owner transfer.
   * @param subId - ID of the subscription
   * @param newOwner - proposed new owner of the subscription
   */
  function requestSubscriptionOwnerTransfer(uint64 subId, address newOwner) external;

  /**
   * @notice Request subscription owner transfer.
   * @param subId - ID of the subscription
   * @dev will revert if original owner of subId has
   * not requested that msg.sender become the new owner.
   */
  function acceptSubscriptionOwnerTransfer(uint64 subId) external;

  /**
   * @notice Add a consumer to a VRF subscription.
   * @param subId - ID of the subscription
   * @param consumer - New consumer which can use the subscription
   */
  function addConsumer(uint64 subId, address consumer) external;

  /**
   * @notice Remove a consumer from a VRF subscription.
   * @param subId - ID of the subscription
   * @param consumer - Consumer to remove from the subscription
   */
  function removeConsumer(uint64 subId, address consumer) external;

  /**
   * @notice Cancel a subscription
   * @param subId - ID of the subscription
   * @param to - Where to send the remaining LINK to
   */
  function cancelSubscription(uint64 subId, address to) external;

  /*
   * @notice Check to see if there exists a request commitment consumers
   * for all consumers and keyhashes for a given sub.
   * @param subId - ID of the subscription
   * @return true if there exists at least one unfulfilled request for the subscription, false
   * otherwise.
   */
  function pendingRequestExists(uint64 subId) external view returns (bool);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (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 Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        _checkOwner();
        _;
    }

    /**
     * @dev Returns the address of the current owner.
     */
    function owner() public view virtual returns (address) {
        return _owner;
    }

    /**
     * @dev Throws if the sender is not the owner.
     */
    function _checkOwner() internal view virtual {
        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) (interfaces/IERC2981.sol)

pragma solidity ^0.8.0;

import "../utils/introspection/IERC165.sol";

/**
 * @dev Interface for the NFT Royalty Standard.
 *
 * A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal
 * support for royalty payments across all NFT marketplaces and ecosystem participants.
 *
 * _Available since v4.5._
 */
interface IERC2981 is IERC165 {
    /**
     * @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of
     * exchange. The royalty amount is denominated and should be paid in that same unit of exchange.
     */
    function royaltyInfo(uint256 tokenId, uint256 salePrice)
        external
        view
        returns (address receiver, uint256 royaltyAmount);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.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: address zero is not a valid owner");
        return _balances[owner];
    }

    /**
     * @dev See {IERC721-ownerOf}.
     */
    function ownerOf(uint256 tokenId) public view virtual override returns (address) {
        address owner = _ownerOf(tokenId);
        require(owner != address(0), "ERC721: invalid token ID");
        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) {
        _requireMinted(tokenId);

        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 token owner or approved for all"
        );

        _approve(to, tokenId);
    }

    /**
     * @dev See {IERC721-getApproved}.
     */
    function getApproved(uint256 tokenId) public view virtual override returns (address) {
        _requireMinted(tokenId);

        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: caller is not token owner or 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: caller is not token owner or 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 the owner of the `tokenId`. Does NOT revert if token doesn't exist
     */
    function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
        return _owners[tokenId];
    }

    /**
     * @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 _ownerOf(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) {
        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, 1);

        // Check that tokenId was not minted by `_beforeTokenTransfer` hook
        require(!_exists(tokenId), "ERC721: token already minted");

        unchecked {
            // Will not overflow unless all 2**256 token ids are minted to the same owner.
            // Given that tokens are minted one by one, it is impossible in practice that
            // this ever happens. Might change if we allow batch minting.
            // The ERC fails to describe this case.
            _balances[to] += 1;
        }

        _owners[tokenId] = to;

        emit Transfer(address(0), to, tokenId);

        _afterTokenTransfer(address(0), to, tokenId, 1);
    }

    /**
     * @dev Destroys `tokenId`.
     * The approval is cleared when the token is burned.
     * This is an internal function that does not check if the sender is authorized to operate on the token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     *
     * Emits a {Transfer} event.
     */
    function _burn(uint256 tokenId) internal virtual {
        address owner = ERC721.ownerOf(tokenId);

        _beforeTokenTransfer(owner, address(0), tokenId, 1);

        // Update ownership in case tokenId was transferred by `_beforeTokenTransfer` hook
        owner = ERC721.ownerOf(tokenId);

        // Clear approvals
        delete _tokenApprovals[tokenId];

        unchecked {
            // Cannot overflow, as that would require more tokens to be burned/transferred
            // out than the owner initially received through minting and transferring in.
            _balances[owner] -= 1;
        }
        delete _owners[tokenId];

        emit Transfer(owner, address(0), tokenId);

        _afterTokenTransfer(owner, address(0), tokenId, 1);
    }

    /**
     * @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, 1);

        // Check that tokenId was not transferred by `_beforeTokenTransfer` hook
        require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");

        // Clear approvals from the previous owner
        delete _tokenApprovals[tokenId];

        unchecked {
            // `_balances[from]` cannot overflow for the same reason as described in `_burn`:
            // `from`'s balance is the number of token held, which is at least one before the current
            // transfer.
            // `_balances[to]` could overflow in the conditions described in `_mint`. That would require
            // all 2**256 token ids to be minted, which in practice is impossible.
            _balances[from] -= 1;
            _balances[to] += 1;
        }
        _owners[tokenId] = to;

        emit Transfer(from, to, tokenId);

        _afterTokenTransfer(from, to, tokenId, 1);
    }

    /**
     * @dev Approve `to` to operate on `tokenId`
     *
     * Emits an {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 an {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 Reverts if the `tokenId` has not been minted yet.
     */
    function _requireMinted(uint256 tokenId) internal view virtual {
        require(_exists(tokenId), "ERC721: invalid token ID");
    }

    /**
     * @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 {
                    /// @solidity memory-safe-assembly
                    assembly {
                        revert(add(32, reason), mload(reason))
                    }
                }
            }
        } else {
            return true;
        }
    }

    /**
     * @dev Hook that is called before any token transfer. This includes minting and burning. If {ERC721Consecutive} is
     * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, ``from``'s tokens will be transferred to `to`.
     * - When `from` is zero, the tokens will be minted for `to`.
     * - When `to` is zero, ``from``'s tokens will be burned.
     * - `from` and `to` are never both zero.
     * - `batchSize` is non-zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _beforeTokenTransfer(
        address from,
        address to,
        uint256, /* firstTokenId */
        uint256 batchSize
    ) internal virtual {
        if (batchSize > 1) {
            if (from != address(0)) {
                _balances[from] -= batchSize;
            }
            if (to != address(0)) {
                _balances[to] += batchSize;
            }
        }
    }

    /**
     * @dev Hook that is called after any token transfer. This includes minting and burning. If {ERC721Consecutive} is
     * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, ``from``'s tokens were transferred to `to`.
     * - When `from` is zero, the tokens were minted for `to`.
     * - When `to` is zero, ``from``'s tokens were burned.
     * - `from` and `to` are never both zero.
     * - `batchSize` is non-zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _afterTokenTransfer(
        address from,
        address to,
        uint256 firstTokenId,
        uint256 batchSize
    ) internal virtual {}
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.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: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
     * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
     * understand this adds an external call which potentially creates a reentrancy vulnerability.
     *
     * 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 (last updated v4.8.0) (token/ERC721/extensions/ERC721Royalty.sol)

pragma solidity ^0.8.0;

import "../ERC721.sol";
import "../../common/ERC2981.sol";
import "../../../utils/introspection/ERC165.sol";

/**
 * @dev Extension of ERC721 with the ERC2981 NFT Royalty Standard, a standardized way to retrieve royalty payment
 * information.
 *
 * Royalty information can be specified globally for all token ids via {ERC2981-_setDefaultRoyalty}, and/or individually for
 * specific token ids via {ERC2981-_setTokenRoyalty}. The latter takes precedence over the first.
 *
 * IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See
 * https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the EIP. Marketplaces are expected to
 * voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.
 *
 * _Available since v4.5._
 */
abstract contract ERC721Royalty is ERC2981, ERC721 {
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721, ERC2981) returns (bool) {
        return super.supportsInterface(interfaceId);
    }

    /**
     * @dev See {ERC721-_burn}. This override additionally clears the royalty information for the token.
     */
    function _burn(uint256 tokenId) internal virtual override {
        super._burn(tokenId);
        _resetTokenRoyalty(tokenId);
    }
}

// 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.7.0) (token/common/ERC2981.sol)

pragma solidity ^0.8.0;

import "../../interfaces/IERC2981.sol";
import "../../utils/introspection/ERC165.sol";

/**
 * @dev Implementation of the NFT Royalty Standard, a standardized way to retrieve royalty payment information.
 *
 * Royalty information can be specified globally for all token ids via {_setDefaultRoyalty}, and/or individually for
 * specific token ids via {_setTokenRoyalty}. The latter takes precedence over the first.
 *
 * Royalty is specified as a fraction of sale price. {_feeDenominator} is overridable but defaults to 10000, meaning the
 * fee is specified in basis points by default.
 *
 * IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See
 * https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the EIP. Marketplaces are expected to
 * voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.
 *
 * _Available since v4.5._
 */
abstract contract ERC2981 is IERC2981, ERC165 {
    struct RoyaltyInfo {
        address receiver;
        uint96 royaltyFraction;
    }

    RoyaltyInfo private _defaultRoyaltyInfo;
    mapping(uint256 => RoyaltyInfo) private _tokenRoyaltyInfo;

    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) {
        return interfaceId == type(IERC2981).interfaceId || super.supportsInterface(interfaceId);
    }

    /**
     * @inheritdoc IERC2981
     */
    function royaltyInfo(uint256 _tokenId, uint256 _salePrice) public view virtual override returns (address, uint256) {
        RoyaltyInfo memory royalty = _tokenRoyaltyInfo[_tokenId];

        if (royalty.receiver == address(0)) {
            royalty = _defaultRoyaltyInfo;
        }

        uint256 royaltyAmount = (_salePrice * royalty.royaltyFraction) / _feeDenominator();

        return (royalty.receiver, royaltyAmount);
    }

    /**
     * @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a
     * fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an
     * override.
     */
    function _feeDenominator() internal pure virtual returns (uint96) {
        return 10000;
    }

    /**
     * @dev Sets the royalty information that all ids in this contract will default to.
     *
     * Requirements:
     *
     * - `receiver` cannot be the zero address.
     * - `feeNumerator` cannot be greater than the fee denominator.
     */
    function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
        require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
        require(receiver != address(0), "ERC2981: invalid receiver");

        _defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator);
    }

    /**
     * @dev Removes default royalty information.
     */
    function _deleteDefaultRoyalty() internal virtual {
        delete _defaultRoyaltyInfo;
    }

    /**
     * @dev Sets the royalty information for a specific token id, overriding the global default.
     *
     * Requirements:
     *
     * - `receiver` cannot be the zero address.
     * - `feeNumerator` cannot be greater than the fee denominator.
     */
    function _setTokenRoyalty(
        uint256 tokenId,
        address receiver,
        uint96 feeNumerator
    ) internal virtual {
        require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
        require(receiver != address(0), "ERC2981: Invalid parameters");

        _tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator);
    }

    /**
     * @dev Resets royalty information for the token id back to the global default.
     */
    function _resetTokenRoyalty(uint256 tokenId) internal virtual {
        delete _tokenRoyaltyInfo[tokenId];
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.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 functionCallWithValue(target, data, 0, "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");
        (bool success, bytes memory returndata) = target.call{value: value}(data);
        return verifyCallResultFromTarget(target, 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) {
        (bool success, bytes memory returndata) = target.staticcall(data);
        return verifyCallResultFromTarget(target, 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) {
        (bool success, bytes memory returndata) = target.delegatecall(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
     * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
     *
     * _Available since v4.8._
     */
    function verifyCallResultFromTarget(
        address target,
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        if (success) {
            if (returndata.length == 0) {
                // only check isContract if the call was successful and the return data is empty
                // otherwise we already know that it was a contract
                require(isContract(target), "Address: call to non-contract");
            }
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    /**
     * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
     * revert reason or 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 {
            _revert(returndata, errorMessage);
        }
    }

    function _revert(bytes memory returndata, string memory errorMessage) private pure {
        // 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
            /// @solidity memory-safe-assembly
            assembly {
                let returndata_size := mload(returndata)
                revert(add(32, returndata), returndata_size)
            }
        } else {
            revert(errorMessage);
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (utils/Base64.sol)

pragma solidity ^0.8.0;

/**
 * @dev Provides a set of functions to operate with Base64 strings.
 *
 * _Available since v4.5._
 */
library Base64 {
    /**
     * @dev Base64 Encoding/Decoding Table
     */
    string internal constant _TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";

    /**
     * @dev Converts a `bytes` to its Bytes64 `string` representation.
     */
    function encode(bytes memory data) internal pure returns (string memory) {
        /**
         * Inspired by Brecht Devos (Brechtpd) implementation - MIT licence
         * https://github.com/Brechtpd/base64/blob/e78d9fd951e7b0977ddca77d92dc85183770daf4/base64.sol
         */
        if (data.length == 0) return "";

        // Loads the table into memory
        string memory table = _TABLE;

        // Encoding takes 3 bytes chunks of binary data from `bytes` data parameter
        // and split into 4 numbers of 6 bits.
        // The final Base64 length should be `bytes` data length multiplied by 4/3 rounded up
        // - `data.length + 2`  -> Round up
        // - `/ 3`              -> Number of 3-bytes chunks
        // - `4 *`              -> 4 characters for each chunk
        string memory result = new string(4 * ((data.length + 2) / 3));

        /// @solidity memory-safe-assembly
        assembly {
            // Prepare the lookup table (skip the first "length" byte)
            let tablePtr := add(table, 1)

            // Prepare result pointer, jump over length
            let resultPtr := add(result, 32)

            // Run over the input, 3 bytes at a time
            for {
                let dataPtr := data
                let endPtr := add(data, mload(data))
            } lt(dataPtr, endPtr) {

            } {
                // Advance 3 bytes
                dataPtr := add(dataPtr, 3)
                let input := mload(dataPtr)

                // To write each character, shift the 3 bytes (18 bits) chunk
                // 4 times in blocks of 6 bits for each character (18, 12, 6, 0)
                // and apply logical AND with 0x3F which is the number of
                // the previous character in the ASCII table prior to the Base64 Table
                // The result is then added to the table to get the character to write,
                // and finally write it in the result pointer but with a left shift
                // of 256 (1 byte) - 8 (1 ASCII char) = 248 bits

                mstore8(resultPtr, mload(add(tablePtr, and(shr(18, input), 0x3F))))
                resultPtr := add(resultPtr, 1) // Advance

                mstore8(resultPtr, mload(add(tablePtr, and(shr(12, input), 0x3F))))
                resultPtr := add(resultPtr, 1) // Advance

                mstore8(resultPtr, mload(add(tablePtr, and(shr(6, input), 0x3F))))
                resultPtr := add(resultPtr, 1) // Advance

                mstore8(resultPtr, mload(add(tablePtr, and(input, 0x3F))))
                resultPtr := add(resultPtr, 1) // Advance
            }

            // When data `bytes` is not exactly 3 bytes long
            // it is padded with `=` characters at the end
            switch mod(mload(data), 3)
            case 1 {
                mstore8(sub(resultPtr, 1), 0x3d)
                mstore8(sub(resultPtr, 2), 0x3d)
            }
            case 2 {
                mstore8(sub(resultPtr, 1), 0x3d)
            }
        }

        return result;
    }
}

// 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.8.0) (utils/Strings.sol)

pragma solidity ^0.8.0;

import "./math/Math.sol";

/**
 * @dev String operations.
 */
library Strings {
    bytes16 private constant _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) {
        unchecked {
            uint256 length = Math.log10(value) + 1;
            string memory buffer = new string(length);
            uint256 ptr;
            /// @solidity memory-safe-assembly
            assembly {
                ptr := add(buffer, add(32, length))
            }
            while (true) {
                ptr--;
                /// @solidity memory-safe-assembly
                assembly {
                    mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
                }
                value /= 10;
                if (value == 0) break;
            }
            return buffer;
        }
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
     */
    function toHexString(uint256 value) internal pure returns (string memory) {
        unchecked {
            return toHexString(value, Math.log256(value) + 1);
        }
    }

    /**
     * @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] = _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
// 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.8.0) (utils/math/Math.sol)

pragma solidity ^0.8.0;

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library Math {
    enum Rounding {
        Down, // Toward negative infinity
        Up, // Toward infinity
        Zero // Toward zero
    }

    /**
     * @dev Returns the largest of two numbers.
     */
    function max(uint256 a, uint256 b) internal pure returns (uint256) {
        return a > b ? a : b;
    }

    /**
     * @dev Returns the smallest of two numbers.
     */
    function min(uint256 a, uint256 b) internal pure returns (uint256) {
        return a < b ? a : b;
    }

    /**
     * @dev Returns the average of two numbers. The result is rounded towards
     * zero.
     */
    function average(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b) / 2 can overflow.
        return (a & b) + (a ^ b) / 2;
    }

    /**
     * @dev Returns the ceiling of the division of two numbers.
     *
     * This differs from standard division with `/` in that it rounds up instead
     * of rounding down.
     */
    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b - 1) / b can overflow on addition, so we distribute.
        return a == 0 ? 0 : (a - 1) / b + 1;
    }

    /**
     * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
     * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
     * with further edits by Uniswap Labs also under MIT license.
     */
    function mulDiv(
        uint256 x,
        uint256 y,
        uint256 denominator
    ) internal pure returns (uint256 result) {
        unchecked {
            // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
            // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
            // variables such that product = prod1 * 2^256 + prod0.
            uint256 prod0; // Least significant 256 bits of the product
            uint256 prod1; // Most significant 256 bits of the product
            assembly {
                let mm := mulmod(x, y, not(0))
                prod0 := mul(x, y)
                prod1 := sub(sub(mm, prod0), lt(mm, prod0))
            }

            // Handle non-overflow cases, 256 by 256 division.
            if (prod1 == 0) {
                return prod0 / denominator;
            }

            // Make sure the result is less than 2^256. Also prevents denominator == 0.
            require(denominator > prod1);

            ///////////////////////////////////////////////
            // 512 by 256 division.
            ///////////////////////////////////////////////

            // Make division exact by subtracting the remainder from [prod1 prod0].
            uint256 remainder;
            assembly {
                // Compute remainder using mulmod.
                remainder := mulmod(x, y, denominator)

                // Subtract 256 bit number from 512 bit number.
                prod1 := sub(prod1, gt(remainder, prod0))
                prod0 := sub(prod0, remainder)
            }

            // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
            // See https://cs.stackexchange.com/q/138556/92363.

            // Does not overflow because the denominator cannot be zero at this stage in the function.
            uint256 twos = denominator & (~denominator + 1);
            assembly {
                // Divide denominator by twos.
                denominator := div(denominator, twos)

                // Divide [prod1 prod0] by twos.
                prod0 := div(prod0, twos)

                // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
                twos := add(div(sub(0, twos), twos), 1)
            }

            // Shift in bits from prod1 into prod0.
            prod0 |= prod1 * twos;

            // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
            // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
            // four bits. That is, denominator * inv = 1 mod 2^4.
            uint256 inverse = (3 * denominator) ^ 2;

            // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
            // in modular arithmetic, doubling the correct bits in each step.
            inverse *= 2 - denominator * inverse; // inverse mod 2^8
            inverse *= 2 - denominator * inverse; // inverse mod 2^16
            inverse *= 2 - denominator * inverse; // inverse mod 2^32
            inverse *= 2 - denominator * inverse; // inverse mod 2^64
            inverse *= 2 - denominator * inverse; // inverse mod 2^128
            inverse *= 2 - denominator * inverse; // inverse mod 2^256

            // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
            // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
            // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
            // is no longer required.
            result = prod0 * inverse;
            return result;
        }
    }

    /**
     * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
     */
    function mulDiv(
        uint256 x,
        uint256 y,
        uint256 denominator,
        Rounding rounding
    ) internal pure returns (uint256) {
        uint256 result = mulDiv(x, y, denominator);
        if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
            result += 1;
        }
        return result;
    }

    /**
     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
     *
     * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
     */
    function sqrt(uint256 a) internal pure returns (uint256) {
        if (a == 0) {
            return 0;
        }

        // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
        //
        // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
        // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
        //
        // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
        // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
        // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
        //
        // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
        uint256 result = 1 << (log2(a) >> 1);

        // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
        // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
        // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
        // into the expected uint128 result.
        unchecked {
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            return min(result, a / result);
        }
    }

    /**
     * @notice Calculates sqrt(a), following the selected rounding direction.
     */
    function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = sqrt(a);
            return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 2, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log2(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 128;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 64;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 32;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 16;
            }
            if (value >> 8 > 0) {
                value >>= 8;
                result += 8;
            }
            if (value >> 4 > 0) {
                value >>= 4;
                result += 4;
            }
            if (value >> 2 > 0) {
                value >>= 2;
                result += 2;
            }
            if (value >> 1 > 0) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 2, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log2(value);
            return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 10, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log10(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >= 10**64) {
                value /= 10**64;
                result += 64;
            }
            if (value >= 10**32) {
                value /= 10**32;
                result += 32;
            }
            if (value >= 10**16) {
                value /= 10**16;
                result += 16;
            }
            if (value >= 10**8) {
                value /= 10**8;
                result += 8;
            }
            if (value >= 10**4) {
                value /= 10**4;
                result += 4;
            }
            if (value >= 10**2) {
                value /= 10**2;
                result += 2;
            }
            if (value >= 10**1) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log10(value);
            return result + (rounding == Rounding.Up && 10**result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 256, rounded down, of a positive value.
     * Returns 0 if given 0.
     *
     * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
     */
    function log256(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 16;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 8;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 4;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 2;
            }
            if (value >> 8 > 0) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log256(value);
            return result + (rounding == Rounding.Up && 1 << (result * 8) < value ? 1 : 0);
        }
    }
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.13;

import {OperatorFilterer} from "./OperatorFilterer.sol";

/**
 * @title  DefaultOperatorFilterer
 * @notice Inherits from OperatorFilterer and automatically subscribes to the default OpenSea subscription.
 */
abstract contract DefaultOperatorFilterer is OperatorFilterer {
    address constant DEFAULT_SUBSCRIPTION = address(0x3cc6CddA760b79bAfa08dF41ECFA224f810dCeB6);

    constructor() OperatorFilterer(DEFAULT_SUBSCRIPTION, true) {}
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.13;

interface IOperatorFilterRegistry {
    function isOperatorAllowed(address registrant, address operator) external view returns (bool);
    function register(address registrant) external;
    function registerAndSubscribe(address registrant, address subscription) external;
    function registerAndCopyEntries(address registrant, address registrantToCopy) external;
    function unregister(address addr) external;
    function updateOperator(address registrant, address operator, bool filtered) external;
    function updateOperators(address registrant, address[] calldata operators, bool filtered) external;
    function updateCodeHash(address registrant, bytes32 codehash, bool filtered) external;
    function updateCodeHashes(address registrant, bytes32[] calldata codeHashes, bool filtered) external;
    function subscribe(address registrant, address registrantToSubscribe) external;
    function unsubscribe(address registrant, bool copyExistingEntries) external;
    function subscriptionOf(address addr) external returns (address registrant);
    function subscribers(address registrant) external returns (address[] memory);
    function subscriberAt(address registrant, uint256 index) external returns (address);
    function copyEntriesOf(address registrant, address registrantToCopy) external;
    function isOperatorFiltered(address registrant, address operator) external returns (bool);
    function isCodeHashOfFiltered(address registrant, address operatorWithCode) external returns (bool);
    function isCodeHashFiltered(address registrant, bytes32 codeHash) external returns (bool);
    function filteredOperators(address addr) external returns (address[] memory);
    function filteredCodeHashes(address addr) external returns (bytes32[] memory);
    function filteredOperatorAt(address registrant, uint256 index) external returns (address);
    function filteredCodeHashAt(address registrant, uint256 index) external returns (bytes32);
    function isRegistered(address addr) external returns (bool);
    function codeHashOf(address addr) external returns (bytes32);
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.13;

import {IOperatorFilterRegistry} from "./IOperatorFilterRegistry.sol";

/**
 * @title  OperatorFilterer
 * @notice Abstract contract whose constructor automatically registers and optionally subscribes to or copies another
 *         registrant's entries in the OperatorFilterRegistry.
 * @dev    This smart contract is meant to be inherited by token contracts so they can use the following:
 *         - `onlyAllowedOperator` modifier for `transferFrom` and `safeTransferFrom` methods.
 *         - `onlyAllowedOperatorApproval` modifier for `approve` and `setApprovalForAll` methods.
 */
abstract contract OperatorFilterer {
    error OperatorNotAllowed(address operator);

    IOperatorFilterRegistry public constant OPERATOR_FILTER_REGISTRY =
        IOperatorFilterRegistry(0x000000000000AAeB6D7670E522A718067333cd4E);

    constructor(address subscriptionOrRegistrantToCopy, bool subscribe) {
        // If an inheriting token contract is deployed to a network without the registry deployed, the modifier
        // will not revert, but the contract will need to be registered with the registry once it is deployed in
        // order for the modifier to filter addresses.
        if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
            if (subscribe) {
                OPERATOR_FILTER_REGISTRY.registerAndSubscribe(address(this), subscriptionOrRegistrantToCopy);
            } else {
                if (subscriptionOrRegistrantToCopy != address(0)) {
                    OPERATOR_FILTER_REGISTRY.registerAndCopyEntries(address(this), subscriptionOrRegistrantToCopy);
                } else {
                    OPERATOR_FILTER_REGISTRY.register(address(this));
                }
            }
        }
    }

    modifier onlyAllowedOperator(address from) virtual {
        // Allow spending tokens from addresses with balance
        // Note that this still allows listings and marketplaces with escrow to transfer tokens if transferred
        // from an EOA.
        if (from != msg.sender) {
            _checkFilterOperator(msg.sender);
        }
        _;
    }

    modifier onlyAllowedOperatorApproval(address operator) virtual {
        _checkFilterOperator(operator);
        _;
    }

    function _checkFilterOperator(address operator) internal view virtual {
        // Check registry code length to facilitate testing in environments without a deployed registry.
        if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
            if (!OPERATOR_FILTER_REGISTRY.isOperatorAllowed(address(this), operator)) {
                revert OperatorNotAllowed(operator);
            }
        }
    }
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.17;

import "@openzeppelin/contracts/access/Ownable.sol";
import "./VRFv2Consumer.sol";
import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Royalty.sol";
import "operator-filter-registry/src/DefaultOperatorFilterer.sol";
import "./ITokenDNAStorage.sol";

/// @title Tribute Drop NFT Abstract Contract
/// @author Tribute Brand LLC
/// @notice This contract defines the interface and default behavior of drop nft contracts.
/// @dev This contract is meant to be implemented by actual drop contracts.
///		 It is mainly interacted with through the TributeBrand contract.
abstract contract DropNFT is
	DefaultOperatorFilterer,
	ERC721Royalty,
	VRFv2Consumer,
	Ownable
{
	error AwaitingEntropy();
	error WrongReveal();
	error MintingPaused();
	error ReservedSupplyReached();
	error TotalSupplyReached();

	string private _revealedBaseURI;
	uint256 private _reservedMinted;
	address immutable deployer;
	uint256 internal _totalMinted;

	bool public mintingPaused;

	ITokenDNAStorage public DNAResolverContract;

	constructor(
		address tributeBrandFactory,
		address dnaContract,
		string memory name_,
		string memory symbol_,
		uint64 chainlinkKey
	) VRFv2Consumer(chainlinkKey) ERC721(name_, symbol_) {
		DNAResolverContract = ITokenDNAStorage(dnaContract);
		deployer = msg.sender;
		_setDefaultRoyalty(deployer, 750); // 750 basis points <=> 7.5 % royalty fee
		transferOwnership(tributeBrandFactory);
	}

	// =============================================================
	//            ROYALTY OVERRIDES (OPERATOR FILTER)
	// =============================================================

	function setApprovalForAll(
		address operator,
		bool approved
	) public override onlyAllowedOperatorApproval(operator) {
		super.setApprovalForAll(operator, approved);
	}

	function approve(
		address operator,
		uint256 tokenId
	) public override onlyAllowedOperatorApproval(operator) {
		super.approve(operator, tokenId);
	}

	function transferFrom(
		address from,
		address to,
		uint256 tokenId
	) public override onlyAllowedOperator(from) {
		super.transferFrom(from, to, tokenId);
	}

	function safeTransferFrom(
		address from,
		address to,
		uint256 tokenId
	) public override onlyAllowedOperator(from) {
		super.safeTransferFrom(from, to, tokenId);
	}

	function safeTransferFrom(
		address from,
		address to,
		uint256 tokenId,
		bytes memory data
	) public override onlyAllowedOperator(from) {
		super.safeTransferFrom(from, to, tokenId, data);
	}

	// =============================================================
	//                        OWNER METHODS
	// =============================================================
	modifier onlyOwnerOrDeployer() {
		require(
			owner() == _msgSender() || deployer == msg.sender,
			"Ownable: caller is not the owner or deployer"
		);
		_;
	}

	function mint(
		address to,
		uint256
	) external virtual onlyOwner returns (uint256) {
		if (_totalMinted + 1 > _maxSupply() - _reservedSupply())
			revert TotalSupplyReached();
		return _mintTo(to);
	}

	function reservedMint(
		address to,
		uint256 quantity,
		uint256
	) external virtual onlyOwnerOrDeployer returns (uint256 startTokenId) {
		if (quantity > _reservedRemaining()) revert ReservedSupplyReached();
		startTokenId = _totalMinted;
		for (uint i; i < quantity; i++) {
			_mintTo(to);
		}
		_reservedMinted += quantity;
	}

	function manualSetEntropy() external virtual onlyOwnerOrDeployer {
		if (entropy == 0)
			entropy = uint(
				keccak256(abi.encodePacked(block.difficulty, block.timestamp))
			);
	}

	function requestEntropy() public virtual returns (uint256) {
		if (entropy > 0) return 0;
		return requestRandomWords();
	}

	function reveal(
		string calldata realBaseTokenURI
	) external onlyOwnerOrDeployer {
		_reveal(realBaseTokenURI);
	}

	function pause(bool on) external onlyOwnerOrDeployer {
		mintingPaused = on;
	}

	function usesEntropy() external pure returns (bool) {
		return _useEntropy();
	}

	// =============================================================
	//              CONSTANTS / TYPES / OVERRIDEABLES
	// =============================================================

	struct Trait {
		string trait_type;
		string trait_value;
		string trait_extra;
	}

	function tokenDNA(
		uint256 tokenId
	) public view virtual returns (bytes16 dna) {
		dna = DNAResolverContract.getTokenDNA(tokenId, entropy);
	}

	// ------ REQUIRED ------

	function dropUUID() external pure virtual returns (string memory);

	function contractURI() external pure virtual returns (string memory);

	function provenanceHash() external pure virtual returns (string memory);

	function _encodedBaseURI() internal pure virtual returns (bytes32);

	function _unrevealedBaseURI() internal pure virtual returns (string memory);

	function _reservedSupply() internal pure virtual returns (uint256);

	// ------ OPTIONAL ------
	function _traitsToAttributeString(
		Trait[] memory traits
	) internal pure virtual returns (string memory) {
		string memory bStr;

		for (uint idx = 0; idx < traits.length; idx++) {
			bStr = string.concat(
				bStr,
				'{"trait_type":"',
				traits[idx].trait_type,
				'","value":"',
				traits[idx].trait_value,
				'"}'
			);

			if (idx < traits.length - 1) bStr = string.concat(bStr, ",");
		}

		return bStr;
	}

	function _maxSupply() internal pure virtual returns (uint256) {
		return 10000;
	}

	function _useEntropy() internal pure virtual returns (bool) {
		return false;
	}

	function _baseURI() internal view virtual override returns (string memory) {
		return _isRevealed() ? _revealedBaseURI : _unrevealedBaseURI();
	}

	function _startTokenId() internal view virtual returns (uint256) {
		return 0;
	}

	function _isRevealed() internal view virtual returns (bool) {
		return bytes(_revealedBaseURI).length > 0;
	}

	function _mintTo(address to) internal virtual returns (uint256 tokenId) {
		// We only have one entropy for the first drop. This is here so that no one can mint between the moment of nft contract publishing
		// (which is when the entropy is requested from chainlink VFR) and the moment that request is fulfilled (~30s later).
		if (mintingPaused) revert MintingPaused();
		if (_useEntropy() && entropy == 0) revert AwaitingEntropy();
		tokenId = _totalMinted++;
		super._mint(to, tokenId);
	}

	// =============================================================
	//                        OTHER
	// =============================================================
	/**
	 * @dev Returns an array of token IDs owned by `owner`.
	 *
	 * This function scans the ownership mapping and is O(`totalSupply`) in complexity.
	 * It is meant to be called off-chain.
	 *
	 * (off-chain calls to view/pure functions are free, but calling
	 * them on-chain, for instance from the TributeBrand contract, is not free).
	 *
	 * To get all the tokens in all drops that an account owns: first read drops() from the
	 * TributeBrand contract, then for each of these addresses call this function.
	 */

	function tokensOfOwner(
		address owner
	) external view returns (uint256[] memory) {
		unchecked {
			uint256 tokenIdsIdx;
			address currOwner;
			uint256 tokenIdsLength = balanceOf(owner);
			uint256[] memory tokenIds = new uint256[](tokenIdsLength);
			for (uint256 i = 0; tokenIdsIdx != tokenIdsLength; ++i) {
				if (currOwner == owner) {
					tokenIds[tokenIdsIdx++] = i;
				}
			}
			return tokenIds;
		}
	}

	function checkClaimEligibility(
		uint256 quantity
	) external view returns (string memory) {
		if (mintingPaused || (_useEntropy() && entropy == 0)) {
			return "not live yet";
		} else if (_totalMinted + quantity > _maxSupply() - _reservedSupply()) {
			return "not enough supply";
		}
		return "";
	}

	// =============================================================
	//                        INTERNAL UTILS
	// =============================================================

	function _reservedRemaining() private view returns (uint256) {
		return _reservedSupply() - _reservedMinted;
	}

	function _reveal(string calldata realBaseTokenURI) private {
		if (keccak256(abi.encodePacked(realBaseTokenURI)) != _encodedBaseURI())
			revert WrongReveal();

		_revealedBaseURI = realBaseTokenURI;
	}

	function withdraw(address _receiver) public onlyOwnerOrDeployer {
		(bool os, ) = payable(_receiver).call{value: address(this).balance}("");
		require(os, "Withdraw unsuccesful");
	}
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.17;

interface ITokenDNAStorage {
	function getTokenDNA(
		uint256 tokenId,
		uint256 entropy
	) external view returns (bytes16);
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.7;

import "@chainlink/contracts/src/v0.8/interfaces/VRFCoordinatorV2Interface.sol";
import "@chainlink/contracts/src/v0.8/VRFConsumerBaseV2.sol";


contract VRFv2Consumer is VRFConsumerBaseV2 {
	event RequestSent(uint256 requestId, uint32 numWords);
	event RequestFulfilled(uint256 requestId, uint256[] randomWords);

	struct RequestStatus {
		bool fulfilled; // whether the request has been successfully fulfilled
		bool exists; // whether a requestId exists
		uint256[] randomWords;
	}
	mapping(uint256 => RequestStatus)
		public s_requests; /* requestId --> requestStatus */
	VRFCoordinatorV2Interface COORDINATOR;

	// Your subscription ID.
	uint64 s_subscriptionId;

	// past requests Id.
	uint256[] public requestIds;
	uint256 public lastRequestId;
	uint256 public entropy;

	// The gas lane to use, which specifies the maximum gas price to bump to.
	// For a list of available gas lanes on each network,
	// see https://docs.chain.link/docs/vrf/v2/subscription/supported-networks/#configurations
	bytes32 keyHash =
		0x8af398995b04c28e9951adb9721ef74c74f93e6a478f39e7e0777be13527e7ef;

	// Depends on the number of requested values that you want sent to the
	// fulfillRandomWords() function. Storing each word costs about 20,000 gas,
	// so 100,000 is a safe default for this example contract. Test and adjust
	// this limit based on the network that you select, the size of the request,
	// and the processing of the callback request in the fulfillRandomWords()
	// function.
	uint32 callbackGasLimit = 100000;

	// The default is 3, but you can set this higher.
	uint16 requestConfirmations = 3;

	// For this example, retrieve 2 random values in one request.
	// Cannot exceed VRFCoordinatorV2.MAX_NUM_WORDS.
	uint32 numWords = 1;

	/**
	 * HARDCODED FOR GOERLI
	 * COORDINATOR: 0x271682DEB8C4E0901D1a1550aD2e64D568E69909
	 */
	constructor(
		uint64 subscriptionId
	)
		VRFConsumerBaseV2(0x271682DEB8C4E0901D1a1550aD2e64D568E69909)
	{
		COORDINATOR = VRFCoordinatorV2Interface(
			0x271682DEB8C4E0901D1a1550aD2e64D568E69909
		);
		s_subscriptionId = subscriptionId;
	}

	// Assumes the subscription is funded sufficiently.
	function requestRandomWords() internal returns (uint256 requestId) {
		// Will revert if subscription is not set and funded.
		requestId = COORDINATOR.requestRandomWords(
			keyHash,
			s_subscriptionId,
			requestConfirmations,
			callbackGasLimit,
			numWords
		);
		s_requests[requestId] = RequestStatus({
			randomWords: new uint256[](0),
			exists: true,
			fulfilled: false
		});
		requestIds.push(requestId);
		lastRequestId = requestId;
		emit RequestSent(requestId, numWords);
		return requestId;
	}

	function fulfillRandomWords(
		uint256 _requestId,
		uint256[] memory _randomWords
	) internal override {
		require(s_requests[_requestId].exists, "request not found");
		s_requests[_requestId].fulfilled = true;
		s_requests[_requestId].randomWords = _randomWords;
		entropy = _randomWords[0];
		emit RequestFulfilled(_requestId, _randomWords);
	}

	function getRequestStatus(
		uint256 _requestId
	) external view returns (bool fulfilled, uint256[] memory randomWords) {
		require(s_requests[_requestId].exists, "request not found");
		RequestStatus memory request = s_requests[_requestId];
		return (request.fulfilled, request.randomWords);
	}
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.17;

import "@openzeppelin/contracts/utils/Base64.sol";
import "@openzeppelin/contracts/utils/Strings.sol";

import "../DropNFT.sol";

interface IFont {
	function getFont(uint256 id) external view returns (string memory);
}

/// @title The PUNK NFT Drop
/// @author Tribute Brand LLC
/// @notice Interaction with this contract is mostly meant to happen through the main
///			TributeBrand.sol contract.
contract Punk is DropNFT {
	using Strings for uint;
	uint16 constant FONT_ID = 1;

	/// @dev Returns the token SVG in base64 encoding.
	function encodedSVG(
		uint256 tokenId,
		bool embeddedFont,
		SVGColor svgColor,
		SVGType svgType
	) public view returns (string memory svgData) {
		return
			Base64.encode(
				abi.encodePacked(
					tokenSVG(tokenId, embeddedFont, svgColor, svgType)
				)
			);
	}

	enum SVGType {
		Square,
		Unpadded,
		Icon
	}
	enum SVGColor {
		WhiteBlack,
		NoneWhite,
		NoneBlack
	}

	/// @dev Returns the token SVG
	function tokenSVG(
		uint256 tokenId,
		bool embeddedFont,
		SVGColor svgColor,
		SVGType svgType
	) public view returns (string memory) {
		(
			,
			Trait[4] memory typeTraits,
			Trait[4] memory rangeTraits,

		) = tokenIdToTraits(tokenId);
		return
			_tokenSVG(typeTraits, rangeTraits, embeddedFont, svgColor, svgType);
	}

	/// @dev Returns the token SVG
	function _tokenSVG(
		Trait[4] memory typeTraits,
		Trait[4] memory rangeTraits,
		bool embeddedFont,
		SVGColor svgColor,
		SVGType svgType
	) private view returns (string memory) {
		string memory viewBox = svgType == SVGType.Unpadded
			? "0 0 400 100"
			: "0 0 400 400";
		string memory fontSize = svgType == SVGType.Icon ? "400px" : "100px";

		string memory text;
		if (svgType == SVGType.Icon) {
			text = string.concat(
				unicode"<text x='50%' y='50%' style='baseline-shift: 25px;font-variation-settings: &#x22;wght&#x22; ",
				rangeTraits[0].trait_extra, // weight
				"'>",
				typeTraits[0].trait_extra, // char
				"</text>"
			);
		} else {
			text = "<text x='50%' y='50%'>";
			for (uint i = 0; i < 4; i++) {
				text = string.concat(
					text,
					unicode"<tspan style='font-variation-settings: &#x22;wght&#x22; ",
					rangeTraits[i].trait_extra, // weight
					"'>",
					typeTraits[i].trait_extra, // char
					"</tspan>"
				);
			}
			text = string.concat(text, "</text>");
		}

		return
			string.concat(
				"<svg viewBox='",
				viewBox,
				"' preserveAspectRatio='xMidYMid meet' xmlns='http://www.w3.org/2000/svg'><defs><style>",
				embeddedFont
					? string.concat(
						"@font-face{font-family:tb;font-weight:0 660;src:url(data:application/font-woff2;charset=utf-8;base64,",
						IFont(fontContractAddress).getFont(FONT_ID),
						") format('woff2')}"
					)
					: "",
				"text{font-family:tb;fill:",
				svgColor == SVGColor.NoneWhite ? "#fff" : "#000",
				";font-size:",
				fontSize,
				";text-anchor: middle;dominant-baseline: central;}</style></defs>",
				svgColor == SVGColor.WhiteBlack
					? "<rect width='100%' height='100%' fill='#fff' />"
					: "",
				text,
				"</svg>"
			);
	}

	/// @dev The stored base64 font
	address fontContractAddress;

	constructor(
		address tributeFactory,
		address _dnaStorageContractAddress,
		address _fontContractAddress,
		uint64 chainlinkKey
	)
		DropNFT(
			tributeFactory,
			_dnaStorageContractAddress,
			"PUNK",
			"PUNK",
			chainlinkKey
		)
	{
		fontContractAddress = _fontContractAddress;
	}

	/// @notice Set the storage contracts (font and dna).
	/// @dev This can only be done before entropy has been set,
	///		 i.e. before the minting has begun.
	/// @param font The address for the font storage contract
	/// @param dna The address for the dna storage contract
	function setResolvers(
		address font,
		address dna
	) external onlyOwnerOrDeployer {
		require(entropy == 0, "metadata already finalized");
		fontContractAddress = font;
		DNAResolverContract = ITokenDNAStorage(dna);
	}

	string[4] private LETTERS = ["P", "U", "N", "K"];

	string[5] private TYPES = [
		"0",
		"2",
		"3",
		"4",
		"1" // ORIGINAL but with a I instead of U.
	];

	string[20] private WEIGHTS = [
		"0", // Range 1
		"33",
		"66",
		"99",
		"132",
		"165",
		"198",
		"231",
		"264",
		"297",
		"330",
		"363",
		"396",
		"429",
		"462",
		"495",
		"561",
		"594",
		"628",
		"660" // Range 20
	];

	// "P","U","N","K",
	// "L","B","M","V",
	// "2","3","4","5",
	// "T","O","S","Z",
	// "P","I","N","K"
	// GLYPHS[4 * type + letter] = correct glyph
	string[20] private GLYPHS = [
		"P",
		"U",
		"N",
		"K",
		"L",
		"B",
		"M",
		"V",
		"2",
		"3",
		"4",
		"5",
		"T",
		"O",
		"S",
		"Z",
		"P",
		"I",
		"N",
		"K"
	];
	string[3] private MIXERS = ["STREETPRESS", "CREDOX", "UNICOPY"];

	/// @notice Traits for a specific token. Requires tokenDNA storage to exist.
	/// @param tokenId The ID of the token you require traits for
	function tokenIdToTraits(
		uint256 tokenId
	)
		public
		view
		returns (
			Trait memory mixerTrait,
			Trait[4] memory typeTraits, // First letterTrait is type, second is range or none.
			Trait[4] memory rangeTraits, // First letterTrait is type, second is range or none.
			Trait[] memory allTraits
		)
	{
		bytes4[4] memory letterDNA = [bytes4(0), 0, 0, 0];

		bytes16 dna = tokenDNA(tokenId);

		assembly {
			mstore(letterDNA, dna)
			mstore(add(letterDNA, 28), dna) // 28 = 32-4. See https://ethereum.stackexchange.com/a/35274
			mstore(add(letterDNA, 56), dna)
			mstore(add(letterDNA, 84), dna)
		}

		// DNA per letter:
		// byte 0 - type
		// byte 1 - range
		// byte 2 - mixer
		// byte 3 - UNUSED (set to 33 dec == 21 hex to make the delimeter clear)

		allTraits = new Trait[](9);
		uint256 traitsSet;

		// First trait is Mixer. Use 3rd byte of first letter to set it:
		uint8 mixerType = uint8(letterDNA[0][2]) % 3;
		mixerTrait = Trait("MACHINE", MIXERS[mixerType], "");
		allTraits[traitsSet++] = mixerTrait;

		for (uint l = 0; l < 4; l++) {
			// First byte decides type:
			uint8 letterType = uint8(letterDNA[l][0]) % 5; // dna for byte should not be over 4.

			typeTraits[l] = Trait(
				string.concat(LETTERS[l], " SERIES"),
				TYPES[letterType],
				GLYPHS[4 * letterType + l]
			);
			allTraits[traitsSet++] = typeTraits[l];

			// Set range through second byte.
			uint256 rangeType = uint8(letterDNA[l][1]) % 21; // The range. Always at least 1 and at most 20.

			rangeTraits[l] = Trait(
				string.concat(LETTERS[l], " COPY"),
				rangeType.toString(),
				WEIGHTS[rangeType - 1]
			);
			allTraits[traitsSet++] = rangeTraits[l];
		}
	}

	function dropUUID() external pure override returns (string memory) {
		return "";
	}

	function provenanceHash() external pure override returns (string memory) {
		return "";
	}

	function _encodedBaseURI() internal pure override returns (bytes32) {
		return
			0x7b957997f488ae05c66002a4b6416afff084b7065cbb580144af328e4bb5fd04;
	}

	function _unrevealedBaseURI()
		internal
		pure
		override
		returns (string memory)
	{
		return "";
	}

	function _reservedSupply() internal pure override returns (uint256) {
		return 500;
	}

	function _maxSupply() internal pure override returns (uint256) {
		return 10000;
	}

	function _isRevealed() internal pure override returns (bool) {
		return true;
	}

	function _useEntropy() internal pure override returns (bool) {
		return false;
	}

	function tokenURI(
		uint256 tokenId
	) public view override returns (string memory result) {
		if (!_exists(tokenId)) return "404";
		(
			,
			Trait[4] memory typeTraits,
			Trait[4] memory rangeTraits,
			Trait[] memory allTraits
		) = tokenIdToTraits(tokenId);

		string memory svg = _tokenSVG(
			typeTraits,
			rangeTraits,
			true,
			SVGColor.NoneBlack,
			SVGType.Square
		);

		result = string(
			abi.encodePacked(
				"data:application/json;base64,",
				Base64.encode(
					abi.encodePacked(
						'{"name":"PUNK #',
						tokenId.toString(),
						'","description": "PUNKS NOT DEAD"',
						',"attributes": [',
						_traitsToAttributeString(allTraits),
						'],"aspect_ratio": 1,"image": "data:image/svg+xml;base64,',
						Base64.encode(abi.encodePacked(svg)),
						'"',
						',"animation_url":"data:text/html;charset=utf-8;base64,',
						Base64.encode(
							abi.encodePacked(
								"<html><head><meta charset='UTF-8'><style>html,body,svg{margin:0;padding:0; width:100%;height:100%;text-align:center;}</style></head><body>",
								svg,
								"</body></html>"
							)
						),
						'"',
						"}"
					)
				)
			)
		);
	}

	function contractURI() external pure override returns (string memory) {
		bytes memory dataURI = abi.encodePacked(
			'{"name":"PUNK"',
			',"description": "THE PUNK DROP"',
			', "image":"https://imagedelivery.net/YHYKpZyJMGcjpDsPjj5XMw/52b8d6ca-081f-4459-b9bf-3046cd279800/public"',
			', "external_link":"https://tribute-brand.com/", "seller_fee_basis_points": 750, "fee_recipient": "0xCF04B138F6ec0f2a6E44fD36E244b4B07798027f" ',
			"}"
		);

		return
			string(
				abi.encodePacked(
					"data:application/json;base64,",
					Base64.encode(dataURI)
				)
			);
	}
}

{
  "evmVersion": "london",
  "libraries": {},
  "metadata": {
    "bytecodeHash": "ipfs",
    "useLiteralContent": true
  },
  "optimizer": {
    "enabled": true,
    "runs": 1
  },
  "remappings": [],
  "viaIR": true,
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"address","name":"tributeFactory","type":"address"},{"internalType":"address","name":"_dnaStorageContractAddress","type":"address"},{"internalType":"address","name":"_fontContractAddress","type":"address"},{"internalType":"uint64","name":"chainlinkKey","type":"uint64"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AwaitingEntropy","type":"error"},{"inputs":[],"name":"MintingPaused","type":"error"},{"inputs":[{"internalType":"address","name":"have","type":"address"},{"internalType":"address","name":"want","type":"address"}],"name":"OnlyCoordinatorCanFulfill","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"OperatorNotAllowed","type":"error"},{"inputs":[],"name":"ReservedSupplyReached","type":"error"},{"inputs":[],"name":"TotalSupplyReached","type":"error"},{"inputs":[],"name":"WrongReveal","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"requestId","type":"uint256"},{"indexed":false,"internalType":"uint256[]","name":"randomWords","type":"uint256[]"}],"name":"RequestFulfilled","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"requestId","type":"uint256"},{"indexed":false,"internalType":"uint32","name":"numWords","type":"uint32"}],"name":"RequestSent","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[],"name":"DNAResolverContract","outputs":[{"internalType":"contract ITokenDNAStorage","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"OPERATOR_FILTER_REGISTRY","outputs":[{"internalType":"contract IOperatorFilterRegistry","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"checkClaimEligibility","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"contractURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"dropUUID","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bool","name":"embeddedFont","type":"bool"},{"internalType":"enum Punk.SVGColor","name":"svgColor","type":"uint8"},{"internalType":"enum Punk.SVGType","name":"svgType","type":"uint8"}],"name":"encodedSVG","outputs":[{"internalType":"string","name":"svgData","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"entropy","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_requestId","type":"uint256"}],"name":"getRequestStatus","outputs":[{"internalType":"bool","name":"fulfilled","type":"bool"},{"internalType":"uint256[]","name":"randomWords","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lastRequestId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"manualSetEntropy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"","type":"uint256"}],"name":"mint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"mintingPaused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bool","name":"on","type":"bool"}],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"provenanceHash","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"uint256","name":"requestId","type":"uint256"},{"internalType":"uint256[]","name":"randomWords","type":"uint256[]"}],"name":"rawFulfillRandomWords","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"requestEntropy","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"requestIds","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"quantity","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"}],"name":"reservedMint","outputs":[{"internalType":"uint256","name":"startTokenId","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"realBaseTokenURI","type":"string"}],"name":"reveal","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint256","name":"_salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"s_requests","outputs":[{"internalType":"bool","name":"fulfilled","type":"bool"},{"internalType":"bool","name":"exists","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"font","type":"address"},{"internalType":"address","name":"dna","type":"address"}],"name":"setResolvers","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenDNA","outputs":[{"internalType":"bytes16","name":"dna","type":"bytes16"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenIdToTraits","outputs":[{"components":[{"internalType":"string","name":"trait_type","type":"string"},{"internalType":"string","name":"trait_value","type":"string"},{"internalType":"string","name":"trait_extra","type":"string"}],"internalType":"struct DropNFT.Trait","name":"mixerTrait","type":"tuple"},{"components":[{"internalType":"string","name":"trait_type","type":"string"},{"internalType":"string","name":"trait_value","type":"string"},{"internalType":"string","name":"trait_extra","type":"string"}],"internalType":"struct DropNFT.Trait[4]","name":"typeTraits","type":"tuple[4]"},{"components":[{"internalType":"string","name":"trait_type","type":"string"},{"internalType":"string","name":"trait_value","type":"string"},{"internalType":"string","name":"trait_extra","type":"string"}],"internalType":"struct DropNFT.Trait[4]","name":"rangeTraits","type":"tuple[4]"},{"components":[{"internalType":"string","name":"trait_type","type":"string"},{"internalType":"string","name":"trait_value","type":"string"},{"internalType":"string","name":"trait_extra","type":"string"}],"internalType":"struct DropNFT.Trait[]","name":"allTraits","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bool","name":"embeddedFont","type":"bool"},{"internalType":"enum Punk.SVGColor","name":"svgColor","type":"uint8"},{"internalType":"enum Punk.SVGType","name":"svgType","type":"uint8"}],"name":"tokenSVG","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"result","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"tokensOfOwner","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"usesEntropy","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"_receiver","type":"address"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"}]

60c0346200141a57600090620056823881900390601f8201601f191683016001600160401b03811184821017620014065791808492608094604052833981010312620013fe57620000508162001458565b6200005e6020830162001458565b60606200006e6040850162001458565b9301516001600160401b0381168103620014025760405162000090816200143c565b600481526350554e4b60e01b9081602082015260405191620000b2836200143c565b600483526020830152866daaeb6d7670e522a718067333cd4e803b6200136e575b50508051906001600160401b0382116200135a578190620000f66002546200146d565b601f811162001319575b50602090601f8311600114620012a257899262001296575b50508160011b916000199060031b1c1916176002555b8051906001600160401b0382116200057d5781906200014f6003546200146d565b601f811162001244575b50602090601f8311600114620011b7578892620011ab575b50508160011b916000199060031b1c1916176003555b73271682deb8c4e0901d1a1550ad2e64d568e6990960808190527f8af398995b04c28e9951adb9721ef74c74f93e6a478f39e7e0777be13527e7ef600d55600e80546001600160501b03191666010003000186a0179055600980546001600160e01b03191660a09390931b600160a01b600160e01b0316929092171790556200021033620014c3565b60128054610100600160a81b03191660089290921b610100600160a81b03169190911790553360a0819052156200116657604080519081016001600160401b0381118282101762000d5857604052338082526102ee602090920191909152600080546001600160a01b0319168217905583546001600160a01b0390811661017760a11b178555600e5460501c160362001122576001600160a01b03811615620010ce57620002be90620014c3565b6040516001600160401b03608082019081119082111762000d585760808101604052620002ee608082016200143c565b600160808201908152600560fc1b60a0830152815260405162000311816200143c565b60018152605560f81b6020820152602082015260405162000332816200143c565b60018152602760f91b6020820152604082015260405162000353816200143c565b60018152604b60f81b6020820152606082015260149083905b6004821062000fae57505060405190506001600160401b0360a082019081119082111762000d585760a08101604052620003a960a082016200143c565b600160a08201908152600360fc1b60c08301528152604051620003cc816200143c565b60018152601960f91b60208201526020820152604051620003ed816200143c565b60018152603360f81b602082015260408201526040516200040e816200143c565b60018152600d60fa1b602082015260608201526040516200042f816200143c565b60018152603160f81b60208201526080820152601883915b6005831015620005915780518051906001600160401b0382116200057d576200047184546200146d565b601f81116200053d575b50602090601f8311600114620004cb5792826001949360209386958b92620004bf575b5050600019600383901b1c191690841b1785555b0192019201919062000447565b0151905038806200049e565b908488526020882091885b601f198516811062000524575083602093600196938796938794601f198116106200050a575b505050811b018555620004b2565b015160001960f88460031b161c19169055388080620004fc565b91926020600181928685015181550194019201620004d6565b6200056b9085895260208920601f850160051c8101916020861062000572575b601f0160051c0190620014aa565b386200047b565b90915081906200055d565b634e487b7160e01b87526041600452602487fd5b8385604051620005a1816200141f565b604051620005af816200143c565b60018152600360fc1b60208201528152604051620005cd816200143c565b6002815261333360f01b60208201526020820152604051620005ef816200143c565b60028152611b1b60f11b6020820152604082015260405162000611816200143c565b6002815261393960f01b6020820152606082015260405162000633816200143c565b600381526218999960e91b6020820152608082015260405162000656816200143c565b600381526231363560e81b602082015260a082015260405162000679816200143c565b600381526206272760eb1b602082015260c08201526040516200069c816200143c565b600381526232333160e81b602082015260e0820152604051620006bf816200143c565b60038152620c8d8d60ea1b6020820152610100820152604051620006e3816200143c565b600381526232393760e81b602082015261012082015260405162000707816200143c565b600381526203333360ec1b60208201526101408201526040516200072b816200143c565b600381526233363360e81b60208201526101608201526040516200074f816200143c565b6003815262199c9b60e91b602082015261018082015260405162000773816200143c565b600381526234323960e81b60208201526101a082015260405162000797816200143c565b60038152621a1b1960e91b60208201526101c0820152604051620007bb816200143c565b600381526234393560e81b60208201526101e0820152604051620007df816200143c565b600381526235363160e81b602082015261020082015260405162000803816200143c565b60038152620d4e4d60ea1b602082015261022082015260405162000827816200143c565b600381526206c64760eb1b60208201526102408201526040516200084b816200143c565b600381526203636360ec1b6020820152610260820152601d9082905b6014821062000e8e5750505060405162000881816200141f565b6040516200088f816200143c565b60018152600560fc1b60208201528152604051620008ad816200143c565b60018152605560f81b60208201526020820152604051620008ce816200143c565b60018152602760f91b60208201526040820152604051620008ef816200143c565b60018152604b60f81b6020820152606082015260405162000910816200143c565b60018152601360fa1b6020820152608082015260405162000931816200143c565b60018152602160f91b602082015260a082015260405162000952816200143c565b60018152604d60f81b602082015260c082015260405162000973816200143c565b60018152602b60f91b602082015260e082015260405162000994816200143c565b60018152601960f91b6020820152610100820152604051620009b6816200143c565b60018152603360f81b6020820152610120820152604051620009d8816200143c565b60018152600d60fa1b6020820152610140820152604051620009fa816200143c565b60018152603560f81b602082015261016082015260405162000a1c816200143c565b60018152601560fa1b602082015261018082015260405162000a3e816200143c565b60018152604f60f81b60208201526101a082015260405162000a60816200143c565b60018152605360f81b60208201526101c082015260405162000a82816200143c565b60018152602d60f91b60208201526101e082015260405162000aa4816200143c565b60018152600560fc1b602082015261020082015260405162000ac6816200143c565b60018152604960f81b602082015261022082015260405162000ae8816200143c565b60018152602760f91b602082015261024082015260405162000b0a816200143c565b60018152604b60f81b602082015261026082015260319082905b6014821062000d6e5750506040519050606081016001600160401b0381118282101762000d58578060405262000b5a816200143c565b600b81526a535452454554505245535360a81b6080830152815260405162000b82816200143c565b6006815265086a48a889eb60d31b6020820152602082015260405162000ba8816200143c565b6007815266554e49434f505960c81b6020820152604082015260459082905b6003821062000c1b57601380546001600160a01b0319166001600160a01b03871617905560405161413e908162001524823960805181611b47015260a05181818161047f01528181610e9201526116500152f35b80518051906001600160401b03821162000d445762000c3b85546200146d565b601f811162000d04575b50602090601f831160011462000c955792826001949360209386958a9262000c89575b5050600019600383901b1c191690841b1786555b0193019101909162000bc7565b015190508a8062000c68565b858752602087209190601f198416885b81811062000ceb575093602093600196938796938388951062000cd1575b505050811b01865562000c7c565b015160001960f88460031b161c191690558a808062000cc3565b9293602060018192878601518155019501930162000ca5565b62000d3290868852602088206005601f8601811c8201926020871062000d39575b601f01901c0190620014aa565b8762000c45565b919250829162000d25565b634e487b7160e01b86526041600452602486fd5b634e487b7160e01b600052604160045260246000fd5b80518051906001600160401b03821162000d445762000d8e85546200146d565b601f811162000e5a575b50602090601f831160011462000de85792826001949360209386958a9262000ddc575b5050600019600383901b1c191690841b1786555b0193019101909162000b24565b015190508a8062000dbb565b908587526020872091875b601f198516811062000e41575083602093600196938796938794601f1981161062000e27575b505050811b01865562000dcf565b015160001960f88460031b161c191690558a808062000e19565b9192602060018192868501518155019401920162000df3565b62000e8790868852602088206005601f8601811c8201926020871062000d3957601f01901c0190620014aa565b8762000d98565b80518051906001600160401b03821162000d445762000eae85546200146d565b601f811162000f7a575b50602090601f831160011462000f085792826001949360209386958a9262000efc575b5050600019600383901b1c191690841b1786555b0193019101909162000867565b015190508a8062000edb565b908587526020872091875b601f198516811062000f61575083602093600196938796938794601f1981161062000f47575b505050811b01865562000eef565b015160001960f88460031b161c191690558a808062000f39565b9192602060018192868501518155019401920162000f13565b62000fa790868852602088206005601f8601811c8201926020871062000d3957601f01901c0190620014aa565b8762000eb8565b80518051906001600160401b0382116200057d5762000fce85546200146d565b601f81116200109a575b50602090601f8311600114620010285792826001949360209386958b926200101c575b5050600019600383901b1c191690841b1786555b019301910190916200036c565b01519050388062000ffb565b908588526020882091885b601f198516811062001081575083602093600196938796938794601f1981161062001067575b505050811b0186556200100f565b015160001960f88460031b161c1916905538808062001059565b9192602060018192868501518155019401920162001033565b620010c790868952602089206005601f8601811c8201926020871062000d3957601f01901c0190620014aa565b3862000fd8565b60405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608490fd5b606460405162461bcd60e51b815260206004820152602060248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152fd5b60405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c6964207265636569766572000000000000006044820152606490fd5b01519050388062000171565b600389528893507fc2575a0e9e593c00f959f8c92f12db2869c3395a3b0502d05e2516446f71f85b91905b601f198416851062001228576001945083601f198116106200120e575b505050811b0160035562000187565b015160001960f88460031b161c19169055388080620011ff565b81810151835560209485019460019093019290910190620011e2565b600389526200128f907fc2575a0e9e593c00f959f8c92f12db2869c3395a3b0502d05e2516446f71f85b601f850160051c810191602086106200057257601f0160051c0190620014aa565b3862000159565b01519050388062000118565b60028a52600080516020620056628339815191529250601f1984168a5b818110620013005750908460019594939210620012e6575b505050811b016002556200012e565b015160001960f88460031b161c19169055388080620012d7565b92936020600181928786015181550195019301620012bf565b60028a52620013539060008051602062005662833981519152601f850160051c810191602086106200057257601f0160051c0190620014aa565b3862000100565b634e487b7160e01b88526041600452602488fd5b803b15620013fe578190604460405180948193633e9f1edf60e11b8352306004840152733cc6cdda760b79bafa08df41ecfa224f810dceb660248401525af18015620013f357620013c2575b8790620000d3565b9096906001600160401b038111620013df576040529538620013ba565b634e487b7160e01b82526041600452602482fd5b6040513d8a823e3d90fd5b5080fd5b8480fd5b634e487b7160e01b85526041600452602485fd5b600080fd5b61028081019081106001600160401b0382111762000d5857604052565b604081019081106001600160401b0382111762000d5857604052565b51906001600160a01b03821682036200141a57565b90600182811c921680156200149f575b60208310146200148957565b634e487b7160e01b600052602260045260246000fd5b91607f16916200147d565b818110620014b6575050565b60008155600101620014aa565b600e8054600160501b600160f01b03198116605084811b600160501b600160f01b0316919091179092556001600160a01b0392831692911c167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0600080a356fe60806040526004361015610013575b600080fd5b60003560e01c806301ffc9a71461037a57806302329a291461037157806306fdde0314610368578063072dad781461035f578063081812fc14610356578063095ea7b31461034d5780631fe543e31461034457806323b872dd1461033b5780632a55205a146103325780633c1d9b621461032957806340c10f191461032057806341f434341461031757806342842e0e1461030e57806347ce07cc146103055780634bbb2346146102635780634c261247146102fc57806351cff8d9146102f35780636352211e146102ea57806365b8bb86146102e157806370a08231146102d8578063715018a6146102cf5780638462151c146102c65780638796ba8c146102bd5780638a0b4456146102b45780638da5cb5b146102ab57806395d89b41146102a25780639a26082214610299578063a168fa8914610290578063a22cb46514610287578063b13038a11461027e578063b88d4fde14610275578063be65d7511461026c578063c6ab67a314610263578063c87b56dd1461025a578063cce8431e14610251578063d8a4676f14610248578063e0665b391461023f578063e1a283d614610236578063e2a702761461022d578063e8a3d48514610224578063e985e9c51461021b578063f2fde38b14610212578063f3c86ff5146102095763fc2a88c31461020157600080fd5b61000e611b0c565b5061000e611a56565b5061000e611912565b5061000e6118c0565b5061000e6116e5565b5061000e61169c565b5061000e611678565b5061000e611580565b5061000e6114ba565b5061000e61143e565b5061000e61141e565b5061000e610c18565b5061000e6113ec565b5061000e611363565b5061000e61131d565b5061000e61123d565b5061000e611200565b5061000e6111e3565b5061000e61113e565b5061000e611110565b5061000e6110e8565b5061000e611068565b5061000e610fb2565b5061000e610f2b565b5061000e610f07565b5061000e610ed9565b5061000e610eba565b5061000e610dfa565b5061000e610c51565b5061000e610bf9565b5061000e610b5d565b5061000e610b33565b5061000e610ac8565b5061000e6109fb565b5061000e61095f565b5061000e610916565b5061000e610855565b5061000e610683565b5061000e610626565b5061000e6105e6565b5061000e610505565b5061000e610428565b5061000e610395565b6001600160e01b031981160361000e57565b503461000e57602036600319011261000e5760206004356103b581610383565b63ffffffff60e01b166380ac58cd60e01b811490811561040d575b81156103e2575b506040519015158152f35b63152a902d60e11b8114915081156103fc575b50386103d7565b6301ffc9a760e01b149050386103f5565b635b5e139f60e01b811491506103d0565b8015150361000e57565b503461000e57602036600319011261000e576004356104468161041e565b61046860018060a01b0380600e5460501c16331490811561047d575b506124fb565b60ff8019601254169115151617601255600080f35b7f0000000000000000000000000000000000000000000000000000000000000000163314905038610462565b60005b8381106104bc5750506000910152565b81810151838201526020016104ac565b906020916104e5815180928185528580860191016104a9565b601f01601f1916010190565b9060206105029281815201906104cc565b90565b503461000e576000806003193601126105e3576040518160025461052881611d81565b808452906001908181169081156105bb5750600114610562575b61055e84610552818803826107de565b604051918291826104f1565b0390f35b60028352602094507f405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5ace5b8284106105a8575050508161055e936105529282010193610542565b805485850187015292850192810161058c565b61055e96506105529450602092508593915060ff191682840152151560051b82010193610542565b80fd5b503461000e57602036600319011261000e5761055e6106066004356128f9565b6040519182916020835260208301906104cc565b6001600160a01b031690565b503461000e57602036600319011261000e576020610645600435611e5f565b6040516001600160a01b039091168152f35b600435906001600160a01b038216820361000e57565b602435906001600160a01b038216820361000e57565b503461000e57604036600319011261000e5761069d610657565b6024356106a982611f25565b6106b281611d5e565b916001600160a01b03808416908216811461071a576106e4936106df9133149081156106e6575b50611fe6565b612077565b005b6001600160a01b03166000908152600760205260409020610714915061070d903390611c89565b5460ff1690565b386106d9565b60405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b6064820152608490fd5b50634e487b7160e01b600052604160045260246000fd5b606081019081106001600160401b0382111761079b57604052565b6107a3610769565b604052565b604081019081106001600160401b0382111761079b57604052565b602081019081106001600160401b0382111761079b57604052565b601f909101601f19168101906001600160401b0382119082101761079b57604052565b6040519061080e82610780565b565b60405190608082016001600160401b0381118382101761079b57604052565b6020906001600160401b038111610848575b60051b0190565b610850610769565b610841565b503461000e57604036600319011261000e576024356001600160401b03811161000e573660238201121561000e578060040135906108928261082f565b906108a060405192836107de565b82825260209260248484019160051b8301019136831161000e57602401905b8282106108d2576106e484600435611b45565b813581529084019084016108bf565b606090600319011261000e576001600160a01b0390600435828116810361000e5791602435908116810361000e579060443590565b503461000e576106e4610928366108e1565b91336001600160a01b03821603610951575b61094c610947843361212d565b6120cb565b6121f5565b61095a33611f25565b61093a565b503461000e57604036600319011261000e57600435600052600160205260406000206040519061098e826107a8565b546001600160a01b0380821680845260a09290921c602084015290156109eb575b6020820151612710906109cd906001600160601b0316602435611f05565b925160408051939091166001600160a01b0316835292046020820152f35b90506109f5611ea8565b906109af565b503461000e57606036600319011261000e57610a15610657565b602435610a3960018060a01b0380600e5460501c16331490811561047d57506124fb565b6010546101f4908103908111610abb575b8111610aa9576011549060005b818110610a915761055e8383601054908101809111610a84575b6010556040519081529081906020820190565b610a8c611ece565b610a71565b610aa490610a9e85612775565b5061254a565b610a57565b604051635284fe7760e01b8152600490fd5b610ac3611ece565b610a4a565b503461000e57604036600319011261000e57610ae2610657565b610aea611c26565b61251c60115460018101809111610b26575b11610b1457610b0c602091612775565b604051908152f35b604051637be9badb60e01b8152600490fd5b610b2e611ece565b610afc565b503461000e57600036600319011261000e5760206040516daaeb6d7670e522a718067333cd4e8152f35b503461000e57610bb9610b6f366108e1565b6001600160a01b0383163314159290919083610beb575b60405193610b93856107c3565b60008552610bdd575b610ba9610947843361212d565b610bb48383836121f5565b612438565b15610bc057005b60405162461bcd60e51b815280610bd96004820161236f565b0390fd5b610be633611f25565b610b9c565b610bf433611f25565b610b86565b503461000e57600036600319011261000e576020600c54604051908152f35b503461000e57600036600319011261000e5761055e604051610c39816107c3565b600081526040519182916020835260208301906104cc565b503461000e5760208060031936011261000e576004356001600160401b0380821161000e573660238301121561000e57816004013590811161000e5760243681838501011161000e57610cbb60018060a01b0380600e5460501c16331490811561047d57506124fb565b604051927f7b957997f488ae05c66002a4b6416afff084b7065cbb580144af328e4bb5fd0485850184848401823784860195610d0588826000998a838201520380845201826107de565b51902003610de857610d2183610d1c600f54611d81565b6129b7565b8394601f8411600114610d605750938394839493610d53575b5050508160011b916000199060031b1c191617600f5580f35b0101359050388080610d3a565b600f600052601f198416957f8d1108e10bcb7c27dddfc02ed9d693a074039d026cf4ea4240b40f7d581ac802939186905b888210610dce575050846001969710610db2575b50505050811b01600f5580f35b60001960f88660031b161c199201013516905538808080610da5565b806001849786839596890101358155019601920190610d91565b604051631b9a273b60e11b8152600490fd5b503461000e57602036600319011261000e57610e14610657565b60018060a01b0380600e5460501c1633148015610e8f575b610e35906124fb565b60008080809481944791165af1610e4a612408565b5015610e535780f35b60405162461bcd60e51b815260206004820152601460248201527315da5d1a191c985dc81d5b9cdd58d8d95cd99d5b60621b6044820152606490fd5b507f000000000000000000000000000000000000000000000000000000000000000081163314610e2c565b503461000e57602036600319011261000e576020610645600435611d5e565b503461000e57600036600319011261000e5760125460405160089190911c6001600160a01b03168152602090f35b503461000e57602036600319011261000e576020610b0c610f26610657565b611ca0565b503461000e576000806003193601126105e357610f46611c26565b600e8054600160501b600160f01b03198116909155819060501c6001600160a01b03166000805160206140c98339815191528280a380f35b90815180825260208080930193019160005b828110610f9e575050505090565b835185529381019392810192600101610f90565b503461000e57602036600319011261000e57610fcc610657565b6000610fd782611ca0565b90610fe18261082f565b92610fef60405194856107de565b828452601f19610ffe8461082f565b013660208601376001600160a01b031615815b83830361102e576040516020808252819061055e90820188610f7e565b6001908261103d575b01611011565b8061104b83860195886128d7565b52611037565b50634e487b7160e01b600052603260045260246000fd5b503461000e57602036600319011261000e57600435600a5481101561000e57600a6000526000805160206140898339815191520154604051908152602090f35b6003111561000e57565b608090600319011261000e57600435906024356110ce8161041e565b906044356110db816110a8565b90606435610502816110a8565b503461000e5761055e610606611108611100366110b2565b939092613887565b5091506134b3565b503461000e57600036600319011261000e57600e5460405160509190911c6001600160a01b03168152602090f35b503461000e576000806003193601126105e3576040518160035461116181611d81565b808452906001908181169081156105bb575060011461118a5761055e84610552818803826107de565b60038352602094507fc2575a0e9e593c00f959f8c92f12db2869c3395a3b0502d05e2516446f71f85b5b8284106111d0575050508161055e936105529282010193610542565b80548585018701529285019281016111b4565b503461000e57600036600319011261000e57602060405160008152f35b503461000e57602036600319011261000e5760043560005260086020526040806000205460ff8251918181161515835260081c1615156020820152f35b503461000e57604036600319011261000e57611257610657565b6024356112638161041e565b61126c82611f25565b6001600160a01b038216913383146112dc57816112996112aa923360005260076020526040600020611c89565b9060ff801983541691151516179055565b604051901515815233907f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c3190602090a3005b60405162461bcd60e51b815260206004820152601960248201527822a9219b99189d1030b8383937bb32903a379031b0b63632b960391b6044820152606490fd5b503461000e57600036600319011261000e576020610b0c612566565b6020906001600160401b038111611356575b601f01601f19160190565b61135e610769565b61134b565b503461000e57608036600319011261000e5761137d610657565b61138561066d565b606435916001600160401b03831161000e573660238401121561000e578260040135916113b183611339565b926113bf60405194856107de565b808452366024828701011161000e5760208160009260246106e49801838801378501015260443591612344565b503461000e57602036600319011261000e57602061140b6004356126da565b6040516001600160801b03199091168152f35b503461000e57602036600319011261000e5761055e610606600435613c71565b503461000e57600036600319011261000e5761147160018060a01b0380600e5460501c16331490811561047d57506124fb565b600c541561147b57005b60405160208101904482524260408201526040815261149981610780565b519020600c55005b6040906105029392151581528160208201520190610f7e565b503461000e5760208060031936011261000e576004356000818152600883526040916114ee60ff8484205460081c16612bc6565b8152600883528181209282519161150483610780565b60ff85548181161515855260081c16151582840152600180950190845195868488958554928381520194845280842093905b82821061156857868961055e61155d8b611552858c03866107de565b848482015251151590565b9151928392836114a1565b84548652899650948501949383019390830190611536565b503461000e57604036600319011261000e5761159a610657565b6115a261066d565b9060018060a01b039081600e5460501c163314801561164d575b6115c5906124fb565b600c5461160b57601380546001600160a01b0319169290911691909117905560128054610100600160a81b03191660089290921b610100600160a81b0316919091179055005b60405162461bcd60e51b815260206004820152601a6024820152791b595d1859185d1848185b1c9958591e48199a5b985b1a5e995960321b6044820152606490fd5b507f0000000000000000000000000000000000000000000000000000000000000000821633146115bc565b503461000e57600036600319011261000e57602060ff601254166040519015158152f35b503461000e5761055e6106066116b7611108611100366110b2565b6116e06020604051836116d382955180928580860191016104a9565b81010380845201826107de565b612cc1565b503461000e57600036600319011261000e576040516d3d913730b6b2911d11282aa7259160911b60208201527f2c226465736372697074696f6e223a20225448452050554e4b2044524f502200602e8201527f2c2022696d616765223a2268747470733a2f2f696d61676564656c6976657279604d8201527f2e6e65742f5948594b705a794a4d47636a704473506a6a35584d772f35326238606d8201527f643663612d303831662d343435392d623962662d333034366364323739383030608d8201526717b83ab13634b19160c11b60ad8201527f2c202265787465726e616c5f6c696e6b223a2268747470733a2f2f747269627560b58201527f74652d6272616e642e636f6d2f222c202273656c6c65725f6665655f6261736960d58201527f735f706f696e7473223a203735302c20226665655f726563697069656e74223a60f58201527f20223078434630344231333846366563306632613645343466443336453234346101158201526d0311a21181b9b9c9c18191bb311160951b61013582015261055e906118b4906105529061189c816118886101438201613c3b565b03916116e0601f19938481018352826107de565b6040519384916118ae60208401613c48565b90612c1d565b039081018352826107de565b503461000e57604036600319011261000e57602060ff6119066118e1610657565b6118e961066d565b6001600160a01b0390911660009081526007855260409020611c89565b54166040519015158152f35b503461000e57602036600319011261000e5761192c610657565b611934611c26565b6001600160a01b0381811691821561198557600e8054600160501b600160f01b03198116605093841b600160501b600160f01b031617909155901c166000805160206140c9833981519152600080a3005b60405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608490fd5b610502916040611a076119f584516060855260608501906104cc565b602085015184820360208601526104cc565b9201519060408184039101526104cc565b60808201918060005b60048110611a30575050505090565b90919293611a46818560019303855286516119d9565b9460209081019493019101611a21565b503461000e5760208060031936011261000e57611aa1611aaf611a7a600435613887565b9392949091611a94604051966080885260808801906119d9565b9086820388880152611a18565b908482036040860152611a18565b92828403606084015281518085528185019180808360051b8801019401926000965b838810611ade5786860387f35b90919293948380611afb600193601f1986820301875289516119d9565b970193019701969093929193611ad1565b503461000e57600036600319011261000e576020600b54604051908152f35b6001600160a01b0391821681529116602082015260400190565b7f00000000000000000000000000000000000000000000000000000000000000009291906001600160a01b0384163303611c0a577ffe2e2d779dba245964d4e3ef9b994be63856fd568bf7d3ca9e224755cb1bd54d929350806000526008602052611bba60ff60406000205460081c16612bc6565b8060005260086020526040600020600160ff19825416179055611be4826001604060002001612a0b565b611bf6611bf0836128c1565b51600c55565b611c0560405192839283612c06565b0390a1565b60405163073e64fd60e21b815280610bd9863360048401611b2b565b600e5460501c6001600160a01b03163303611c3d57565b606460405162461bcd60e51b815260206004820152602060248201526000805160206140a98339815191526044820152fd5b6001600160a01b0316600090815260056020526040902090565b9060018060a01b0316600052602052604060002090565b6001600160a01b03168015611cc057600052600560205260406000205490565b60405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b6064820152608490fd5b15611d1e57565b60405162461bcd60e51b8152602060048201526018602482015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b6044820152606490fd5b6000908152600460205260409020546001600160a01b0316610502811515611d17565b90600182811c92168015611db1575b6020831014611d9b57565b634e487b7160e01b600052602260045260246000fd5b91607f1691611d90565b9060405191826000825492611dcf84611d81565b908184526001948581169081600014611e3c5750600114611df9575b505061080e925003836107de565b9093915060005260209081600020936000915b818310611e2457505061080e93508201013880611deb565b85548884018501529485019487945091830191611e0c565b91505061080e94506020925060ff191682840152151560051b8201013880611deb565b611e70611e6b82611e8b565b611d17565b6000908152600660205260409020546001600160a01b031690565b6000908152600460205260409020546001600160a01b0316151590565b60405190611eb5826107a8565b6000546001600160a01b038116835260a01c6020830152565b50634e487b7160e01b600052601160045260246000fd5b600281901b91906001600160fe1b03811603611efd57565b61080e611ece565b81810292918115918404141715611efd57565b506040513d6000823e3d90fd5b6daaeb6d7670e522a718067333cd4e803b611f3e575050565b60206040518092633185c44d60e21b82528180611f5f873060048401611b2b565b03915afa908115611fd9575b600091611f9f575b5015611f7c5750565b604051633b79c77360e21b81526001600160a01b03919091166004820152602490fd5b906020823d8211611fd1575b81611fb8602093836107de565b810103126105e3575051611fcb8161041e565b38611f73565b3d9150611fab565b611fe1611f18565b611f6b565b15611fed57565b60405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c0000006064820152608490fd5b80546001600160a01b0319166001600160a01b03909216919091179055565b81600052600660205261208e816040600020612058565b6001600160a01b03806120a084611d5e565b169116907f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925600080a4565b156120d257565b60405162461bcd60e51b815260206004820152602d60248201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560448201526c1c881bdc88185c1c1c9bdd9959609a1b6064820152608490fd5b6001600160a01b038061213f84611d5e565b169281831692848414948515612175575b5050831561215f575b50505090565b61216b91929350611e5f565b1614388080612159565b60ff929550906121919160005260076020526040600020611c89565b5416923880612150565b156121a257565b60405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b6064820152608490fd5b6122199061220284611d5e565b6001600160a01b038281169390918216841461219b565b83169283156122b6576122706122a1926122448561223e6122398a611d5e565b61061a565b1461219b565b61226b61225b886000526006602052604060002090565b80546001600160a01b0319169055565b611c6f565b805460001901905561228181611c6f565b6001815401905561229c856000526004602052604060002090565b612058565b6000805160206140e9833981519152600080a4565b60405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b600019810191908211611efd57565b9060028201809211611efd57565b91908201809211611efd57565b6040519061233e826107c3565b60008252565b61236893929190336001600160a01b03821603610bdd57610ba9610947843361212d565b15610bc057565b60809060208152603260208201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b60608201520190565b9081602091031261000e575161050281610383565b6001600160a01b039182168152911660208201526040810191909152608060608201819052610502929101906104cc565b3d15612433573d9061241982611339565b9161242760405193846107de565b82523d6000602084013e565b606090565b92909190823b156124f25761246b926020926000604051809681958294630a85bd0160e11b9a8b855233600486016123d7565b03926001600160a01b03165af1600091816124c2575b506124b45761248e612408565b805190816124af5760405162461bcd60e51b815280610bd96004820161236f565b602001fd5b6001600160e01b0319161490565b6124e491925060203d81116124eb575b6124dc81836107de565b8101906123c2565b9038612481565b503d6124d2565b50505050600190565b1561250257565b60405162461bcd60e51b815260206004820152602c60248201526000805160206140a983398151915260448201526b1037b9103232b83637bcb2b960a11b6064820152608490fd5b600190600019811461255a570190565b612562611ece565b0190565b600c546126d557600954600d54600e546040516305d3b1d360e41b8152600481019290925260a083901c6001600160401b03166024830152602081811c61ffff16604484015263ffffffff808316606485015260309290921c9091166084830152909182908160008160a4810103926001600160a01b03165af19081156126c8575b60009161269a575b5061262e6125fc6128a9565b612604610801565b6000815260016020820152906040820152612629836000526008602052604060002090565b612aa0565b61263781612b74565b61264081600b55565b7fcc58b13ad3eab50626c6a6300b1d139cd6ebb1688a7cced9461c2f7e762665ee612694612677600e5463ffffffff9060301c1690565b6040805185815263ffffffff909216602083015290918291820190565b0390a190565b6126bb915060203d81116126c1575b6126b381836107de565b8101906129fc565b386125f0565b503d6126a9565b6126d0611f18565b6125e8565b600090565b601254600c54604051631a61c61360e31b8152600481019390935260248301526020908290604490829060081c6001600160a01b03165afa908115612768575b600091612725575090565b6020813d8211612760575b8161273d602093836107de565b8101031261275c5751906001600160801b0319821682036105e3575090565b5080fd5b3d9150612730565b612770611f18565b61271a565b9060ff6012541661284c5760115461278c8161254a565b6011559182906001600160a01b038116908115612808576127f2906127bf6127ba6127b686611e8b565b1590565b61285e565b6127ce6127ba6127b686611e8b565b6127d781611c6f565b6001815401905561229c846000526004602052604060002090565b60006000805160206140e98339815191528180a4565b606460405162461bcd60e51b815260206004820152602060248201527f4552433732313a206d696e7420746f20746865207a65726f20616464726573736044820152fd5b6040516375ab03ab60e11b8152600490fd5b1561286557565b60405162461bcd60e51b815260206004820152601c60248201527b115490cdcc8c4e881d1bdad95b88185b1c9958591e481b5a5b9d195960221b6044820152606490fd5b6040516128b5816107c3565b60008152906000368137565b6020908051156128cf570190565b612562611051565b60209181518110156128ec575b60051b010190565b6128f4611051565b6128e4565b60ff601254168015612998575b156129345750604051612918816107a8565b600c81526b1b9bdd081b1a5d99481e595d60a21b602082015290565b61251c9060115490810180911161298b575b1161295e57604051612957816107c3565b6000815290565b60405161296a816107a8565b60118152706e6f7420656e6f75676820737570706c7960781b602082015290565b612993611ece565b612946565b506000612906565b8181106129ab575050565b600081556001016129a0565b90601f82116129c4575050565b61080e91600f6000526020600020906020601f840160051c830193106129f2575b601f0160051c01906129a0565b90915081906129e5565b9081602091031261000e575190565b8151916001600160401b038311612a93575b600160401b8311612a86575b8154838355808410612a68575b50602080910191600052806000209060005b848110612a56575050505050565b83518382015592810192600101612a48565b612a80908360005284602060002091820191016129a0565b38612a36565b612a8e610769565b612a29565b612a9b610769565b612a1d565b90612aba81511515839060ff801983541691151516179055565b602081810151835461ff00191690151560081b61ff0016178355604090910151805160019390929084019181906001600160401b038511612b67575b600160401b8511612b5a575b8354858555808610612b3d575b500191600052806000209060005b848110612b2c57505050505050565b835183820155928101928501612b1d565b612b549085600052868460002091820191016129a0565b38612b0f565b612b62610769565b612b02565b612b6f610769565b612af6565b600a54600160401b811015612bb9575b6001810180600a55811015612bac575b600a6000526000805160206140898339815191520155565b612bb4611051565b612b94565b612bc1610769565b612b84565b15612bcd57565b60405162461bcd60e51b81526020600482015260116024820152701c995c5d595cdd081b9bdd08199bdd5b99607a1b6044820152606490fd5b604090610502939281528160208201520190610f7e565b90612562602092828151948592016104a9565b60405190612c3d82610780565b604082527f6768696a6b6c6d6e6f707172737475767778797a303132333435363738392b2f6040837f4142434445464748494a4b4c4d4e4f505152535455565758595a61626364656660208201520152565b90612c9982611339565b612ca660405191826107de565b8281528092612cb7601f1991611339565b0190602036910137565b805115612d9357612cd0612c30565b612cf4612cef612cea612ce38551612316565b6003900490565b611ee5565b612c8f565b9160208301918182518301915b828210612d4157505050600390510680600114612d2e57600214612d23575090565b603d90600019015390565b50603d9081600019820153600119015390565b9091936004906003809401938451600190603f9082828260121c16880101518553828282600c1c16880101518386015382828260061c1688010151600286015316850101519082015301939190612d01565b50610502612331565b60031115612da657565b634e487b7160e01b600052602160045260246000fd5b60405190612dc9826107a8565b600b82526a030203020343030203430360ac1b6020830152565b60405190612df0826107a8565b600b82526a030203020343030203130360ac1b6020830152565b60405190612e17826107a8565b60058252640626060e0f60db1b6020830152565b60405190612e38826107a8565b60058252640686060e0f60db1b6020830152565b60405190612e59826107a8565b60168252751e3a32bc3a103c1e939a981293903c9e939a9812939f60511b6020830152565b906004811015612e8f5760051b0190565b610850611051565b60629061080e9294936040519582612eb98894518092602080880191016104a9565b83017f3c747370616e207374796c653d27666f6e742d766172696174696f6e2d73657460208201527703a34b733b99d101311bc19191dbbb3b43a1311bc19191d960451b6040820152612f168251809360206058850191016104a9565b0161139f60f11b6058820152612f36825180936020605a850191016104a9565b01671e17ba39b830b71f60c11b605a8201520360428101855201836107de565b9061080e602760405184612f748296518092602080860191016104a9565b8101661e17ba32bc3a1f60c91b60208201520360078101855201836107de565b608561080e919392936040519485917f3c7465787420783d273530252720793d2735302527207374796c653d2762617360208401527f656c696e652d73686966743a20323570783b666f6e742d766172696174696f6e60408401527b016b9b2ba3a34b733b99d101311bc19191dbbb3b43a1311bc19191d960251b6060840152613028815180926020607c870191016104a9565b820161139f60f11b607c820152613049825180936020607e850191016104a9565b01661e17ba32bc3a1f60c91b607e8201520360658101855201836107de565b60208183031261000e578051906001600160401b03821161000e570181601f8201121561000e57805161309a81611339565b926130a860405194856107de565b8184526020828401011161000e5761050291602080850191016104a9565b9061080e609760405180947f40666f6e742d666163657b666f6e742d66616d696c793a74623b666f6e742d7760208301527f65696768743a30203636303b7372633a75726c28646174613a6170706c69636160408301527f74696f6e2f666f6e742d776f6666323b636861727365743d7574662d383b62616060830152641cd94d8d0b60da1b60808301526131658151809260206085860191016104a9565b8101712920666f726d61742827776f66663227297d60701b60858201520360778101855201836107de565b6040519061319d826107a8565b60048252630233030360e41b6020830152565b604051906131bd826107a8565b600482526311b3333360e11b6020830152565b604051906131dd82610780565b602f82526e103334b6361e9391b333331390179f60891b6040837f3c726563742077696474683d273130302527206865696768743d27313030252760208201520152565b93919594929095604051968795602087016d3c7376672076696577426f783d2760901b905280519081602e8901916020019161325c926104a9565b7f27207072657365727665417370656374526174696f3d27784d6964594d696420602e918801918201527f6d6565742720786d6c6e733d27687474703a2f2f7777772e77332e6f72672f32604e8201527518181817b9bb33939f1e3232b3399f1e39ba3cb6329f60511b606e8201528151916132e190839060848401906020016104a9565b0160848101783a32bc3a3db337b73a16b330b6b4b63c9d3a311db334b6361d60391b9052609d0161331191612c1d565b6a1db337b73a16b9b4bd329d60a91b8152600b0161332e91612c1d565b7f3b746578742d616e63686f723a206d6964646c653b646f6d696e616e742d626181527f73656c696e653a2063656e7472616c3b7d3c2f7374796c653e3c2f646566733e602082015260400161338391612c1d565b61338c91612c1d565b651e17b9bb339f60d11b8152036019198101835260060161080e90836107de565b91906133b7612dbc565b6133bf612e0a565b916133c8612e4c565b946000905b60048210613476575050506133e56105029394612f56565b916134316133fa61223961223960135461061a565b604051635dc44aed60e01b81526001600482015290600090829060249082905afa908115613469575b600091613448575b506130c6565b613439613190565b90613442612331565b93613221565b613463913d8091833e61345b81836107de565b810190613068565b3861342b565b613471611f18565b613423565b9091956134a46134aa9160408061348d878c612e7e565b5101519061349b8787612e7e565b51015191612e97565b9261254a565b909591956133cd565b94939091926134c182612d9c565b600182036135ec576134d1612de3565b925b6134dc83612d9c565b6002831480156135e1576134f76134f1612e2b565b94612d9c565b15613583576105029596604080613515935101519151015190612f94565b935b15613576576135306133fa61223961223960135461061a565b61353982612d9c565b60018203613568576135496131b0565b915b61355481612d9c565b613560576134426131d0565b613442612331565b613570613190565b9161354b565b61357e612331565b613530565b9561358c612e4c565b966000915b600483106135af575050506135a96105029596612f56565b93613517565b9091976135d46135da916040806135c68d88612e7e565b5101519061349b8d87612e7e565b9861254a565b9190613591565b6134f76134f1612e0a565b6135f4612dbc565b926134d3565b6040519061360782610780565b60606040838281528260208201520152565b6040519060808083016001600160401b0381118482101761365d575b6040528260005b82811061364857505050565b6020906136536135fa565b818401520161363c565b613665610769565b613635565b6040519061014082016001600160401b038111838210176136b5575b604052600982528160005b610120811061369e575050565b6020906136a96135fa565b82828501015201613691565b6136bd610769565b613686565b60038110156136d5575b60450190600090565b6136dd611051565b6136cc565b604051906136ef826107a8565b60078252664d414348494e4560c81b6020830152565b6004811015613718575b60140190600090565b613720611051565b61370f565b60009291815461373481611d81565b9260019180831690811561378d5750600114613751575b50505050565b90919293945060005260209081600020906000915b85831061377c575050505001903880808061374b565b805485840152918301918101613766565b60ff191684525050508115159091020191503880808061374b565b9061080e60076137c2936040519485916020830190613725565b662053455249455360c81b8152036018198101855201836107de565b60058110156137f1575b60180190600090565b6137f9611051565b6137e8565b60021b906103fc60fc831692168203611efd57565b6014811015613826575b60310190600090565b61382e611051565b61381d565b6014811015613846575b601d0190600090565b61384e611051565b61383d565b9061080e600561386d936040519485916020830190613725565b6420434f505960d81b815203601a198101855201836107de565b61388f6135fa565b50613898613619565b906138a1613619565b906138aa610810565b93600080865260209281848801526138ce60409183838a01528360608a01526126da565b80885280601c89015280603889015260548801526138ea61366a565b93849161391061390b63ffffffff60e01b8b511660021a60ff600391160690565b6136c2565b5061392c61391c610801565b916139256136e2565b8352611dbb565b83820152613938612331565b818301529860019089828c61394c886128c1565b52613956876128c1565b5087905b8b6004831061396f5750505050505050505050565b613abb838a92613a4a610a9e95613a2f8f613ad69a8f8f613a108f8a956139aa61399c886139b294612e7e565b516001600160e01b03191690565b6005911a0690565b6139c46139be87613705565b506137a8565b93613a076139f56139f0896139eb6139e56139de886137de565b50976137fe565b60ff1690565b612324565b613813565b50926139ff610801565b968752611dbb565b90850152611dbb565b90820152613a1e8383612e7e565b52613a298282612e7e565b50612e7e565b51613a4382613a3d8161254a565b986128d7565b528d6128d7565b50613a676139e5613a5e61399c858c612e7e565b6015908c1a0690565b613aad8c613a7d613a7786613705565b50613853565b92613a98613a93613a8d83613adf565b92612307565b613833565b5091613aa2610801565b948552840152611dbb565b8b820152613a1e8383612e7e565b51613acf82613ac98161254a565b9b6128d7565b528b6128d7565b8a90899661395a565b6000908072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b80821015613c0e575b506904ee2d6d415b85acef8160201b80831015613bff575b50662386f26fc1000080831015613bf0575b506305f5e10080831015613be1575b5061271080831015613bd2575b506064821015613bc2575b600a80921015613bb8575b600190816021613b70828701612c8f565b95860101905b613b82575b5050505090565b600019019083906f181899199a1a9b1b9c1cb0b131b232b360811b8282061a835304918215613bb357919082613b76565b613b7b565b9160010191613b5f565b9190606460029104910191613b54565b60049193920491019138613b49565b60089193920491019138613b3c565b60109193920491019138613b2d565b60209193920491019138613b1b565b604093508104915038613b03565b60405190613c29826107a8565b60038252620d0c0d60ea1b6020830152565b607d60f81b815260010190565b7f646174613a6170706c69636174696f6e2f6a736f6e3b6261736536342c0000008152601d0190565b613c7d6127b682611e8b565b613f5157613c8a81613887565b9250613c95916133ad565b91613c9f90613adf565b90613ca990613f92565b90604051928360208101613cbd9083612c1d565b0393601f19948581018252613cd290826107de565b613cdb90612cc1565b90604051809160208201613d9890608a907f3c68746d6c3e3c686561643e3c6d65746120636861727365743d275554462d3881527f273e3c7374796c653e68746d6c2c626f64792c7376677b6d617267696e3a303b60208201527f70616464696e673a303b2077696474683a313030253b6865696768743a31303060408201527f253b746578742d616c69676e3a63656e7465723b7d3c2f7374796c653e3c2f6860608201526932b0b21f1e3137b23c9f60b11b60808201520190565b613da191612c1d565b6d1e17b137b23c9f1e17b43a36b61f60911b8152600e01038581018252613dc890826107de565b613dd190612cc1565b6040516e7b226e616d65223a2250554e4b202360881b6020820152938493919291602f8501613dff91612c1d565b7f222c226465736372697074696f6e223a202250554e4b53204e4f5420444541448152601160f91b60208201526021016f2c2261747472696275746573223a205b60801b8152601001613e5191612c1d565b7f5d2c226173706563745f726174696f223a20312c22696d616765223a202264618152771d184e9a5b5859d94bdcdd99cade1b5b0ed8985cd94d8d0b60421b6020820152603801613ea191612c1d565b601160f91b81526001017f2c22616e696d6174696f6e5f75726c223a22646174613a746578742f68746d6c8152750ed8da185c9cd95d0f5d5d198b4e0ed8985cd94d8d0b60521b6020820152603601613ef991612c1d565b601160f91b8152600101613f0c90613c3b565b038281018252613f1c90826107de565b613f2590612cc1565b90604051809260208201613f3890613c48565b613f4191612c1d565b03908101825261050290826107de565b50610502613c1c565b9061080e602160405184613f788296518092602080860191016104a9565b8101600b60fa1b60208201520360018101855201836107de565b90606060005b83518110156140835761404c603c613fb083876128d7565b515193602080613fc0868a6128d7565b5101516040519683613fdb89955180928680890191016104a9565b84016e3d913a3930b4ba2fba3cb832911d1160891b8482015281519061400982602f948786850191016104a9565b01906a1116113b30b63ab2911d1160a91b9082015261403282518093603a9586850191016104a9565b019061227d60f01b9082015203601c8101855201836107de565b816140578551612307565b821061406d575b506140689061254a565b613f98565b61406891925061407c90613f5a565b919061405e565b50915056fec65a7bb8d6351c1cf70c95a316cc6a92839c986682d98bc35f958f4883f9d2a84f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65728be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa26469706673582212202e266497617fd271a36223a585df14e67a23562f466c22d85594de045b90b44564736f6c63430008110033405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5ace00000000000000000000000008a72a8a49debb183ac5c0f25053c23c863c9a7200000000000000000000000099f9043b42360a294f797fa6dd4c74d05154a59500000000000000000000000079c4388c061873baeaf53cebd19bc71a86f55bfa0000000000000000000000000000000000000000000000000000000000000245

0x60806040526004361015610013575b600080fd5b60003560e01c806301ffc9a71461037a57806302329a291461037157806306fdde0314610368578063072dad781461035f578063081812fc14610356578063095ea7b31461034d5780631fe543e31461034457806323b872dd1461033b5780632a55205a146103325780633c1d9b621461032957806340c10f191461032057806341f434341461031757806342842e0e1461030e57806347ce07cc146103055780634bbb2346146102635780634c261247146102fc57806351cff8d9146102f35780636352211e146102ea57806365b8bb86146102e157806370a08231146102d8578063715018a6146102cf5780638462151c146102c65780638796ba8c146102bd5780638a0b4456146102b45780638da5cb5b146102ab57806395d89b41146102a25780639a26082214610299578063a168fa8914610290578063a22cb46514610287578063b13038a11461027e578063b88d4fde14610275578063be65d7511461026c578063c6ab67a314610263578063c87b56dd1461025a578063cce8431e14610251578063d8a4676f14610248578063e0665b391461023f578063e1a283d614610236578063e2a702761461022d578063e8a3d48514610224578063e985e9c51461021b578063f2fde38b14610212578063f3c86ff5146102095763fc2a88c31461020157600080fd5b61000e611b0c565b5061000e611a56565b5061000e611912565b5061000e6118c0565b5061000e6116e5565b5061000e61169c565b5061000e611678565b5061000e611580565b5061000e6114ba565b5061000e61143e565b5061000e61141e565b5061000e610c18565b5061000e6113ec565b5061000e611363565b5061000e61131d565b5061000e61123d565b5061000e611200565b5061000e6111e3565b5061000e61113e565b5061000e611110565b5061000e6110e8565b5061000e611068565b5061000e610fb2565b5061000e610f2b565b5061000e610f07565b5061000e610ed9565b5061000e610eba565b5061000e610dfa565b5061000e610c51565b5061000e610bf9565b5061000e610b5d565b5061000e610b33565b5061000e610ac8565b5061000e6109fb565b5061000e61095f565b5061000e610916565b5061000e610855565b5061000e610683565b5061000e610626565b5061000e6105e6565b5061000e610505565b5061000e610428565b5061000e610395565b6001600160e01b031981160361000e57565b503461000e57602036600319011261000e5760206004356103b581610383565b63ffffffff60e01b166380ac58cd60e01b811490811561040d575b81156103e2575b506040519015158152f35b63152a902d60e11b8114915081156103fc575b50386103d7565b6301ffc9a760e01b149050386103f5565b635b5e139f60e01b811491506103d0565b8015150361000e57565b503461000e57602036600319011261000e576004356104468161041e565b61046860018060a01b0380600e5460501c16331490811561047d575b506124fb565b60ff8019601254169115151617601255600080f35b7f0000000000000000000000001e5a692c24dce13a5e32f21fd944fb8842f5567f163314905038610462565b60005b8381106104bc5750506000910152565b81810151838201526020016104ac565b906020916104e5815180928185528580860191016104a9565b601f01601f1916010190565b9060206105029281815201906104cc565b90565b503461000e576000806003193601126105e3576040518160025461052881611d81565b808452906001908181169081156105bb5750600114610562575b61055e84610552818803826107de565b604051918291826104f1565b0390f35b60028352602094507f405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5ace5b8284106105a8575050508161055e936105529282010193610542565b805485850187015292850192810161058c565b61055e96506105529450602092508593915060ff191682840152151560051b82010193610542565b80fd5b503461000e57602036600319011261000e5761055e6106066004356128f9565b6040519182916020835260208301906104cc565b6001600160a01b031690565b503461000e57602036600319011261000e576020610645600435611e5f565b6040516001600160a01b039091168152f35b600435906001600160a01b038216820361000e57565b602435906001600160a01b038216820361000e57565b503461000e57604036600319011261000e5761069d610657565b6024356106a982611f25565b6106b281611d5e565b916001600160a01b03808416908216811461071a576106e4936106df9133149081156106e6575b50611fe6565b612077565b005b6001600160a01b03166000908152600760205260409020610714915061070d903390611c89565b5460ff1690565b386106d9565b60405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b6064820152608490fd5b50634e487b7160e01b600052604160045260246000fd5b606081019081106001600160401b0382111761079b57604052565b6107a3610769565b604052565b604081019081106001600160401b0382111761079b57604052565b602081019081106001600160401b0382111761079b57604052565b601f909101601f19168101906001600160401b0382119082101761079b57604052565b6040519061080e82610780565b565b60405190608082016001600160401b0381118382101761079b57604052565b6020906001600160401b038111610848575b60051b0190565b610850610769565b610841565b503461000e57604036600319011261000e576024356001600160401b03811161000e573660238201121561000e578060040135906108928261082f565b906108a060405192836107de565b82825260209260248484019160051b8301019136831161000e57602401905b8282106108d2576106e484600435611b45565b813581529084019084016108bf565b606090600319011261000e576001600160a01b0390600435828116810361000e5791602435908116810361000e579060443590565b503461000e576106e4610928366108e1565b91336001600160a01b03821603610951575b61094c610947843361212d565b6120cb565b6121f5565b61095a33611f25565b61093a565b503461000e57604036600319011261000e57600435600052600160205260406000206040519061098e826107a8565b546001600160a01b0380821680845260a09290921c602084015290156109eb575b6020820151612710906109cd906001600160601b0316602435611f05565b925160408051939091166001600160a01b0316835292046020820152f35b90506109f5611ea8565b906109af565b503461000e57606036600319011261000e57610a15610657565b602435610a3960018060a01b0380600e5460501c16331490811561047d57506124fb565b6010546101f4908103908111610abb575b8111610aa9576011549060005b818110610a915761055e8383601054908101809111610a84575b6010556040519081529081906020820190565b610a8c611ece565b610a71565b610aa490610a9e85612775565b5061254a565b610a57565b604051635284fe7760e01b8152600490fd5b610ac3611ece565b610a4a565b503461000e57604036600319011261000e57610ae2610657565b610aea611c26565b61251c60115460018101809111610b26575b11610b1457610b0c602091612775565b604051908152f35b604051637be9badb60e01b8152600490fd5b610b2e611ece565b610afc565b503461000e57600036600319011261000e5760206040516daaeb6d7670e522a718067333cd4e8152f35b503461000e57610bb9610b6f366108e1565b6001600160a01b0383163314159290919083610beb575b60405193610b93856107c3565b60008552610bdd575b610ba9610947843361212d565b610bb48383836121f5565b612438565b15610bc057005b60405162461bcd60e51b815280610bd96004820161236f565b0390fd5b610be633611f25565b610b9c565b610bf433611f25565b610b86565b503461000e57600036600319011261000e576020600c54604051908152f35b503461000e57600036600319011261000e5761055e604051610c39816107c3565b600081526040519182916020835260208301906104cc565b503461000e5760208060031936011261000e576004356001600160401b0380821161000e573660238301121561000e57816004013590811161000e5760243681838501011161000e57610cbb60018060a01b0380600e5460501c16331490811561047d57506124fb565b604051927f7b957997f488ae05c66002a4b6416afff084b7065cbb580144af328e4bb5fd0485850184848401823784860195610d0588826000998a838201520380845201826107de565b51902003610de857610d2183610d1c600f54611d81565b6129b7565b8394601f8411600114610d605750938394839493610d53575b5050508160011b916000199060031b1c191617600f5580f35b0101359050388080610d3a565b600f600052601f198416957f8d1108e10bcb7c27dddfc02ed9d693a074039d026cf4ea4240b40f7d581ac802939186905b888210610dce575050846001969710610db2575b50505050811b01600f5580f35b60001960f88660031b161c199201013516905538808080610da5565b806001849786839596890101358155019601920190610d91565b604051631b9a273b60e11b8152600490fd5b503461000e57602036600319011261000e57610e14610657565b60018060a01b0380600e5460501c1633148015610e8f575b610e35906124fb565b60008080809481944791165af1610e4a612408565b5015610e535780f35b60405162461bcd60e51b815260206004820152601460248201527315da5d1a191c985dc81d5b9cdd58d8d95cd99d5b60621b6044820152606490fd5b507f0000000000000000000000001e5a692c24dce13a5e32f21fd944fb8842f5567f81163314610e2c565b503461000e57602036600319011261000e576020610645600435611d5e565b503461000e57600036600319011261000e5760125460405160089190911c6001600160a01b03168152602090f35b503461000e57602036600319011261000e576020610b0c610f26610657565b611ca0565b503461000e576000806003193601126105e357610f46611c26565b600e8054600160501b600160f01b03198116909155819060501c6001600160a01b03166000805160206140c98339815191528280a380f35b90815180825260208080930193019160005b828110610f9e575050505090565b835185529381019392810192600101610f90565b503461000e57602036600319011261000e57610fcc610657565b6000610fd782611ca0565b90610fe18261082f565b92610fef60405194856107de565b828452601f19610ffe8461082f565b013660208601376001600160a01b031615815b83830361102e576040516020808252819061055e90820188610f7e565b6001908261103d575b01611011565b8061104b83860195886128d7565b52611037565b50634e487b7160e01b600052603260045260246000fd5b503461000e57602036600319011261000e57600435600a5481101561000e57600a6000526000805160206140898339815191520154604051908152602090f35b6003111561000e57565b608090600319011261000e57600435906024356110ce8161041e565b906044356110db816110a8565b90606435610502816110a8565b503461000e5761055e610606611108611100366110b2565b939092613887565b5091506134b3565b503461000e57600036600319011261000e57600e5460405160509190911c6001600160a01b03168152602090f35b503461000e576000806003193601126105e3576040518160035461116181611d81565b808452906001908181169081156105bb575060011461118a5761055e84610552818803826107de565b60038352602094507fc2575a0e9e593c00f959f8c92f12db2869c3395a3b0502d05e2516446f71f85b5b8284106111d0575050508161055e936105529282010193610542565b80548585018701529285019281016111b4565b503461000e57600036600319011261000e57602060405160008152f35b503461000e57602036600319011261000e5760043560005260086020526040806000205460ff8251918181161515835260081c1615156020820152f35b503461000e57604036600319011261000e57611257610657565b6024356112638161041e565b61126c82611f25565b6001600160a01b038216913383146112dc57816112996112aa923360005260076020526040600020611c89565b9060ff801983541691151516179055565b604051901515815233907f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c3190602090a3005b60405162461bcd60e51b815260206004820152601960248201527822a9219b99189d1030b8383937bb32903a379031b0b63632b960391b6044820152606490fd5b503461000e57600036600319011261000e576020610b0c612566565b6020906001600160401b038111611356575b601f01601f19160190565b61135e610769565b61134b565b503461000e57608036600319011261000e5761137d610657565b61138561066d565b606435916001600160401b03831161000e573660238401121561000e578260040135916113b183611339565b926113bf60405194856107de565b808452366024828701011161000e5760208160009260246106e49801838801378501015260443591612344565b503461000e57602036600319011261000e57602061140b6004356126da565b6040516001600160801b03199091168152f35b503461000e57602036600319011261000e5761055e610606600435613c71565b503461000e57600036600319011261000e5761147160018060a01b0380600e5460501c16331490811561047d57506124fb565b600c541561147b57005b60405160208101904482524260408201526040815261149981610780565b519020600c55005b6040906105029392151581528160208201520190610f7e565b503461000e5760208060031936011261000e576004356000818152600883526040916114ee60ff8484205460081c16612bc6565b8152600883528181209282519161150483610780565b60ff85548181161515855260081c16151582840152600180950190845195868488958554928381520194845280842093905b82821061156857868961055e61155d8b611552858c03866107de565b848482015251151590565b9151928392836114a1565b84548652899650948501949383019390830190611536565b503461000e57604036600319011261000e5761159a610657565b6115a261066d565b9060018060a01b039081600e5460501c163314801561164d575b6115c5906124fb565b600c5461160b57601380546001600160a01b0319169290911691909117905560128054610100600160a81b03191660089290921b610100600160a81b0316919091179055005b60405162461bcd60e51b815260206004820152601a6024820152791b595d1859185d1848185b1c9958591e48199a5b985b1a5e995960321b6044820152606490fd5b507f0000000000000000000000001e5a692c24dce13a5e32f21fd944fb8842f5567f821633146115bc565b503461000e57600036600319011261000e57602060ff601254166040519015158152f35b503461000e5761055e6106066116b7611108611100366110b2565b6116e06020604051836116d382955180928580860191016104a9565b81010380845201826107de565b612cc1565b503461000e57600036600319011261000e576040516d3d913730b6b2911d11282aa7259160911b60208201527f2c226465736372697074696f6e223a20225448452050554e4b2044524f502200602e8201527f2c2022696d616765223a2268747470733a2f2f696d61676564656c6976657279604d8201527f2e6e65742f5948594b705a794a4d47636a704473506a6a35584d772f35326238606d8201527f643663612d303831662d343435392d623962662d333034366364323739383030608d8201526717b83ab13634b19160c11b60ad8201527f2c202265787465726e616c5f6c696e6b223a2268747470733a2f2f747269627560b58201527f74652d6272616e642e636f6d2f222c202273656c6c65725f6665655f6261736960d58201527f735f706f696e7473223a203735302c20226665655f726563697069656e74223a60f58201527f20223078434630344231333846366563306632613645343466443336453234346101158201526d0311a21181b9b9c9c18191bb311160951b61013582015261055e906118b4906105529061189c816118886101438201613c3b565b03916116e0601f19938481018352826107de565b6040519384916118ae60208401613c48565b90612c1d565b039081018352826107de565b503461000e57604036600319011261000e57602060ff6119066118e1610657565b6118e961066d565b6001600160a01b0390911660009081526007855260409020611c89565b54166040519015158152f35b503461000e57602036600319011261000e5761192c610657565b611934611c26565b6001600160a01b0381811691821561198557600e8054600160501b600160f01b03198116605093841b600160501b600160f01b031617909155901c166000805160206140c9833981519152600080a3005b60405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608490fd5b610502916040611a076119f584516060855260608501906104cc565b602085015184820360208601526104cc565b9201519060408184039101526104cc565b60808201918060005b60048110611a30575050505090565b90919293611a46818560019303855286516119d9565b9460209081019493019101611a21565b503461000e5760208060031936011261000e57611aa1611aaf611a7a600435613887565b9392949091611a94604051966080885260808801906119d9565b9086820388880152611a18565b908482036040860152611a18565b92828403606084015281518085528185019180808360051b8801019401926000965b838810611ade5786860387f35b90919293948380611afb600193601f1986820301875289516119d9565b970193019701969093929193611ad1565b503461000e57600036600319011261000e576020600b54604051908152f35b6001600160a01b0391821681529116602082015260400190565b7f000000000000000000000000271682deb8c4e0901d1a1550ad2e64d568e699099291906001600160a01b0384163303611c0a577ffe2e2d779dba245964d4e3ef9b994be63856fd568bf7d3ca9e224755cb1bd54d929350806000526008602052611bba60ff60406000205460081c16612bc6565b8060005260086020526040600020600160ff19825416179055611be4826001604060002001612a0b565b611bf6611bf0836128c1565b51600c55565b611c0560405192839283612c06565b0390a1565b60405163073e64fd60e21b815280610bd9863360048401611b2b565b600e5460501c6001600160a01b03163303611c3d57565b606460405162461bcd60e51b815260206004820152602060248201526000805160206140a98339815191526044820152fd5b6001600160a01b0316600090815260056020526040902090565b9060018060a01b0316600052602052604060002090565b6001600160a01b03168015611cc057600052600560205260406000205490565b60405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b6064820152608490fd5b15611d1e57565b60405162461bcd60e51b8152602060048201526018602482015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b6044820152606490fd5b6000908152600460205260409020546001600160a01b0316610502811515611d17565b90600182811c92168015611db1575b6020831014611d9b57565b634e487b7160e01b600052602260045260246000fd5b91607f1691611d90565b9060405191826000825492611dcf84611d81565b908184526001948581169081600014611e3c5750600114611df9575b505061080e925003836107de565b9093915060005260209081600020936000915b818310611e2457505061080e93508201013880611deb565b85548884018501529485019487945091830191611e0c565b91505061080e94506020925060ff191682840152151560051b8201013880611deb565b611e70611e6b82611e8b565b611d17565b6000908152600660205260409020546001600160a01b031690565b6000908152600460205260409020546001600160a01b0316151590565b60405190611eb5826107a8565b6000546001600160a01b038116835260a01c6020830152565b50634e487b7160e01b600052601160045260246000fd5b600281901b91906001600160fe1b03811603611efd57565b61080e611ece565b81810292918115918404141715611efd57565b506040513d6000823e3d90fd5b6daaeb6d7670e522a718067333cd4e803b611f3e575050565b60206040518092633185c44d60e21b82528180611f5f873060048401611b2b565b03915afa908115611fd9575b600091611f9f575b5015611f7c5750565b604051633b79c77360e21b81526001600160a01b03919091166004820152602490fd5b906020823d8211611fd1575b81611fb8602093836107de565b810103126105e3575051611fcb8161041e565b38611f73565b3d9150611fab565b611fe1611f18565b611f6b565b15611fed57565b60405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c0000006064820152608490fd5b80546001600160a01b0319166001600160a01b03909216919091179055565b81600052600660205261208e816040600020612058565b6001600160a01b03806120a084611d5e565b169116907f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925600080a4565b156120d257565b60405162461bcd60e51b815260206004820152602d60248201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560448201526c1c881bdc88185c1c1c9bdd9959609a1b6064820152608490fd5b6001600160a01b038061213f84611d5e565b169281831692848414948515612175575b5050831561215f575b50505090565b61216b91929350611e5f565b1614388080612159565b60ff929550906121919160005260076020526040600020611c89565b5416923880612150565b156121a257565b60405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b6064820152608490fd5b6122199061220284611d5e565b6001600160a01b038281169390918216841461219b565b83169283156122b6576122706122a1926122448561223e6122398a611d5e565b61061a565b1461219b565b61226b61225b886000526006602052604060002090565b80546001600160a01b0319169055565b611c6f565b805460001901905561228181611c6f565b6001815401905561229c856000526004602052604060002090565b612058565b6000805160206140e9833981519152600080a4565b60405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b600019810191908211611efd57565b9060028201809211611efd57565b91908201809211611efd57565b6040519061233e826107c3565b60008252565b61236893929190336001600160a01b03821603610bdd57610ba9610947843361212d565b15610bc057565b60809060208152603260208201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b60608201520190565b9081602091031261000e575161050281610383565b6001600160a01b039182168152911660208201526040810191909152608060608201819052610502929101906104cc565b3d15612433573d9061241982611339565b9161242760405193846107de565b82523d6000602084013e565b606090565b92909190823b156124f25761246b926020926000604051809681958294630a85bd0160e11b9a8b855233600486016123d7565b03926001600160a01b03165af1600091816124c2575b506124b45761248e612408565b805190816124af5760405162461bcd60e51b815280610bd96004820161236f565b602001fd5b6001600160e01b0319161490565b6124e491925060203d81116124eb575b6124dc81836107de565b8101906123c2565b9038612481565b503d6124d2565b50505050600190565b1561250257565b60405162461bcd60e51b815260206004820152602c60248201526000805160206140a983398151915260448201526b1037b9103232b83637bcb2b960a11b6064820152608490fd5b600190600019811461255a570190565b612562611ece565b0190565b600c546126d557600954600d54600e546040516305d3b1d360e41b8152600481019290925260a083901c6001600160401b03166024830152602081811c61ffff16604484015263ffffffff808316606485015260309290921c9091166084830152909182908160008160a4810103926001600160a01b03165af19081156126c8575b60009161269a575b5061262e6125fc6128a9565b612604610801565b6000815260016020820152906040820152612629836000526008602052604060002090565b612aa0565b61263781612b74565b61264081600b55565b7fcc58b13ad3eab50626c6a6300b1d139cd6ebb1688a7cced9461c2f7e762665ee612694612677600e5463ffffffff9060301c1690565b6040805185815263ffffffff909216602083015290918291820190565b0390a190565b6126bb915060203d81116126c1575b6126b381836107de565b8101906129fc565b386125f0565b503d6126a9565b6126d0611f18565b6125e8565b600090565b601254600c54604051631a61c61360e31b8152600481019390935260248301526020908290604490829060081c6001600160a01b03165afa908115612768575b600091612725575090565b6020813d8211612760575b8161273d602093836107de565b8101031261275c5751906001600160801b0319821682036105e3575090565b5080fd5b3d9150612730565b612770611f18565b61271a565b9060ff6012541661284c5760115461278c8161254a565b6011559182906001600160a01b038116908115612808576127f2906127bf6127ba6127b686611e8b565b1590565b61285e565b6127ce6127ba6127b686611e8b565b6127d781611c6f565b6001815401905561229c846000526004602052604060002090565b60006000805160206140e98339815191528180a4565b606460405162461bcd60e51b815260206004820152602060248201527f4552433732313a206d696e7420746f20746865207a65726f20616464726573736044820152fd5b6040516375ab03ab60e11b8152600490fd5b1561286557565b60405162461bcd60e51b815260206004820152601c60248201527b115490cdcc8c4e881d1bdad95b88185b1c9958591e481b5a5b9d195960221b6044820152606490fd5b6040516128b5816107c3565b60008152906000368137565b6020908051156128cf570190565b612562611051565b60209181518110156128ec575b60051b010190565b6128f4611051565b6128e4565b60ff601254168015612998575b156129345750604051612918816107a8565b600c81526b1b9bdd081b1a5d99481e595d60a21b602082015290565b61251c9060115490810180911161298b575b1161295e57604051612957816107c3565b6000815290565b60405161296a816107a8565b60118152706e6f7420656e6f75676820737570706c7960781b602082015290565b612993611ece565b612946565b506000612906565b8181106129ab575050565b600081556001016129a0565b90601f82116129c4575050565b61080e91600f6000526020600020906020601f840160051c830193106129f2575b601f0160051c01906129a0565b90915081906129e5565b9081602091031261000e575190565b8151916001600160401b038311612a93575b600160401b8311612a86575b8154838355808410612a68575b50602080910191600052806000209060005b848110612a56575050505050565b83518382015592810192600101612a48565b612a80908360005284602060002091820191016129a0565b38612a36565b612a8e610769565b612a29565b612a9b610769565b612a1d565b90612aba81511515839060ff801983541691151516179055565b602081810151835461ff00191690151560081b61ff0016178355604090910151805160019390929084019181906001600160401b038511612b67575b600160401b8511612b5a575b8354858555808610612b3d575b500191600052806000209060005b848110612b2c57505050505050565b835183820155928101928501612b1d565b612b549085600052868460002091820191016129a0565b38612b0f565b612b62610769565b612b02565b612b6f610769565b612af6565b600a54600160401b811015612bb9575b6001810180600a55811015612bac575b600a6000526000805160206140898339815191520155565b612bb4611051565b612b94565b612bc1610769565b612b84565b15612bcd57565b60405162461bcd60e51b81526020600482015260116024820152701c995c5d595cdd081b9bdd08199bdd5b99607a1b6044820152606490fd5b604090610502939281528160208201520190610f7e565b90612562602092828151948592016104a9565b60405190612c3d82610780565b604082527f6768696a6b6c6d6e6f707172737475767778797a303132333435363738392b2f6040837f4142434445464748494a4b4c4d4e4f505152535455565758595a61626364656660208201520152565b90612c9982611339565b612ca660405191826107de565b8281528092612cb7601f1991611339565b0190602036910137565b805115612d9357612cd0612c30565b612cf4612cef612cea612ce38551612316565b6003900490565b611ee5565b612c8f565b9160208301918182518301915b828210612d4157505050600390510680600114612d2e57600214612d23575090565b603d90600019015390565b50603d9081600019820153600119015390565b9091936004906003809401938451600190603f9082828260121c16880101518553828282600c1c16880101518386015382828260061c1688010151600286015316850101519082015301939190612d01565b50610502612331565b60031115612da657565b634e487b7160e01b600052602160045260246000fd5b60405190612dc9826107a8565b600b82526a030203020343030203430360ac1b6020830152565b60405190612df0826107a8565b600b82526a030203020343030203130360ac1b6020830152565b60405190612e17826107a8565b60058252640626060e0f60db1b6020830152565b60405190612e38826107a8565b60058252640686060e0f60db1b6020830152565b60405190612e59826107a8565b60168252751e3a32bc3a103c1e939a981293903c9e939a9812939f60511b6020830152565b906004811015612e8f5760051b0190565b610850611051565b60629061080e9294936040519582612eb98894518092602080880191016104a9565b83017f3c747370616e207374796c653d27666f6e742d766172696174696f6e2d73657460208201527703a34b733b99d101311bc19191dbbb3b43a1311bc19191d960451b6040820152612f168251809360206058850191016104a9565b0161139f60f11b6058820152612f36825180936020605a850191016104a9565b01671e17ba39b830b71f60c11b605a8201520360428101855201836107de565b9061080e602760405184612f748296518092602080860191016104a9565b8101661e17ba32bc3a1f60c91b60208201520360078101855201836107de565b608561080e919392936040519485917f3c7465787420783d273530252720793d2735302527207374796c653d2762617360208401527f656c696e652d73686966743a20323570783b666f6e742d766172696174696f6e60408401527b016b9b2ba3a34b733b99d101311bc19191dbbb3b43a1311bc19191d960251b6060840152613028815180926020607c870191016104a9565b820161139f60f11b607c820152613049825180936020607e850191016104a9565b01661e17ba32bc3a1f60c91b607e8201520360658101855201836107de565b60208183031261000e578051906001600160401b03821161000e570181601f8201121561000e57805161309a81611339565b926130a860405194856107de565b8184526020828401011161000e5761050291602080850191016104a9565b9061080e609760405180947f40666f6e742d666163657b666f6e742d66616d696c793a74623b666f6e742d7760208301527f65696768743a30203636303b7372633a75726c28646174613a6170706c69636160408301527f74696f6e2f666f6e742d776f6666323b636861727365743d7574662d383b62616060830152641cd94d8d0b60da1b60808301526131658151809260206085860191016104a9565b8101712920666f726d61742827776f66663227297d60701b60858201520360778101855201836107de565b6040519061319d826107a8565b60048252630233030360e41b6020830152565b604051906131bd826107a8565b600482526311b3333360e11b6020830152565b604051906131dd82610780565b602f82526e103334b6361e9391b333331390179f60891b6040837f3c726563742077696474683d273130302527206865696768743d27313030252760208201520152565b93919594929095604051968795602087016d3c7376672076696577426f783d2760901b905280519081602e8901916020019161325c926104a9565b7f27207072657365727665417370656374526174696f3d27784d6964594d696420602e918801918201527f6d6565742720786d6c6e733d27687474703a2f2f7777772e77332e6f72672f32604e8201527518181817b9bb33939f1e3232b3399f1e39ba3cb6329f60511b606e8201528151916132e190839060848401906020016104a9565b0160848101783a32bc3a3db337b73a16b330b6b4b63c9d3a311db334b6361d60391b9052609d0161331191612c1d565b6a1db337b73a16b9b4bd329d60a91b8152600b0161332e91612c1d565b7f3b746578742d616e63686f723a206d6964646c653b646f6d696e616e742d626181527f73656c696e653a2063656e7472616c3b7d3c2f7374796c653e3c2f646566733e602082015260400161338391612c1d565b61338c91612c1d565b651e17b9bb339f60d11b8152036019198101835260060161080e90836107de565b91906133b7612dbc565b6133bf612e0a565b916133c8612e4c565b946000905b60048210613476575050506133e56105029394612f56565b916134316133fa61223961223960135461061a565b604051635dc44aed60e01b81526001600482015290600090829060249082905afa908115613469575b600091613448575b506130c6565b613439613190565b90613442612331565b93613221565b613463913d8091833e61345b81836107de565b810190613068565b3861342b565b613471611f18565b613423565b9091956134a46134aa9160408061348d878c612e7e565b5101519061349b8787612e7e565b51015191612e97565b9261254a565b909591956133cd565b94939091926134c182612d9c565b600182036135ec576134d1612de3565b925b6134dc83612d9c565b6002831480156135e1576134f76134f1612e2b565b94612d9c565b15613583576105029596604080613515935101519151015190612f94565b935b15613576576135306133fa61223961223960135461061a565b61353982612d9c565b60018203613568576135496131b0565b915b61355481612d9c565b613560576134426131d0565b613442612331565b613570613190565b9161354b565b61357e612331565b613530565b9561358c612e4c565b966000915b600483106135af575050506135a96105029596612f56565b93613517565b9091976135d46135da916040806135c68d88612e7e565b5101519061349b8d87612e7e565b9861254a565b9190613591565b6134f76134f1612e0a565b6135f4612dbc565b926134d3565b6040519061360782610780565b60606040838281528260208201520152565b6040519060808083016001600160401b0381118482101761365d575b6040528260005b82811061364857505050565b6020906136536135fa565b818401520161363c565b613665610769565b613635565b6040519061014082016001600160401b038111838210176136b5575b604052600982528160005b610120811061369e575050565b6020906136a96135fa565b82828501015201613691565b6136bd610769565b613686565b60038110156136d5575b60450190600090565b6136dd611051565b6136cc565b604051906136ef826107a8565b60078252664d414348494e4560c81b6020830152565b6004811015613718575b60140190600090565b613720611051565b61370f565b60009291815461373481611d81565b9260019180831690811561378d5750600114613751575b50505050565b90919293945060005260209081600020906000915b85831061377c575050505001903880808061374b565b805485840152918301918101613766565b60ff191684525050508115159091020191503880808061374b565b9061080e60076137c2936040519485916020830190613725565b662053455249455360c81b8152036018198101855201836107de565b60058110156137f1575b60180190600090565b6137f9611051565b6137e8565b60021b906103fc60fc831692168203611efd57565b6014811015613826575b60310190600090565b61382e611051565b61381d565b6014811015613846575b601d0190600090565b61384e611051565b61383d565b9061080e600561386d936040519485916020830190613725565b6420434f505960d81b815203601a198101855201836107de565b61388f6135fa565b50613898613619565b906138a1613619565b906138aa610810565b93600080865260209281848801526138ce60409183838a01528360608a01526126da565b80885280601c89015280603889015260548801526138ea61366a565b93849161391061390b63ffffffff60e01b8b511660021a60ff600391160690565b6136c2565b5061392c61391c610801565b916139256136e2565b8352611dbb565b83820152613938612331565b818301529860019089828c61394c886128c1565b52613956876128c1565b5087905b8b6004831061396f5750505050505050505050565b613abb838a92613a4a610a9e95613a2f8f613ad69a8f8f613a108f8a956139aa61399c886139b294612e7e565b516001600160e01b03191690565b6005911a0690565b6139c46139be87613705565b506137a8565b93613a076139f56139f0896139eb6139e56139de886137de565b50976137fe565b60ff1690565b612324565b613813565b50926139ff610801565b968752611dbb565b90850152611dbb565b90820152613a1e8383612e7e565b52613a298282612e7e565b50612e7e565b51613a4382613a3d8161254a565b986128d7565b528d6128d7565b50613a676139e5613a5e61399c858c612e7e565b6015908c1a0690565b613aad8c613a7d613a7786613705565b50613853565b92613a98613a93613a8d83613adf565b92612307565b613833565b5091613aa2610801565b948552840152611dbb565b8b820152613a1e8383612e7e565b51613acf82613ac98161254a565b9b6128d7565b528b6128d7565b8a90899661395a565b6000908072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b80821015613c0e575b506904ee2d6d415b85acef8160201b80831015613bff575b50662386f26fc1000080831015613bf0575b506305f5e10080831015613be1575b5061271080831015613bd2575b506064821015613bc2575b600a80921015613bb8575b600190816021613b70828701612c8f565b95860101905b613b82575b5050505090565b600019019083906f181899199a1a9b1b9c1cb0b131b232b360811b8282061a835304918215613bb357919082613b76565b613b7b565b9160010191613b5f565b9190606460029104910191613b54565b60049193920491019138613b49565b60089193920491019138613b3c565b60109193920491019138613b2d565b60209193920491019138613b1b565b604093508104915038613b03565b60405190613c29826107a8565b60038252620d0c0d60ea1b6020830152565b607d60f81b815260010190565b7f646174613a6170706c69636174696f6e2f6a736f6e3b6261736536342c0000008152601d0190565b613c7d6127b682611e8b565b613f5157613c8a81613887565b9250613c95916133ad565b91613c9f90613adf565b90613ca990613f92565b90604051928360208101613cbd9083612c1d565b0393601f19948581018252613cd290826107de565b613cdb90612cc1565b90604051809160208201613d9890608a907f3c68746d6c3e3c686561643e3c6d65746120636861727365743d275554462d3881527f273e3c7374796c653e68746d6c2c626f64792c7376677b6d617267696e3a303b60208201527f70616464696e673a303b2077696474683a313030253b6865696768743a31303060408201527f253b746578742d616c69676e3a63656e7465723b7d3c2f7374796c653e3c2f6860608201526932b0b21f1e3137b23c9f60b11b60808201520190565b613da191612c1d565b6d1e17b137b23c9f1e17b43a36b61f60911b8152600e01038581018252613dc890826107de565b613dd190612cc1565b6040516e7b226e616d65223a2250554e4b202360881b6020820152938493919291602f8501613dff91612c1d565b7f222c226465736372697074696f6e223a202250554e4b53204e4f5420444541448152601160f91b60208201526021016f2c2261747472696275746573223a205b60801b8152601001613e5191612c1d565b7f5d2c226173706563745f726174696f223a20312c22696d616765223a202264618152771d184e9a5b5859d94bdcdd99cade1b5b0ed8985cd94d8d0b60421b6020820152603801613ea191612c1d565b601160f91b81526001017f2c22616e696d6174696f6e5f75726c223a22646174613a746578742f68746d6c8152750ed8da185c9cd95d0f5d5d198b4e0ed8985cd94d8d0b60521b6020820152603601613ef991612c1d565b601160f91b8152600101613f0c90613c3b565b038281018252613f1c90826107de565b613f2590612cc1565b90604051809260208201613f3890613c48565b613f4191612c1d565b03908101825261050290826107de565b50610502613c1c565b9061080e602160405184613f788296518092602080860191016104a9565b8101600b60fa1b60208201520360018101855201836107de565b90606060005b83518110156140835761404c603c613fb083876128d7565b515193602080613fc0868a6128d7565b5101516040519683613fdb89955180928680890191016104a9565b84016e3d913a3930b4ba2fba3cb832911d1160891b8482015281519061400982602f948786850191016104a9565b01906a1116113b30b63ab2911d1160a91b9082015261403282518093603a9586850191016104a9565b019061227d60f01b9082015203601c8101855201836107de565b816140578551612307565b821061406d575b506140689061254a565b613f98565b61406891925061407c90613f5a565b919061405e565b50915056fec65a7bb8d6351c1cf70c95a316cc6a92839c986682d98bc35f958f4883f9d2a84f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65728be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa26469706673582212202e266497617fd271a36223a585df14e67a23562f466c22d85594de045b90b44564736f6c63430008110033

00000000000000000000000008a72a8a49debb183ac5c0f25053c23c863c9a7200000000000000000000000099f9043b42360a294f797fa6dd4c74d05154a59500000000000000000000000079c4388c061873baeaf53cebd19bc71a86f55bfa0000000000000000000000000000000000000000000000000000000000000245

-----Decoded View---------------
Arg [0] : tributeFactory (address): 0x08A72a8A49DEbB183ac5C0F25053C23C863C9a72
Arg [1] : _dnaStorageContractAddress (address): 0x99f9043B42360a294f797fa6DD4C74D05154A595
Arg [2] : _fontContractAddress (address): 0x79C4388C061873bAEAf53CeBD19BC71A86F55bfa
Arg [3] : chainlinkKey (uint64): 581

-----Encoded View---------------
4 Constructor Arguments found :
Arg [0] : 00000000000000000000000008a72a8a49debb183ac5c0f25053c23c863c9a72
Arg [1] : 00000000000000000000000099f9043b42360a294f797fa6dd4c74d05154a595
Arg [2] : 00000000000000000000000079c4388c061873baeaf53cebd19bc71a86f55bfa
Arg [3] : 0000000000000000000000000000000000000000000000000000000000000245