Token

Contract Source Code (Solidity)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

Outline

   - function _msgSender()    - function _msgData()    - function owner()    - function _checkOwner()    - function renounceOwnership()    - function transferOwnership(address ne ...    - function _transferOwnership(address n ... interface IERC721A    - function totalSupply()    - function supportsInterface(bytes4 int ...    - function balanceOf(address owner)    - function ownerOf(uint256 tokenId)    - function safeTransferFrom(    - function safeTransferFrom(    - function transferFrom(    - function approve(address to, uint256 ...    - function setApprovalForAll(address op ...    - function getApproved(uint256 tokenId)    - function isApprovedForAll(address own ...    - function name()    - function symbol()    - function tokenURI(uint256 tokenId) interface ERC721A__IERC721Receiver    - function onERC721Received(  contract ERC721A is IERC721A    - function _startTokenId()    - function _nextTokenId()    - function totalSupply()    - function _totalMinted()    - function _totalBurned()    - function balanceOf(address owner)    - function _numberMinted(address owner)    - function _numberBurned(address owner)    - function _getAux(address owner)    - function _setAux(address owner, uint6 ...    - function supportsInterface(bytes4 int ...    - function name()    - function symbol()    - function tokenURI(uint256 tokenId)    - function _baseURI()    - function ownerOf(uint256 tokenId)    - function _ownershipOf(uint256 tokenId ...    - function _ownershipAt(uint256 index)    - function _initializeOwnershipAt(uint2 ...    - function _packedOwnershipOf(uint256 t ...    - function _unpackedOwnership(uint256 p ...    - function _packOwnershipData(address o ...    - function _nextInitializedFlag(uint256 ...    - function approve(address to, uint256 ...    - function getApproved(uint256 tokenId)    - function setApprovalForAll(address op ...    - function isApprovedForAll(address own ...    - function _exists(uint256 tokenId)    - function _isSenderApprovedOrOwner(    - function _getApprovedSlotAndAddress(u ...    - function transferFrom(    - function safeTransferFrom(    - function safeTransferFrom(    - function _beforeTokenTransfers(    - function _afterTokenTransfers(    - function _checkContractOnERC721Receiv ...    - function _mint(address to, uint256 qu ...    - function _mintERC2309(address to, uin ...    - function _safeMint(    - function _safeMint(address to, uint25 ...    - function _burn(uint256 tokenId)    - function _burn(uint256 tokenId, bool ...    - function _setExtraDataAt(uint256 inde ...    - function _extraData(    - function _nextExtraData(    - function _msgSenderERC721A()    - function _toString(uint256 value)  contract Saints is ERC721A, Ownabl ... *    - function mint(uint256 quantity)    - function ownerMint(address to, uint25 ...    - function withdraw()    - function _baseURI()    - function _startTokenId()    - function tokenURI(uint256 tokenId)    - function setMintPrice(uint256 _mintPr ...    - function setBaseURI(string memory _ne ...    - function pause(bool _state)

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

/**
 *Submitted for verification at Etherscan.io on 2023-03-30
*/

// SPDX-License-Identifier: MIT
// File: @openzeppelin/contracts/utils/Context.sol


// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)

pragma solidity ^0.8.0;

/**
 * @dev Provides information about the current execution context, including the
 * sender of the transaction and its data. While these are generally available
 * via msg.sender and msg.data, they should not be accessed in such a direct
 * manner, since when dealing with meta-transactions the account sending and
 * paying for execution may not be the actual sender (as far as an application
 * is concerned).
 *
 * This contract is only required for intermediate, library-like contracts.
 */
abstract contract Context {
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

    function _msgData() internal view virtual returns (bytes calldata) {
        return msg.data;
    }
}

// File: @openzeppelin/contracts/access/Ownable.sol


// OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol)

pragma solidity ^0.8.0;


/**
 * @dev Contract module which provides a basic access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * By default, the owner account will be the one that deploys the contract. This
 * can later be changed with {transferOwnership}.
 *
 * This module is used through inheritance. It will make available the modifier
 * `onlyOwner`, which can be applied to your functions to restrict their use to
 * the owner.
 */
abstract contract Ownable is Context {
    address private _owner;

    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);

    /**
     * @dev Initializes the contract setting the deployer as the initial owner.
     */
    constructor() {
        _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);
    }
}

// File: erc721a/contracts/IERC721A.sol


// ERC721A Contracts v4.2.3
// Creator: Chiru Labs

pragma solidity ^0.8.4;

/**
 * @dev Interface of ERC721A.
 */
interface IERC721A {
    /**
     * The caller must own the token or be an approved operator.
     */
    error ApprovalCallerNotOwnerNorApproved();

    /**
     * The token does not exist.
     */
    error ApprovalQueryForNonexistentToken();

    /**
     * Cannot query the balance for the zero address.
     */
    error BalanceQueryForZeroAddress();

    /**
     * Cannot mint to the zero address.
     */
    error MintToZeroAddress();

    /**
     * The quantity of tokens minted must be more than zero.
     */
    error MintZeroQuantity();

    /**
     * The token does not exist.
     */
    error OwnerQueryForNonexistentToken();

    /**
     * The caller must own the token or be an approved operator.
     */
    error TransferCallerNotOwnerNorApproved();

    /**
     * The token must be owned by `from`.
     */
    error TransferFromIncorrectOwner();

    /**
     * Cannot safely transfer to a contract that does not implement the
     * ERC721Receiver interface.
     */
    error TransferToNonERC721ReceiverImplementer();

    /**
     * Cannot transfer to the zero address.
     */
    error TransferToZeroAddress();

    /**
     * The token does not exist.
     */
    error URIQueryForNonexistentToken();

    /**
     * The `quantity` minted with ERC2309 exceeds the safety limit.
     */
    error MintERC2309QuantityExceedsLimit();

    /**
     * The `extraData` cannot be set on an unintialized ownership slot.
     */
    error OwnershipNotInitializedForExtraData();

    // =============================================================
    //                            STRUCTS
    // =============================================================

    struct TokenOwnership {
        // The address of the owner.
        address addr;
        // Stores the start time of ownership with minimal overhead for tokenomics.
        uint64 startTimestamp;
        // Whether the token has been burned.
        bool burned;
        // Arbitrary data similar to `startTimestamp` that can be set via {_extraData}.
        uint24 extraData;
    }

    // =============================================================
    //                         TOKEN COUNTERS
    // =============================================================

    /**
     * @dev Returns the total number of tokens in existence.
     * Burned tokens will reduce the count.
     * To get the total number of tokens minted, please see {_totalMinted}.
     */
    function totalSupply() external view returns (uint256);

    // =============================================================
    //                            IERC165
    // =============================================================

    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30000 gas.
     */
    function supportsInterface(bytes4 interfaceId) external view returns (bool);

    // =============================================================
    //                            IERC721
    // =============================================================

    /**
     * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
     */
    event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);

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

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

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

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

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

    /**
     * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId
    ) external payable;

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

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

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

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

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

    // =============================================================
    //                        IERC721Metadata
    // =============================================================

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

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

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

    // =============================================================
    //                           IERC2309
    // =============================================================

    /**
     * @dev Emitted when tokens in `fromTokenId` to `toTokenId`
     * (inclusive) is transferred from `from` to `to`, as defined in the
     * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard.
     *
     * See {_mintERC2309} for more details.
     */
    event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to);
}

// File: erc721a/contracts/ERC721A.sol


// ERC721A Contracts v4.2.3
// Creator: Chiru Labs

pragma solidity ^0.8.4;


/**
 * @dev Interface of ERC721 token receiver.
 */
interface ERC721A__IERC721Receiver {
    function onERC721Received(
        address operator,
        address from,
        uint256 tokenId,
        bytes calldata data
    ) external returns (bytes4);
}

/**
 * @title ERC721A
 *
 * @dev Implementation of the [ERC721](https://eips.ethereum.org/EIPS/eip-721)
 * Non-Fungible Token Standard, including the Metadata extension.
 * Optimized for lower gas during batch mints.
 *
 * Token IDs are minted in sequential order (e.g. 0, 1, 2, 3, ...)
 * starting from `_startTokenId()`.
 *
 * Assumptions:
 *
 * - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply.
 * - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256).
 */
contract ERC721A is IERC721A {
    // Bypass for a `--via-ir` bug (https://github.com/chiru-labs/ERC721A/pull/364).
    struct TokenApprovalRef {
        address value;
    }

    // =============================================================
    //                           CONSTANTS
    // =============================================================

    // Mask of an entry in packed address data.
    uint256 private constant _BITMASK_ADDRESS_DATA_ENTRY = (1 << 64) - 1;

    // The bit position of `numberMinted` in packed address data.
    uint256 private constant _BITPOS_NUMBER_MINTED = 64;

    // The bit position of `numberBurned` in packed address data.
    uint256 private constant _BITPOS_NUMBER_BURNED = 128;

    // The bit position of `aux` in packed address data.
    uint256 private constant _BITPOS_AUX = 192;

    // Mask of all 256 bits in packed address data except the 64 bits for `aux`.
    uint256 private constant _BITMASK_AUX_COMPLEMENT = (1 << 192) - 1;

    // The bit position of `startTimestamp` in packed ownership.
    uint256 private constant _BITPOS_START_TIMESTAMP = 160;

    // The bit mask of the `burned` bit in packed ownership.
    uint256 private constant _BITMASK_BURNED = 1 << 224;

    // The bit position of the `nextInitialized` bit in packed ownership.
    uint256 private constant _BITPOS_NEXT_INITIALIZED = 225;

    // The bit mask of the `nextInitialized` bit in packed ownership.
    uint256 private constant _BITMASK_NEXT_INITIALIZED = 1 << 225;

    // The bit position of `extraData` in packed ownership.
    uint256 private constant _BITPOS_EXTRA_DATA = 232;

    // Mask of all 256 bits in a packed ownership except the 24 bits for `extraData`.
    uint256 private constant _BITMASK_EXTRA_DATA_COMPLEMENT = (1 << 232) - 1;

    // The mask of the lower 160 bits for addresses.
    uint256 private constant _BITMASK_ADDRESS = (1 << 160) - 1;

    // The maximum `quantity` that can be minted with {_mintERC2309}.
    // This limit is to prevent overflows on the address data entries.
    // For a limit of 5000, a total of 3.689e15 calls to {_mintERC2309}
    // is required to cause an overflow, which is unrealistic.
    uint256 private constant _MAX_MINT_ERC2309_QUANTITY_LIMIT = 5000;

    // The `Transfer` event signature is given by:
    // `keccak256(bytes("Transfer(address,address,uint256)"))`.
    bytes32 private constant _TRANSFER_EVENT_SIGNATURE =
        0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef;

    // =============================================================
    //                            STORAGE
    // =============================================================

    // The next token ID to be minted.
    uint256 private _currentIndex;

    // The number of tokens burned.
    uint256 private _burnCounter;

    // Token name
    string private _name;

    // Token symbol
    string private _symbol;

    // Mapping from token ID to ownership details
    // An empty struct value does not necessarily mean the token is unowned.
    // See {_packedOwnershipOf} implementation for details.
    //
    // Bits Layout:
    // - [0..159]   `addr`
    // - [160..223] `startTimestamp`
    // - [224]      `burned`
    // - [225]      `nextInitialized`
    // - [232..255] `extraData`
    mapping(uint256 => uint256) private _packedOwnerships;

    // Mapping owner address to address data.
    //
    // Bits Layout:
    // - [0..63]    `balance`
    // - [64..127]  `numberMinted`
    // - [128..191] `numberBurned`
    // - [192..255] `aux`
    mapping(address => uint256) private _packedAddressData;

    // Mapping from token ID to approved address.
    mapping(uint256 => TokenApprovalRef) private _tokenApprovals;

    // Mapping from owner to operator approvals
    mapping(address => mapping(address => bool)) private _operatorApprovals;

    // =============================================================
    //                          CONSTRUCTOR
    // =============================================================

    constructor(string memory name_, string memory symbol_) {
        _name = name_;
        _symbol = symbol_;
        _currentIndex = _startTokenId();
    }

    // =============================================================
    //                   TOKEN COUNTING OPERATIONS
    // =============================================================

    /**
     * @dev Returns the starting token ID.
     * To change the starting token ID, please override this function.
     */
    function _startTokenId() internal view virtual returns (uint256) {
        return 0;
    }

    /**
     * @dev Returns the next token ID to be minted.
     */
    function _nextTokenId() internal view virtual returns (uint256) {
        return _currentIndex;
    }

    /**
     * @dev Returns the total number of tokens in existence.
     * Burned tokens will reduce the count.
     * To get the total number of tokens minted, please see {_totalMinted}.
     */
    function totalSupply() public view virtual override returns (uint256) {
        // Counter underflow is impossible as _burnCounter cannot be incremented
        // more than `_currentIndex - _startTokenId()` times.
        unchecked {
            return _currentIndex - _burnCounter - _startTokenId();
        }
    }

    /**
     * @dev Returns the total amount of tokens minted in the contract.
     */
    function _totalMinted() internal view virtual returns (uint256) {
        // Counter underflow is impossible as `_currentIndex` does not decrement,
        // and it is initialized to `_startTokenId()`.
        unchecked {
            return _currentIndex - _startTokenId();
        }
    }

    /**
     * @dev Returns the total number of tokens burned.
     */
    function _totalBurned() internal view virtual returns (uint256) {
        return _burnCounter;
    }

    // =============================================================
    //                    ADDRESS DATA OPERATIONS
    // =============================================================

    /**
     * @dev Returns the number of tokens in `owner`'s account.
     */
    function balanceOf(address owner) public view virtual override returns (uint256) {
        if (owner == address(0)) revert BalanceQueryForZeroAddress();
        return _packedAddressData[owner] & _BITMASK_ADDRESS_DATA_ENTRY;
    }

    /**
     * Returns the number of tokens minted by `owner`.
     */
    function _numberMinted(address owner) internal view returns (uint256) {
        return (_packedAddressData[owner] >> _BITPOS_NUMBER_MINTED) & _BITMASK_ADDRESS_DATA_ENTRY;
    }

    /**
     * Returns the number of tokens burned by or on behalf of `owner`.
     */
    function _numberBurned(address owner) internal view returns (uint256) {
        return (_packedAddressData[owner] >> _BITPOS_NUMBER_BURNED) & _BITMASK_ADDRESS_DATA_ENTRY;
    }

    /**
     * Returns the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
     */
    function _getAux(address owner) internal view returns (uint64) {
        return uint64(_packedAddressData[owner] >> _BITPOS_AUX);
    }

    /**
     * Sets the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
     * If there are multiple variables, please pack them into a uint64.
     */
    function _setAux(address owner, uint64 aux) internal virtual {
        uint256 packed = _packedAddressData[owner];
        uint256 auxCasted;
        // Cast `aux` with assembly to avoid redundant masking.
        assembly {
            auxCasted := aux
        }
        packed = (packed & _BITMASK_AUX_COMPLEMENT) | (auxCasted << _BITPOS_AUX);
        _packedAddressData[owner] = packed;
    }

    // =============================================================
    //                            IERC165
    // =============================================================

    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30000 gas.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        // The interface IDs are constants representing the first 4 bytes
        // of the XOR of all function selectors in the interface.
        // See: [ERC165](https://eips.ethereum.org/EIPS/eip-165)
        // (e.g. `bytes4(i.functionA.selector ^ i.functionB.selector ^ ...)`)
        return
            interfaceId == 0x01ffc9a7 || // ERC165 interface ID for ERC165.
            interfaceId == 0x80ac58cd || // ERC165 interface ID for ERC721.
            interfaceId == 0x5b5e139f; // ERC165 interface ID for ERC721Metadata.
    }

    // =============================================================
    //                        IERC721Metadata
    // =============================================================

    /**
     * @dev Returns the token collection name.
     */
    function name() public view virtual override returns (string memory) {
        return _name;
    }

    /**
     * @dev Returns the token collection symbol.
     */
    function symbol() public view virtual override returns (string memory) {
        return _symbol;
    }

    /**
     * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
     */
    function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
        if (!_exists(tokenId)) revert URIQueryForNonexistentToken();

        string memory baseURI = _baseURI();
        return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : '';
    }

    /**
     * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
     * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
     * by default, it can be overridden in child contracts.
     */
    function _baseURI() internal view virtual returns (string memory) {
        return '';
    }

    // =============================================================
    //                     OWNERSHIPS OPERATIONS
    // =============================================================

    /**
     * @dev Returns the owner of the `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function ownerOf(uint256 tokenId) public view virtual override returns (address) {
        return address(uint160(_packedOwnershipOf(tokenId)));
    }

    /**
     * @dev Gas spent here starts off proportional to the maximum mint batch size.
     * It gradually moves to O(1) as tokens get transferred around over time.
     */
    function _ownershipOf(uint256 tokenId) internal view virtual returns (TokenOwnership memory) {
        return _unpackedOwnership(_packedOwnershipOf(tokenId));
    }

    /**
     * @dev Returns the unpacked `TokenOwnership` struct at `index`.
     */
    function _ownershipAt(uint256 index) internal view virtual returns (TokenOwnership memory) {
        return _unpackedOwnership(_packedOwnerships[index]);
    }

    /**
     * @dev Initializes the ownership slot minted at `index` for efficiency purposes.
     */
    function _initializeOwnershipAt(uint256 index) internal virtual {
        if (_packedOwnerships[index] == 0) {
            _packedOwnerships[index] = _packedOwnershipOf(index);
        }
    }

    /**
     * Returns the packed ownership data of `tokenId`.
     */
    function _packedOwnershipOf(uint256 tokenId) private view returns (uint256) {
        uint256 curr = tokenId;

        unchecked {
            if (_startTokenId() <= curr)
                if (curr < _currentIndex) {
                    uint256 packed = _packedOwnerships[curr];
                    // If not burned.
                    if (packed & _BITMASK_BURNED == 0) {
                        // Invariant:
                        // There will always be an initialized ownership slot
                        // (i.e. `ownership.addr != address(0) && ownership.burned == false`)
                        // before an unintialized ownership slot
                        // (i.e. `ownership.addr == address(0) && ownership.burned == false`)
                        // Hence, `curr` will not underflow.
                        //
                        // We can directly compare the packed value.
                        // If the address is zero, packed will be zero.
                        while (packed == 0) {
                            packed = _packedOwnerships[--curr];
                        }
                        return packed;
                    }
                }
        }
        revert OwnerQueryForNonexistentToken();
    }

    /**
     * @dev Returns the unpacked `TokenOwnership` struct from `packed`.
     */
    function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) {
        ownership.addr = address(uint160(packed));
        ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP);
        ownership.burned = packed & _BITMASK_BURNED != 0;
        ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA);
    }

    /**
     * @dev Packs ownership data into a single uint256.
     */
    function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) {
        assembly {
            // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
            owner := and(owner, _BITMASK_ADDRESS)
            // `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`.
            result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags))
        }
    }

    /**
     * @dev Returns the `nextInitialized` flag set if `quantity` equals 1.
     */
    function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) {
        // For branchless setting of the `nextInitialized` flag.
        assembly {
            // `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`.
            result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1))
        }
    }

    // =============================================================
    //                      APPROVAL OPERATIONS
    // =============================================================

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

        if (_msgSenderERC721A() != owner)
            if (!isApprovedForAll(owner, _msgSenderERC721A())) {
                revert ApprovalCallerNotOwnerNorApproved();
            }

        _tokenApprovals[tokenId].value = to;
        emit Approval(owner, to, tokenId);
    }

    /**
     * @dev Returns the account approved for `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function getApproved(uint256 tokenId) public view virtual override returns (address) {
        if (!_exists(tokenId)) revert ApprovalQueryForNonexistentToken();

        return _tokenApprovals[tokenId].value;
    }

    /**
     * @dev Approve or remove `operator` as an operator for the caller.
     * Operators can call {transferFrom} or {safeTransferFrom}
     * for any token owned by the caller.
     *
     * Requirements:
     *
     * - The `operator` cannot be the caller.
     *
     * Emits an {ApprovalForAll} event.
     */
    function setApprovalForAll(address operator, bool approved) public virtual override {
        _operatorApprovals[_msgSenderERC721A()][operator] = approved;
        emit ApprovalForAll(_msgSenderERC721A(), operator, approved);
    }

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

    /**
     * @dev Returns whether `tokenId` exists.
     *
     * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
     *
     * Tokens start existing when they are minted. See {_mint}.
     */
    function _exists(uint256 tokenId) internal view virtual returns (bool) {
        return
            _startTokenId() <= tokenId &&
            tokenId < _currentIndex && // If within bounds,
            _packedOwnerships[tokenId] & _BITMASK_BURNED == 0; // and not burned.
    }

    /**
     * @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`.
     */
    function _isSenderApprovedOrOwner(
        address approvedAddress,
        address owner,
        address msgSender
    ) private pure returns (bool result) {
        assembly {
            // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
            owner := and(owner, _BITMASK_ADDRESS)
            // Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean.
            msgSender := and(msgSender, _BITMASK_ADDRESS)
            // `msgSender == owner || msgSender == approvedAddress`.
            result := or(eq(msgSender, owner), eq(msgSender, approvedAddress))
        }
    }

    /**
     * @dev Returns the storage slot and value for the approved address of `tokenId`.
     */
    function _getApprovedSlotAndAddress(uint256 tokenId)
        private
        view
        returns (uint256 approvedAddressSlot, address approvedAddress)
    {
        TokenApprovalRef storage tokenApproval = _tokenApprovals[tokenId];
        // The following is equivalent to `approvedAddress = _tokenApprovals[tokenId].value`.
        assembly {
            approvedAddressSlot := tokenApproval.slot
            approvedAddress := sload(approvedAddressSlot)
        }
    }

    // =============================================================
    //                      TRANSFER OPERATIONS
    // =============================================================

    /**
     * @dev Transfers `tokenId` from `from` to `to`.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must be owned by `from`.
     * - If the caller is not `from`, it must be approved to move this token
     * by either {approve} or {setApprovalForAll}.
     *
     * Emits a {Transfer} event.
     */
    function transferFrom(
        address from,
        address to,
        uint256 tokenId
    ) public payable virtual override {
        uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);

        if (address(uint160(prevOwnershipPacked)) != from) revert TransferFromIncorrectOwner();

        (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);

        // The nested ifs save around 20+ gas over a compound boolean condition.
        if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
            if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved();

        if (to == address(0)) revert TransferToZeroAddress();

        _beforeTokenTransfers(from, to, tokenId, 1);

        // Clear approvals from the previous owner.
        assembly {
            if approvedAddress {
                // This is equivalent to `delete _tokenApprovals[tokenId]`.
                sstore(approvedAddressSlot, 0)
            }
        }

        // Underflow of the sender's balance is impossible because we check for
        // ownership above and the recipient's balance can't realistically overflow.
        // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
        unchecked {
            // We can directly increment and decrement the balances.
            --_packedAddressData[from]; // Updates: `balance -= 1`.
            ++_packedAddressData[to]; // Updates: `balance += 1`.

            // Updates:
            // - `address` to the next owner.
            // - `startTimestamp` to the timestamp of transfering.
            // - `burned` to `false`.
            // - `nextInitialized` to `true`.
            _packedOwnerships[tokenId] = _packOwnershipData(
                to,
                _BITMASK_NEXT_INITIALIZED | _nextExtraData(from, to, prevOwnershipPacked)
            );

            // If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
            if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
                uint256 nextTokenId = tokenId + 1;
                // If the next slot's address is zero and not burned (i.e. packed value is zero).
                if (_packedOwnerships[nextTokenId] == 0) {
                    // If the next slot is within bounds.
                    if (nextTokenId != _currentIndex) {
                        // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
                        _packedOwnerships[nextTokenId] = prevOwnershipPacked;
                    }
                }
            }
        }

        emit Transfer(from, to, tokenId);
        _afterTokenTransfers(from, to, tokenId, 1);
    }

    /**
     * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId
    ) public payable virtual override {
        safeTransferFrom(from, to, tokenId, '');
    }

    /**
     * @dev Safely transfers `tokenId` token from `from` to `to`.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must exist and be owned by `from`.
     * - If the caller is not `from`, it must be approved to move this token
     * by either {approve} or {setApprovalForAll}.
     * - If `to` refers to a smart contract, it must implement
     * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
     *
     * Emits a {Transfer} event.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId,
        bytes memory _data
    ) public payable virtual override {
        transferFrom(from, to, tokenId);
        if (to.code.length != 0)
            if (!_checkContractOnERC721Received(from, to, tokenId, _data)) {
                revert TransferToNonERC721ReceiverImplementer();
            }
    }

    /**
     * @dev Hook that is called before a set of serially-ordered token IDs
     * are about to be transferred. This includes minting.
     * And also called before burning one token.
     *
     * `startTokenId` - the first token ID to be transferred.
     * `quantity` - the amount to be transferred.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
     * transferred to `to`.
     * - When `from` is zero, `tokenId` will be minted for `to`.
     * - When `to` is zero, `tokenId` will be burned by `from`.
     * - `from` and `to` are never both zero.
     */
    function _beforeTokenTransfers(
        address from,
        address to,
        uint256 startTokenId,
        uint256 quantity
    ) internal virtual {}

    /**
     * @dev Hook that is called after a set of serially-ordered token IDs
     * have been transferred. This includes minting.
     * And also called after one token has been burned.
     *
     * `startTokenId` - the first token ID to be transferred.
     * `quantity` - the amount to be transferred.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, `from`'s `tokenId` has been
     * transferred to `to`.
     * - When `from` is zero, `tokenId` has been minted for `to`.
     * - When `to` is zero, `tokenId` has been burned by `from`.
     * - `from` and `to` are never both zero.
     */
    function _afterTokenTransfers(
        address from,
        address to,
        uint256 startTokenId,
        uint256 quantity
    ) internal virtual {}

    /**
     * @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract.
     *
     * `from` - Previous owner of the given token ID.
     * `to` - Target address that will receive the token.
     * `tokenId` - Token ID to be transferred.
     * `_data` - Optional data to send along with the call.
     *
     * Returns whether the call correctly returned the expected magic value.
     */
    function _checkContractOnERC721Received(
        address from,
        address to,
        uint256 tokenId,
        bytes memory _data
    ) private returns (bool) {
        try ERC721A__IERC721Receiver(to).onERC721Received(_msgSenderERC721A(), from, tokenId, _data) returns (
            bytes4 retval
        ) {
            return retval == ERC721A__IERC721Receiver(to).onERC721Received.selector;
        } catch (bytes memory reason) {
            if (reason.length == 0) {
                revert TransferToNonERC721ReceiverImplementer();
            } else {
                assembly {
                    revert(add(32, reason), mload(reason))
                }
            }
        }
    }

    // =============================================================
    //                        MINT OPERATIONS
    // =============================================================

    /**
     * @dev Mints `quantity` tokens and transfers them to `to`.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - `quantity` must be greater than 0.
     *
     * Emits a {Transfer} event for each mint.
     */
    function _mint(address to, uint256 quantity) internal virtual {
        uint256 startTokenId = _currentIndex;
        if (quantity == 0) revert MintZeroQuantity();

        _beforeTokenTransfers(address(0), to, startTokenId, quantity);

        // Overflows are incredibly unrealistic.
        // `balance` and `numberMinted` have a maximum limit of 2**64.
        // `tokenId` has a maximum limit of 2**256.
        unchecked {
            // Updates:
            // - `balance += quantity`.
            // - `numberMinted += quantity`.
            //
            // We can directly add to the `balance` and `numberMinted`.
            _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);

            // Updates:
            // - `address` to the owner.
            // - `startTimestamp` to the timestamp of minting.
            // - `burned` to `false`.
            // - `nextInitialized` to `quantity == 1`.
            _packedOwnerships[startTokenId] = _packOwnershipData(
                to,
                _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
            );

            uint256 toMasked;
            uint256 end = startTokenId + quantity;

            // Use assembly to loop and emit the `Transfer` event for gas savings.
            // The duplicated `log4` removes an extra check and reduces stack juggling.
            // The assembly, together with the surrounding Solidity code, have been
            // delicately arranged to nudge the compiler into producing optimized opcodes.
            assembly {
                // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
                toMasked := and(to, _BITMASK_ADDRESS)
                // Emit the `Transfer` event.
                log4(
                    0, // Start of data (0, since no data).
                    0, // End of data (0, since no data).
                    _TRANSFER_EVENT_SIGNATURE, // Signature.
                    0, // `address(0)`.
                    toMasked, // `to`.
                    startTokenId // `tokenId`.
                )

                // The `iszero(eq(,))` check ensures that large values of `quantity`
                // that overflows uint256 will make the loop run out of gas.
                // The compiler will optimize the `iszero` away for performance.
                for {
                    let tokenId := add(startTokenId, 1)
                } iszero(eq(tokenId, end)) {
                    tokenId := add(tokenId, 1)
                } {
                    // Emit the `Transfer` event. Similar to above.
                    log4(0, 0, _TRANSFER_EVENT_SIGNATURE, 0, toMasked, tokenId)
                }
            }
            if (toMasked == 0) revert MintToZeroAddress();

            _currentIndex = end;
        }
        _afterTokenTransfers(address(0), to, startTokenId, quantity);
    }

    /**
     * @dev Mints `quantity` tokens and transfers them to `to`.
     *
     * This function is intended for efficient minting only during contract creation.
     *
     * It emits only one {ConsecutiveTransfer} as defined in
     * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309),
     * instead of a sequence of {Transfer} event(s).
     *
     * Calling this function outside of contract creation WILL make your contract
     * non-compliant with the ERC721 standard.
     * For full ERC721 compliance, substituting ERC721 {Transfer} event(s) with the ERC2309
     * {ConsecutiveTransfer} event is only permissible during contract creation.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - `quantity` must be greater than 0.
     *
     * Emits a {ConsecutiveTransfer} event.
     */
    function _mintERC2309(address to, uint256 quantity) internal virtual {
        uint256 startTokenId = _currentIndex;
        if (to == address(0)) revert MintToZeroAddress();
        if (quantity == 0) revert MintZeroQuantity();
        if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) revert MintERC2309QuantityExceedsLimit();

        _beforeTokenTransfers(address(0), to, startTokenId, quantity);

        // Overflows are unrealistic due to the above check for `quantity` to be below the limit.
        unchecked {
            // Updates:
            // - `balance += quantity`.
            // - `numberMinted += quantity`.
            //
            // We can directly add to the `balance` and `numberMinted`.
            _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);

            // Updates:
            // - `address` to the owner.
            // - `startTimestamp` to the timestamp of minting.
            // - `burned` to `false`.
            // - `nextInitialized` to `quantity == 1`.
            _packedOwnerships[startTokenId] = _packOwnershipData(
                to,
                _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
            );

            emit ConsecutiveTransfer(startTokenId, startTokenId + quantity - 1, address(0), to);

            _currentIndex = startTokenId + quantity;
        }
        _afterTokenTransfers(address(0), to, startTokenId, quantity);
    }

    /**
     * @dev Safely mints `quantity` tokens and transfers them to `to`.
     *
     * Requirements:
     *
     * - If `to` refers to a smart contract, it must implement
     * {IERC721Receiver-onERC721Received}, which is called for each safe transfer.
     * - `quantity` must be greater than 0.
     *
     * See {_mint}.
     *
     * Emits a {Transfer} event for each mint.
     */
    function _safeMint(
        address to,
        uint256 quantity,
        bytes memory _data
    ) internal virtual {
        _mint(to, quantity);

        unchecked {
            if (to.code.length != 0) {
                uint256 end = _currentIndex;
                uint256 index = end - quantity;
                do {
                    if (!_checkContractOnERC721Received(address(0), to, index++, _data)) {
                        revert TransferToNonERC721ReceiverImplementer();
                    }
                } while (index < end);
                // Reentrancy protection.
                if (_currentIndex != end) revert();
            }
        }
    }

    /**
     * @dev Equivalent to `_safeMint(to, quantity, '')`.
     */
    function _safeMint(address to, uint256 quantity) internal virtual {
        _safeMint(to, quantity, '');
    }

    // =============================================================
    //                        BURN OPERATIONS
    // =============================================================

    /**
     * @dev Equivalent to `_burn(tokenId, false)`.
     */
    function _burn(uint256 tokenId) internal virtual {
        _burn(tokenId, false);
    }

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

        address from = address(uint160(prevOwnershipPacked));

        (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);

        if (approvalCheck) {
            // The nested ifs save around 20+ gas over a compound boolean condition.
            if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
                if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved();
        }

        _beforeTokenTransfers(from, address(0), tokenId, 1);

        // Clear approvals from the previous owner.
        assembly {
            if approvedAddress {
                // This is equivalent to `delete _tokenApprovals[tokenId]`.
                sstore(approvedAddressSlot, 0)
            }
        }

        // Underflow of the sender's balance is impossible because we check for
        // ownership above and the recipient's balance can't realistically overflow.
        // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
        unchecked {
            // Updates:
            // - `balance -= 1`.
            // - `numberBurned += 1`.
            //
            // We can directly decrement the balance, and increment the number burned.
            // This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`.
            _packedAddressData[from] += (1 << _BITPOS_NUMBER_BURNED) - 1;

            // Updates:
            // - `address` to the last owner.
            // - `startTimestamp` to the timestamp of burning.
            // - `burned` to `true`.
            // - `nextInitialized` to `true`.
            _packedOwnerships[tokenId] = _packOwnershipData(
                from,
                (_BITMASK_BURNED | _BITMASK_NEXT_INITIALIZED) | _nextExtraData(from, address(0), prevOwnershipPacked)
            );

            // If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
            if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
                uint256 nextTokenId = tokenId + 1;
                // If the next slot's address is zero and not burned (i.e. packed value is zero).
                if (_packedOwnerships[nextTokenId] == 0) {
                    // If the next slot is within bounds.
                    if (nextTokenId != _currentIndex) {
                        // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
                        _packedOwnerships[nextTokenId] = prevOwnershipPacked;
                    }
                }
            }
        }

        emit Transfer(from, address(0), tokenId);
        _afterTokenTransfers(from, address(0), tokenId, 1);

        // Overflow not possible, as _burnCounter cannot be exceed _currentIndex times.
        unchecked {
            _burnCounter++;
        }
    }

    // =============================================================
    //                     EXTRA DATA OPERATIONS
    // =============================================================

    /**
     * @dev Directly sets the extra data for the ownership data `index`.
     */
    function _setExtraDataAt(uint256 index, uint24 extraData) internal virtual {
        uint256 packed = _packedOwnerships[index];
        if (packed == 0) revert OwnershipNotInitializedForExtraData();
        uint256 extraDataCasted;
        // Cast `extraData` with assembly to avoid redundant masking.
        assembly {
            extraDataCasted := extraData
        }
        packed = (packed & _BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << _BITPOS_EXTRA_DATA);
        _packedOwnerships[index] = packed;
    }

    /**
     * @dev Called during each token transfer to set the 24bit `extraData` field.
     * Intended to be overridden by the cosumer contract.
     *
     * `previousExtraData` - the value of `extraData` before transfer.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
     * transferred to `to`.
     * - When `from` is zero, `tokenId` will be minted for `to`.
     * - When `to` is zero, `tokenId` will be burned by `from`.
     * - `from` and `to` are never both zero.
     */
    function _extraData(
        address from,
        address to,
        uint24 previousExtraData
    ) internal view virtual returns (uint24) {}

    /**
     * @dev Returns the next extra data for the packed ownership data.
     * The returned result is shifted into position.
     */
    function _nextExtraData(
        address from,
        address to,
        uint256 prevOwnershipPacked
    ) private view returns (uint256) {
        uint24 extraData = uint24(prevOwnershipPacked >> _BITPOS_EXTRA_DATA);
        return uint256(_extraData(from, to, extraData)) << _BITPOS_EXTRA_DATA;
    }

    // =============================================================
    //                       OTHER OPERATIONS
    // =============================================================

    /**
     * @dev Returns the message sender (defaults to `msg.sender`).
     *
     * If you are writing GSN compatible contracts, you need to override this function.
     */
    function _msgSenderERC721A() internal view virtual returns (address) {
        return msg.sender;
    }

    /**
     * @dev Converts a uint256 to its ASCII string decimal representation.
     */
    function _toString(uint256 value) internal pure virtual returns (string memory str) {
        assembly {
            // The maximum value of a uint256 contains 78 digits (1 byte per digit), but
            // we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned.
            // We will need 1 word for the trailing zeros padding, 1 word for the length,
            // and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0.
            let m := add(mload(0x40), 0xa0)
            // Update the free memory pointer to allocate.
            mstore(0x40, m)
            // Assign the `str` to the end.
            str := sub(m, 0x20)
            // Zeroize the slot after the string.
            mstore(str, 0)

            // Cache the end of the memory to calculate the length later.
            let end := str

            // We write the string from rightmost digit to leftmost digit.
            // The following is essentially a do-while loop that also handles the zero case.
            // prettier-ignore
            for { let temp := value } 1 {} {
                str := sub(str, 1)
                // Write the character to the pointer.
                // The ASCII index of the '0' character is 48.
                mstore8(str, add(48, mod(temp, 10)))
                // Keep dividing `temp` until zero.
                temp := div(temp, 10)
                // prettier-ignore
                if iszero(temp) { break }
            }

            let length := sub(end, str)
            // Move the pointer 32 bytes leftwards to make room for the length.
            str := sub(str, 0x20)
            // Store the length.
            mstore(str, length)
        }
    }
}

// File: contracts/Saints.sol


pragma solidity ^0.8.4;



contract Saints is ERC721A, Ownable {
    uint256 MAX_MINTS = 10;
    uint256 MAX_SUPPLY = 12000;
    uint256 public mintPrice = 0.8 ether;
    bool public paused = false;

    string public baseURI = "ipfs://QmYMVLm5yspZNL8AhSbSp3owtjZdWWsjqhbjXc9FshKDcw/";

    constructor() ERC721A("Saints", "SAT") {}

    function mint(uint256 quantity) external payable {
        // _safeMint's second argument now takes in a quantity, not a tokenId.
        require(!paused);
        require(totalSupply() + quantity <= MAX_SUPPLY, "Not enough tokens left");
        if (msg.sender != owner()) {
            require(quantity + _numberMinted(msg.sender) <= MAX_MINTS, "Exceeded the limit");
            require(msg.value >= (mintPrice * quantity), "Not enough ether sent");
        }
        
        _safeMint(msg.sender, quantity);
    }

    function ownerMint(address to, uint256 quantity) external onlyOwner {
        // _safeMint's second argument now takes in a quantity, not a tokenId.
        
        require(totalSupply() + quantity <= MAX_SUPPLY, "Not enough tokens left");
        
        _safeMint(to, quantity);
    }

    function withdraw() external payable onlyOwner {
        payable(owner()).transfer(address(this).balance);
    }

    function _baseURI() internal view override returns (string memory) {
        return baseURI;
    }

    function _startTokenId() internal pure override returns (uint256) {
        return 1;
    }

    function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
        if (!_exists(tokenId)) revert URIQueryForNonexistentToken();

        string memory currentBaseURI = _baseURI();
        return bytes(baseURI).length != 0 ? string(abi.encodePacked(currentBaseURI, _toString(tokenId), ".json")) : '';
    }

    function setMintPrice(uint256 _mintPrice) public onlyOwner {
        mintPrice = _mintPrice;
    }

    function setBaseURI(string memory _newBaseURI) public onlyOwner {
        baseURI = _newBaseURI;
    }
    
    function pause(bool _state) public onlyOwner {
        paused = _state;
    }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToNonERC721ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"toTokenId","type":"uint256"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"}],"name":"ConsecutiveTransfer","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":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"mint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"mintPrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"ownerMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bool","name":"_state","type":"bool"}],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","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":"payable","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":"payable","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":"_newBaseURI","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_mintPrice","type":"uint256"}],"name":"setMintPrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"payable","type":"function"}]

600a6009819055612ee09055670b1a2bc2ec500000600b55600c805460ff1916905560e060405260366080818152906200195860a039600d90620000449082620001be565b503480156200005257600080fd5b50604051806040016040528060068152602001655361696e747360d01b8152506040518060400160405280600381526020016214d05560ea1b81525081600290816200009f9190620001be565b506003620000ae8282620001be565b5050600160005550620000c133620000c7565b6200028a565b600880546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b634e487b7160e01b600052604160045260246000fd5b600181811c908216806200014457607f821691505b6020821081036200016557634e487b7160e01b600052602260045260246000fd5b50919050565b601f821115620001b957600081815260208120601f850160051c81016020861015620001945750805b601f850160051c820191505b81811015620001b557828155600101620001a0565b5050505b505050565b81516001600160401b03811115620001da57620001da62000119565b620001f281620001eb84546200012f565b846200016b565b602080601f8311600181146200022a5760008415620002115750858301515b600019600386901b1c1916600185901b178555620001b5565b600085815260208120601f198616915b828110156200025b578886015182559484019460019091019084016200023a565b50858210156200027a5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6116be806200029a6000396000f3fe6080604052600436106101815760003560e01c80636817c76c116100d1578063a0712d681161008a578063c87b56dd11610064578063c87b56dd146103f2578063e985e9c514610412578063f2fde38b14610432578063f4a0a5281461045257600080fd5b8063a0712d68146103ac578063a22cb465146103bf578063b88d4fde146103df57600080fd5b80636817c76c146103195780636c0360eb1461032f57806370a0823114610344578063715018a6146103645780638da5cb5b1461037957806395d89b411461039757600080fd5b806323b872dd1161013e578063484b973c11610118578063484b973c1461029f57806355f804b3146102bf5780635c975abb146102df5780636352211e146102f957600080fd5b806323b872dd146102715780633ccfd60b1461028457806342842e0e1461028c57600080fd5b806301ffc9a71461018657806302329a29146101bb57806306fdde03146101dd578063081812fc146101ff578063095ea7b31461023757806318160ddd1461024a575b600080fd5b34801561019257600080fd5b506101a66101a1366004611160565b610472565b60405190151581526020015b60405180910390f35b3480156101c757600080fd5b506101db6101d6366004611192565b6104c4565b005b3480156101e957600080fd5b506101f26104df565b6040516101b291906111fd565b34801561020b57600080fd5b5061021f61021a366004611210565b610571565b6040516001600160a01b0390911681526020016101b2565b6101db610245366004611240565b6105b5565b34801561025657600080fd5b5060015460005403600019015b6040519081526020016101b2565b6101db61027f36600461126a565b610655565b6101db6107ee565b6101db61029a36600461126a565b610832565b3480156102ab57600080fd5b506101db6102ba366004611240565b610852565b3480156102cb57600080fd5b506101db6102da366004611332565b6108cf565b3480156102eb57600080fd5b50600c546101a69060ff1681565b34801561030557600080fd5b5061021f610314366004611210565b6108e3565b34801561032557600080fd5b50610263600b5481565b34801561033b57600080fd5b506101f26108ee565b34801561035057600080fd5b5061026361035f36600461137b565b61097c565b34801561037057600080fd5b506101db6109cb565b34801561038557600080fd5b506008546001600160a01b031661021f565b3480156103a357600080fd5b506101f26109df565b6101db6103ba366004611210565b6109ee565b3480156103cb57600080fd5b506101db6103da366004611396565b610b3e565b6101db6103ed3660046113c9565b610baa565b3480156103fe57600080fd5b506101f261040d366004611210565b610bf4565b34801561041e57600080fd5b506101a661042d366004611445565b610c85565b34801561043e57600080fd5b506101db61044d36600461137b565b610cb3565b34801561045e57600080fd5b506101db61046d366004611210565b610d29565b60006301ffc9a760e01b6001600160e01b0319831614806104a357506380ac58cd60e01b6001600160e01b03198316145b806104be5750635b5e139f60e01b6001600160e01b03198316145b92915050565b6104cc610d36565b600c805460ff1916911515919091179055565b6060600280546104ee9061146f565b80601f016020809104026020016040519081016040528092919081815260200182805461051a9061146f565b80156105675780601f1061053c57610100808354040283529160200191610567565b820191906000526020600020905b81548152906001019060200180831161054a57829003601f168201915b5050505050905090565b600061057c82610d90565b610599576040516333d1c03960e21b815260040160405180910390fd5b506000908152600660205260409020546001600160a01b031690565b60006105c0826108e3565b9050336001600160a01b038216146105f9576105dc8133610c85565b6105f9576040516367d9dca160e11b815260040160405180910390fd5b60008281526006602052604080822080546001600160a01b0319166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b600061066082610dc5565b9050836001600160a01b0316816001600160a01b0316146106935760405162a1148160e81b815260040160405180910390fd5b60008281526006602052604090208054338082146001600160a01b038816909114176106e0576106c38633610c85565b6106e057604051632ce44b5f60e11b815260040160405180910390fd5b6001600160a01b03851661070757604051633a954ecd60e21b815260040160405180910390fd5b801561071257600082555b6001600160a01b038681166000908152600560205260408082208054600019019055918716808252919020805460010190554260a01b17600160e11b17600085815260046020526040812091909155600160e11b841690036107a4576001840160008181526004602052604081205490036107a25760005481146107a25760008181526004602052604090208490555b505b83856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a45b505050505050565b6107f6610d36565b6008546040516001600160a01b03909116904780156108fc02916000818181858888f1935050505015801561082f573d6000803e3d6000fd5b50565b61084d83838360405180602001604052806000815250610baa565b505050565b61085a610d36565b600a54600154600054839190036000190161087591906114bf565b11156108c15760405162461bcd60e51b8152602060048201526016602482015275139bdd08195b9bdd59da081d1bdad95b9cc81b19599d60521b60448201526064015b60405180910390fd5b6108cb8282610e34565b5050565b6108d7610d36565b600d6108cb8282611518565b60006104be82610dc5565b600d80546108fb9061146f565b80601f01602080910402602001604051908101604052809291908181526020018280546109279061146f565b80156109745780601f1061094957610100808354040283529160200191610974565b820191906000526020600020905b81548152906001019060200180831161095757829003601f168201915b505050505081565b60006001600160a01b0382166109a5576040516323d3ad8160e21b815260040160405180910390fd5b506001600160a01b031660009081526005602052604090205467ffffffffffffffff1690565b6109d3610d36565b6109dd6000610e4e565b565b6060600380546104ee9061146f565b600c5460ff16156109fe57600080fd5b600a546001546000548391900360001901610a1991906114bf565b1115610a605760405162461bcd60e51b8152602060048201526016602482015275139bdd08195b9bdd59da081d1bdad95b9cc81b19599d60521b60448201526064016108b8565b6008546001600160a01b03163314610b3457600954336000908152600560205260409081902054610a9c911c67ffffffffffffffff16836114bf565b1115610adf5760405162461bcd60e51b8152602060048201526012602482015271115e18d959591959081d1a19481b1a5b5a5d60721b60448201526064016108b8565b80600b54610aed91906115d8565b341015610b345760405162461bcd60e51b8152602060048201526015602482015274139bdd08195b9bdd59da08195d1a195c881cd95b9d605a1b60448201526064016108b8565b61082f3382610e34565b3360008181526007602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b610bb5848484610655565b6001600160a01b0383163b15610bee57610bd184848484610ea0565b610bee576040516368d2bf6b60e11b815260040160405180910390fd5b50505050565b6060610bff82610d90565b610c1c57604051630a14c4b560e41b815260040160405180910390fd5b6000610c26610f8c565b9050600d8054610c359061146f565b9050600003610c535760405180602001604052806000815250610c7e565b80610c5d84610f9b565b604051602001610c6e9291906115ef565b6040516020818303038152906040525b9392505050565b6001600160a01b03918216600090815260076020908152604080832093909416825291909152205460ff1690565b610cbb610d36565b6001600160a01b038116610d205760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016108b8565b61082f81610e4e565b610d31610d36565b600b55565b6008546001600160a01b031633146109dd5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016108b8565b600081600111158015610da4575060005482105b80156104be575050600090815260046020526040902054600160e01b161590565b60008180600111610e1b57600054811015610e1b5760008181526004602052604081205490600160e01b82169003610e19575b80600003610c7e575060001901600081815260046020526040902054610df8565b505b604051636f96cda160e11b815260040160405180910390fd5b6108cb828260405180602001604052806000815250610fdf565b600880546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b604051630a85bd0160e11b81526000906001600160a01b0385169063150b7a0290610ed590339089908890889060040161162e565b6020604051808303816000875af1925050508015610f10575060408051601f3d908101601f19168201909252610f0d9181019061166b565b60015b610f6e573d808015610f3e576040519150601f19603f3d011682016040523d82523d6000602084013e610f43565b606091505b508051600003610f66576040516368d2bf6b60e11b815260040160405180910390fd5b805181602001fd5b6001600160e01b031916630a85bd0160e11b1490505b949350505050565b6060600d80546104ee9061146f565b606060a06040510180604052602081039150506000815280825b600183039250600a81066030018353600a900480610fb55750819003601f19909101908152919050565b610fe9838361104c565b6001600160a01b0383163b1561084d576000548281035b6110136000868380600101945086610ea0565b611030576040516368d2bf6b60e11b815260040160405180910390fd5b81811061100057816000541461104557600080fd5b5050505050565b60008054908290036110715760405163b562e8dd60e01b815260040160405180910390fd5b6001600160a01b03831660008181526005602090815260408083208054680100000000000000018802019055848352600490915281206001851460e11b4260a01b178317905582840190839083907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8180a4600183015b81811461112057808360007fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef600080a46001016110e8565b508160000361114157604051622e076360e81b815260040160405180910390fd5b60005550505050565b6001600160e01b03198116811461082f57600080fd5b60006020828403121561117257600080fd5b8135610c7e8161114a565b8035801515811461118d57600080fd5b919050565b6000602082840312156111a457600080fd5b610c7e8261117d565b60005b838110156111c85781810151838201526020016111b0565b50506000910152565b600081518084526111e98160208601602086016111ad565b601f01601f19169290920160200192915050565b602081526000610c7e60208301846111d1565b60006020828403121561122257600080fd5b5035919050565b80356001600160a01b038116811461118d57600080fd5b6000806040838503121561125357600080fd5b61125c83611229565b946020939093013593505050565b60008060006060848603121561127f57600080fd5b61128884611229565b925061129660208501611229565b9150604084013590509250925092565b634e487b7160e01b600052604160045260246000fd5b600067ffffffffffffffff808411156112d7576112d76112a6565b604051601f8501601f19908116603f011681019082821181831017156112ff576112ff6112a6565b8160405280935085815286868601111561131857600080fd5b858560208301376000602087830101525050509392505050565b60006020828403121561134457600080fd5b813567ffffffffffffffff81111561135b57600080fd5b8201601f8101841361136c57600080fd5b610f84848235602084016112bc565b60006020828403121561138d57600080fd5b610c7e82611229565b600080604083850312156113a957600080fd5b6113b283611229565b91506113c06020840161117d565b90509250929050565b600080600080608085870312156113df57600080fd5b6113e885611229565b93506113f660208601611229565b925060408501359150606085013567ffffffffffffffff81111561141957600080fd5b8501601f8101871361142a57600080fd5b611439878235602084016112bc565b91505092959194509250565b6000806040838503121561145857600080fd5b61146183611229565b91506113c060208401611229565b600181811c9082168061148357607f821691505b6020821081036114a357634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b808201808211156104be576104be6114a9565b601f82111561084d57600081815260208120601f850160051c810160208610156114f95750805b601f850160051c820191505b818110156107e657828155600101611505565b815167ffffffffffffffff811115611532576115326112a6565b61154681611540845461146f565b846114d2565b602080601f83116001811461157b57600084156115635750858301515b600019600386901b1c1916600185901b1785556107e6565b600085815260208120601f198616915b828110156115aa5788860151825594840194600190910190840161158b565b50858210156115c85787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b80820281158282048414176104be576104be6114a9565b600083516116018184602088016111ad565b8351908301906116158183602088016111ad565b64173539b7b760d91b9101908152600501949350505050565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090611661908301846111d1565b9695505050505050565b60006020828403121561167d57600080fd5b8151610c7e8161114a56fea26469706673582212201795cd672723c9c43e92fdbae6ff5bb05160084ee1c833dcd3c7b8d4f0b42ebc64736f6c63430008120033697066733a2f2f516d594d564c6d357973705a4e4c38416853625370336f77746a5a645757736a7168626a5863394673684b4463772f

0x6080604052600436106101815760003560e01c80636817c76c116100d1578063a0712d681161008a578063c87b56dd11610064578063c87b56dd146103f2578063e985e9c514610412578063f2fde38b14610432578063f4a0a5281461045257600080fd5b8063a0712d68146103ac578063a22cb465146103bf578063b88d4fde146103df57600080fd5b80636817c76c146103195780636c0360eb1461032f57806370a0823114610344578063715018a6146103645780638da5cb5b1461037957806395d89b411461039757600080fd5b806323b872dd1161013e578063484b973c11610118578063484b973c1461029f57806355f804b3146102bf5780635c975abb146102df5780636352211e146102f957600080fd5b806323b872dd146102715780633ccfd60b1461028457806342842e0e1461028c57600080fd5b806301ffc9a71461018657806302329a29146101bb57806306fdde03146101dd578063081812fc146101ff578063095ea7b31461023757806318160ddd1461024a575b600080fd5b34801561019257600080fd5b506101a66101a1366004611160565b610472565b60405190151581526020015b60405180910390f35b3480156101c757600080fd5b506101db6101d6366004611192565b6104c4565b005b3480156101e957600080fd5b506101f26104df565b6040516101b291906111fd565b34801561020b57600080fd5b5061021f61021a366004611210565b610571565b6040516001600160a01b0390911681526020016101b2565b6101db610245366004611240565b6105b5565b34801561025657600080fd5b5060015460005403600019015b6040519081526020016101b2565b6101db61027f36600461126a565b610655565b6101db6107ee565b6101db61029a36600461126a565b610832565b3480156102ab57600080fd5b506101db6102ba366004611240565b610852565b3480156102cb57600080fd5b506101db6102da366004611332565b6108cf565b3480156102eb57600080fd5b50600c546101a69060ff1681565b34801561030557600080fd5b5061021f610314366004611210565b6108e3565b34801561032557600080fd5b50610263600b5481565b34801561033b57600080fd5b506101f26108ee565b34801561035057600080fd5b5061026361035f36600461137b565b61097c565b34801561037057600080fd5b506101db6109cb565b34801561038557600080fd5b506008546001600160a01b031661021f565b3480156103a357600080fd5b506101f26109df565b6101db6103ba366004611210565b6109ee565b3480156103cb57600080fd5b506101db6103da366004611396565b610b3e565b6101db6103ed3660046113c9565b610baa565b3480156103fe57600080fd5b506101f261040d366004611210565b610bf4565b34801561041e57600080fd5b506101a661042d366004611445565b610c85565b34801561043e57600080fd5b506101db61044d36600461137b565b610cb3565b34801561045e57600080fd5b506101db61046d366004611210565b610d29565b60006301ffc9a760e01b6001600160e01b0319831614806104a357506380ac58cd60e01b6001600160e01b03198316145b806104be5750635b5e139f60e01b6001600160e01b03198316145b92915050565b6104cc610d36565b600c805460ff1916911515919091179055565b6060600280546104ee9061146f565b80601f016020809104026020016040519081016040528092919081815260200182805461051a9061146f565b80156105675780601f1061053c57610100808354040283529160200191610567565b820191906000526020600020905b81548152906001019060200180831161054a57829003601f168201915b5050505050905090565b600061057c82610d90565b610599576040516333d1c03960e21b815260040160405180910390fd5b506000908152600660205260409020546001600160a01b031690565b60006105c0826108e3565b9050336001600160a01b038216146105f9576105dc8133610c85565b6105f9576040516367d9dca160e11b815260040160405180910390fd5b60008281526006602052604080822080546001600160a01b0319166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b600061066082610dc5565b9050836001600160a01b0316816001600160a01b0316146106935760405162a1148160e81b815260040160405180910390fd5b60008281526006602052604090208054338082146001600160a01b038816909114176106e0576106c38633610c85565b6106e057604051632ce44b5f60e11b815260040160405180910390fd5b6001600160a01b03851661070757604051633a954ecd60e21b815260040160405180910390fd5b801561071257600082555b6001600160a01b038681166000908152600560205260408082208054600019019055918716808252919020805460010190554260a01b17600160e11b17600085815260046020526040812091909155600160e11b841690036107a4576001840160008181526004602052604081205490036107a25760005481146107a25760008181526004602052604090208490555b505b83856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a45b505050505050565b6107f6610d36565b6008546040516001600160a01b03909116904780156108fc02916000818181858888f1935050505015801561082f573d6000803e3d6000fd5b50565b61084d83838360405180602001604052806000815250610baa565b505050565b61085a610d36565b600a54600154600054839190036000190161087591906114bf565b11156108c15760405162461bcd60e51b8152602060048201526016602482015275139bdd08195b9bdd59da081d1bdad95b9cc81b19599d60521b60448201526064015b60405180910390fd5b6108cb8282610e34565b5050565b6108d7610d36565b600d6108cb8282611518565b60006104be82610dc5565b600d80546108fb9061146f565b80601f01602080910402602001604051908101604052809291908181526020018280546109279061146f565b80156109745780601f1061094957610100808354040283529160200191610974565b820191906000526020600020905b81548152906001019060200180831161095757829003601f168201915b505050505081565b60006001600160a01b0382166109a5576040516323d3ad8160e21b815260040160405180910390fd5b506001600160a01b031660009081526005602052604090205467ffffffffffffffff1690565b6109d3610d36565b6109dd6000610e4e565b565b6060600380546104ee9061146f565b600c5460ff16156109fe57600080fd5b600a546001546000548391900360001901610a1991906114bf565b1115610a605760405162461bcd60e51b8152602060048201526016602482015275139bdd08195b9bdd59da081d1bdad95b9cc81b19599d60521b60448201526064016108b8565b6008546001600160a01b03163314610b3457600954336000908152600560205260409081902054610a9c911c67ffffffffffffffff16836114bf565b1115610adf5760405162461bcd60e51b8152602060048201526012602482015271115e18d959591959081d1a19481b1a5b5a5d60721b60448201526064016108b8565b80600b54610aed91906115d8565b341015610b345760405162461bcd60e51b8152602060048201526015602482015274139bdd08195b9bdd59da08195d1a195c881cd95b9d605a1b60448201526064016108b8565b61082f3382610e34565b3360008181526007602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b610bb5848484610655565b6001600160a01b0383163b15610bee57610bd184848484610ea0565b610bee576040516368d2bf6b60e11b815260040160405180910390fd5b50505050565b6060610bff82610d90565b610c1c57604051630a14c4b560e41b815260040160405180910390fd5b6000610c26610f8c565b9050600d8054610c359061146f565b9050600003610c535760405180602001604052806000815250610c7e565b80610c5d84610f9b565b604051602001610c6e9291906115ef565b6040516020818303038152906040525b9392505050565b6001600160a01b03918216600090815260076020908152604080832093909416825291909152205460ff1690565b610cbb610d36565b6001600160a01b038116610d205760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016108b8565b61082f81610e4e565b610d31610d36565b600b55565b6008546001600160a01b031633146109dd5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016108b8565b600081600111158015610da4575060005482105b80156104be575050600090815260046020526040902054600160e01b161590565b60008180600111610e1b57600054811015610e1b5760008181526004602052604081205490600160e01b82169003610e19575b80600003610c7e575060001901600081815260046020526040902054610df8565b505b604051636f96cda160e11b815260040160405180910390fd5b6108cb828260405180602001604052806000815250610fdf565b600880546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b604051630a85bd0160e11b81526000906001600160a01b0385169063150b7a0290610ed590339089908890889060040161162e565b6020604051808303816000875af1925050508015610f10575060408051601f3d908101601f19168201909252610f0d9181019061166b565b60015b610f6e573d808015610f3e576040519150601f19603f3d011682016040523d82523d6000602084013e610f43565b606091505b508051600003610f66576040516368d2bf6b60e11b815260040160405180910390fd5b805181602001fd5b6001600160e01b031916630a85bd0160e11b1490505b949350505050565b6060600d80546104ee9061146f565b606060a06040510180604052602081039150506000815280825b600183039250600a81066030018353600a900480610fb55750819003601f19909101908152919050565b610fe9838361104c565b6001600160a01b0383163b1561084d576000548281035b6110136000868380600101945086610ea0565b611030576040516368d2bf6b60e11b815260040160405180910390fd5b81811061100057816000541461104557600080fd5b5050505050565b60008054908290036110715760405163b562e8dd60e01b815260040160405180910390fd5b6001600160a01b03831660008181526005602090815260408083208054680100000000000000018802019055848352600490915281206001851460e11b4260a01b178317905582840190839083907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8180a4600183015b81811461112057808360007fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef600080a46001016110e8565b508160000361114157604051622e076360e81b815260040160405180910390fd5b60005550505050565b6001600160e01b03198116811461082f57600080fd5b60006020828403121561117257600080fd5b8135610c7e8161114a565b8035801515811461118d57600080fd5b919050565b6000602082840312156111a457600080fd5b610c7e8261117d565b60005b838110156111c85781810151838201526020016111b0565b50506000910152565b600081518084526111e98160208601602086016111ad565b601f01601f19169290920160200192915050565b602081526000610c7e60208301846111d1565b60006020828403121561122257600080fd5b5035919050565b80356001600160a01b038116811461118d57600080fd5b6000806040838503121561125357600080fd5b61125c83611229565b946020939093013593505050565b60008060006060848603121561127f57600080fd5b61128884611229565b925061129660208501611229565b9150604084013590509250925092565b634e487b7160e01b600052604160045260246000fd5b600067ffffffffffffffff808411156112d7576112d76112a6565b604051601f8501601f19908116603f011681019082821181831017156112ff576112ff6112a6565b8160405280935085815286868601111561131857600080fd5b858560208301376000602087830101525050509392505050565b60006020828403121561134457600080fd5b813567ffffffffffffffff81111561135b57600080fd5b8201601f8101841361136c57600080fd5b610f84848235602084016112bc565b60006020828403121561138d57600080fd5b610c7e82611229565b600080604083850312156113a957600080fd5b6113b283611229565b91506113c06020840161117d565b90509250929050565b600080600080608085870312156113df57600080fd5b6113e885611229565b93506113f660208601611229565b925060408501359150606085013567ffffffffffffffff81111561141957600080fd5b8501601f8101871361142a57600080fd5b611439878235602084016112bc565b91505092959194509250565b6000806040838503121561145857600080fd5b61146183611229565b91506113c060208401611229565b600181811c9082168061148357607f821691505b6020821081036114a357634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b808201808211156104be576104be6114a9565b601f82111561084d57600081815260208120601f850160051c810160208610156114f95750805b601f850160051c820191505b818110156107e657828155600101611505565b815167ffffffffffffffff811115611532576115326112a6565b61154681611540845461146f565b846114d2565b602080601f83116001811461157b57600084156115635750858301515b600019600386901b1c1916600185901b1785556107e6565b600085815260208120601f198616915b828110156115aa5788860151825594840194600190910190840161158b565b50858210156115c85787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b80820281158282048414176104be576104be6114a9565b600083516116018184602088016111ad565b8351908301906116158183602088016111ad565b64173539b7b760d91b9101908152600501949350505050565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090611661908301846111d1565b9695505050505050565b60006020828403121561167d57600080fd5b8151610c7e8161114a56fea26469706673582212201795cd672723c9c43e92fdbae6ff5bb05160084ee1c833dcd3c7b8d4f0b42ebc64736f6c63430008120033

55127:2145:0:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;22030:639;;;;;;;;;;-1:-1:-1;22030:639:0;;;;;:::i;:::-;;:::i;:::-;;;565:14:1;;558:22;540:41;;528:2;513:18;22030:639:0;;;;;;;;57190:79;;;;;;;;;;-1:-1:-1;57190:79:0;;;;;:::i;:::-;;:::i;:::-;;22932:100;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;29423:218::-;;;;;;;;;;-1:-1:-1;29423:218:0;;;;;:::i;:::-;;:::i;:::-;;;-1:-1:-1;;;;;2047:32:1;;;2029:51;;2017:2;2002:18;29423:218:0;1883:203:1;28856:408:0;;;;;;:::i;:::-;;:::i;18683:323::-;;;;;;;;;;-1:-1:-1;56600:1:0;18957:12;18744:7;18941:13;:28;-1:-1:-1;;18941:46:0;18683:323;;;2674:25:1;;;2662:2;2647:18;18683:323:0;2528:177:1;33062:2825:0;;;;;;:::i;:::-;;:::i;56286:114::-;;;:::i;35983:193::-;;;;;;:::i;:::-;;:::i;55984:294::-;;;;;;;;;;-1:-1:-1;55984:294:0;;;;;:::i;:::-;;:::i;57074:104::-;;;;;;;;;;-1:-1:-1;57074:104:0;;;;;:::i;:::-;;:::i;55275:26::-;;;;;;;;;;-1:-1:-1;55275:26:0;;;;;;;;24325:152;;;;;;;;;;-1:-1:-1;24325:152:0;;;;;:::i;:::-;;:::i;55232:36::-;;;;;;;;;;;;;;;;55310:80;;;;;;;;;;;;;:::i;19867:233::-;;;;;;;;;;-1:-1:-1;19867:233:0;;;;;:::i;:::-;;:::i;2809:103::-;;;;;;;;;;;;;:::i;2161:87::-;;;;;;;;;;-1:-1:-1;2234:6:0;;-1:-1:-1;;;;;2234:6:0;2161:87;;23108:104;;;;;;;;;;;;;:::i;55448:528::-;;;;;;:::i;:::-;;:::i;29981:234::-;;;;;;;;;;-1:-1:-1;29981:234:0;;;;;:::i;:::-;;:::i;36774:407::-;;;;;;:::i;:::-;;:::i;56617:341::-;;;;;;;;;;-1:-1:-1;56617:341:0;;;;;:::i;:::-;;:::i;30372:164::-;;;;;;;;;;-1:-1:-1;30372:164:0;;;;;:::i;:::-;;:::i;3067:201::-;;;;;;;;;;-1:-1:-1;3067:201:0;;;;;:::i;:::-;;:::i;56966:100::-;;;;;;;;;;-1:-1:-1;56966:100:0;;;;;:::i;:::-;;:::i;22030:639::-;22115:4;-1:-1:-1;;;;;;;;;22439:25:0;;;;:102;;-1:-1:-1;;;;;;;;;;22516:25:0;;;22439:102;:179;;;-1:-1:-1;;;;;;;;;;22593:25:0;;;22439:179;22419:199;22030:639;-1:-1:-1;;22030:639:0:o;57190:79::-;2047:13;:11;:13::i;:::-;57246:6:::1;:15:::0;;-1:-1:-1;;57246:15:0::1;::::0;::::1;;::::0;;;::::1;::::0;;57190:79::o;22932:100::-;22986:13;23019:5;23012:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;22932:100;:::o;29423:218::-;29499:7;29524:16;29532:7;29524;:16::i;:::-;29519:64;;29549:34;;-1:-1:-1;;;29549:34:0;;;;;;;;;;;29519:64;-1:-1:-1;29603:24:0;;;;:15;:24;;;;;:30;-1:-1:-1;;;;;29603:30:0;;29423:218::o;28856:408::-;28945:13;28961:16;28969:7;28961;:16::i;:::-;28945:32;-1:-1:-1;53189:10:0;-1:-1:-1;;;;;28994:28:0;;;28990:175;;29042:44;29059:5;53189:10;30372:164;:::i;29042:44::-;29037:128;;29114:35;;-1:-1:-1;;;29114:35:0;;;;;;;;;;;29037:128;29177:24;;;;:15;:24;;;;;;:35;;-1:-1:-1;;;;;;29177:35:0;-1:-1:-1;;;;;29177:35:0;;;;;;;;;29228:28;;29177:24;;29228:28;;;;;;;28934:330;28856:408;;:::o;33062:2825::-;33204:27;33234;33253:7;33234:18;:27::i;:::-;33204:57;;33319:4;-1:-1:-1;;;;;33278:45:0;33294:19;-1:-1:-1;;;;;33278:45:0;;33274:86;;33332:28;;-1:-1:-1;;;33332:28:0;;;;;;;;;;;33274:86;33374:27;32170:24;;;:15;:24;;;;;32398:26;;53189:10;31795:30;;;-1:-1:-1;;;;;31488:28:0;;31773:20;;;31770:56;33560:180;;33653:43;33670:4;53189:10;30372:164;:::i;33653:43::-;33648:92;;33705:35;;-1:-1:-1;;;33705:35:0;;;;;;;;;;;33648:92;-1:-1:-1;;;;;33757:16:0;;33753:52;;33782:23;;-1:-1:-1;;;33782:23:0;;;;;;;;;;;33753:52;33954:15;33951:160;;;34094:1;34073:19;34066:30;33951:160;-1:-1:-1;;;;;34491:24:0;;;;;;;:18;:24;;;;;;34489:26;;-1:-1:-1;;34489:26:0;;;34560:22;;;;;;;;;34558:24;;-1:-1:-1;34558:24:0;;;27714:11;27689:23;27685:41;27672:63;-1:-1:-1;;;27672:63:0;34853:26;;;;:17;:26;;;;;:175;;;;-1:-1:-1;;;35148:47:0;;:52;;35144:627;;35253:1;35243:11;;35221:19;35376:30;;;:17;:30;;;;;;:35;;35372:384;;35514:13;;35499:11;:28;35495:242;;35661:30;;;;:17;:30;;;;;:52;;;35495:242;35202:569;35144:627;35818:7;35814:2;-1:-1:-1;;;;;35799:27:0;35808:4;-1:-1:-1;;;;;35799:27:0;;;;;;;;;;;35837:42;33193:2694;;;33062:2825;;;:::o;56286:114::-;2047:13;:11;:13::i;:::-;2234:6;;56344:48:::1;::::0;-1:-1:-1;;;;;2234:6:0;;;;56370:21:::1;56344:48:::0;::::1;;;::::0;::::1;::::0;;;56370:21;2234:6;56344:48;::::1;;;;;;;;;;;;;::::0;::::1;;;;;;56286:114::o:0;35983:193::-;36129:39;36146:4;36152:2;36156:7;36129:39;;;;;;;;;;;;:16;:39::i;:::-;35983:193;;;:::o;55984:294::-;2047:13;:11;:13::i;:::-;56189:10:::1;::::0;56600:1;18957:12;18744:7;18941:13;56177:8;;18941:28;;-1:-1:-1;;18941:46:0;56161:24:::1;;;;:::i;:::-;:38;;56153:73;;;::::0;-1:-1:-1;;;56153:73:0;;6504:2:1;56153:73:0::1;::::0;::::1;6486:21:1::0;6543:2;6523:18;;;6516:30;-1:-1:-1;;;6562:18:1;;;6555:52;6624:18;;56153:73:0::1;;;;;;;;;56247:23;56257:2;56261:8;56247:9;:23::i;:::-;55984:294:::0;;:::o;57074:104::-;2047:13;:11;:13::i;:::-;57149:7:::1;:21;57159:11:::0;57149:7;:21:::1;:::i;24325:152::-:0;24397:7;24440:27;24459:7;24440:18;:27::i;55310:80::-;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::o;19867:233::-;19939:7;-1:-1:-1;;;;;19963:19:0;;19959:60;;19991:28;;-1:-1:-1;;;19991:28:0;;;;;;;;;;;19959:60;-1:-1:-1;;;;;;20037:25:0;;;;;:18;:25;;;;;;14026:13;20037:55;;19867:233::o;2809:103::-;2047:13;:11;:13::i;:::-;2874:30:::1;2901:1;2874:18;:30::i;:::-;2809:103::o:0;23108:104::-;23164:13;23197:7;23190:14;;;;;:::i;55448:528::-;55597:6;;;;55596:7;55588:16;;;;;;55651:10;;56600:1;18957:12;18744:7;18941:13;55639:8;;18941:28;;-1:-1:-1;;18941:46:0;55623:24;;;;:::i;:::-;:38;;55615:73;;;;-1:-1:-1;;;55615:73:0;;6504:2:1;55615:73:0;;;6486:21:1;6543:2;6523:18;;;6516:30;-1:-1:-1;;;6562:18:1;;;6555:52;6624:18;;55615:73:0;6302:346:1;55615:73:0;2234:6;;-1:-1:-1;;;;;2234:6:0;55703:10;:21;55699:218;;55789:9;;55774:10;20243:7;20271:25;;;:18;:25;;14164:2;20271:25;;;;;55749:36;;20271:50;14026:13;20270:82;55749:8;:36;:::i;:::-;:49;;55741:80;;;;-1:-1:-1;;;55741:80:0;;9059:2:1;55741:80:0;;;9041:21:1;9098:2;9078:18;;;9071:30;-1:-1:-1;;;9117:18:1;;;9110:48;9175:18;;55741:80:0;8857:342:1;55741:80:0;55870:8;55858:9;;:20;;;;:::i;:::-;55844:9;:35;;55836:69;;;;-1:-1:-1;;;55836:69:0;;9579:2:1;55836:69:0;;;9561:21:1;9618:2;9598:18;;;9591:30;-1:-1:-1;;;9637:18:1;;;9630:51;9698:18;;55836:69:0;9377:345:1;55836:69:0;55937:31;55947:10;55959:8;55937:9;:31::i;29981:234::-;53189:10;30076:39;;;;:18;:39;;;;;;;;-1:-1:-1;;;;;30076:49:0;;;;;;;;;;;;:60;;-1:-1:-1;;30076:60:0;;;;;;;;;;30152:55;;540:41:1;;;30076:49:0;;53189:10;30152:55;;513:18:1;30152:55:0;;;;;;;29981:234;;:::o;36774:407::-;36949:31;36962:4;36968:2;36972:7;36949:12;:31::i;:::-;-1:-1:-1;;;;;36995:14:0;;;:19;36991:183;;37034:56;37065:4;37071:2;37075:7;37084:5;37034:30;:56::i;:::-;37029:145;;37118:40;;-1:-1:-1;;;37118:40:0;;;;;;;;;;;37029:145;36774:407;;;;:::o;56617:341::-;56690:13;56721:16;56729:7;56721;:16::i;:::-;56716:59;;56746:29;;-1:-1:-1;;;56746:29:0;;;;;;;;;;;56716:59;56788:28;56819:10;:8;:10::i;:::-;56788:41;;56853:7;56847:21;;;;;:::i;:::-;;;56872:1;56847:26;:103;;;;;;;;;;;;;;;;;56900:14;56916:18;56926:7;56916:9;:18::i;:::-;56883:61;;;;;;;;;:::i;:::-;;;;;;;;;;;;;56847:103;56840:110;56617:341;-1:-1:-1;;;56617:341:0:o;30372:164::-;-1:-1:-1;;;;;30493:25:0;;;30469:4;30493:25;;;:18;:25;;;;;;;;:35;;;;;;;;;;;;;;;30372:164::o;3067:201::-;2047:13;:11;:13::i;:::-;-1:-1:-1;;;;;3156:22:0;::::1;3148:73;;;::::0;-1:-1:-1;;;3148:73:0;;10597:2:1;3148:73:0::1;::::0;::::1;10579:21:1::0;10636:2;10616:18;;;10609:30;10675:34;10655:18;;;10648:62;-1:-1:-1;;;10726:18:1;;;10719:36;10772:19;;3148:73:0::1;10395:402:1::0;3148:73:0::1;3232:28;3251:8;3232:18;:28::i;56966:100::-:0;2047:13;:11;:13::i;:::-;57036:9:::1;:22:::0;56966:100::o;2326:132::-;2234:6;;-1:-1:-1;;;;;2234:6:0;53189:10;2390:23;2382:68;;;;-1:-1:-1;;;2382:68:0;;11004:2:1;2382:68:0;;;10986:21:1;;;11023:18;;;11016:30;11082:34;11062:18;;;11055:62;11134:18;;2382:68:0;10802:356:1;30794:282:0;30859:4;30915:7;56600:1;30896:26;;:66;;;;;30949:13;;30939:7;:23;30896:66;:153;;;;-1:-1:-1;;31000:26:0;;;;:17;:26;;;;;;-1:-1:-1;;;31000:44:0;:49;;30794:282::o;25480:1275::-;25547:7;25582;;56600:1;25631:23;25627:1061;;25684:13;;25677:4;:20;25673:1015;;;25722:14;25739:23;;;:17;:23;;;;;;;-1:-1:-1;;;25828:24:0;;:29;;25824:845;;26493:113;26500:6;26510:1;26500:11;26493:113;;-1:-1:-1;;;26571:6:0;26553:25;;;;:17;:25;;;;;;26493:113;;25824:845;25699:989;25673:1015;26716:31;;-1:-1:-1;;;26716:31:0;;;;;;;;;;;46934:112;47011:27;47021:2;47025:8;47011:27;;;;;;;;;;;;:9;:27::i;3428:191::-;3521:6;;;-1:-1:-1;;;;;3538:17:0;;;-1:-1:-1;;;;;;3538:17:0;;;;;;;3571:40;;3521:6;;;3538:17;3521:6;;3571:40;;3502:16;;3571:40;3491:128;3428:191;:::o;39265:716::-;39449:88;;-1:-1:-1;;;39449:88:0;;39428:4;;-1:-1:-1;;;;;39449:45:0;;;;;:88;;53189:10;;39516:4;;39522:7;;39531:5;;39449:88;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;-1:-1:-1;39449:88:0;;;;;;;;-1:-1:-1;;39449:88:0;;;;;;;;;;;;:::i;:::-;;;39445:529;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;39732:6;:13;39749:1;39732:18;39728:235;;39778:40;;-1:-1:-1;;;39778:40:0;;;;;;;;;;;39728:235;39921:6;39915:13;39906:6;39902:2;39898:15;39891:38;39445:529;-1:-1:-1;;;;;;39608:64:0;-1:-1:-1;;;39608:64:0;;-1:-1:-1;39445:529:0;39265:716;;;;;;:::o;56408:100::-;56460:13;56493:7;56486:14;;;;;:::i;53309:1745::-;53374:17;53808:4;53801;53795:11;53791:22;53900:1;53894:4;53887:15;53975:4;53972:1;53968:12;53961:19;;;54057:1;54052:3;54045:14;54161:3;54400:5;54382:428;54448:1;54443:3;54439:11;54432:18;;54619:2;54613:4;54609:13;54605:2;54601:22;54596:3;54588:36;54713:2;54703:13;;54770:25;54382:428;54770:25;-1:-1:-1;54840:13:0;;;-1:-1:-1;;54955:14:0;;;55017:19;;;54955:14;53309:1745;-1:-1:-1;53309:1745:0:o;46161:689::-;46292:19;46298:2;46302:8;46292:5;:19::i;:::-;-1:-1:-1;;;;;46353:14:0;;;:19;46349:483;;46393:11;46407:13;46455:14;;;46488:233;46519:62;46558:1;46562:2;46566:7;;;;;;46575:5;46519:30;:62::i;:::-;46514:167;;46617:40;;-1:-1:-1;;;46617:40:0;;;;;;;;;;;46514:167;46716:3;46708:5;:11;46488:233;;46803:3;46786:13;;:20;46782:34;;46808:8;;;46782:34;46374:458;;46161:689;;;:::o;40443:2966::-;40516:20;40539:13;;;40567;;;40563:44;;40589:18;;-1:-1:-1;;;40589:18:0;;;;;;;;;;;40563:44;-1:-1:-1;;;;;41095:22:0;;;;;;:18;:22;;;;14164:2;41095:22;;;:71;;41133:32;41121:45;;41095:71;;;41409:31;;;:17;:31;;;;;-1:-1:-1;28145:15:0;;28119:24;28115:46;27714:11;27689:23;27685:41;27682:52;27672:63;;41409:173;;41644:23;;;;41409:31;;41095:22;;42409:25;41095:22;;42262:335;42923:1;42909:12;42905:20;42863:346;42964:3;42955:7;42952:16;42863:346;;43182:7;43172:8;43169:1;43142:25;43139:1;43136;43131:59;43017:1;43004:15;42863:346;;;42867:77;43242:8;43254:1;43242:13;43238:45;;43264:19;;-1:-1:-1;;;43264:19:0;;;;;;;;;;;43238:45;43300:13;:19;-1:-1:-1;35983:193:0;;;:::o;14:131:1:-;-1:-1:-1;;;;;;88:32:1;;78:43;;68:71;;135:1;132;125:12;150:245;208:6;261:2;249:9;240:7;236:23;232:32;229:52;;;277:1;274;267:12;229:52;316:9;303:23;335:30;359:5;335:30;:::i;592:160::-;657:20;;713:13;;706:21;696:32;;686:60;;742:1;739;732:12;686:60;592:160;;;:::o;757:180::-;813:6;866:2;854:9;845:7;841:23;837:32;834:52;;;882:1;879;872:12;834:52;905:26;921:9;905:26;:::i;942:250::-;1027:1;1037:113;1051:6;1048:1;1045:13;1037:113;;;1127:11;;;1121:18;1108:11;;;1101:39;1073:2;1066:10;1037:113;;;-1:-1:-1;;1184:1:1;1166:16;;1159:27;942:250::o;1197:271::-;1239:3;1277:5;1271:12;1304:6;1299:3;1292:19;1320:76;1389:6;1382:4;1377:3;1373:14;1366:4;1359:5;1355:16;1320:76;:::i;:::-;1450:2;1429:15;-1:-1:-1;;1425:29:1;1416:39;;;;1457:4;1412:50;;1197:271;-1:-1:-1;;1197:271:1:o;1473:220::-;1622:2;1611:9;1604:21;1585:4;1642:45;1683:2;1672:9;1668:18;1660:6;1642:45;:::i;1698:180::-;1757:6;1810:2;1798:9;1789:7;1785:23;1781:32;1778:52;;;1826:1;1823;1816:12;1778:52;-1:-1:-1;1849:23:1;;1698:180;-1:-1:-1;1698:180:1:o;2091:173::-;2159:20;;-1:-1:-1;;;;;2208:31:1;;2198:42;;2188:70;;2254:1;2251;2244:12;2269:254;2337:6;2345;2398:2;2386:9;2377:7;2373:23;2369:32;2366:52;;;2414:1;2411;2404:12;2366:52;2437:29;2456:9;2437:29;:::i;:::-;2427:39;2513:2;2498:18;;;;2485:32;;-1:-1:-1;;;2269:254:1:o;2710:328::-;2787:6;2795;2803;2856:2;2844:9;2835:7;2831:23;2827:32;2824:52;;;2872:1;2869;2862:12;2824:52;2895:29;2914:9;2895:29;:::i;:::-;2885:39;;2943:38;2977:2;2966:9;2962:18;2943:38;:::i;:::-;2933:48;;3028:2;3017:9;3013:18;3000:32;2990:42;;2710:328;;;;;:::o;3043:127::-;3104:10;3099:3;3095:20;3092:1;3085:31;3135:4;3132:1;3125:15;3159:4;3156:1;3149:15;3175:632;3240:5;3270:18;3311:2;3303:6;3300:14;3297:40;;;3317:18;;:::i;:::-;3392:2;3386:9;3360:2;3446:15;;-1:-1:-1;;3442:24:1;;;3468:2;3438:33;3434:42;3422:55;;;3492:18;;;3512:22;;;3489:46;3486:72;;;3538:18;;:::i;:::-;3578:10;3574:2;3567:22;3607:6;3598:15;;3637:6;3629;3622:22;3677:3;3668:6;3663:3;3659:16;3656:25;3653:45;;;3694:1;3691;3684:12;3653:45;3744:6;3739:3;3732:4;3724:6;3720:17;3707:44;3799:1;3792:4;3783:6;3775;3771:19;3767:30;3760:41;;;;3175:632;;;;;:::o;3812:451::-;3881:6;3934:2;3922:9;3913:7;3909:23;3905:32;3902:52;;;3950:1;3947;3940:12;3902:52;3990:9;3977:23;4023:18;4015:6;4012:30;4009:50;;;4055:1;4052;4045:12;4009:50;4078:22;;4131:4;4123:13;;4119:27;-1:-1:-1;4109:55:1;;4160:1;4157;4150:12;4109:55;4183:74;4249:7;4244:2;4231:16;4226:2;4222;4218:11;4183:74;:::i;4268:186::-;4327:6;4380:2;4368:9;4359:7;4355:23;4351:32;4348:52;;;4396:1;4393;4386:12;4348:52;4419:29;4438:9;4419:29;:::i;4459:254::-;4524:6;4532;4585:2;4573:9;4564:7;4560:23;4556:32;4553:52;;;4601:1;4598;4591:12;4553:52;4624:29;4643:9;4624:29;:::i;:::-;4614:39;;4672:35;4703:2;4692:9;4688:18;4672:35;:::i;:::-;4662:45;;4459:254;;;;;:::o;4718:667::-;4813:6;4821;4829;4837;4890:3;4878:9;4869:7;4865:23;4861:33;4858:53;;;4907:1;4904;4897:12;4858:53;4930:29;4949:9;4930:29;:::i;:::-;4920:39;;4978:38;5012:2;5001:9;4997:18;4978:38;:::i;:::-;4968:48;;5063:2;5052:9;5048:18;5035:32;5025:42;;5118:2;5107:9;5103:18;5090:32;5145:18;5137:6;5134:30;5131:50;;;5177:1;5174;5167:12;5131:50;5200:22;;5253:4;5245:13;;5241:27;-1:-1:-1;5231:55:1;;5282:1;5279;5272:12;5231:55;5305:74;5371:7;5366:2;5353:16;5348:2;5344;5340:11;5305:74;:::i;:::-;5295:84;;;4718:667;;;;;;;:::o;5390:260::-;5458:6;5466;5519:2;5507:9;5498:7;5494:23;5490:32;5487:52;;;5535:1;5532;5525:12;5487:52;5558:29;5577:9;5558:29;:::i;:::-;5548:39;;5606:38;5640:2;5629:9;5625:18;5606:38;:::i;5655:380::-;5734:1;5730:12;;;;5777;;;5798:61;;5852:4;5844:6;5840:17;5830:27;;5798:61;5905:2;5897:6;5894:14;5874:18;5871:38;5868:161;;5951:10;5946:3;5942:20;5939:1;5932:31;5986:4;5983:1;5976:15;6014:4;6011:1;6004:15;5868:161;;5655:380;;;:::o;6040:127::-;6101:10;6096:3;6092:20;6089:1;6082:31;6132:4;6129:1;6122:15;6156:4;6153:1;6146:15;6172:125;6237:9;;;6258:10;;;6255:36;;;6271:18;;:::i;6779:545::-;6881:2;6876:3;6873:11;6870:448;;;6917:1;6942:5;6938:2;6931:17;6987:4;6983:2;6973:19;7057:2;7045:10;7041:19;7038:1;7034:27;7028:4;7024:38;7093:4;7081:10;7078:20;7075:47;;;-1:-1:-1;7116:4:1;7075:47;7171:2;7166:3;7162:12;7159:1;7155:20;7149:4;7145:31;7135:41;;7226:82;7244:2;7237:5;7234:13;7226:82;;;7289:17;;;7270:1;7259:13;7226:82;;7500:1352;7626:3;7620:10;7653:18;7645:6;7642:30;7639:56;;;7675:18;;:::i;:::-;7704:97;7794:6;7754:38;7786:4;7780:11;7754:38;:::i;:::-;7748:4;7704:97;:::i;:::-;7856:4;;7920:2;7909:14;;7937:1;7932:663;;;;8639:1;8656:6;8653:89;;;-1:-1:-1;8708:19:1;;;8702:26;8653:89;-1:-1:-1;;7457:1:1;7453:11;;;7449:24;7445:29;7435:40;7481:1;7477:11;;;7432:57;8755:81;;7902:944;;7932:663;6726:1;6719:14;;;6763:4;6750:18;;-1:-1:-1;;7968:20:1;;;8086:236;8100:7;8097:1;8094:14;8086:236;;;8189:19;;;8183:26;8168:42;;8281:27;;;;8249:1;8237:14;;;;8116:19;;8086:236;;;8090:3;8350:6;8341:7;8338:19;8335:201;;;8411:19;;;8405:26;-1:-1:-1;;8494:1:1;8490:14;;;8506:3;8486:24;8482:37;8478:42;8463:58;8448:74;;8335:201;-1:-1:-1;;;;;8582:1:1;8566:14;;;8562:22;8549:36;;-1:-1:-1;7500:1352:1:o;9204:168::-;9277:9;;;9308;;9325:15;;;9319:22;;9305:37;9295:71;;9346:18;;:::i;9727:663::-;10007:3;10045:6;10039:13;10061:66;10120:6;10115:3;10108:4;10100:6;10096:17;10061:66;:::i;:::-;10190:13;;10149:16;;;;10212:70;10190:13;10149:16;10259:4;10247:17;;10212:70;:::i;:::-;-1:-1:-1;;;10304:20:1;;10333:22;;;10382:1;10371:13;;9727:663;-1:-1:-1;;;;9727:663:1:o;11163:489::-;-1:-1:-1;;;;;11432:15:1;;;11414:34;;11484:15;;11479:2;11464:18;;11457:43;11531:2;11516:18;;11509:34;;;11579:3;11574:2;11559:18;;11552:31;;;11357:4;;11600:46;;11626:19;;11618:6;11600:46;:::i;:::-;11592:54;11163:489;-1:-1:-1;;;;;;11163:489:1:o;11657:249::-;11726:6;11779:2;11767:9;11758:7;11754:23;11750:32;11747:52;;;11795:1;11792;11785:12;11747:52;11827:9;11821:16;11846:30;11870:5;11846:30;:::i

ipfs://1795cd672723c9c43e92fdbae6ff5bb05160084ee1c833dcd3c7b8d4f0b42ebc