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: Unlicense
pragma solidity ^0.8.9;

import '@openzeppelin/contracts/token/ERC721/ERC721.sol';
import '@openzeppelin/contracts/utils/math/SafeMath.sol';
import '@openzeppelin/contracts/utils/Strings.sol';
import '@openzeppelin/contracts/access/Ownable.sol';
import './RandomlyAssigned.sol';

/**
 * @title The Party Spud Club's ApeRon LFG Minting contract
 * @dev Extends the ERC721 Non-Fungible Token Standard
 */
contract ApeRonLFG is ERC721, Ownable, RandomlyAssigned {
    using SafeMath for uint256;
    using Strings for uint256;

    // ======================================================== Structs and Enums

    struct MintTypes {
        uint256 _numberOfFreeMintsByAddress;
        uint256 _numberOfMintsByAddress;
    }

    struct Voucher {
        bytes32 r;
        bytes32 s;
        uint8 v;
    }
    enum VoucherType {
        OGHodler,
        FreeMint,
        Whitelist,
        ApeFreeMint
    }
    enum SalePhase {
        Locked,
        Open
    }

    // ======================================================== Private Variables

    string private constant _defaultBaseURI =
        'https://api.thepartyspudclub.io/aperon/metadata';

    address private teamAddress = 0xa54F87a652254baA2D1B39984a7E25022681fF41;

    // ======================================================== Public Variables

    uint256 public constant NUMBER_OF_RESERVED_APES = 200;
    uint256 public constant MAX_APES_SUPPLY = 5555;

    address public immutable adminSigner;

    string public tokenBaseURI;

    SalePhase public phase = SalePhase.Locked;

    uint256 public apePrice = 0.005555 ether;

    uint256 public teamTokensMinted = 0;

    uint256 public maxMintsPerAddress = 10; // max total mints per address

    mapping(address => MintTypes) public addressToMints;

    // ======================================================== Constructor

    constructor(string memory _uri, address _adminSigner)
        ERC721('ApeRon LFG', 'APERONLFG')
        RandomlyAssigned(MAX_APES_SUPPLY, NUMBER_OF_RESERVED_APES)
    {
        tokenBaseURI = _uri;
        adminSigner = _adminSigner;
    }

    // ======================================================== Spud Emperor Functions

    /// Set the base URI for the metadata
    /// @dev modifies the state of the `_tokenBaseURI` variable
    /// @param URI the URI to set as the base token URI
    function setBaseURI(string memory URI) external onlyOwner {
        tokenBaseURI = URI;
    }

    /// Updates the team address
    /// @dev modifies the state of the `teamAddress` variable
    /// @notice updates the team address
    /// @param newAddress_ The new price for minting
    function updateTeamAddress(address newAddress_) external onlyOwner {
        teamAddress = newAddress_;
    }

    /// Adjust the mint price
    /// @dev modifies the state of the `apePrice` variable
    /// @notice sets the price for minting a token
    /// @param newPrice_ The new price for minting
    function adjustMintPrice(uint256 newPrice_) external onlyOwner {
        apePrice = newPrice_;
    }

    /// Adjust the maximum allowed mints per address
    /// @dev modifies the state of the `maxMintsPerAddress` variable
    /// @notice sets the maximum allowed mints per address
    /// @param maxMintsPerAddress_ The new price maximum
    function adjustMaximumMints(uint256 maxMintsPerAddress_)
        external
        onlyOwner
    {
        maxMintsPerAddress = maxMintsPerAddress_;
    }

    /// Enter Phase
    /// @dev Updates the `phase` variable
    /// @notice Enters a new sale phase
    function enterPhase(SalePhase phase_) external onlyOwner {
        phase = phase_;
    }

    /// Mint tokens for the team and airdropping
    /// @dev Mints the number of tokens passed in as count to the teamAddress
    /// @param count The number of tokens to mint
    function reserveTeamTokens(uint256 count)
        external
        onlyOwner
        ensureAvailabilityFor(count)
    {
        require(
            count + teamTokensMinted <= NUMBER_OF_RESERVED_APES,
            'Exceeds the allowed supply of team tokens'
        );
        for (uint256 i = teamTokensMinted + 1; i <= count; i++) {
            _claimReservedToken(teamAddress, i);
        }
        teamTokensMinted += count;
    }

    /// Disburse payments
    /// @dev transfers amounts that correspond to addresses passeed in as args
    /// @param payees_ recipient addresses
    /// @param amounts_ amount to payout to address with corresponding index in the `payees_` array
    function disbursePayments(
        address[] memory payees_,
        uint256[] memory amounts_
    ) external onlyOwner {
        require(
            payees_.length == amounts_.length,
            'Payees and amounts length mismatch'
        );
        for (uint256 i; i < payees_.length; i++) {
            makePaymentTo(payees_[i], amounts_[i]);
        }
    }

    /// Make a payment
    /// @dev internal fn called by `disbursePayments` to send Ether to an address
    function makePaymentTo(address address_, uint256 amt_) private {
        (bool success, ) = address_.call{value: amt_}('');
        require(success, 'Transfer failed.');
    }

    // ======================================================== External Functions

    /// Claim Free Mint Tokens
    /// @dev mints the qty of tokens verified using vouchers signed by an admin signer
    /// @notice claims earned free tokens
    /// @param count number of tokens to claim in transaction
    /// @param allotted total number of tokens recipient is allowed to claim
    /// @param voucher voucher for verifying the signer
    function claimFreeMintTokens(
        uint256 count,
        uint256 allotted,
        Voucher memory voucher
    ) external ensureAvailabilityFor(count) {
        require(phase == SalePhase.Open, 'Free Minting is not active');
        bytes32 digest = keccak256(
            abi.encode(VoucherType.ApeFreeMint, allotted, msg.sender)
        );
        require(_isVerifiedVoucher(digest, voucher), 'Invalid voucher');
        require(
            count + addressToMints[msg.sender]._numberOfFreeMintsByAddress <=
                allotted,
            'Exceeds number of earned Apes'
        );
        addressToMints[msg.sender]._numberOfFreeMintsByAddress += count;
        for (uint256 i; i < count; i++) {
            _mintRandomId(msg.sender);
        }
    }

    /// Public minting open to all
    /// @dev mints tokens during public sale, limited by `maxMintsPerAddress`
    /// @notice mints tokens with randomized IDs to the sender's address
    /// @param count number of tokens to mint in transaction
    function mintApe(uint256 count)
        external
        payable
        validateEthPayment(count)
        ensureAvailabilityFor(count)
    {
        require(phase == SalePhase.Open, 'Public sale is not active');
        require(
            count + addressToMints[msg.sender]._numberOfMintsByAddress <=
                maxMintsPerAddress,
            'Exceeds maximum allowable mints'
        );
        addressToMints[msg.sender]._numberOfMintsByAddress += count;
        for (uint256 i; i < count; i++) {
            _mintRandomId(msg.sender);
        }
    }

    // ======================================================== Internal Functions

    /// @dev make sure that the voucher sent was signed by the admin signer
    function _isVerifiedVoucher(bytes32 digest, Voucher memory voucher)
        private
        view
        returns (bool)
    {
        address signer = ecrecover(digest, voucher.v, voucher.r, voucher.s);
        require(signer != address(0), 'ECDSA: invalid voucher');
        return signer == adminSigner;
    }

    /// @dev internal check to ensure a reserved token ID, or ID outside of the collection, doesn't get minted
    function _mintRandomId(address to) private {
        uint256 id = nextToken();
        assert(
            id > NUMBER_OF_RESERVED_APES &&
                id <= MAX_APES_SUPPLY + NUMBER_OF_RESERVED_APES
        );
        _safeMint(to, id);
    }

    /// @dev mints a token with a known ID, must fall within desired range
    function _claimReservedToken(address to, uint256 id) private {
        assert(id != 0);
        assert(id <= NUMBER_OF_RESERVED_APES);
        if (!_exists(id)) {
            _safeMint(to, id);
        }
    }

    // ======================================================== Overrides

    /// Return the tokenURI for a given ID
    /// @dev overrides ERC721's `tokenURI` function and returns either the `_tokenBaseURI` or a custom URI
    /// @notice reutrns the tokenURI using the `_tokenBase` URI if the token ID hasn't been supplied with a unique custom URI
    function tokenURI(uint256 tokenId)
        public
        view
        override(ERC721)
        returns (string memory)
    {
        require(_exists(tokenId), 'Cannot query non-existent token');

        return
            bytes(tokenBaseURI).length > 0
                ? string(
                    abi.encodePacked(tokenBaseURI, '/', tokenId.toString())
                )
                : _defaultBaseURI;
    }

    // ======================================================== Modifiers

    /// Modifier to validate Eth payments on payable functions
    /// @dev compares the product of the state variable `apePrice` and supplied `count` to msg.value
    /// @param count factor to multiply by
    modifier validateEthPayment(uint256 count) {
        require(
            apePrice * count <= msg.value,
            'You have not sent enough ether'
        );
        _;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.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 = _owners[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 nor 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 nor approved");

        _transfer(from, to, tokenId);
    }

    /**
     * @dev See {IERC721-safeTransferFrom}.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId
    ) public virtual override {
        safeTransferFrom(from, to, tokenId, "");
    }

    /**
     * @dev See {IERC721-safeTransferFrom}.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId,
        bytes memory data
    ) public virtual override {
        require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner nor approved");
        _safeTransfer(from, to, tokenId, data);
    }

    /**
     * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
     * are aware of the ERC721 protocol to prevent tokens from being forever locked.
     *
     * `data` is additional data, it has no specified format and it is sent in call to `to`.
     *
     * This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
     * implement alternative mechanisms to perform token transfer, such as signature-based.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must exist and be owned by `from`.
     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
     *
     * Emits a {Transfer} event.
     */
    function _safeTransfer(
        address from,
        address to,
        uint256 tokenId,
        bytes memory data
    ) internal virtual {
        _transfer(from, to, tokenId);
        require(_checkOnERC721Received(from, to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer");
    }

    /**
     * @dev Returns whether `tokenId` exists.
     *
     * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
     *
     * Tokens start existing when they are minted (`_mint`),
     * and stop existing when they are burned (`_burn`).
     */
    function _exists(uint256 tokenId) internal view virtual returns (bool) {
        return _owners[tokenId] != address(0);
    }

    /**
     * @dev Returns whether `spender` is allowed to manage `tokenId`.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
        address owner = ERC721.ownerOf(tokenId);
        return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender);
    }

    /**
     * @dev Safely mints `tokenId` and transfers it to `to`.
     *
     * Requirements:
     *
     * - `tokenId` must not exist.
     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
     *
     * Emits a {Transfer} event.
     */
    function _safeMint(address to, uint256 tokenId) internal virtual {
        _safeMint(to, tokenId, "");
    }

    /**
     * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
     * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
     */
    function _safeMint(
        address to,
        uint256 tokenId,
        bytes memory data
    ) internal virtual {
        _mint(to, tokenId);
        require(
            _checkOnERC721Received(address(0), to, tokenId, data),
            "ERC721: transfer to non ERC721Receiver implementer"
        );
    }

    /**
     * @dev Mints `tokenId` and transfers it to `to`.
     *
     * WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
     *
     * Requirements:
     *
     * - `tokenId` must not exist.
     * - `to` cannot be the zero address.
     *
     * Emits a {Transfer} event.
     */
    function _mint(address to, uint256 tokenId) internal virtual {
        require(to != address(0), "ERC721: mint to the zero address");
        require(!_exists(tokenId), "ERC721: token already minted");

        _beforeTokenTransfer(address(0), to, tokenId);

        _balances[to] += 1;
        _owners[tokenId] = to;

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

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

    /**
     * @dev Destroys `tokenId`.
     * The approval is cleared when the token is burned.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     *
     * Emits a {Transfer} event.
     */
    function _burn(uint256 tokenId) internal virtual {
        address owner = ERC721.ownerOf(tokenId);

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

        // Clear approvals
        _approve(address(0), tokenId);

        _balances[owner] -= 1;
        delete _owners[tokenId];

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

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

    /**
     * @dev Transfers `tokenId` from `from` to `to`.
     *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - `tokenId` token must be owned by `from`.
     *
     * Emits a {Transfer} event.
     */
    function _transfer(
        address from,
        address to,
        uint256 tokenId
    ) internal virtual {
        require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
        require(to != address(0), "ERC721: transfer to the zero address");

        _beforeTokenTransfer(from, to, tokenId);

        // Clear approvals from the previous owner
        _approve(address(0), tokenId);

        _balances[from] -= 1;
        _balances[to] += 1;
        _owners[tokenId] = to;

        emit Transfer(from, to, tokenId);

        _afterTokenTransfer(from, to, tokenId);
    }

    /**
     * @dev Approve `to` to operate on `tokenId`
     *
     * Emits 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.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
     * transferred to `to`.
     * - When `from` is zero, `tokenId` will be minted for `to`.
     * - When `to` is zero, ``from``'s `tokenId` will be burned.
     * - `from` and `to` are never both zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _beforeTokenTransfer(
        address from,
        address to,
        uint256 tokenId
    ) internal virtual {}

    /**
     * @dev Hook that is called after any transfer of tokens. This includes
     * minting and burning.
     *
     * Calling conditions:
     *
     * - when `from` and `to` are both non-zero.
     * - `from` and `to` are never both zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _afterTokenTransfer(
        address from,
        address to,
        uint256 tokenId
    ) internal virtual {}
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (utils/math/SafeMath.sol)

pragma solidity ^0.8.0;

// CAUTION
// This version of SafeMath should only be used with Solidity 0.8 or later,
// because it relies on the compiler's built in overflow checks.

/**
 * @dev Wrappers over Solidity's arithmetic operations.
 *
 * NOTE: `SafeMath` is generally not needed starting with Solidity 0.8, since the compiler
 * now has built in overflow checking.
 */
library SafeMath {
    /**
     * @dev Returns the addition of two unsigned integers, with an overflow flag.
     *
     * _Available since v3.4._
     */
    function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            uint256 c = a + b;
            if (c < a) return (false, 0);
            return (true, c);
        }
    }

    /**
     * @dev Returns the subtraction of two unsigned integers, with an overflow flag.
     *
     * _Available since v3.4._
     */
    function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            if (b > a) return (false, 0);
            return (true, a - b);
        }
    }

    /**
     * @dev Returns the multiplication of two unsigned integers, with an overflow flag.
     *
     * _Available since v3.4._
     */
    function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
            // benefit is lost if 'b' is also tested.
            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
            if (a == 0) return (true, 0);
            uint256 c = a * b;
            if (c / a != b) return (false, 0);
            return (true, c);
        }
    }

    /**
     * @dev Returns the division of two unsigned integers, with a division by zero flag.
     *
     * _Available since v3.4._
     */
    function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            if (b == 0) return (false, 0);
            return (true, a / b);
        }
    }

    /**
     * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
     *
     * _Available since v3.4._
     */
    function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            if (b == 0) return (false, 0);
            return (true, a % b);
        }
    }

    /**
     * @dev Returns the addition of two unsigned integers, reverting on
     * overflow.
     *
     * Counterpart to Solidity's `+` operator.
     *
     * Requirements:
     *
     * - Addition cannot overflow.
     */
    function add(uint256 a, uint256 b) internal pure returns (uint256) {
        return a + b;
    }

    /**
     * @dev Returns the subtraction of two unsigned integers, reverting on
     * overflow (when the result is negative).
     *
     * Counterpart to Solidity's `-` operator.
     *
     * Requirements:
     *
     * - Subtraction cannot overflow.
     */
    function sub(uint256 a, uint256 b) internal pure returns (uint256) {
        return a - b;
    }

    /**
     * @dev Returns the multiplication of two unsigned integers, reverting on
     * overflow.
     *
     * Counterpart to Solidity's `*` operator.
     *
     * Requirements:
     *
     * - Multiplication cannot overflow.
     */
    function mul(uint256 a, uint256 b) internal pure returns (uint256) {
        return a * b;
    }

    /**
     * @dev Returns the integer division of two unsigned integers, reverting on
     * division by zero. The result is rounded towards zero.
     *
     * Counterpart to Solidity's `/` operator.
     *
     * Requirements:
     *
     * - The divisor cannot be zero.
     */
    function div(uint256 a, uint256 b) internal pure returns (uint256) {
        return a / b;
    }

    /**
     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
     * reverting when dividing by zero.
     *
     * Counterpart to Solidity's `%` operator. This function uses a `revert`
     * opcode (which leaves remaining gas untouched) while Solidity uses an
     * invalid opcode to revert (consuming all remaining gas).
     *
     * Requirements:
     *
     * - The divisor cannot be zero.
     */
    function mod(uint256 a, uint256 b) internal pure returns (uint256) {
        return a % b;
    }

    /**
     * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
     * overflow (when the result is negative).
     *
     * CAUTION: This function is deprecated because it requires allocating memory for the error
     * message unnecessarily. For custom revert reasons use {trySub}.
     *
     * Counterpart to Solidity's `-` operator.
     *
     * Requirements:
     *
     * - Subtraction cannot overflow.
     */
    function sub(
        uint256 a,
        uint256 b,
        string memory errorMessage
    ) internal pure returns (uint256) {
        unchecked {
            require(b <= a, errorMessage);
            return a - b;
        }
    }

    /**
     * @dev Returns the integer division of two unsigned integers, reverting with custom message on
     * division by zero. The result is rounded towards zero.
     *
     * Counterpart to Solidity's `/` operator. Note: this function uses a
     * `revert` opcode (which leaves remaining gas untouched) while Solidity
     * uses an invalid opcode to revert (consuming all remaining gas).
     *
     * Requirements:
     *
     * - The divisor cannot be zero.
     */
    function div(
        uint256 a,
        uint256 b,
        string memory errorMessage
    ) internal pure returns (uint256) {
        unchecked {
            require(b > 0, errorMessage);
            return a / b;
        }
    }

    /**
     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
     * reverting with custom message when dividing by zero.
     *
     * CAUTION: This function is deprecated because it requires allocating memory for the error
     * message unnecessarily. For custom revert reasons use {tryMod}.
     *
     * Counterpart to Solidity's `%` operator. This function uses a `revert`
     * opcode (which leaves remaining gas untouched) while Solidity uses an
     * invalid opcode to revert (consuming all remaining gas).
     *
     * Requirements:
     *
     * - The divisor cannot be zero.
     */
    function mod(
        uint256 a,
        uint256 b,
        string memory errorMessage
    ) internal pure returns (uint256) {
        unchecked {
            require(b > 0, errorMessage);
            return a % b;
        }
    }
}

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

pragma solidity ^0.8.0;

/**
 * @dev String operations.
 */
library Strings {
    bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
    uint8 private constant _ADDRESS_LENGTH = 20;

    /**
     * @dev Converts a `uint256` to its ASCII `string` decimal representation.
     */
    function toString(uint256 value) internal pure returns (string memory) {
        // Inspired by OraclizeAPI's implementation - MIT licence
        // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol

        if (value == 0) {
            return "0";
        }
        uint256 temp = value;
        uint256 digits;
        while (temp != 0) {
            digits++;
            temp /= 10;
        }
        bytes memory buffer = new bytes(digits);
        while (value != 0) {
            digits -= 1;
            buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
            value /= 10;
        }
        return string(buffer);
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
     */
    function toHexString(uint256 value) internal pure returns (string memory) {
        if (value == 0) {
            return "0x00";
        }
        uint256 temp = value;
        uint256 length = 0;
        while (temp != 0) {
            length++;
            temp >>= 8;
        }
        return toHexString(value, length);
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
     */
    function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
        bytes memory buffer = new bytes(2 * length + 2);
        buffer[0] = "0";
        buffer[1] = "x";
        for (uint256 i = 2 * length + 1; i > 1; --i) {
            buffer[i] = _HEX_SYMBOLS[value & 0xf];
            value >>= 4;
        }
        require(value == 0, "Strings: hex length insufficient");
        return string(buffer);
    }

    /**
     * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
     */
    function toHexString(address addr) internal pure returns (string memory) {
        return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
    }
}

// SPDX-License-Identifier: MIT
// 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
pragma solidity ^0.8.4;

import './WithLimitedSupply.sol';

/// @author Modified version of original code by 1001.digital
/// @title Randomly assign tokenIDs from a given set of tokens.
abstract contract RandomlyAssigned is WithLimitedSupply {
    // Used for random index assignment
    mapping(uint256 => uint256) private tokenMatrix;

    // The initial token ID
    uint256 private immutable startFrom;

    /// Instanciate the contract
    /// @param maxSupply_ how many tokens this collection should hold
    /// @param numReserved_ the number of tokens reserved whose IDs dont come from the randomizer
    constructor(uint256 maxSupply_, uint256 numReserved_)
        WithLimitedSupply(maxSupply_, numReserved_)
    {
        startFrom = numReserved_ + 1;
    }

    /// Get the next token ID
    /// @dev Randomly gets a new token ID and keeps track of the ones that are still available.
    /// @return the next token ID
    function nextToken() internal override returns (uint256) {
        uint256 maxIndex = maxAvailableSupply() - tokenCount();
        uint256 random = uint256(
            keccak256(
                abi.encodePacked(
                    msg.sender,
                    block.coinbase,
                    block.difficulty,
                    block.gaslimit,
                    block.timestamp
                )
            )
        ) % maxIndex;

        uint256 value = 0;
        if (tokenMatrix[random] == 0) {
            // If this matrix position is empty, set the value to the generated random number.
            value = random;
        } else {
            // Otherwise, use the previously stored number from the matrix.
            value = tokenMatrix[random];
        }

        // If the last available tokenID is still unused...
        if (tokenMatrix[maxIndex - 1] == 0) {
            // ...store that ID in the current matrix position.
            tokenMatrix[random] = maxIndex - 1;
        } else {
            // ...otherwise copy over the stored number to the current matrix position.
            tokenMatrix[random] = tokenMatrix[maxIndex - 1];
        }

        // Increment counts (ie. qty minted)
        super.nextToken();

        return value + startFrom;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/IERC721.sol)

pragma solidity ^0.8.0;

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

/**
 * @dev Required interface of an ERC721 compliant contract.
 */
interface IERC721 is IERC165 {
    /**
     * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
     */
    event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);

    /**
     * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
     */
    event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);

    /**
     * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
     */
    event ApprovalForAll(address indexed owner, address indexed operator, bool approved);

    /**
     * @dev Returns the number of tokens in ``owner``'s account.
     */
    function balanceOf(address owner) external view returns (uint256 balance);

    /**
     * @dev Returns the owner of the `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function ownerOf(uint256 tokenId) external view returns (address owner);

    /**
     * @dev Safely transfers `tokenId` token from `from` to `to`.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must exist and be owned by `from`.
     * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
     *
     * Emits a {Transfer} event.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId,
        bytes calldata data
    ) external;

    /**
     * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
     * are aware of the ERC721 protocol to prevent tokens from being forever locked.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must exist and be owned by `from`.
     * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}.
     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
     *
     * Emits a {Transfer} event.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId
    ) external;

    /**
     * @dev Transfers `tokenId` token from `from` to `to`.
     *
     * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must be owned by `from`.
     * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
     *
     * Emits a {Transfer} event.
     */
    function transferFrom(
        address from,
        address to,
        uint256 tokenId
    ) external;

    /**
     * @dev Gives permission to `to` to transfer `tokenId` token to another account.
     * The approval is cleared when the token is transferred.
     *
     * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
     *
     * Requirements:
     *
     * - The caller must own the token or be an approved operator.
     * - `tokenId` must exist.
     *
     * Emits an {Approval} event.
     */
    function approve(address to, uint256 tokenId) external;

    /**
     * @dev Approve or remove `operator` as an operator for the caller.
     * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
     *
     * Requirements:
     *
     * - The `operator` cannot be the caller.
     *
     * Emits an {ApprovalForAll} event.
     */
    function setApprovalForAll(address operator, bool _approved) external;

    /**
     * @dev Returns the account approved for `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function getApproved(uint256 tokenId) external view returns (address operator);

    /**
     * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
     *
     * See {setApprovalForAll}
     */
    function isApprovedForAll(address owner, address operator) external view returns (bool);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol)

pragma solidity ^0.8.0;

/**
 * @title ERC721 token receiver interface
 * @dev Interface for any contract that wants to support safeTransfers
 * from ERC721 asset contracts.
 */
interface IERC721Receiver {
    /**
     * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
     * by `operator` from `from`, this function is called.
     *
     * It must return its Solidity selector to confirm the token transfer.
     * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
     *
     * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
     */
    function onERC721Received(
        address operator,
        address from,
        uint256 tokenId,
        bytes calldata data
    ) external returns (bytes4);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)

pragma solidity ^0.8.0;

import "../IERC721.sol";

/**
 * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
 * @dev See https://eips.ethereum.org/EIPS/eip-721
 */
interface IERC721Metadata is IERC721 {
    /**
     * @dev Returns the token collection name.
     */
    function name() external view returns (string memory);

    /**
     * @dev Returns the token collection symbol.
     */
    function symbol() external view returns (string memory);

    /**
     * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
     */
    function tokenURI(uint256 tokenId) external view returns (string memory);
}

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

pragma solidity ^0.8.1;

/**
 * @dev Collection of functions related to the address type
 */
library Address {
    /**
     * @dev Returns true if `account` is a contract.
     *
     * [IMPORTANT]
     * ====
     * It is unsafe to assume that an address for which this function returns
     * false is an externally-owned account (EOA) and not a contract.
     *
     * Among others, `isContract` will return false for the following
     * types of addresses:
     *
     *  - an externally-owned account
     *  - a contract in construction
     *  - an address where a contract will be created
     *  - an address where a contract lived, but was destroyed
     * ====
     *
     * [IMPORTANT]
     * ====
     * You shouldn't rely on `isContract` to protect against flash loan attacks!
     *
     * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
     * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
     * constructor.
     * ====
     */
    function isContract(address account) internal view returns (bool) {
        // This method relies on extcodesize/address.code.length, which returns 0
        // for contracts in construction, since the code is only stored at the end
        // of the constructor execution.

        return account.code.length > 0;
    }

    /**
     * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
     * `recipient`, forwarding all available gas and reverting on errors.
     *
     * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
     * of certain opcodes, possibly making contracts go over the 2300 gas limit
     * imposed by `transfer`, making them unable to receive funds via
     * `transfer`. {sendValue} removes this limitation.
     *
     * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
     *
     * IMPORTANT: because control is transferred to `recipient`, care must be
     * taken to not create reentrancy vulnerabilities. Consider using
     * {ReentrancyGuard} or the
     * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
     */
    function sendValue(address payable recipient, uint256 amount) internal {
        require(address(this).balance >= amount, "Address: insufficient balance");

        (bool success, ) = recipient.call{value: amount}("");
        require(success, "Address: unable to send value, recipient may have reverted");
    }

    /**
     * @dev Performs a Solidity function call using a low level `call`. A
     * plain `call` is an unsafe replacement for a function call: use this
     * function instead.
     *
     * If `target` reverts with a revert reason, it is bubbled up by this
     * function (like regular Solidity function calls).
     *
     * Returns the raw returned data. To convert to the expected return value,
     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
     *
     * Requirements:
     *
     * - `target` must be a contract.
     * - calling `target` with `data` must not revert.
     *
     * _Available since v3.1._
     */
    function functionCall(address target, bytes memory data) internal returns (bytes memory) {
        return functionCall(target, data, "Address: low-level call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
     * `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but also transferring `value` wei to `target`.
     *
     * Requirements:
     *
     * - the calling contract must have an ETH balance of at least `value`.
     * - the called Solidity function must be `payable`.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(
        address target,
        bytes memory data,
        uint256 value
    ) internal returns (bytes memory) {
        return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
    }

    /**
     * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
     * with `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(
        address target,
        bytes memory data,
        uint256 value,
        string memory errorMessage
    ) internal returns (bytes memory) {
        require(address(this).balance >= value, "Address: insufficient balance for call");
        require(isContract(target), "Address: call to non-contract");

        (bool success, bytes memory returndata) = target.call{value: value}(data);
        return verifyCallResult(success, returndata, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
        return functionStaticCall(target, data, "Address: low-level static call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        require(isContract(target), "Address: static call to non-contract");

        (bool success, bytes memory returndata) = target.staticcall(data);
        return verifyCallResult(success, returndata, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a delegate call.
     *
     * _Available since v3.4._
     */
    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
        return functionDelegateCall(target, data, "Address: low-level delegate call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a delegate call.
     *
     * _Available since v3.4._
     */
    function functionDelegateCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        require(isContract(target), "Address: delegate call to non-contract");

        (bool success, bytes memory returndata) = target.delegatecall(data);
        return verifyCallResult(success, returndata, errorMessage);
    }

    /**
     * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
     * revert reason using the provided one.
     *
     * _Available since v4.3._
     */
    function verifyCallResult(
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal pure returns (bytes memory) {
        if (success) {
            return returndata;
        } else {
            // Look for revert reason and bubble it up if present
            if (returndata.length > 0) {
                // The easiest way to bubble the revert reason is using memory via assembly
                /// @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 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 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
pragma solidity ^0.8.4;

/// @author Modified version of original code by 1001.digital
/// @title A token tracker that limits the token supply and increments token IDs on each new mint.
abstract contract WithLimitedSupply {
    // Keeps track of how many we have minted
    uint256 private _tokenCount;

    /// @dev The maximum count of tokens this token tracker will issue.
    uint256 private immutable _maxAvailableSupply;

    /// Instanciate the contract
    /// @param maxSupply_ how many tokens this collection should hold
    constructor(uint256 maxSupply_, uint256 reserved_) {
        _maxAvailableSupply = maxSupply_ - reserved_;
    }

    function maxAvailableSupply() public view returns (uint256) {
        return _maxAvailableSupply;
    }

    /// @dev Get the current token count
    /// @return the created token count
    /// TODO: if this is not required externally, does making it `public view` use unnecessary gas?
    function tokenCount() public view returns (uint256) {
        return _tokenCount;
    }

    /// @dev Check whether tokens are still available
    /// @return the available token count
    function availableTokenCount() public view returns (uint256) {
        return maxAvailableSupply() - tokenCount();
    }

    /// @dev Increment the token count and fetch the latest count
    /// @return the next token id
    function nextToken() internal virtual ensureAvailability returns (uint256) {
        return _tokenCount++;
    }

    /// @dev Check whether another token is still available
    modifier ensureAvailability() {
        require(availableTokenCount() > 0, 'No more tokens available');
        _;
    }

    /// @param amount Check whether number of tokens are still available
    /// @dev Check whether tokens are still available
    modifier ensureAvailabilityFor(uint256 amount) {
        require(
            availableTokenCount() >= amount,
            'Requested number of tokens not available'
        );
        _;
    }
}

{
  "optimizer": {
    "enabled": false,
    "runs": 200
  },
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  },
  "libraries": {}
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"string","name":"_uri","type":"string"},{"internalType":"address","name":"_adminSigner","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"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":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":"MAX_APES_SUPPLY","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NUMBER_OF_RESERVED_APES","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"addressToMints","outputs":[{"internalType":"uint256","name":"_numberOfFreeMintsByAddress","type":"uint256"},{"internalType":"uint256","name":"_numberOfMintsByAddress","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"maxMintsPerAddress_","type":"uint256"}],"name":"adjustMaximumMints","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newPrice_","type":"uint256"}],"name":"adjustMintPrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"adminSigner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"apePrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"availableTokenCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","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":"count","type":"uint256"},{"internalType":"uint256","name":"allotted","type":"uint256"},{"components":[{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"uint8","name":"v","type":"uint8"}],"internalType":"struct ApeRonLFG.Voucher","name":"voucher","type":"tuple"}],"name":"claimFreeMintTokens","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"payees_","type":"address[]"},{"internalType":"uint256[]","name":"amounts_","type":"uint256[]"}],"name":"disbursePayments","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"enum ApeRonLFG.SalePhase","name":"phase_","type":"uint8"}],"name":"enterPhase","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"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":"maxAvailableSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxMintsPerAddress","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"count","type":"uint256"}],"name":"mintApe","outputs":[],"stateMutability":"payable","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":[],"name":"phase","outputs":[{"internalType":"enum ApeRonLFG.SalePhase","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"count","type":"uint256"}],"name":"reserveTeamTokens","outputs":[],"stateMutability":"nonpayable","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":"string","name":"URI","type":"string"}],"name":"setBaseURI","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":[],"name":"teamTokensMinted","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tokenBaseURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tokenCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"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":[{"internalType":"address","name":"newAddress_","type":"address"}],"name":"updateTeamAddress","outputs":[],"stateMutability":"nonpayable","type":"function"}]

60e060405273a54f87a652254baa2d1b39984a7e25022681ff41600960006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055506000600b60006101000a81548160ff0219169083600181111562000082576200008162000398565b5b02179055506613bc3e39ba3000600c556000600d55600a600e55348015620000a957600080fd5b506040516200517c3803806200517c8339818101604052810190620000cf9190620005c9565b6115b360c881816040518060400160405280600a81526020017f417065526f6e204c4647000000000000000000000000000000000000000000008152506040518060400160405280600981526020017f415045524f4e4c4647000000000000000000000000000000000000000000000081525081600090805190602001906200015a929190620002e8565b50806001908051906020019062000173929190620002e8565b505050620001966200018a6200021a60201b60201c565b6200022260201b60201c565b8082620001a4919062000668565b608081815250505050600181620001bc9190620006a3565b60a08181525050505081600a9080519060200190620001dd929190620002e8565b508073ffffffffffffffffffffffffffffffffffffffff1660c08173ffffffffffffffffffffffffffffffffffffffff1681525050505062000765565b600033905090565b6000600660009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905081600660006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b828054620002f6906200072f565b90600052602060002090601f0160209004810192826200031a576000855562000366565b82601f106200033557805160ff191683800117855562000366565b8280016001018555821562000366579182015b828111156200036557825182559160200191906001019062000348565b5b50905062000375919062000379565b5090565b5b80821115620003945760008160009055506001016200037a565b5090565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602160045260246000fd5b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6200043082620003e5565b810181811067ffffffffffffffff82111715620004525762000451620003f6565b5b80604052505050565b600062000467620003c7565b905062000475828262000425565b919050565b600067ffffffffffffffff821115620004985762000497620003f6565b5b620004a382620003e5565b9050602081019050919050565b60005b83811015620004d0578082015181840152602081019050620004b3565b83811115620004e0576000848401525b50505050565b6000620004fd620004f7846200047a565b6200045b565b9050828152602081018484840111156200051c576200051b620003e0565b5b62000529848285620004b0565b509392505050565b600082601f830112620005495762000548620003db565b5b81516200055b848260208601620004e6565b91505092915050565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000620005918262000564565b9050919050565b620005a38162000584565b8114620005af57600080fd5b50565b600081519050620005c38162000598565b92915050565b60008060408385031215620005e357620005e2620003d1565b5b600083015167ffffffffffffffff811115620006045762000603620003d6565b5b620006128582860162000531565b92505060206200062585828601620005b2565b9150509250929050565b6000819050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600062000675826200062f565b915062000682836200062f565b92508282101562000698576200069762000639565b5b828203905092915050565b6000620006b0826200062f565b9150620006bd836200062f565b9250827fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff03821115620006f557620006f462000639565b5b828201905092915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806200074857607f821691505b602082108114156200075f576200075e62000700565b5b50919050565b60805160a05160c0516149e06200079c600039600081816118a50152611b0f015260006125a101526000610e0f01526149e06000f3fe60806040526004361061021a5760003560e01c806370a0823111610123578063ae6a80d5116100ab578063cf84f8721161006f578063cf84f872146107af578063e14ca353146107da578063e985e9c514610805578063f2fde38b14610842578063ff9d2dcc1461086b5761021a565b8063ae6a80d5146106ca578063b1c9fe6e146106f5578063b375a08514610720578063b88d4fde14610749578063c87b56dd146107725761021a565b80638da5cb5b116100f25780638da5cb5b1461060457806395d89b411461062f5780639f181b5e1461065a578063a22cb46514610685578063a723533e146106ae5761021a565b806370a082311461055c578063715018a61461059957806377fc393e146105b05780637a3f451e146105d95761021a565b806323b872dd116101a65780634e99b800116101755780634e99b8001461046457806355f804b31461048f5780636352211e146104b857806363820f23146104f557806368c17be0146105335761021a565b806323b872dd146103c05780633123387b146103e957806342842e0e14610412578063460b289c1461043b5761021a565b80630e586a1a116101ed5780630e586a1a146102ed578063115131661461031657806314eb76ac1461034157806315f91c181461036a57806322cb1ec8146103955761021a565b806301ffc9a71461021f57806306fdde031461025c578063081812fc14610287578063095ea7b3146102c4575b600080fd5b34801561022b57600080fd5b5061024660048036038101906102419190612b60565b610896565b6040516102539190612ba8565b60405180910390f35b34801561026857600080fd5b50610271610978565b60405161027e9190612c5c565b60405180910390f35b34801561029357600080fd5b506102ae60048036038101906102a99190612cb4565b610a0a565b6040516102bb9190612d22565b60405180910390f35b3480156102d057600080fd5b506102eb60048036038101906102e69190612d69565b610a50565b005b3480156102f957600080fd5b50610314600480360381019061030f9190612efc565b610b68565b005b34801561032257600080fd5b5061032b610db9565b6040516103389190612f5e565b60405180910390f35b34801561034d57600080fd5b5061036860048036038101906103639190612f79565b610dbf565b005b34801561037657600080fd5b5061037f610e0b565b60405161038c9190612f5e565b60405180910390f35b3480156103a157600080fd5b506103aa610e33565b6040516103b79190612f5e565b60405180910390f35b3480156103cc57600080fd5b506103e760048036038101906103e29190612fa6565b610e39565b005b3480156103f557600080fd5b50610410600480360381019061040b919061301e565b610e99565b005b34801561041e57600080fd5b5061043960048036038101906104349190612fa6565b610ece565b005b34801561044757600080fd5b50610462600480360381019061045d9190612cb4565b610eee565b005b34801561047057600080fd5b50610479610f00565b6040516104869190612c5c565b60405180910390f35b34801561049b57600080fd5b506104b660048036038101906104b19190613105565b610f8e565b005b3480156104c457600080fd5b506104df60048036038101906104da9190612cb4565b610fb0565b6040516104ec9190612d22565b60405180910390f35b34801561050157600080fd5b5061051c60048036038101906105179190612f79565b611062565b60405161052a92919061314e565b60405180910390f35b34801561053f57600080fd5b5061055a60048036038101906105559190612cb4565b611086565b005b34801561056857600080fd5b50610583600480360381019061057e9190612f79565b6111a2565b6040516105909190612f5e565b60405180910390f35b3480156105a557600080fd5b506105ae61125a565b005b3480156105bc57600080fd5b506105d760048036038101906105d29190613302565b61126e565b005b3480156105e557600080fd5b506105ee61131c565b6040516105fb9190612f5e565b60405180910390f35b34801561061057600080fd5b50610619611322565b6040516106269190612d22565b60405180910390f35b34801561063b57600080fd5b5061064461134c565b6040516106519190612c5c565b60405180910390f35b34801561066657600080fd5b5061066f6113de565b60405161067c9190612f5e565b60405180910390f35b34801561069157600080fd5b506106ac60048036038101906106a791906133a6565b6113e8565b005b6106c860048036038101906106c39190612cb4565b6113fe565b005b3480156106d657600080fd5b506106df611627565b6040516106ec9190612f5e565b60405180910390f35b34801561070157600080fd5b5061070a61162d565b604051610717919061345d565b60405180910390f35b34801561072c57600080fd5b5061074760048036038101906107429190612cb4565b611640565b005b34801561075557600080fd5b50610770600480360381019061076b9190613519565b611652565b005b34801561077e57600080fd5b5061079960048036038101906107949190612cb4565b6116b4565b6040516107a69190612c5c565b60405180910390f35b3480156107bb57600080fd5b506107c4611765565b6040516107d19190612f5e565b60405180910390f35b3480156107e657600080fd5b506107ef61176a565b6040516107fc9190612f5e565b60405180910390f35b34801561081157600080fd5b5061082c6004803603810190610827919061359c565b61178b565b6040516108399190612ba8565b60405180910390f35b34801561084e57600080fd5b5061086960048036038101906108649190612f79565b61181f565b005b34801561087757600080fd5b506108806118a3565b60405161088d9190612d22565b60405180910390f35b60007f80ac58cd000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916148061096157507f5b5e139f000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b806109715750610970826118c7565b5b9050919050565b6060600080546109879061360b565b80601f01602080910402602001604051908101604052809291908181526020018280546109b39061360b565b8015610a005780601f106109d557610100808354040283529160200191610a00565b820191906000526020600020905b8154815290600101906020018083116109e357829003601f168201915b5050505050905090565b6000610a1582611931565b6004600083815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b6000610a5b82610fb0565b90508073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161415610acc576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610ac3906136af565b60405180910390fd5b8073ffffffffffffffffffffffffffffffffffffffff16610aeb61197c565b73ffffffffffffffffffffffffffffffffffffffff161480610b1a5750610b1981610b1461197c565b61178b565b5b610b59576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610b5090613741565b60405180910390fd5b610b638383611984565b505050565b8280610b7261176a565b1015610bb3576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610baa906137d3565b60405180910390fd5b600180811115610bc657610bc56133e6565b5b600b60009054906101000a900460ff166001811115610be857610be76133e6565b5b14610c28576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610c1f9061383f565b60405180910390fd5b600060038433604051602001610c40939291906138a7565b604051602081830303815290604052805190602001209050610c628184611a3d565b610ca1576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610c989061392a565b60405180910390fd5b83600f60003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000015486610cf09190613979565b1115610d31576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610d2890613a1b565b60405180910390fd5b84600f60003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000016000828254610d839190613979565b9250508190555060005b85811015610db157610d9e33611b65565b8080610da990613a3b565b915050610d8d565b505050505050565b6115b381565b610dc7611baa565b80600960006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050565b60007f0000000000000000000000000000000000000000000000000000000000000000905090565b600d5481565b610e4a610e4461197c565b82611c28565b610e89576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610e8090613af6565b60405180910390fd5b610e94838383611cbd565b505050565b610ea1611baa565b80600b60006101000a81548160ff02191690836001811115610ec657610ec56133e6565b5b021790555050565b610ee983838360405180602001604052806000815250611652565b505050565b610ef6611baa565b80600c8190555050565b600a8054610f0d9061360b565b80601f0160208091040260200160405190810160405280929190818152602001828054610f399061360b565b8015610f865780601f10610f5b57610100808354040283529160200191610f86565b820191906000526020600020905b815481529060010190602001808311610f6957829003601f168201915b505050505081565b610f96611baa565b80600a9080519060200190610fac929190612a51565b5050565b6000806002600084815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161415611059576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161105090613b62565b60405180910390fd5b80915050919050565b600f6020528060005260406000206000915090508060000154908060010154905082565b61108e611baa565b808061109861176a565b10156110d9576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016110d0906137d3565b60405180910390fd5b60c8600d54836110e99190613979565b111561112a576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161112190613bf4565b60405180910390fd5b60006001600d5461113b9190613979565b90505b82811161118457611171600960009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1682611f24565b808061117c90613a3b565b91505061113e565b5081600d60008282546111979190613979565b925050819055505050565b60008073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff161415611213576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161120a90613c86565b60405180910390fd5b600360008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020549050919050565b611262611baa565b61126c6000611f64565b565b611276611baa565b80518251146112ba576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016112b190613d18565b60405180910390fd5b60005b8251811015611317576113048382815181106112dc576112db613d38565b5b60200260200101518383815181106112f7576112f6613d38565b5b602002602001015161202a565b808061130f90613a3b565b9150506112bd565b505050565b600c5481565b6000600660009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b60606001805461135b9061360b565b80601f01602080910402602001604051908101604052809291908181526020018280546113879061360b565b80156113d45780601f106113a9576101008083540402835291602001916113d4565b820191906000526020600020905b8154815290600101906020018083116113b757829003601f168201915b5050505050905090565b6000600754905090565b6113fa6113f361197c565b83836120db565b5050565b803481600c5461140e9190613d67565b111561144f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161144690613e0d565b60405180910390fd5b818061145961176a565b101561149a576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611491906137d3565b60405180910390fd5b6001808111156114ad576114ac6133e6565b5b600b60009054906101000a900460ff1660018111156114cf576114ce6133e6565b5b1461150f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161150690613e79565b60405180910390fd5b600e54600f60003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060010154846115609190613979565b11156115a1576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161159890613ee5565b60405180910390fd5b82600f60003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060010160008282546115f39190613979565b9250508190555060005b838110156116215761160e33611b65565b808061161990613a3b565b9150506115fd565b50505050565b600e5481565b600b60009054906101000a900460ff1681565b611648611baa565b80600e8190555050565b61166361165d61197c565b83611c28565b6116a2576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161169990613af6565b60405180910390fd5b6116ae84848484612248565b50505050565b60606116bf826122a4565b6116fe576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016116f590613f51565b60405180910390fd5b6000600a805461170d9061360b565b905011611732576040518060600160405280602f815260200161497c602f913961175e565b600a61173d83612310565b60405160200161174e92919061408d565b6040516020818303038152906040525b9050919050565b60c881565b60006117746113de565b61177c610e0b565b61178691906140bc565b905090565b6000600560008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900460ff16905092915050565b611827611baa565b600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161415611897576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161188e90614162565b60405180910390fd5b6118a081611f64565b50565b7f000000000000000000000000000000000000000000000000000000000000000081565b60007f01ffc9a7000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916149050919050565b61193a816122a4565b611979576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161197090613b62565b60405180910390fd5b50565b600033905090565b816004600083815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550808273ffffffffffffffffffffffffffffffffffffffff166119f783610fb0565b73ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b60008060018484604001518560000151866020015160405160008152602001604052604051611a6f94939291906141a0565b6020604051602081039080840390855afa158015611a91573d6000803e3d6000fd5b505050602060405103519050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161415611b0d576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611b0490614231565b60405180910390fd5b7f000000000000000000000000000000000000000000000000000000000000000073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161491505092915050565b6000611b6f612471565b905060c881118015611b8f575060c86115b3611b8b9190613979565b8111155b611b9c57611b9b614251565b5b611ba682826125d3565b5050565b611bb261197c565b73ffffffffffffffffffffffffffffffffffffffff16611bd0611322565b73ffffffffffffffffffffffffffffffffffffffff1614611c26576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611c1d906142cc565b60405180910390fd5b565b600080611c3483610fb0565b90508073ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff161480611c765750611c75818561178b565b5b80611cb457508373ffffffffffffffffffffffffffffffffffffffff16611c9c84610a0a565b73ffffffffffffffffffffffffffffffffffffffff16145b91505092915050565b8273ffffffffffffffffffffffffffffffffffffffff16611cdd82610fb0565b73ffffffffffffffffffffffffffffffffffffffff1614611d33576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611d2a9061435e565b60405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff161415611da3576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611d9a906143f0565b60405180910390fd5b611dae8383836125f1565b611db9600082611984565b6001600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254611e0991906140bc565b925050819055506001600360008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254611e609190613979565b92505081905550816002600083815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550808273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4611f1f8383836125f6565b505050565b6000811415611f3657611f35614251565b5b60c8811115611f4857611f47614251565b5b611f51816122a4565b611f6057611f5f82826125d3565b5b5050565b6000600660009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905081600660006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b60008273ffffffffffffffffffffffffffffffffffffffff168260405161205090614441565b60006040518083038185875af1925050503d806000811461208d576040519150601f19603f3d011682016040523d82523d6000602084013e612092565b606091505b50509050806120d6576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016120cd906144a2565b60405180910390fd5b505050565b8173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16141561214a576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016121419061450e565b60405180910390fd5b80600560008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548160ff0219169083151502179055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c318360405161223b9190612ba8565b60405180910390a3505050565b612253848484611cbd565b61225f848484846125fb565b61229e576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612295906145a0565b60405180910390fd5b50505050565b60008073ffffffffffffffffffffffffffffffffffffffff166002600084815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614159050919050565b60606000821415612358576040518060400160405280600181526020017f3000000000000000000000000000000000000000000000000000000000000000815250905061246c565b600082905060005b6000821461238a57808061237390613a3b565b915050600a8261238391906145ef565b9150612360565b60008167ffffffffffffffff8111156123a6576123a5612dae565b5b6040519080825280601f01601f1916602001820160405280156123d85781602001600182028036833780820191505090505b5090505b60008514612465576001826123f191906140bc565b9150600a856124009190614620565b603061240c9190613979565b60f81b81838151811061242257612421613d38565b5b60200101907effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916908160001a905350600a8561245e91906145ef565b94506123dc565b8093505050505b919050565b60008061247c6113de565b612484610e0b565b61248e91906140bc565b905060008133414445426040516020016124ac9594939291906146f5565b6040516020818303038152906040528051906020012060001c6124cf9190614620565b9050600080600860008481526020019081526020016000205414156124f65781905061250d565b600860008381526020019081526020016000205490505b60006008600060018661252091906140bc565b815260200190815260200160002054141561255e5760018361254291906140bc565b6008600084815260200190815260200160002081905550612596565b6008600060018561256f91906140bc565b81526020019081526020016000205460086000848152602001908152602001600020819055505b61259e612792565b507f0000000000000000000000000000000000000000000000000000000000000000816125cb9190613979565b935050505090565b6125ed8282604051806020016040528060008152506127f9565b5050565b505050565b505050565b600061261c8473ffffffffffffffffffffffffffffffffffffffff16612854565b15612785578373ffffffffffffffffffffffffffffffffffffffff1663150b7a0261264561197c565b8786866040518563ffffffff1660e01b815260040161266794939291906147a9565b602060405180830381600087803b15801561268157600080fd5b505af19250505080156126b257506040513d601f19601f820116820180604052508101906126af919061480a565b60015b612735573d80600081146126e2576040519150601f19603f3d011682016040523d82523d6000602084013e6126e7565b606091505b5060008151141561272d576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612724906145a0565b60405180910390fd5b805181602001fd5b63150b7a0260e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161491505061278a565b600190505b949350505050565b60008061279d61176a565b116127dd576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016127d490614883565b60405180910390fd5b600760008154809291906127f090613a3b565b91905055905090565b6128038383612877565b61281060008484846125fb565b61284f576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612846906145a0565b60405180910390fd5b505050565b6000808273ffffffffffffffffffffffffffffffffffffffff163b119050919050565b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614156128e7576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016128de906148ef565b60405180910390fd5b6128f0816122a4565b15612930576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016129279061495b565b60405180910390fd5b61293c600083836125f1565b6001600360008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825461298c9190613979565b92505081905550816002600083815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550808273ffffffffffffffffffffffffffffffffffffffff16600073ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4612a4d600083836125f6565b5050565b828054612a5d9061360b565b90600052602060002090601f016020900481019282612a7f5760008555612ac6565b82601f10612a9857805160ff1916838001178555612ac6565b82800160010185558215612ac6579182015b82811115612ac5578251825591602001919060010190612aaa565b5b509050612ad39190612ad7565b5090565b5b80821115612af0576000816000905550600101612ad8565b5090565b6000604051905090565b600080fd5b600080fd5b60007fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b612b3d81612b08565b8114612b4857600080fd5b50565b600081359050612b5a81612b34565b92915050565b600060208284031215612b7657612b75612afe565b5b6000612b8484828501612b4b565b91505092915050565b60008115159050919050565b612ba281612b8d565b82525050565b6000602082019050612bbd6000830184612b99565b92915050565b600081519050919050565b600082825260208201905092915050565b60005b83811015612bfd578082015181840152602081019050612be2565b83811115612c0c576000848401525b50505050565b6000601f19601f8301169050919050565b6000612c2e82612bc3565b612c388185612bce565b9350612c48818560208601612bdf565b612c5181612c12565b840191505092915050565b60006020820190508181036000830152612c768184612c23565b905092915050565b6000819050919050565b612c9181612c7e565b8114612c9c57600080fd5b50565b600081359050612cae81612c88565b92915050565b600060208284031215612cca57612cc9612afe565b5b6000612cd884828501612c9f565b91505092915050565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000612d0c82612ce1565b9050919050565b612d1c81612d01565b82525050565b6000602082019050612d376000830184612d13565b92915050565b612d4681612d01565b8114612d5157600080fd5b50565b600081359050612d6381612d3d565b92915050565b60008060408385031215612d8057612d7f612afe565b5b6000612d8e85828601612d54565b9250506020612d9f85828601612c9f565b9150509250929050565b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b612de682612c12565b810181811067ffffffffffffffff82111715612e0557612e04612dae565b5b80604052505050565b6000612e18612af4565b9050612e248282612ddd565b919050565b6000819050919050565b612e3c81612e29565b8114612e4757600080fd5b50565b600081359050612e5981612e33565b92915050565b600060ff82169050919050565b612e7581612e5f565b8114612e8057600080fd5b50565b600081359050612e9281612e6c565b92915050565b600060608284031215612eae57612ead612da9565b5b612eb86060612e0e565b90506000612ec884828501612e4a565b6000830152506020612edc84828501612e4a565b6020830152506040612ef084828501612e83565b60408301525092915050565b600080600060a08486031215612f1557612f14612afe565b5b6000612f2386828701612c9f565b9350506020612f3486828701612c9f565b9250506040612f4586828701612e98565b9150509250925092565b612f5881612c7e565b82525050565b6000602082019050612f736000830184612f4f565b92915050565b600060208284031215612f8f57612f8e612afe565b5b6000612f9d84828501612d54565b91505092915050565b600080600060608486031215612fbf57612fbe612afe565b5b6000612fcd86828701612d54565b9350506020612fde86828701612d54565b9250506040612fef86828701612c9f565b9150509250925092565b6002811061300657600080fd5b50565b60008135905061301881612ff9565b92915050565b60006020828403121561303457613033612afe565b5b600061304284828501613009565b91505092915050565b600080fd5b600080fd5b600067ffffffffffffffff8211156130705761306f612dae565b5b61307982612c12565b9050602081019050919050565b82818337600083830152505050565b60006130a86130a384613055565b612e0e565b9050828152602081018484840111156130c4576130c3613050565b5b6130cf848285613086565b509392505050565b600082601f8301126130ec576130eb61304b565b5b81356130fc848260208601613095565b91505092915050565b60006020828403121561311b5761311a612afe565b5b600082013567ffffffffffffffff81111561313957613138612b03565b5b613145848285016130d7565b91505092915050565b60006040820190506131636000830185612f4f565b6131706020830184612f4f565b9392505050565b600067ffffffffffffffff82111561319257613191612dae565b5b602082029050602081019050919050565b600080fd5b60006131bb6131b684613177565b612e0e565b905080838252602082019050602084028301858111156131de576131dd6131a3565b5b835b8181101561320757806131f38882612d54565b8452602084019350506020810190506131e0565b5050509392505050565b600082601f8301126132265761322561304b565b5b81356132368482602086016131a8565b91505092915050565b600067ffffffffffffffff82111561325a57613259612dae565b5b602082029050602081019050919050565b600061327e6132798461323f565b612e0e565b905080838252602082019050602084028301858111156132a1576132a06131a3565b5b835b818110156132ca57806132b68882612c9f565b8452602084019350506020810190506132a3565b5050509392505050565b600082601f8301126132e9576132e861304b565b5b81356132f984826020860161326b565b91505092915050565b6000806040838503121561331957613318612afe565b5b600083013567ffffffffffffffff81111561333757613336612b03565b5b61334385828601613211565b925050602083013567ffffffffffffffff81111561336457613363612b03565b5b613370858286016132d4565b9150509250929050565b61338381612b8d565b811461338e57600080fd5b50565b6000813590506133a08161337a565b92915050565b600080604083850312156133bd576133bc612afe565b5b60006133cb85828601612d54565b92505060206133dc85828601613391565b9150509250929050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602160045260246000fd5b60028110613426576134256133e6565b5b50565b600081905061343782613415565b919050565b600061344782613429565b9050919050565b6134578161343c565b82525050565b6000602082019050613472600083018461344e565b92915050565b600067ffffffffffffffff82111561349357613492612dae565b5b61349c82612c12565b9050602081019050919050565b60006134bc6134b784613478565b612e0e565b9050828152602081018484840111156134d8576134d7613050565b5b6134e3848285613086565b509392505050565b600082601f830112613500576134ff61304b565b5b81356135108482602086016134a9565b91505092915050565b6000806000806080858703121561353357613532612afe565b5b600061354187828801612d54565b945050602061355287828801612d54565b935050604061356387828801612c9f565b925050606085013567ffffffffffffffff81111561358457613583612b03565b5b613590878288016134eb565b91505092959194509250565b600080604083850312156135b3576135b2612afe565b5b60006135c185828601612d54565b92505060206135d285828601612d54565b9150509250929050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b6000600282049050600182168061362357607f821691505b60208210811415613637576136366135dc565b5b50919050565b7f4552433732313a20617070726f76616c20746f2063757272656e74206f776e6560008201527f7200000000000000000000000000000000000000000000000000000000000000602082015250565b6000613699602183612bce565b91506136a48261363d565b604082019050919050565b600060208201905081810360008301526136c88161368c565b9050919050565b7f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60008201527f6b656e206f776e6572206e6f7220617070726f76656420666f7220616c6c0000602082015250565b600061372b603e83612bce565b9150613736826136cf565b604082019050919050565b6000602082019050818103600083015261375a8161371e565b9050919050565b7f526571756573746564206e756d626572206f6620746f6b656e73206e6f74206160008201527f7661696c61626c65000000000000000000000000000000000000000000000000602082015250565b60006137bd602883612bce565b91506137c882613761565b604082019050919050565b600060208201905081810360008301526137ec816137b0565b9050919050565b7f46726565204d696e74696e67206973206e6f7420616374697665000000000000600082015250565b6000613829601a83612bce565b9150613834826137f3565b602082019050919050565b600060208201905081810360008301526138588161381c565b9050919050565b600481106138705761386f6133e6565b5b50565b60008190506138818261385f565b919050565b600061389182613873565b9050919050565b6138a181613886565b82525050565b60006060820190506138bc6000830186613898565b6138c96020830185612f4f565b6138d66040830184612d13565b949350505050565b7f496e76616c696420766f75636865720000000000000000000000000000000000600082015250565b6000613914600f83612bce565b915061391f826138de565b602082019050919050565b6000602082019050818103600083015261394381613907565b9050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061398482612c7e565b915061398f83612c7e565b9250827fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff038211156139c4576139c361394a565b5b828201905092915050565b7f45786365656473206e756d626572206f66206561726e65642041706573000000600082015250565b6000613a05601d83612bce565b9150613a10826139cf565b602082019050919050565b60006020820190508181036000830152613a34816139f8565b9050919050565b6000613a4682612c7e565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff821415613a7957613a7861394a565b5b600182019050919050565b7f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560008201527f72206e6f7220617070726f766564000000000000000000000000000000000000602082015250565b6000613ae0602e83612bce565b9150613aeb82613a84565b604082019050919050565b60006020820190508181036000830152613b0f81613ad3565b9050919050565b7f4552433732313a20696e76616c696420746f6b656e2049440000000000000000600082015250565b6000613b4c601883612bce565b9150613b5782613b16565b602082019050919050565b60006020820190508181036000830152613b7b81613b3f565b9050919050565b7f457863656564732074686520616c6c6f77656420737570706c79206f6620746560008201527f616d20746f6b656e730000000000000000000000000000000000000000000000602082015250565b6000613bde602983612bce565b9150613be982613b82565b604082019050919050565b60006020820190508181036000830152613c0d81613bd1565b9050919050565b7f4552433732313a2061646472657373207a65726f206973206e6f74206120766160008201527f6c6964206f776e65720000000000000000000000000000000000000000000000602082015250565b6000613c70602983612bce565b9150613c7b82613c14565b604082019050919050565b60006020820190508181036000830152613c9f81613c63565b9050919050565b7f50617965657320616e6420616d6f756e7473206c656e677468206d69736d617460008201527f6368000000000000000000000000000000000000000000000000000000000000602082015250565b6000613d02602283612bce565b9150613d0d82613ca6565b604082019050919050565b60006020820190508181036000830152613d3181613cf5565b9050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b6000613d7282612c7e565b9150613d7d83612c7e565b9250817fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0483118215151615613db657613db561394a565b5b828202905092915050565b7f596f752068617665206e6f742073656e7420656e6f7567682065746865720000600082015250565b6000613df7601e83612bce565b9150613e0282613dc1565b602082019050919050565b60006020820190508181036000830152613e2681613dea565b9050919050565b7f5075626c69632073616c65206973206e6f742061637469766500000000000000600082015250565b6000613e63601983612bce565b9150613e6e82613e2d565b602082019050919050565b60006020820190508181036000830152613e9281613e56565b9050919050565b7f45786365656473206d6178696d756d20616c6c6f7761626c65206d696e747300600082015250565b6000613ecf601f83612bce565b9150613eda82613e99565b602082019050919050565b60006020820190508181036000830152613efe81613ec2565b9050919050565b7f43616e6e6f74207175657279206e6f6e2d6578697374656e7420746f6b656e00600082015250565b6000613f3b601f83612bce565b9150613f4682613f05565b602082019050919050565b60006020820190508181036000830152613f6a81613f2e565b9050919050565b600081905092915050565b60008190508160005260206000209050919050565b60008154613f9e8161360b565b613fa88186613f71565b94506001821660008114613fc35760018114613fd457614007565b60ff19831686528186019350614007565b613fdd85613f7c565b60005b83811015613fff57815481890152600182019150602081019050613fe0565b838801955050505b50505092915050565b7f2f00000000000000000000000000000000000000000000000000000000000000600082015250565b6000614046600183613f71565b915061405182614010565b600182019050919050565b600061406782612bc3565b6140718185613f71565b9350614081818560208601612bdf565b80840191505092915050565b60006140998285613f91565b91506140a482614039565b91506140b0828461405c565b91508190509392505050565b60006140c782612c7e565b91506140d283612c7e565b9250828210156140e5576140e461394a565b5b828203905092915050565b7f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160008201527f6464726573730000000000000000000000000000000000000000000000000000602082015250565b600061414c602683612bce565b9150614157826140f0565b604082019050919050565b6000602082019050818103600083015261417b8161413f565b9050919050565b61418b81612e29565b82525050565b61419a81612e5f565b82525050565b60006080820190506141b56000830187614182565b6141c26020830186614191565b6141cf6040830185614182565b6141dc6060830184614182565b95945050505050565b7f45434453413a20696e76616c696420766f756368657200000000000000000000600082015250565b600061421b601683612bce565b9150614226826141e5565b602082019050919050565b6000602082019050818103600083015261424a8161420e565b9050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052600160045260246000fd5b7f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572600082015250565b60006142b6602083612bce565b91506142c182614280565b602082019050919050565b600060208201905081810360008301526142e5816142a9565b9050919050565b7f4552433732313a207472616e736665722066726f6d20696e636f72726563742060008201527f6f776e6572000000000000000000000000000000000000000000000000000000602082015250565b6000614348602583612bce565b9150614353826142ec565b604082019050919050565b600060208201905081810360008301526143778161433b565b9050919050565b7f4552433732313a207472616e7366657220746f20746865207a65726f2061646460008201527f7265737300000000000000000000000000000000000000000000000000000000602082015250565b60006143da602483612bce565b91506143e58261437e565b604082019050919050565b60006020820190508181036000830152614409816143cd565b9050919050565b600081905092915050565b50565b600061442b600083614410565b91506144368261441b565b600082019050919050565b600061444c8261441e565b9150819050919050565b7f5472616e73666572206661696c65642e00000000000000000000000000000000600082015250565b600061448c601083612bce565b915061449782614456565b602082019050919050565b600060208201905081810360008301526144bb8161447f565b9050919050565b7f4552433732313a20617070726f766520746f2063616c6c657200000000000000600082015250565b60006144f8601983612bce565b9150614503826144c2565b602082019050919050565b60006020820190508181036000830152614527816144eb565b9050919050565b7f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560008201527f63656976657220696d706c656d656e7465720000000000000000000000000000602082015250565b600061458a603283612bce565b91506145958261452e565b604082019050919050565b600060208201905081810360008301526145b98161457d565b9050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601260045260246000fd5b60006145fa82612c7e565b915061460583612c7e565b925082614615576146146145c0565b5b828204905092915050565b600061462b82612c7e565b915061463683612c7e565b925082614646576146456145c0565b5b828206905092915050565b60008160601b9050919050565b600061466982614651565b9050919050565b600061467b8261465e565b9050919050565b61469361468e82612d01565b614670565b82525050565b60006146a482612ce1565b9050919050565b60006146b68261465e565b9050919050565b6146ce6146c982614699565b6146ab565b82525050565b6000819050919050565b6146ef6146ea82612c7e565b6146d4565b82525050565b60006147018288614682565b60148201915061471182876146bd565b60148201915061472182866146de565b60208201915061473182856146de565b60208201915061474182846146de565b6020820191508190509695505050505050565b600081519050919050565b600082825260208201905092915050565b600061477b82614754565b614785818561475f565b9350614795818560208601612bdf565b61479e81612c12565b840191505092915050565b60006080820190506147be6000830187612d13565b6147cb6020830186612d13565b6147d86040830185612f4f565b81810360608301526147ea8184614770565b905095945050505050565b60008151905061480481612b34565b92915050565b6000602082840312156148205761481f612afe565b5b600061482e848285016147f5565b91505092915050565b7f4e6f206d6f726520746f6b656e7320617661696c61626c650000000000000000600082015250565b600061486d601883612bce565b915061487882614837565b602082019050919050565b6000602082019050818103600083015261489c81614860565b9050919050565b7f4552433732313a206d696e7420746f20746865207a65726f2061646472657373600082015250565b60006148d9602083612bce565b91506148e4826148a3565b602082019050919050565b60006020820190508181036000830152614908816148cc565b9050919050565b7f4552433732313a20746f6b656e20616c7265616479206d696e74656400000000600082015250565b6000614945601c83612bce565b91506149508261490f565b602082019050919050565b6000602082019050818103600083015261497481614938565b905091905056fe68747470733a2f2f6170692e746865706172747973707564636c75622e696f2f617065726f6e2f6d65746164617461a2646970667358221220abd24a9cccd3b09039f9ee2c1c7dff4c52293b4d298e03484caaf1a3d59dc9a064736f6c634300080900330000000000000000000000000000000000000000000000000000000000000040000000000000000000000000c1d7dbd73af45f7bcd5bed3049dc9da4c75c79a0000000000000000000000000000000000000000000000000000000000000002f68747470733a2f2f6170692e746865706172747973707564636c75622e696f2f617065726f6e2f6d657461646174610000000000000000000000000000000000

0x60806040526004361061021a5760003560e01c806370a0823111610123578063ae6a80d5116100ab578063cf84f8721161006f578063cf84f872146107af578063e14ca353146107da578063e985e9c514610805578063f2fde38b14610842578063ff9d2dcc1461086b5761021a565b8063ae6a80d5146106ca578063b1c9fe6e146106f5578063b375a08514610720578063b88d4fde14610749578063c87b56dd146107725761021a565b80638da5cb5b116100f25780638da5cb5b1461060457806395d89b411461062f5780639f181b5e1461065a578063a22cb46514610685578063a723533e146106ae5761021a565b806370a082311461055c578063715018a61461059957806377fc393e146105b05780637a3f451e146105d95761021a565b806323b872dd116101a65780634e99b800116101755780634e99b8001461046457806355f804b31461048f5780636352211e146104b857806363820f23146104f557806368c17be0146105335761021a565b806323b872dd146103c05780633123387b146103e957806342842e0e14610412578063460b289c1461043b5761021a565b80630e586a1a116101ed5780630e586a1a146102ed578063115131661461031657806314eb76ac1461034157806315f91c181461036a57806322cb1ec8146103955761021a565b806301ffc9a71461021f57806306fdde031461025c578063081812fc14610287578063095ea7b3146102c4575b600080fd5b34801561022b57600080fd5b5061024660048036038101906102419190612b60565b610896565b6040516102539190612ba8565b60405180910390f35b34801561026857600080fd5b50610271610978565b60405161027e9190612c5c565b60405180910390f35b34801561029357600080fd5b506102ae60048036038101906102a99190612cb4565b610a0a565b6040516102bb9190612d22565b60405180910390f35b3480156102d057600080fd5b506102eb60048036038101906102e69190612d69565b610a50565b005b3480156102f957600080fd5b50610314600480360381019061030f9190612efc565b610b68565b005b34801561032257600080fd5b5061032b610db9565b6040516103389190612f5e565b60405180910390f35b34801561034d57600080fd5b5061036860048036038101906103639190612f79565b610dbf565b005b34801561037657600080fd5b5061037f610e0b565b60405161038c9190612f5e565b60405180910390f35b3480156103a157600080fd5b506103aa610e33565b6040516103b79190612f5e565b60405180910390f35b3480156103cc57600080fd5b506103e760048036038101906103e29190612fa6565b610e39565b005b3480156103f557600080fd5b50610410600480360381019061040b919061301e565b610e99565b005b34801561041e57600080fd5b5061043960048036038101906104349190612fa6565b610ece565b005b34801561044757600080fd5b50610462600480360381019061045d9190612cb4565b610eee565b005b34801561047057600080fd5b50610479610f00565b6040516104869190612c5c565b60405180910390f35b34801561049b57600080fd5b506104b660048036038101906104b19190613105565b610f8e565b005b3480156104c457600080fd5b506104df60048036038101906104da9190612cb4565b610fb0565b6040516104ec9190612d22565b60405180910390f35b34801561050157600080fd5b5061051c60048036038101906105179190612f79565b611062565b60405161052a92919061314e565b60405180910390f35b34801561053f57600080fd5b5061055a60048036038101906105559190612cb4565b611086565b005b34801561056857600080fd5b50610583600480360381019061057e9190612f79565b6111a2565b6040516105909190612f5e565b60405180910390f35b3480156105a557600080fd5b506105ae61125a565b005b3480156105bc57600080fd5b506105d760048036038101906105d29190613302565b61126e565b005b3480156105e557600080fd5b506105ee61131c565b6040516105fb9190612f5e565b60405180910390f35b34801561061057600080fd5b50610619611322565b6040516106269190612d22565b60405180910390f35b34801561063b57600080fd5b5061064461134c565b6040516106519190612c5c565b60405180910390f35b34801561066657600080fd5b5061066f6113de565b60405161067c9190612f5e565b60405180910390f35b34801561069157600080fd5b506106ac60048036038101906106a791906133a6565b6113e8565b005b6106c860048036038101906106c39190612cb4565b6113fe565b005b3480156106d657600080fd5b506106df611627565b6040516106ec9190612f5e565b60405180910390f35b34801561070157600080fd5b5061070a61162d565b604051610717919061345d565b60405180910390f35b34801561072c57600080fd5b5061074760048036038101906107429190612cb4565b611640565b005b34801561075557600080fd5b50610770600480360381019061076b9190613519565b611652565b005b34801561077e57600080fd5b5061079960048036038101906107949190612cb4565b6116b4565b6040516107a69190612c5c565b60405180910390f35b3480156107bb57600080fd5b506107c4611765565b6040516107d19190612f5e565b60405180910390f35b3480156107e657600080fd5b506107ef61176a565b6040516107fc9190612f5e565b60405180910390f35b34801561081157600080fd5b5061082c6004803603810190610827919061359c565b61178b565b6040516108399190612ba8565b60405180910390f35b34801561084e57600080fd5b5061086960048036038101906108649190612f79565b61181f565b005b34801561087757600080fd5b506108806118a3565b60405161088d9190612d22565b60405180910390f35b60007f80ac58cd000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916148061096157507f5b5e139f000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b806109715750610970826118c7565b5b9050919050565b6060600080546109879061360b565b80601f01602080910402602001604051908101604052809291908181526020018280546109b39061360b565b8015610a005780601f106109d557610100808354040283529160200191610a00565b820191906000526020600020905b8154815290600101906020018083116109e357829003601f168201915b5050505050905090565b6000610a1582611931565b6004600083815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b6000610a5b82610fb0565b90508073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161415610acc576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610ac3906136af565b60405180910390fd5b8073ffffffffffffffffffffffffffffffffffffffff16610aeb61197c565b73ffffffffffffffffffffffffffffffffffffffff161480610b1a5750610b1981610b1461197c565b61178b565b5b610b59576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610b5090613741565b60405180910390fd5b610b638383611984565b505050565b8280610b7261176a565b1015610bb3576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610baa906137d3565b60405180910390fd5b600180811115610bc657610bc56133e6565b5b600b60009054906101000a900460ff166001811115610be857610be76133e6565b5b14610c28576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610c1f9061383f565b60405180910390fd5b600060038433604051602001610c40939291906138a7565b604051602081830303815290604052805190602001209050610c628184611a3d565b610ca1576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610c989061392a565b60405180910390fd5b83600f60003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000015486610cf09190613979565b1115610d31576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610d2890613a1b565b60405180910390fd5b84600f60003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000016000828254610d839190613979565b9250508190555060005b85811015610db157610d9e33611b65565b8080610da990613a3b565b915050610d8d565b505050505050565b6115b381565b610dc7611baa565b80600960006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050565b60007f00000000000000000000000000000000000000000000000000000000000014eb905090565b600d5481565b610e4a610e4461197c565b82611c28565b610e89576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610e8090613af6565b60405180910390fd5b610e94838383611cbd565b505050565b610ea1611baa565b80600b60006101000a81548160ff02191690836001811115610ec657610ec56133e6565b5b021790555050565b610ee983838360405180602001604052806000815250611652565b505050565b610ef6611baa565b80600c8190555050565b600a8054610f0d9061360b565b80601f0160208091040260200160405190810160405280929190818152602001828054610f399061360b565b8015610f865780601f10610f5b57610100808354040283529160200191610f86565b820191906000526020600020905b815481529060010190602001808311610f6957829003601f168201915b505050505081565b610f96611baa565b80600a9080519060200190610fac929190612a51565b5050565b6000806002600084815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161415611059576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161105090613b62565b60405180910390fd5b80915050919050565b600f6020528060005260406000206000915090508060000154908060010154905082565b61108e611baa565b808061109861176a565b10156110d9576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016110d0906137d3565b60405180910390fd5b60c8600d54836110e99190613979565b111561112a576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161112190613bf4565b60405180910390fd5b60006001600d5461113b9190613979565b90505b82811161118457611171600960009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1682611f24565b808061117c90613a3b565b91505061113e565b5081600d60008282546111979190613979565b925050819055505050565b60008073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff161415611213576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161120a90613c86565b60405180910390fd5b600360008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020549050919050565b611262611baa565b61126c6000611f64565b565b611276611baa565b80518251146112ba576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016112b190613d18565b60405180910390fd5b60005b8251811015611317576113048382815181106112dc576112db613d38565b5b60200260200101518383815181106112f7576112f6613d38565b5b602002602001015161202a565b808061130f90613a3b565b9150506112bd565b505050565b600c5481565b6000600660009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b60606001805461135b9061360b565b80601f01602080910402602001604051908101604052809291908181526020018280546113879061360b565b80156113d45780601f106113a9576101008083540402835291602001916113d4565b820191906000526020600020905b8154815290600101906020018083116113b757829003601f168201915b5050505050905090565b6000600754905090565b6113fa6113f361197c565b83836120db565b5050565b803481600c5461140e9190613d67565b111561144f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161144690613e0d565b60405180910390fd5b818061145961176a565b101561149a576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611491906137d3565b60405180910390fd5b6001808111156114ad576114ac6133e6565b5b600b60009054906101000a900460ff1660018111156114cf576114ce6133e6565b5b1461150f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161150690613e79565b60405180910390fd5b600e54600f60003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060010154846115609190613979565b11156115a1576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161159890613ee5565b60405180910390fd5b82600f60003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060010160008282546115f39190613979565b9250508190555060005b838110156116215761160e33611b65565b808061161990613a3b565b9150506115fd565b50505050565b600e5481565b600b60009054906101000a900460ff1681565b611648611baa565b80600e8190555050565b61166361165d61197c565b83611c28565b6116a2576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161169990613af6565b60405180910390fd5b6116ae84848484612248565b50505050565b60606116bf826122a4565b6116fe576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016116f590613f51565b60405180910390fd5b6000600a805461170d9061360b565b905011611732576040518060600160405280602f815260200161497c602f913961175e565b600a61173d83612310565b60405160200161174e92919061408d565b6040516020818303038152906040525b9050919050565b60c881565b60006117746113de565b61177c610e0b565b61178691906140bc565b905090565b6000600560008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900460ff16905092915050565b611827611baa565b600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161415611897576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161188e90614162565b60405180910390fd5b6118a081611f64565b50565b7f000000000000000000000000c1d7dbd73af45f7bcd5bed3049dc9da4c75c79a081565b60007f01ffc9a7000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916149050919050565b61193a816122a4565b611979576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161197090613b62565b60405180910390fd5b50565b600033905090565b816004600083815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550808273ffffffffffffffffffffffffffffffffffffffff166119f783610fb0565b73ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b60008060018484604001518560000151866020015160405160008152602001604052604051611a6f94939291906141a0565b6020604051602081039080840390855afa158015611a91573d6000803e3d6000fd5b505050602060405103519050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161415611b0d576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611b0490614231565b60405180910390fd5b7f000000000000000000000000c1d7dbd73af45f7bcd5bed3049dc9da4c75c79a073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161491505092915050565b6000611b6f612471565b905060c881118015611b8f575060c86115b3611b8b9190613979565b8111155b611b9c57611b9b614251565b5b611ba682826125d3565b5050565b611bb261197c565b73ffffffffffffffffffffffffffffffffffffffff16611bd0611322565b73ffffffffffffffffffffffffffffffffffffffff1614611c26576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611c1d906142cc565b60405180910390fd5b565b600080611c3483610fb0565b90508073ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff161480611c765750611c75818561178b565b5b80611cb457508373ffffffffffffffffffffffffffffffffffffffff16611c9c84610a0a565b73ffffffffffffffffffffffffffffffffffffffff16145b91505092915050565b8273ffffffffffffffffffffffffffffffffffffffff16611cdd82610fb0565b73ffffffffffffffffffffffffffffffffffffffff1614611d33576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611d2a9061435e565b60405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff161415611da3576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611d9a906143f0565b60405180910390fd5b611dae8383836125f1565b611db9600082611984565b6001600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254611e0991906140bc565b925050819055506001600360008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254611e609190613979565b92505081905550816002600083815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550808273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4611f1f8383836125f6565b505050565b6000811415611f3657611f35614251565b5b60c8811115611f4857611f47614251565b5b611f51816122a4565b611f6057611f5f82826125d3565b5b5050565b6000600660009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905081600660006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b60008273ffffffffffffffffffffffffffffffffffffffff168260405161205090614441565b60006040518083038185875af1925050503d806000811461208d576040519150601f19603f3d011682016040523d82523d6000602084013e612092565b606091505b50509050806120d6576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016120cd906144a2565b60405180910390fd5b505050565b8173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16141561214a576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016121419061450e565b60405180910390fd5b80600560008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548160ff0219169083151502179055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c318360405161223b9190612ba8565b60405180910390a3505050565b612253848484611cbd565b61225f848484846125fb565b61229e576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612295906145a0565b60405180910390fd5b50505050565b60008073ffffffffffffffffffffffffffffffffffffffff166002600084815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614159050919050565b60606000821415612358576040518060400160405280600181526020017f3000000000000000000000000000000000000000000000000000000000000000815250905061246c565b600082905060005b6000821461238a57808061237390613a3b565b915050600a8261238391906145ef565b9150612360565b60008167ffffffffffffffff8111156123a6576123a5612dae565b5b6040519080825280601f01601f1916602001820160405280156123d85781602001600182028036833780820191505090505b5090505b60008514612465576001826123f191906140bc565b9150600a856124009190614620565b603061240c9190613979565b60f81b81838151811061242257612421613d38565b5b60200101907effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916908160001a905350600a8561245e91906145ef565b94506123dc565b8093505050505b919050565b60008061247c6113de565b612484610e0b565b61248e91906140bc565b905060008133414445426040516020016124ac9594939291906146f5565b6040516020818303038152906040528051906020012060001c6124cf9190614620565b9050600080600860008481526020019081526020016000205414156124f65781905061250d565b600860008381526020019081526020016000205490505b60006008600060018661252091906140bc565b815260200190815260200160002054141561255e5760018361254291906140bc565b6008600084815260200190815260200160002081905550612596565b6008600060018561256f91906140bc565b81526020019081526020016000205460086000848152602001908152602001600020819055505b61259e612792565b507f00000000000000000000000000000000000000000000000000000000000000c9816125cb9190613979565b935050505090565b6125ed8282604051806020016040528060008152506127f9565b5050565b505050565b505050565b600061261c8473ffffffffffffffffffffffffffffffffffffffff16612854565b15612785578373ffffffffffffffffffffffffffffffffffffffff1663150b7a0261264561197c565b8786866040518563ffffffff1660e01b815260040161266794939291906147a9565b602060405180830381600087803b15801561268157600080fd5b505af19250505080156126b257506040513d601f19601f820116820180604052508101906126af919061480a565b60015b612735573d80600081146126e2576040519150601f19603f3d011682016040523d82523d6000602084013e6126e7565b606091505b5060008151141561272d576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612724906145a0565b60405180910390fd5b805181602001fd5b63150b7a0260e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161491505061278a565b600190505b949350505050565b60008061279d61176a565b116127dd576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016127d490614883565b60405180910390fd5b600760008154809291906127f090613a3b565b91905055905090565b6128038383612877565b61281060008484846125fb565b61284f576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612846906145a0565b60405180910390fd5b505050565b6000808273ffffffffffffffffffffffffffffffffffffffff163b119050919050565b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614156128e7576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016128de906148ef565b60405180910390fd5b6128f0816122a4565b15612930576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016129279061495b565b60405180910390fd5b61293c600083836125f1565b6001600360008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825461298c9190613979565b92505081905550816002600083815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550808273ffffffffffffffffffffffffffffffffffffffff16600073ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4612a4d600083836125f6565b5050565b828054612a5d9061360b565b90600052602060002090601f016020900481019282612a7f5760008555612ac6565b82601f10612a9857805160ff1916838001178555612ac6565b82800160010185558215612ac6579182015b82811115612ac5578251825591602001919060010190612aaa565b5b509050612ad39190612ad7565b5090565b5b80821115612af0576000816000905550600101612ad8565b5090565b6000604051905090565b600080fd5b600080fd5b60007fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b612b3d81612b08565b8114612b4857600080fd5b50565b600081359050612b5a81612b34565b92915050565b600060208284031215612b7657612b75612afe565b5b6000612b8484828501612b4b565b91505092915050565b60008115159050919050565b612ba281612b8d565b82525050565b6000602082019050612bbd6000830184612b99565b92915050565b600081519050919050565b600082825260208201905092915050565b60005b83811015612bfd578082015181840152602081019050612be2565b83811115612c0c576000848401525b50505050565b6000601f19601f8301169050919050565b6000612c2e82612bc3565b612c388185612bce565b9350612c48818560208601612bdf565b612c5181612c12565b840191505092915050565b60006020820190508181036000830152612c768184612c23565b905092915050565b6000819050919050565b612c9181612c7e565b8114612c9c57600080fd5b50565b600081359050612cae81612c88565b92915050565b600060208284031215612cca57612cc9612afe565b5b6000612cd884828501612c9f565b91505092915050565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000612d0c82612ce1565b9050919050565b612d1c81612d01565b82525050565b6000602082019050612d376000830184612d13565b92915050565b612d4681612d01565b8114612d5157600080fd5b50565b600081359050612d6381612d3d565b92915050565b60008060408385031215612d8057612d7f612afe565b5b6000612d8e85828601612d54565b9250506020612d9f85828601612c9f565b9150509250929050565b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b612de682612c12565b810181811067ffffffffffffffff82111715612e0557612e04612dae565b5b80604052505050565b6000612e18612af4565b9050612e248282612ddd565b919050565b6000819050919050565b612e3c81612e29565b8114612e4757600080fd5b50565b600081359050612e5981612e33565b92915050565b600060ff82169050919050565b612e7581612e5f565b8114612e8057600080fd5b50565b600081359050612e9281612e6c565b92915050565b600060608284031215612eae57612ead612da9565b5b612eb86060612e0e565b90506000612ec884828501612e4a565b6000830152506020612edc84828501612e4a565b6020830152506040612ef084828501612e83565b60408301525092915050565b600080600060a08486031215612f1557612f14612afe565b5b6000612f2386828701612c9f565b9350506020612f3486828701612c9f565b9250506040612f4586828701612e98565b9150509250925092565b612f5881612c7e565b82525050565b6000602082019050612f736000830184612f4f565b92915050565b600060208284031215612f8f57612f8e612afe565b5b6000612f9d84828501612d54565b91505092915050565b600080600060608486031215612fbf57612fbe612afe565b5b6000612fcd86828701612d54565b9350506020612fde86828701612d54565b9250506040612fef86828701612c9f565b9150509250925092565b6002811061300657600080fd5b50565b60008135905061301881612ff9565b92915050565b60006020828403121561303457613033612afe565b5b600061304284828501613009565b91505092915050565b600080fd5b600080fd5b600067ffffffffffffffff8211156130705761306f612dae565b5b61307982612c12565b9050602081019050919050565b82818337600083830152505050565b60006130a86130a384613055565b612e0e565b9050828152602081018484840111156130c4576130c3613050565b5b6130cf848285613086565b509392505050565b600082601f8301126130ec576130eb61304b565b5b81356130fc848260208601613095565b91505092915050565b60006020828403121561311b5761311a612afe565b5b600082013567ffffffffffffffff81111561313957613138612b03565b5b613145848285016130d7565b91505092915050565b60006040820190506131636000830185612f4f565b6131706020830184612f4f565b9392505050565b600067ffffffffffffffff82111561319257613191612dae565b5b602082029050602081019050919050565b600080fd5b60006131bb6131b684613177565b612e0e565b905080838252602082019050602084028301858111156131de576131dd6131a3565b5b835b8181101561320757806131f38882612d54565b8452602084019350506020810190506131e0565b5050509392505050565b600082601f8301126132265761322561304b565b5b81356132368482602086016131a8565b91505092915050565b600067ffffffffffffffff82111561325a57613259612dae565b5b602082029050602081019050919050565b600061327e6132798461323f565b612e0e565b905080838252602082019050602084028301858111156132a1576132a06131a3565b5b835b818110156132ca57806132b68882612c9f565b8452602084019350506020810190506132a3565b5050509392505050565b600082601f8301126132e9576132e861304b565b5b81356132f984826020860161326b565b91505092915050565b6000806040838503121561331957613318612afe565b5b600083013567ffffffffffffffff81111561333757613336612b03565b5b61334385828601613211565b925050602083013567ffffffffffffffff81111561336457613363612b03565b5b613370858286016132d4565b9150509250929050565b61338381612b8d565b811461338e57600080fd5b50565b6000813590506133a08161337a565b92915050565b600080604083850312156133bd576133bc612afe565b5b60006133cb85828601612d54565b92505060206133dc85828601613391565b9150509250929050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602160045260246000fd5b60028110613426576134256133e6565b5b50565b600081905061343782613415565b919050565b600061344782613429565b9050919050565b6134578161343c565b82525050565b6000602082019050613472600083018461344e565b92915050565b600067ffffffffffffffff82111561349357613492612dae565b5b61349c82612c12565b9050602081019050919050565b60006134bc6134b784613478565b612e0e565b9050828152602081018484840111156134d8576134d7613050565b5b6134e3848285613086565b509392505050565b600082601f830112613500576134ff61304b565b5b81356135108482602086016134a9565b91505092915050565b6000806000806080858703121561353357613532612afe565b5b600061354187828801612d54565b945050602061355287828801612d54565b935050604061356387828801612c9f565b925050606085013567ffffffffffffffff81111561358457613583612b03565b5b613590878288016134eb565b91505092959194509250565b600080604083850312156135b3576135b2612afe565b5b60006135c185828601612d54565b92505060206135d285828601612d54565b9150509250929050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b6000600282049050600182168061362357607f821691505b60208210811415613637576136366135dc565b5b50919050565b7f4552433732313a20617070726f76616c20746f2063757272656e74206f776e6560008201527f7200000000000000000000000000000000000000000000000000000000000000602082015250565b6000613699602183612bce565b91506136a48261363d565b604082019050919050565b600060208201905081810360008301526136c88161368c565b9050919050565b7f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60008201527f6b656e206f776e6572206e6f7220617070726f76656420666f7220616c6c0000602082015250565b600061372b603e83612bce565b9150613736826136cf565b604082019050919050565b6000602082019050818103600083015261375a8161371e565b9050919050565b7f526571756573746564206e756d626572206f6620746f6b656e73206e6f74206160008201527f7661696c61626c65000000000000000000000000000000000000000000000000602082015250565b60006137bd602883612bce565b91506137c882613761565b604082019050919050565b600060208201905081810360008301526137ec816137b0565b9050919050565b7f46726565204d696e74696e67206973206e6f7420616374697665000000000000600082015250565b6000613829601a83612bce565b9150613834826137f3565b602082019050919050565b600060208201905081810360008301526138588161381c565b9050919050565b600481106138705761386f6133e6565b5b50565b60008190506138818261385f565b919050565b600061389182613873565b9050919050565b6138a181613886565b82525050565b60006060820190506138bc6000830186613898565b6138c96020830185612f4f565b6138d66040830184612d13565b949350505050565b7f496e76616c696420766f75636865720000000000000000000000000000000000600082015250565b6000613914600f83612bce565b915061391f826138de565b602082019050919050565b6000602082019050818103600083015261394381613907565b9050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061398482612c7e565b915061398f83612c7e565b9250827fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff038211156139c4576139c361394a565b5b828201905092915050565b7f45786365656473206e756d626572206f66206561726e65642041706573000000600082015250565b6000613a05601d83612bce565b9150613a10826139cf565b602082019050919050565b60006020820190508181036000830152613a34816139f8565b9050919050565b6000613a4682612c7e565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff821415613a7957613a7861394a565b5b600182019050919050565b7f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560008201527f72206e6f7220617070726f766564000000000000000000000000000000000000602082015250565b6000613ae0602e83612bce565b9150613aeb82613a84565b604082019050919050565b60006020820190508181036000830152613b0f81613ad3565b9050919050565b7f4552433732313a20696e76616c696420746f6b656e2049440000000000000000600082015250565b6000613b4c601883612bce565b9150613b5782613b16565b602082019050919050565b60006020820190508181036000830152613b7b81613b3f565b9050919050565b7f457863656564732074686520616c6c6f77656420737570706c79206f6620746560008201527f616d20746f6b656e730000000000000000000000000000000000000000000000602082015250565b6000613bde602983612bce565b9150613be982613b82565b604082019050919050565b60006020820190508181036000830152613c0d81613bd1565b9050919050565b7f4552433732313a2061646472657373207a65726f206973206e6f74206120766160008201527f6c6964206f776e65720000000000000000000000000000000000000000000000602082015250565b6000613c70602983612bce565b9150613c7b82613c14565b604082019050919050565b60006020820190508181036000830152613c9f81613c63565b9050919050565b7f50617965657320616e6420616d6f756e7473206c656e677468206d69736d617460008201527f6368000000000000000000000000000000000000000000000000000000000000602082015250565b6000613d02602283612bce565b9150613d0d82613ca6565b604082019050919050565b60006020820190508181036000830152613d3181613cf5565b9050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b6000613d7282612c7e565b9150613d7d83612c7e565b9250817fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0483118215151615613db657613db561394a565b5b828202905092915050565b7f596f752068617665206e6f742073656e7420656e6f7567682065746865720000600082015250565b6000613df7601e83612bce565b9150613e0282613dc1565b602082019050919050565b60006020820190508181036000830152613e2681613dea565b9050919050565b7f5075626c69632073616c65206973206e6f742061637469766500000000000000600082015250565b6000613e63601983612bce565b9150613e6e82613e2d565b602082019050919050565b60006020820190508181036000830152613e9281613e56565b9050919050565b7f45786365656473206d6178696d756d20616c6c6f7761626c65206d696e747300600082015250565b6000613ecf601f83612bce565b9150613eda82613e99565b602082019050919050565b60006020820190508181036000830152613efe81613ec2565b9050919050565b7f43616e6e6f74207175657279206e6f6e2d6578697374656e7420746f6b656e00600082015250565b6000613f3b601f83612bce565b9150613f4682613f05565b602082019050919050565b60006020820190508181036000830152613f6a81613f2e565b9050919050565b600081905092915050565b60008190508160005260206000209050919050565b60008154613f9e8161360b565b613fa88186613f71565b94506001821660008114613fc35760018114613fd457614007565b60ff19831686528186019350614007565b613fdd85613f7c565b60005b83811015613fff57815481890152600182019150602081019050613fe0565b838801955050505b50505092915050565b7f2f00000000000000000000000000000000000000000000000000000000000000600082015250565b6000614046600183613f71565b915061405182614010565b600182019050919050565b600061406782612bc3565b6140718185613f71565b9350614081818560208601612bdf565b80840191505092915050565b60006140998285613f91565b91506140a482614039565b91506140b0828461405c565b91508190509392505050565b60006140c782612c7e565b91506140d283612c7e565b9250828210156140e5576140e461394a565b5b828203905092915050565b7f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160008201527f6464726573730000000000000000000000000000000000000000000000000000602082015250565b600061414c602683612bce565b9150614157826140f0565b604082019050919050565b6000602082019050818103600083015261417b8161413f565b9050919050565b61418b81612e29565b82525050565b61419a81612e5f565b82525050565b60006080820190506141b56000830187614182565b6141c26020830186614191565b6141cf6040830185614182565b6141dc6060830184614182565b95945050505050565b7f45434453413a20696e76616c696420766f756368657200000000000000000000600082015250565b600061421b601683612bce565b9150614226826141e5565b602082019050919050565b6000602082019050818103600083015261424a8161420e565b9050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052600160045260246000fd5b7f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572600082015250565b60006142b6602083612bce565b91506142c182614280565b602082019050919050565b600060208201905081810360008301526142e5816142a9565b9050919050565b7f4552433732313a207472616e736665722066726f6d20696e636f72726563742060008201527f6f776e6572000000000000000000000000000000000000000000000000000000602082015250565b6000614348602583612bce565b9150614353826142ec565b604082019050919050565b600060208201905081810360008301526143778161433b565b9050919050565b7f4552433732313a207472616e7366657220746f20746865207a65726f2061646460008201527f7265737300000000000000000000000000000000000000000000000000000000602082015250565b60006143da602483612bce565b91506143e58261437e565b604082019050919050565b60006020820190508181036000830152614409816143cd565b9050919050565b600081905092915050565b50565b600061442b600083614410565b91506144368261441b565b600082019050919050565b600061444c8261441e565b9150819050919050565b7f5472616e73666572206661696c65642e00000000000000000000000000000000600082015250565b600061448c601083612bce565b915061449782614456565b602082019050919050565b600060208201905081810360008301526144bb8161447f565b9050919050565b7f4552433732313a20617070726f766520746f2063616c6c657200000000000000600082015250565b60006144f8601983612bce565b9150614503826144c2565b602082019050919050565b60006020820190508181036000830152614527816144eb565b9050919050565b7f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560008201527f63656976657220696d706c656d656e7465720000000000000000000000000000602082015250565b600061458a603283612bce565b91506145958261452e565b604082019050919050565b600060208201905081810360008301526145b98161457d565b9050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601260045260246000fd5b60006145fa82612c7e565b915061460583612c7e565b925082614615576146146145c0565b5b828204905092915050565b600061462b82612c7e565b915061463683612c7e565b925082614646576146456145c0565b5b828206905092915050565b60008160601b9050919050565b600061466982614651565b9050919050565b600061467b8261465e565b9050919050565b61469361468e82612d01565b614670565b82525050565b60006146a482612ce1565b9050919050565b60006146b68261465e565b9050919050565b6146ce6146c982614699565b6146ab565b82525050565b6000819050919050565b6146ef6146ea82612c7e565b6146d4565b82525050565b60006147018288614682565b60148201915061471182876146bd565b60148201915061472182866146de565b60208201915061473182856146de565b60208201915061474182846146de565b6020820191508190509695505050505050565b600081519050919050565b600082825260208201905092915050565b600061477b82614754565b614785818561475f565b9350614795818560208601612bdf565b61479e81612c12565b840191505092915050565b60006080820190506147be6000830187612d13565b6147cb6020830186612d13565b6147d86040830185612f4f565b81810360608301526147ea8184614770565b905095945050505050565b60008151905061480481612b34565b92915050565b6000602082840312156148205761481f612afe565b5b600061482e848285016147f5565b91505092915050565b7f4e6f206d6f726520746f6b656e7320617661696c61626c650000000000000000600082015250565b600061486d601883612bce565b915061487882614837565b602082019050919050565b6000602082019050818103600083015261489c81614860565b9050919050565b7f4552433732313a206d696e7420746f20746865207a65726f2061646472657373600082015250565b60006148d9602083612bce565b91506148e4826148a3565b602082019050919050565b60006020820190508181036000830152614908816148cc565b9050919050565b7f4552433732313a20746f6b656e20616c7265616479206d696e74656400000000600082015250565b6000614945601c83612bce565b91506149508261490f565b602082019050919050565b6000602082019050818103600083015261497481614938565b905091905056fe68747470733a2f2f6170692e746865706172747973707564636c75622e696f2f617065726f6e2f6d65746164617461a2646970667358221220abd24a9cccd3b09039f9ee2c1c7dff4c52293b4d298e03484caaf1a3d59dc9a064736f6c63430008090033

0000000000000000000000000000000000000000000000000000000000000040000000000000000000000000c1d7dbd73af45f7bcd5bed3049dc9da4c75c79a0000000000000000000000000000000000000000000000000000000000000002f68747470733a2f2f6170692e746865706172747973707564636c75622e696f2f617065726f6e2f6d657461646174610000000000000000000000000000000000

-----Decoded View---------------
Arg [0] : _uri (string): https://api.thepartyspudclub.io/aperon/metadata
Arg [1] : _adminSigner (address): 0xc1d7dBd73AF45f7bCD5bED3049Dc9da4c75C79A0

-----Encoded View---------------
5 Constructor Arguments found :
Arg [0] : 0000000000000000000000000000000000000000000000000000000000000040
Arg [1] : 000000000000000000000000c1d7dbd73af45f7bcd5bed3049dc9da4c75c79a0
Arg [2] : 000000000000000000000000000000000000000000000000000000000000002f
Arg [3] : 68747470733a2f2f6170692e746865706172747973707564636c75622e696f2f
Arg [4] : 617065726f6e2f6d657461646174610000000000000000000000000000000000