ETH Price: $3,390.22 (-2.61%)
Gas: 1 Gwei

Token

Hidden One 404 (HIDDEN404)
 

Overview

Max Total Supply

1 HIDDEN404

Holders

26

Market

Onchain Market Cap

$0.00

Circulating Supply Market Cap

-

Other Info

Token Contract (WITH 18 Decimals)

Balance
0.012142449724879949 HIDDEN404

Value
$0.00
0x4dfbb14040c6840884a3acf135c5ff6976a46406
Loading...
Loading
Loading...
Loading
Loading...
Loading

Click here to update the token information / general information
# Exchange Pair Price  24H Volume % Volume

Contract Source Code Verified (Exact Match)

Contract Name:
HiddenOne

Compiler Version
v0.8.24+commit.e11b9ed9

Optimization Enabled:
Yes with 1000 runs

Other Settings:
default evmVersion, None license

Contract Source Code (Solidity)

/**
 *Submitted for verification at Etherscan.io on 2024-02-20
*/

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

/// @title DN404
/// @notice DN404 is a hybrid ERC20 and ERC721 implementation that mints
/// and burns NFTs based on an account's ERC20 token balance.
///
/// @author vectorized.eth (@optimizoor)
/// @author Quit (@0xQuit)
/// @author Michael Amadi (@AmadiMichaels)
/// @author cygaar (@0xCygaar)
/// @author Thomas (@0xjustadev)
/// @author Harrison (@PopPunkOnChain)
///
/// @dev Note:
/// - The ERC721 data is stored in this base DN404 contract, however a
///   DN404Mirror contract ***MUST*** be deployed and linked during
///   initialization.
abstract contract DN404 {
    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                           EVENTS                           */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

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

    /// @dev Emitted when `amount` tokens is approved by `owner` to be used by `spender`.
    event Approval(address indexed owner, address indexed spender, uint256 amount);

    /// @dev Emitted when `target` sets their skipNFT flag to `status`.
    event SkipNFTSet(address indexed target, bool status);

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                        CUSTOM ERRORS                       */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Thrown when attempting to double-initialize the contract.
    error DNAlreadyInitialized();

    /// @dev Thrown when attempting to transfer or burn more tokens than sender's balance.
    error InsufficientBalance();

    /// @dev Thrown when a spender attempts to transfer tokens with an insufficient allowance.
    error InsufficientAllowance();

    /// @dev Thrown when minting an amount of tokens that would overflow the max tokens.
    error TotalSupplyOverflow();

    /// @dev Thrown when the caller for a fallback NFT function is not the mirror contract.
    error SenderNotMirror();

    /// @dev Thrown when attempting to transfer tokens to the zero address.
    error TransferToZeroAddress();

    /// @dev Thrown when the mirror address provided for initialization is the zero address.
    error MirrorAddressIsZero();

    /// @dev Thrown when the link call to the mirror contract reverts.
    error LinkMirrorContractFailed();

    /// @dev Thrown when setting an NFT token approval
    /// and the caller is not the owner or an approved operator.
    error ApprovalCallerNotOwnerNorApproved();

    /// @dev Thrown when transferring an NFT
    /// and the caller is not the owner or an approved operator.
    error TransferCallerNotOwnerNorApproved();

    /// @dev Thrown when transferring an NFT and the from address is not the current owner.
    error TransferFromIncorrectOwner();

    /// @dev Thrown when checking the owner or approved address for an non-existent NFT.
    error TokenDoesNotExist();

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                         CONSTANTS                          */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Amount of token balance that is equal to one NFT.
    uint256 internal constant _WAD = 10 ** 18;

    /// @dev The maximum token ID allowed for an NFT.
    uint256 internal constant _MAX_TOKEN_ID = 0xffffffff;

    /// @dev The maximum possible token supply.
    uint256 internal constant _MAX_SUPPLY = 10 ** 18 * 0xffffffff - 1;

    /// @dev The flag to denote that the address data is initialized.
    uint8 internal constant _ADDRESS_DATA_INITIALIZED_FLAG = 1 << 0;

    /// @dev The flag to denote that the address should skip NFTs.
    uint8 internal constant _ADDRESS_DATA_SKIP_NFT_FLAG = 1 << 1;

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                          STORAGE                           */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Struct containing an address's token data and settings.
    struct AddressData {
        // Auxiliary data.
        uint88 aux;
        // Flags for `initialized` and `skipNFT`.
        uint8 flags;
        // The alias for the address. Zero means absence of an alias.
        uint32 addressAlias;
        // The number of NFT tokens.
        uint32 ownedLength;
        // The token balance in wei.
        uint96 balance;
    }

    /// @dev A uint32 map in storage.
    struct Uint32Map {
        mapping(uint256 => uint256) map;
    }

    /// @dev Struct containing the base token contract storage.
    struct DN404Storage {
        // Current number of address aliases assigned.
        uint32 numAliases;
        // Next token ID to assign for an NFT mint.
        uint32 nextTokenId;
        // Total supply of minted NFTs.
        uint32 totalNFTSupply;
        // Total supply of tokens.
        uint96 totalSupply;
        // Address of the NFT mirror contract.
        address mirrorERC721;
        // Mapping of a user alias number to their address.
        mapping(uint32 => address) aliasToAddress;
        // Mapping of user operator approvals for NFTs.
        mapping(address => mapping(address => bool)) operatorApprovals;
        // Mapping of NFT token approvals to approved operators.
        mapping(uint256 => address) tokenApprovals;
        // Mapping of user allowances for token spenders.
        mapping(address => mapping(address => uint256)) allowance;
        // Mapping of NFT token IDs owned by an address.
        mapping(address => Uint32Map) owned;
        // Even indices: owner aliases. Odd indices: owned indices.
        Uint32Map oo;
        // Mapping of user account AddressData
        mapping(address => AddressData) addressData;
    }

    /// @dev Returns a storage pointer for DN404Storage.
    function _getDN404Storage() internal pure virtual returns (DN404Storage storage $) {
        /// @solidity memory-safe-assembly
        assembly {
            // `uint72(bytes9(keccak256("DN404_STORAGE")))`.
            $.slot := 0xa20d6e21d0e5255308 // Truncate to 9 bytes to reduce bytecode size.
        }
    }

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                         INITIALIZER                        */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Initializes the DN404 contract with an
    /// `initialTokenSupply`, `initialTokenOwner` and `mirror` NFT contract address.
    function _initializeDN404(
        uint256 initialTokenSupply,
        address initialSupplyOwner,
        address mirror
    ) internal virtual {
        DN404Storage storage $ = _getDN404Storage();

        if ($.nextTokenId != 0) revert DNAlreadyInitialized();

        if (mirror == address(0)) revert MirrorAddressIsZero();
        _linkMirrorContract(mirror);

        $.nextTokenId = 1;
        $.mirrorERC721 = mirror;

        if (initialTokenSupply > 0) {
            if (initialSupplyOwner == address(0)) revert TransferToZeroAddress();
            if (initialTokenSupply > _MAX_SUPPLY) revert TotalSupplyOverflow();

            $.totalSupply = uint96(initialTokenSupply);
            AddressData storage initialOwnerAddressData = _addressData(initialSupplyOwner);
            initialOwnerAddressData.balance = uint96(initialTokenSupply);

            emit Transfer(address(0), initialSupplyOwner, initialTokenSupply);

            _setSkipNFT(initialSupplyOwner, true);
        }
    }

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*               METADATA FUNCTIONS TO OVERRIDE               */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Returns the name of the token.
    function name() public view virtual returns (string memory);

    /// @dev Returns the symbol of the token.
    function symbol() public view virtual returns (string memory);

    /// @dev Returns the Uniform Resource Identifier (URI) for token `id`.
    function tokenURI(uint256 id) public view virtual returns (string memory);

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                      ERC20 OPERATIONS                      */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Returns the decimals places of the token. Always 18.
    function decimals() public pure returns (uint8) {
        return 18;
    }

    /// @dev Returns the amount of tokens in existence.
    function totalSupply() public view virtual returns (uint256) {
        return uint256(_getDN404Storage().totalSupply);
    }

    /// @dev Returns the amount of tokens owned by `owner`.
    function balanceOf(address owner) public view virtual returns (uint256) {
        return _getDN404Storage().addressData[owner].balance;
    }

    /// @dev Returns the amount of tokens that `spender` can spend on behalf of `owner`.
    function allowance(address owner, address spender) public view returns (uint256) {
        return _getDN404Storage().allowance[owner][spender];
    }

    /// @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
    ///
    /// Emits a {Approval} event.
    function approve(address spender, uint256 amount) public virtual returns (bool) {
        DN404Storage storage $ = _getDN404Storage();

        $.allowance[msg.sender][spender] = amount;

        emit Approval(msg.sender, spender, amount);

        return true;
    }

    /// @dev Transfer `amount` tokens from the caller to `to`.
    ///
    /// Will burn sender NFTs if balance after transfer is less than
    /// the amount required to support the current NFT balance.
    ///
    /// Will mint NFTs to `to` if the recipient's new balance supports
    /// additional NFTs ***AND*** the `to` address's skipNFT flag is
    /// set to false.
    ///
    /// Requirements:
    /// - `from` must at least have `amount`.
    ///
    /// Emits a {Transfer} event.
    function transfer(address to, uint256 amount) public virtual returns (bool) {
        _transfer(msg.sender, to, amount);
        return true;
    }

    /// @dev Transfers `amount` tokens from `from` to `to`.
    ///
    /// Note: Does not update the allowance if it is the maximum uint256 value.
    ///
    /// Will burn sender NFTs if balance after transfer is less than
    /// the amount required to support the current NFT balance.
    ///
    /// Will mint NFTs to `to` if the recipient's new balance supports
    /// additional NFTs ***AND*** the `to` address's skipNFT flag is
    /// set to false.
    ///
    /// Requirements:
    /// - `from` must at least have `amount`.
    /// - The caller must have at least `amount` of allowance to transfer the tokens of `from`.
    ///
    /// Emits a {Transfer} event.
    function transferFrom(address from, address to, uint256 amount) public virtual returns (bool) {
        DN404Storage storage $ = _getDN404Storage();

        uint256 allowed = $.allowance[from][msg.sender];

        if (allowed != type(uint256).max) {
            if (amount > allowed) revert InsufficientAllowance();
            unchecked {
                $.allowance[from][msg.sender] = allowed - amount;
            }
        }

        _transfer(from, to, amount);

        return true;
    }

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                  INTERNAL MINT FUNCTIONS                   */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Mints `amount` tokens to `to`, increasing the total supply.
    ///
    /// Will mint NFTs to `to` if the recipient's new balance supports
    /// additional NFTs ***AND*** the `to` address's skipNFT flag is
    /// set to false.
    ///
    /// Emits a {Transfer} event.
    function _mint(address to, uint256 amount) internal virtual {
        if (to == address(0)) revert TransferToZeroAddress();

        DN404Storage storage $ = _getDN404Storage();

        AddressData storage toAddressData = _addressData(to);

        unchecked {
            uint256 currentTokenSupply = uint256($.totalSupply) + amount;
            if (amount > _MAX_SUPPLY || currentTokenSupply > _MAX_SUPPLY) {
                revert TotalSupplyOverflow();
            }
            $.totalSupply = uint96(currentTokenSupply);

            uint256 toBalance = toAddressData.balance + amount;
            toAddressData.balance = uint96(toBalance);

            if (toAddressData.flags & _ADDRESS_DATA_SKIP_NFT_FLAG == 0) {
                Uint32Map storage toOwned = $.owned[to];
                uint256 toIndex = toAddressData.ownedLength;
                uint256 toEnd = toBalance * 100 / _WAD;
                _PackedLogs memory packedLogs = _packedLogsMalloc(_zeroFloorSub(toEnd, toIndex));

                if (packedLogs.logs.length != 0) {
                    uint256 maxNFTId = $.totalSupply * 100 / _WAD;
                    uint32 toAlias = _registerAndResolveAlias(toAddressData, to);
                    uint256 id = $.nextTokenId;
                    $.totalNFTSupply += uint32(packedLogs.logs.length);
                    toAddressData.ownedLength = uint32(toEnd);
                    // Mint loop.
                    do {
                        while (_get($.oo, _ownershipIndex(id)) != 0) {
                            if (++id > maxNFTId) id = 1;
                        }
                        _set(toOwned, toIndex, uint32(id));
                        _setOwnerAliasAndOwnedIndex($.oo, id, toAlias, uint32(toIndex++));
                        _packedLogsAppend(packedLogs, to, id, 0);
                        if (++id > maxNFTId) id = 1;
                    } while (toIndex != toEnd);
                    $.nextTokenId = uint32(id);
                    _packedLogsSend(packedLogs, $.mirrorERC721);
                }
            }
        }
        emit Transfer(address(0), to, amount);
    }

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                  INTERNAL BURN FUNCTIONS                   */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Burns `amount` tokens from `from`, reducing the total supply.
    ///
    /// Will burn sender NFTs if balance after transfer is less than
    /// the amount required to support the current NFT balance.
    ///
    /// Emits a {Transfer} event.
    function _burn(address from, uint256 amount) internal virtual {
        DN404Storage storage $ = _getDN404Storage();

        AddressData storage fromAddressData = _addressData(from);

        uint256 fromBalance = fromAddressData.balance;
        if (amount > fromBalance) revert InsufficientBalance();

        uint256 currentTokenSupply = $.totalSupply;

        unchecked {
            fromBalance -= amount;
            fromAddressData.balance = uint96(fromBalance);
            currentTokenSupply -= amount;
            $.totalSupply = uint96(currentTokenSupply);

            Uint32Map storage fromOwned = $.owned[from];
            uint256 fromIndex = fromAddressData.ownedLength;
            uint256 nftAmountToBurn = _zeroFloorSub(fromIndex, fromBalance * 100 / _WAD);

            if (nftAmountToBurn != 0) {
                $.totalNFTSupply -= uint32(nftAmountToBurn);

                _PackedLogs memory packedLogs = _packedLogsMalloc(nftAmountToBurn);

                uint256 fromEnd = fromIndex - nftAmountToBurn;
                // Burn loop.
                do {
                    uint256 id = _get(fromOwned, --fromIndex);
                    _setOwnerAliasAndOwnedIndex($.oo, id, 0, 0);
                    delete $.tokenApprovals[id];
                    _packedLogsAppend(packedLogs, from, id, 1);
                } while (fromIndex != fromEnd);

                fromAddressData.ownedLength = uint32(fromIndex);
                _packedLogsSend(packedLogs, $.mirrorERC721);
            }
        }
        emit Transfer(from, address(0), amount);
    }

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                INTERNAL TRANSFER FUNCTIONS                 */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Moves `amount` of tokens from `from` to `to`.
    ///
    /// Will burn sender NFTs if balance after transfer is less than
    /// the amount required to support the current NFT balance.
    ///
    /// Will mint NFTs to `to` if the recipient's new balance supports
    /// additional NFTs ***AND*** the `to` address's skipNFT flag is
    /// set to false.
    ///
    /// Emits a {Transfer} event.
    function _transfer(address from, address to, uint256 amount) internal virtual {
        if (to == address(0)) revert TransferToZeroAddress();

        DN404Storage storage $ = _getDN404Storage();

        AddressData storage fromAddressData = _addressData(from);
        AddressData storage toAddressData = _addressData(to);

        _TransferTemps memory t;
        t.fromOwnedLength = fromAddressData.ownedLength;
        t.toOwnedLength = toAddressData.ownedLength;
        t.fromBalance = fromAddressData.balance;

        if (amount > t.fromBalance) revert InsufficientBalance();

        unchecked {
            t.fromBalance -= amount;
            fromAddressData.balance = uint96(t.fromBalance);
            toAddressData.balance = uint96(t.toBalance = toAddressData.balance + amount);

            t.nftAmountToBurn = _zeroFloorSub(t.fromOwnedLength, t.fromBalance * 100 / _WAD);

            if (toAddressData.flags & _ADDRESS_DATA_SKIP_NFT_FLAG == 0) {
                if (from == to) t.toOwnedLength = t.fromOwnedLength - t.nftAmountToBurn;
                t.nftAmountToMint = _zeroFloorSub(t.toBalance * 100 / _WAD, t.toOwnedLength);
            }

            _PackedLogs memory packedLogs = _packedLogsMalloc(t.nftAmountToBurn + t.nftAmountToMint);

            if (t.nftAmountToBurn != 0) {
                Uint32Map storage fromOwned = $.owned[from];
                uint256 fromIndex = t.fromOwnedLength;
                uint256 fromEnd = fromIndex - t.nftAmountToBurn;
                $.totalNFTSupply -= uint32(t.nftAmountToBurn);
                fromAddressData.ownedLength = uint32(fromEnd);
                // Burn loop.
                do {
                    uint256 id = _get(fromOwned, --fromIndex);
                    _setOwnerAliasAndOwnedIndex($.oo, id, 0, 0);
                    delete $.tokenApprovals[id];
                    _packedLogsAppend(packedLogs, from, id, 1);
                } while (fromIndex != fromEnd);
            }

            if (t.nftAmountToMint != 0) {
                Uint32Map storage toOwned = $.owned[to];
                uint256 toIndex = t.toOwnedLength;
                uint256 toEnd = toIndex + t.nftAmountToMint;
                uint32 toAlias = _registerAndResolveAlias(toAddressData, to);
                uint256 maxNFTId = $.totalSupply * 100 / _WAD;
                uint256 id = $.nextTokenId;
                $.totalNFTSupply += uint32(t.nftAmountToMint);
                toAddressData.ownedLength = uint32(toEnd);
                // Mint loop.
                do {
                    while (_get($.oo, _ownershipIndex(id)) != 0) {
                        if (++id > maxNFTId) id = 1;
                    }
                    _set(toOwned, toIndex, uint32(id));
                    _setOwnerAliasAndOwnedIndex($.oo, id, toAlias, uint32(toIndex++));
                    _packedLogsAppend(packedLogs, to, id, 0);
                    if (++id > maxNFTId) id = 1;
                } while (toIndex != toEnd);
                $.nextTokenId = uint32(id);
            }

            if (packedLogs.logs.length != 0) {
                _packedLogsSend(packedLogs, $.mirrorERC721);
            }
        }
        emit Transfer(from, to, amount);
    }

    /// @dev Transfers token `id` from `from` to `to`.
    ///
    /// Requirements:
    ///
    /// - Call must originate from the mirror contract.
    /// - Token `id` must exist.
    /// - `from` must be the owner of the token.
    /// - `to` cannot be the zero address.
    ///   `msgSender` must be the owner of the token, or be approved to manage the token.
    ///
    /// Emits a {Transfer} event.
    function _transferFromNFT(address from, address to, uint256 id, address msgSender)
        internal
        virtual
    {
        DN404Storage storage $ = _getDN404Storage();

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

        address owner = $.aliasToAddress[_get($.oo, _ownershipIndex(id))];

        if (from != owner) revert TransferFromIncorrectOwner();

        if (msgSender != from) {
            if (!$.operatorApprovals[from][msgSender]) {
                if (msgSender != $.tokenApprovals[id]) {
                    revert TransferCallerNotOwnerNorApproved();
                }
            }
        }

        AddressData storage fromAddressData = _addressData(from);
        AddressData storage toAddressData = _addressData(to);

        fromAddressData.balance -= uint96(_WAD);

        unchecked {
            toAddressData.balance += uint96(_WAD);

            _set($.oo, _ownershipIndex(id), _registerAndResolveAlias(toAddressData, to));
            delete $.tokenApprovals[id];

            uint256 updatedId = _get($.owned[from], --fromAddressData.ownedLength);
            _set($.owned[from], _get($.oo, _ownedIndex(id)), uint32(updatedId));

            uint256 n = toAddressData.ownedLength++;
            _set($.oo, _ownedIndex(updatedId), _get($.oo, _ownedIndex(id)));
            _set($.owned[to], n, uint32(id));
            _set($.oo, _ownedIndex(id), uint32(n));
        }

        emit Transfer(from, to, _WAD);
    }

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                 DATA HITCHHIKING FUNCTIONS                 */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Returns the auxiliary data for `owner`.
    /// Minting, transferring, burning the tokens of `owner` will not change the auxiliary data.
    /// Auxiliary data can be set for any address, even if it does not have any tokens.
    function _getAux(address owner) internal view virtual returns (uint88) {
        return _getDN404Storage().addressData[owner].aux;
    }

    /// @dev Set the auxiliary data for `owner` to `value`.
    /// Minting, transferring, burning the tokens of `owner` will not change the auxiliary data.
    /// Auxiliary data can be set for any address, even if it does not have any tokens.
    function _setAux(address owner, uint88 value) internal virtual {
        _getDN404Storage().addressData[owner].aux = value;
    }

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                     SKIP NFT FUNCTIONS                     */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Returns true if account `a` will skip NFT minting on token mints and transfers.
    /// Returns false if account `a` will mint NFTs on token mints and transfers.
    function getSkipNFT(address a) public view virtual returns (bool) {
        AddressData storage d = _getDN404Storage().addressData[a];
        if (d.flags & _ADDRESS_DATA_INITIALIZED_FLAG == 0) return _hasCode(a);
        return d.flags & _ADDRESS_DATA_SKIP_NFT_FLAG != 0;
    }

    /// @dev Sets the caller's skipNFT flag to `skipNFT`
    ///
    /// Emits a {SkipNFTSet} event.
    function setSkipNFT(bool skipNFT) public virtual {
        _setSkipNFT(msg.sender, skipNFT);
    }

    /// @dev Internal function to set account `a` skipNFT flag to `state`
    ///
    /// Initializes account `a` AddressData if it is not currently initialized.
    ///
    /// Emits a {SkipNFTSet} event.
    function _setSkipNFT(address a, bool state) internal virtual {
        AddressData storage d = _addressData(a);
        if ((d.flags & _ADDRESS_DATA_SKIP_NFT_FLAG != 0) != state) {
            d.flags ^= _ADDRESS_DATA_SKIP_NFT_FLAG;
        }
        emit SkipNFTSet(a, state);
    }

    /// @dev Returns a storage data pointer for account `a` AddressData
    ///
    /// Initializes account `a` AddressData if it is not currently initialized.
    function _addressData(address a) internal virtual returns (AddressData storage d) {
        DN404Storage storage $ = _getDN404Storage();
        d = $.addressData[a];

        if (d.flags & _ADDRESS_DATA_INITIALIZED_FLAG == 0) {
            uint8 flags = _ADDRESS_DATA_INITIALIZED_FLAG;
            if (_hasCode(a)) flags |= _ADDRESS_DATA_SKIP_NFT_FLAG;
            d.flags = flags;
        }
    }

    /// @dev Returns the `addressAlias` of account `to`.
    ///
    /// Assigns and registers the next alias if `to` alias was not previously registered.
    function _registerAndResolveAlias(AddressData storage toAddressData, address to)
        internal
        virtual
        returns (uint32 addressAlias)
    {
        DN404Storage storage $ = _getDN404Storage();
        addressAlias = toAddressData.addressAlias;
        if (addressAlias == 0) {
            addressAlias = ++$.numAliases;
            toAddressData.addressAlias = addressAlias;
            $.aliasToAddress[addressAlias] = to;
        }
    }

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                     MIRROR OPERATIONS                      */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Returns the address of the mirror NFT contract.
    function mirrorERC721() public view virtual returns (address) {
        return _getDN404Storage().mirrorERC721;
    }

    /// @dev Returns the total NFT supply.
    function _totalNFTSupply() internal view virtual returns (uint256) {
        return _getDN404Storage().totalNFTSupply;
    }

    /// @dev Returns `owner` NFT balance.
    function _balanceOfNFT(address owner) internal view virtual returns (uint256) {
        return _getDN404Storage().addressData[owner].ownedLength;
    }

    /// @dev Returns the owner of token `id`.
    /// Returns the zero address instead of reverting if the token does not exist.
    function _ownerAt(uint256 id) internal view virtual returns (address) {
        DN404Storage storage $ = _getDN404Storage();
        return $.aliasToAddress[_get($.oo, _ownershipIndex(id))];
    }

    /// @dev Returns the owner of token `id`.
    ///
    /// Requirements:
    /// - Token `id` must exist.
    function _ownerOf(uint256 id) internal view virtual returns (address) {
        if (!_exists(id)) revert TokenDoesNotExist();
        return _ownerAt(id);
    }

    /// @dev Returns if token `id` exists.
    function _exists(uint256 id) internal view virtual returns (bool) {
        return _ownerAt(id) != address(0);
    }

    /// @dev Returns the account approved to manage token `id`.
    ///
    /// Requirements:
    /// - Token `id` must exist.
    function _getApproved(uint256 id) internal view virtual returns (address) {
        if (!_exists(id)) revert TokenDoesNotExist();
        return _getDN404Storage().tokenApprovals[id];
    }

    /// @dev Sets `spender` as the approved account to manage token `id`, using `msgSender`.
    ///
    /// Requirements:
    /// - `msgSender` must be the owner or an approved operator for the token owner.
    function _approveNFT(address spender, uint256 id, address msgSender)
        internal
        virtual
        returns (address)
    {
        DN404Storage storage $ = _getDN404Storage();

        address owner = $.aliasToAddress[_get($.oo, _ownershipIndex(id))];

        if (msgSender != owner) {
            if (!$.operatorApprovals[owner][msgSender]) {
                revert ApprovalCallerNotOwnerNorApproved();
            }
        }

        $.tokenApprovals[id] = spender;

        return owner;
    }

    /// @dev Approve or remove the `operator` as an operator for `msgSender`,
    /// without authorization checks.
    function _setApprovalForAll(address operator, bool approved, address msgSender)
        internal
        virtual
    {
        _getDN404Storage().operatorApprovals[msgSender][operator] = approved;
    }

    /// @dev Calls the mirror contract to link it to this contract.
    ///
    /// Reverts if the call to the mirror contract reverts.
    function _linkMirrorContract(address mirror) internal virtual {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, 0x0f4599e5) // `linkMirrorContract(address)`.
            mstore(0x20, caller())
            if iszero(and(eq(mload(0x00), 1), call(gas(), mirror, 0, 0x1c, 0x24, 0x00, 0x20))) {
                mstore(0x00, 0xd125259c) // `LinkMirrorContractFailed()`.
                revert(0x1c, 0x04)
            }
        }
    }

    /// @dev Fallback modifier to dispatch calls from the mirror NFT contract
    /// to internal functions in this contract.
    modifier dn404Fallback() virtual {
        DN404Storage storage $ = _getDN404Storage();

        uint256 fnSelector = _calldataload(0x00) >> 224;

        // `isApprovedForAll(address,address)`.
        if (fnSelector == 0xe985e9c5) {
            if (msg.sender != $.mirrorERC721) revert SenderNotMirror();
            if (msg.data.length < 0x44) revert();

            address owner = address(uint160(_calldataload(0x04)));
            address operator = address(uint160(_calldataload(0x24)));

            _return($.operatorApprovals[owner][operator] ? 1 : 0);
        }
        // `ownerOf(uint256)`.
        if (fnSelector == 0x6352211e) {
            if (msg.sender != $.mirrorERC721) revert SenderNotMirror();
            if (msg.data.length < 0x24) revert();

            uint256 id = _calldataload(0x04);

            _return(uint160(_ownerOf(id)));
        }
        // `transferFromNFT(address,address,uint256,address)`.
        if (fnSelector == 0xe5eb36c8) {
            if (msg.sender != $.mirrorERC721) revert SenderNotMirror();
            if (msg.data.length < 0x84) revert();

            address from = address(uint160(_calldataload(0x04)));
            address to = address(uint160(_calldataload(0x24)));
            uint256 id = _calldataload(0x44);
            address msgSender = address(uint160(_calldataload(0x64)));

            _transferFromNFT(from, to, id, msgSender);
            _return(1);
        }
        // `setApprovalForAll(address,bool,address)`.
        if (fnSelector == 0x813500fc) {
            if (msg.sender != $.mirrorERC721) revert SenderNotMirror();
            if (msg.data.length < 0x64) revert();

            address spender = address(uint160(_calldataload(0x04)));
            bool status = _calldataload(0x24) != 0;
            address msgSender = address(uint160(_calldataload(0x44)));

            _setApprovalForAll(spender, status, msgSender);
            _return(1);
        }
        // `approveNFT(address,uint256,address)`.
        if (fnSelector == 0xd10b6e0c) {
            if (msg.sender != $.mirrorERC721) revert SenderNotMirror();
            if (msg.data.length < 0x64) revert();

            address spender = address(uint160(_calldataload(0x04)));
            uint256 id = _calldataload(0x24);
            address msgSender = address(uint160(_calldataload(0x44)));

            _return(uint160(_approveNFT(spender, id, msgSender)));
        }
        // `getApproved(uint256)`.
        if (fnSelector == 0x081812fc) {
            if (msg.sender != $.mirrorERC721) revert SenderNotMirror();
            if (msg.data.length < 0x24) revert();

            uint256 id = _calldataload(0x04);

            _return(uint160(_getApproved(id)));
        }
        // `balanceOfNFT(address)`.
        if (fnSelector == 0xf5b100ea) {
            if (msg.sender != $.mirrorERC721) revert SenderNotMirror();
            if (msg.data.length < 0x24) revert();

            address owner = address(uint160(_calldataload(0x04)));

            _return(_balanceOfNFT(owner));
        }
        // `totalNFTSupply()`.
        if (fnSelector == 0xe2c79281) {
            if (msg.sender != $.mirrorERC721) revert SenderNotMirror();
            if (msg.data.length < 0x04) revert();

            _return(_totalNFTSupply());
        }
        // `implementsDN404()`.
        if (fnSelector == 0xb7a94eb8) {
            _return(1);
        }
        _;
    }

    /// @dev Fallback function for calls from mirror NFT contract.
    fallback() external payable virtual dn404Fallback {}

    receive() external payable virtual {}

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                      PRIVATE HELPERS                       */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    /// @dev Struct containing packed log data for `Transfer` events to be
    /// emitted by the mirror NFT contract.
    struct _PackedLogs {
        uint256[] logs;
        uint256 offset;
    }

    /// @dev Initiates memory allocation for packed logs with `n` log items.
    function _packedLogsMalloc(uint256 n) private pure returns (_PackedLogs memory p) {
        /// @solidity memory-safe-assembly
        assembly {
            let logs := add(mload(0x40), 0x40) // Offset by 2 words for `_packedLogsSend`.
            mstore(logs, n)
            let offset := add(0x20, logs)
            mstore(0x40, add(offset, shl(5, n)))
            mstore(p, logs)
            mstore(add(0x20, p), offset)
        }
    }

    /// @dev Adds a packed log item to `p` with address `a`, token `id` and burn flag `burnBit`.
    function _packedLogsAppend(_PackedLogs memory p, address a, uint256 id, uint256 burnBit)
        private
        pure
    {
        /// @solidity memory-safe-assembly
        assembly {
            let offset := mload(add(0x20, p))
            mstore(offset, or(or(shl(96, a), shl(8, id)), burnBit))
            mstore(add(0x20, p), add(offset, 0x20))
        }
    }

    /// @dev Calls the `mirror` NFT contract to emit Transfer events for packed logs `p`.
    function _packedLogsSend(_PackedLogs memory p, address mirror) private {
        /// @solidity memory-safe-assembly
        assembly {
            let logs := mload(p)
            let o := sub(logs, 0x40) // Start of calldata to send.
            mstore(o, 0x263c69d6) // `logTransfer(uint256[])`.
            mstore(add(o, 0x20), 0x20) // Offset of `logs` in the calldata to send.
            let n := add(0x44, shl(5, mload(logs))) // Length of calldata to send.
            if iszero(and(eq(mload(o), 1), call(gas(), mirror, 0, add(o, 0x1c), n, o, 0x20))) {
                revert(o, 0x00)
            }
        }
    }

    /// @dev Struct of temporary variables for transfers.
    struct _TransferTemps {
        uint256 nftAmountToBurn;
        uint256 nftAmountToMint;
        uint256 fromBalance;
        uint256 toBalance;
        uint256 fromOwnedLength;
        uint256 toOwnedLength;
    }

    /// @dev Returns if `a` has bytecode of non-zero length.
    function _hasCode(address a) private view returns (bool result) {
        /// @solidity memory-safe-assembly
        assembly {
            result := extcodesize(a) // Can handle dirty upper bits.
        }
    }

    /// @dev Returns the calldata value at `offset`.
    function _calldataload(uint256 offset) private pure returns (uint256 value) {
        /// @solidity memory-safe-assembly
        assembly {
            value := calldataload(offset)
        }
    }

    /// @dev Executes a return opcode to return `x` and end the current call frame.
    function _return(uint256 x) private pure {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, x)
            return(0x00, 0x20)
        }
    }

    /// @dev Returns `max(0, x - y)`.
    function _zeroFloorSub(uint256 x, uint256 y) private pure returns (uint256 z) {
        /// @solidity memory-safe-assembly
        assembly {
            z := mul(gt(x, y), sub(x, y))
        }
    }

    /// @dev Returns `i << 1`.
    function _ownershipIndex(uint256 i) private pure returns (uint256) {
        return i << 1;
    }

    /// @dev Returns `(i << 1) + 1`.
    function _ownedIndex(uint256 i) private pure returns (uint256) {
        unchecked {
            return (i << 1) + 1;
        }
    }

    /// @dev Returns the uint32 value at `index` in `map`.
    function _get(Uint32Map storage map, uint256 index) private view returns (uint32 result) {
        result = uint32(map.map[index >> 3] >> ((index & 7) << 5));
    }

    /// @dev Updates the uint32 value at `index` in `map`.
    function _set(Uint32Map storage map, uint256 index, uint32 value) private {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x20, map.slot)
            mstore(0x00, shr(3, index))
            let s := keccak256(0x00, 0x40) // Storage slot.
            let o := shl(5, and(index, 7)) // Storage slot offset (bits).
            let v := sload(s) // Storage slot value.
            let m := 0xffffffff // Value mask.
            sstore(s, xor(v, shl(o, and(m, xor(shr(o, v), value)))))
        }
    }

    /// @dev Sets the owner alias and the owned index together.
    function _setOwnerAliasAndOwnedIndex(
        Uint32Map storage map,
        uint256 id,
        uint32 ownership,
        uint32 ownedIndex
    ) private {
        /// @solidity memory-safe-assembly
        assembly {
            let value := or(shl(32, ownedIndex), and(0xffffffff, ownership))
            mstore(0x20, map.slot)
            mstore(0x00, shr(2, id))
            let s := keccak256(0x00, 0x40) // Storage slot.
            let o := shl(6, and(id, 3)) // Storage slot offset (bits).
            let v := sload(s) // Storage slot value.
            let m := 0xffffffffffffffff // Value mask.
            sstore(s, xor(v, shl(o, and(m, xor(shr(o, v), value)))))
        }
    }
}

pragma solidity ^0.8.4;

library DailyOutflowCounterLib {
    uint256 internal constant WAD_TRUNCATED = 10 ** 18 >> 40;

    uint256 internal constant OUTFLOW_TRUNCATED_MASK = 0xffffffffffffff;

    uint256 internal constant DAY_BITPOS = 56;

    uint256 internal constant DAY_MASK = 0x7fffffff;

    uint256 internal constant OUTFLOW_TRUNCATE_SHR = 40;

    uint256 internal constant WHITELISTED_BITPOS = 87;

    function update(uint88 packed, uint256 outflow)
        internal
        view
        returns (uint88 updated, uint256 multiple)
    {
        unchecked {
            if (isWhitelisted(packed)) {
                return (packed, 0);
            }

            uint256 currentDay = (block.timestamp / 86400) & DAY_MASK;
            uint256 packedDay = (uint256(packed) >> DAY_BITPOS) & DAY_MASK;
            uint256 totalOutflowTruncated = uint256(packed) & OUTFLOW_TRUNCATED_MASK;

            if (packedDay != currentDay) {
                totalOutflowTruncated = 0;
                packedDay = currentDay;
            }

            uint256 result = packedDay << DAY_BITPOS;
            uint256 todaysOutflowTruncated =
                totalOutflowTruncated + ((outflow >> OUTFLOW_TRUNCATE_SHR) & OUTFLOW_TRUNCATED_MASK);
            result |= todaysOutflowTruncated & OUTFLOW_TRUNCATED_MASK;
            updated = uint88(result);
            multiple = todaysOutflowTruncated / WAD_TRUNCATED;
        }
    }

    function isWhitelisted(uint88 packed) internal pure returns (bool) {
        return packed >> WHITELISTED_BITPOS != 0;
    }

    function setWhitelisted(uint88 packed, bool status) internal pure returns (uint88) {
        if (isWhitelisted(packed) != status) {
            packed ^= uint88(1 << WHITELISTED_BITPOS);
        }
        return packed;
    }
}

pragma solidity ^0.8.4;

/// @notice Simple single owner authorization mixin.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/auth/Ownable.sol)
///
/// @dev Note:
/// This implementation does NOT auto-initialize the owner to `msg.sender`.
/// You MUST call the `_initializeOwner` in the constructor / initializer.
///
/// While the ownable portion follows
/// [EIP-173](https://eips.ethereum.org/EIPS/eip-173) for compatibility,
/// the nomenclature for the 2-step ownership handover may be unique to this codebase.
abstract contract Ownable {
    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                       CUSTOM ERRORS                        */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The caller is not authorized to call the function.
    error Unauthorized();

    /// @dev The `newOwner` cannot be the zero address.
    error NewOwnerIsZeroAddress();

    /// @dev The `pendingOwner` does not have a valid handover request.
    error NoHandoverRequest();

    /// @dev Cannot double-initialize.
    error AlreadyInitialized();

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                           EVENTS                           */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The ownership is transferred from `oldOwner` to `newOwner`.
    /// This event is intentionally kept the same as OpenZeppelin's Ownable to be
    /// compatible with indexers and [EIP-173](https://eips.ethereum.org/EIPS/eip-173),
    /// despite it not being as lightweight as a single argument event.
    event OwnershipTransferred(address indexed oldOwner, address indexed newOwner);

    /// @dev An ownership handover to `pendingOwner` has been requested.
    event OwnershipHandoverRequested(address indexed pendingOwner);

    /// @dev The ownership handover to `pendingOwner` has been canceled.
    event OwnershipHandoverCanceled(address indexed pendingOwner);

    /// @dev `keccak256(bytes("OwnershipTransferred(address,address)"))`.
    uint256 private constant _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE =
        0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0;

    /// @dev `keccak256(bytes("OwnershipHandoverRequested(address)"))`.
    uint256 private constant _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE =
        0xdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d;

    /// @dev `keccak256(bytes("OwnershipHandoverCanceled(address)"))`.
    uint256 private constant _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE =
        0xfa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c92;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                          STORAGE                           */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The owner slot is given by:
    /// `bytes32(~uint256(uint32(bytes4(keccak256("_OWNER_SLOT_NOT")))))`.
    /// It is intentionally chosen to be a high value
    /// to avoid collision with lower slots.
    /// The choice of manual storage layout is to enable compatibility
    /// with both regular and upgradeable contracts.
    bytes32 internal constant _OWNER_SLOT =
        0xffffffffffffffffffffffffffffffffffffffffffffffffffffffff74873927;

    /// The ownership handover slot of `newOwner` is given by:
    /// ```
    ///     mstore(0x00, or(shl(96, user), _HANDOVER_SLOT_SEED))
    ///     let handoverSlot := keccak256(0x00, 0x20)
    /// ```
    /// It stores the expiry timestamp of the two-step ownership handover.
    uint256 private constant _HANDOVER_SLOT_SEED = 0x389a75e1;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                     INTERNAL FUNCTIONS                     */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Override to return true to make `_initializeOwner` prevent double-initialization.
    function _guardInitializeOwner() internal pure virtual returns (bool guard) {}

    /// @dev Initializes the owner directly without authorization guard.
    /// This function must be called upon initialization,
    /// regardless of whether the contract is upgradeable or not.
    /// This is to enable generalization to both regular and upgradeable contracts,
    /// and to save gas in case the initial owner is not the caller.
    /// For performance reasons, this function will not check if there
    /// is an existing owner.
    function _initializeOwner(address newOwner) internal virtual {
        if (_guardInitializeOwner()) {
            /// @solidity memory-safe-assembly
            assembly {
                let ownerSlot := _OWNER_SLOT
                if sload(ownerSlot) {
                    mstore(0x00, 0x0dc149f0) // `AlreadyInitialized()`.
                    revert(0x1c, 0x04)
                }
                // Clean the upper 96 bits.
                newOwner := shr(96, shl(96, newOwner))
                // Store the new value.
                sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner))))
                // Emit the {OwnershipTransferred} event.
                log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner)
            }
        } else {
            /// @solidity memory-safe-assembly
            assembly {
                // Clean the upper 96 bits.
                newOwner := shr(96, shl(96, newOwner))
                // Store the new value.
                sstore(_OWNER_SLOT, newOwner)
                // Emit the {OwnershipTransferred} event.
                log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner)
            }
        }
    }

    /// @dev Sets the owner directly without authorization guard.
    function _setOwner(address newOwner) internal virtual {
        if (_guardInitializeOwner()) {
            /// @solidity memory-safe-assembly
            assembly {
                let ownerSlot := _OWNER_SLOT
                // Clean the upper 96 bits.
                newOwner := shr(96, shl(96, newOwner))
                // Emit the {OwnershipTransferred} event.
                log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner)
                // Store the new value.
                sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner))))
            }
        } else {
            /// @solidity memory-safe-assembly
            assembly {
                let ownerSlot := _OWNER_SLOT
                // Clean the upper 96 bits.
                newOwner := shr(96, shl(96, newOwner))
                // Emit the {OwnershipTransferred} event.
                log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner)
                // Store the new value.
                sstore(ownerSlot, newOwner)
            }
        }
    }

    /// @dev Throws if the sender is not the owner.
    function _checkOwner() internal view virtual {
        /// @solidity memory-safe-assembly
        assembly {
            // If the caller is not the stored owner, revert.
            if iszero(eq(caller(), sload(_OWNER_SLOT))) {
                mstore(0x00, 0x82b42900) // `Unauthorized()`.
                revert(0x1c, 0x04)
            }
        }
    }

    /// @dev Returns how long a two-step ownership handover is valid for in seconds.
    /// Override to return a different value if needed.
    /// Made internal to conserve bytecode. Wrap it in a public function if needed.
    function _ownershipHandoverValidFor() internal view virtual returns (uint64) {
        return 48 * 3600;
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                  PUBLIC UPDATE FUNCTIONS                   */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Allows the owner to transfer the ownership to `newOwner`.
    function transferOwnership(address newOwner) public payable virtual onlyOwner {
        /// @solidity memory-safe-assembly
        assembly {
            if iszero(shl(96, newOwner)) {
                mstore(0x00, 0x7448fbae) // `NewOwnerIsZeroAddress()`.
                revert(0x1c, 0x04)
            }
        }
        _setOwner(newOwner);
    }

    /// @dev Allows the owner to renounce their ownership.
    function renounceOwnership() public payable virtual onlyOwner {
        _setOwner(address(0));
    }

    /// @dev Request a two-step ownership handover to the caller.
    /// The request will automatically expire in 48 hours (172800 seconds) by default.
    function requestOwnershipHandover() public payable virtual {
        unchecked {
            uint256 expires = block.timestamp + _ownershipHandoverValidFor();
            /// @solidity memory-safe-assembly
            assembly {
                // Compute and set the handover slot to `expires`.
                mstore(0x0c, _HANDOVER_SLOT_SEED)
                mstore(0x00, caller())
                sstore(keccak256(0x0c, 0x20), expires)
                // Emit the {OwnershipHandoverRequested} event.
                log2(0, 0, _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE, caller())
            }
        }
    }

    /// @dev Cancels the two-step ownership handover to the caller, if any.
    function cancelOwnershipHandover() public payable virtual {
        /// @solidity memory-safe-assembly
        assembly {
            // Compute and set the handover slot to 0.
            mstore(0x0c, _HANDOVER_SLOT_SEED)
            mstore(0x00, caller())
            sstore(keccak256(0x0c, 0x20), 0)
            // Emit the {OwnershipHandoverCanceled} event.
            log2(0, 0, _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE, caller())
        }
    }

    /// @dev Allows the owner to complete the two-step ownership handover to `pendingOwner`.
    /// Reverts if there is no existing ownership handover requested by `pendingOwner`.
    function completeOwnershipHandover(address pendingOwner) public payable virtual onlyOwner {
        /// @solidity memory-safe-assembly
        assembly {
            // Compute and set the handover slot to 0.
            mstore(0x0c, _HANDOVER_SLOT_SEED)
            mstore(0x00, pendingOwner)
            let handoverSlot := keccak256(0x0c, 0x20)
            // If the handover does not exist, or has expired.
            if gt(timestamp(), sload(handoverSlot)) {
                mstore(0x00, 0x6f5e8818) // `NoHandoverRequest()`.
                revert(0x1c, 0x04)
            }
            // Set the handover slot to 0.
            sstore(handoverSlot, 0)
        }
        _setOwner(pendingOwner);
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                   PUBLIC READ FUNCTIONS                    */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Returns the owner of the contract.
    function owner() public view virtual returns (address result) {
        /// @solidity memory-safe-assembly
        assembly {
            result := sload(_OWNER_SLOT)
        }
    }

    /// @dev Returns the expiry timestamp for the two-step ownership handover to `pendingOwner`.
    function ownershipHandoverExpiresAt(address pendingOwner)
        public
        view
        virtual
        returns (uint256 result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            // Compute the handover slot.
            mstore(0x0c, _HANDOVER_SLOT_SEED)
            mstore(0x00, pendingOwner)
            // Load the handover slot.
            result := sload(keccak256(0x0c, 0x20))
        }
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                         MODIFIERS                          */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Marks a function as only callable by the owner.
    modifier onlyOwner() virtual {
        _checkOwner();
        _;
    }
}

pragma solidity ^0.8.4;

/// @notice Library for burning gas without reverting.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/GasBurnerLib.sol)
library GasBurnerLib {
    /// @dev Burns approximately `x` amount of gas.
    /// Intended for Contract Secured Revenue (CSR).
    ///
    /// Recommendation: pass in an admin-controlled dynamic value instead of a hardcoded one.
    /// This is so that you can adjust your contract as needed depending on market conditions,
    /// and to give you and your users a leeway in case the L2 chain change the rules.
    function burn(uint256 x) internal pure {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x10, or(1, x))
            let n := mul(gt(x, 120), div(x, 91))
            // We use keccak256 instead of blake2f precompile for better widespread compatibility.
            for { let i := 0 } iszero(eq(i, n)) { i := add(i, 1) } {
                mstore(0x10, keccak256(0x10, 0x10)) // Yes.
            }
            if iszero(mload(0x10)) { invalid() }
        }
    }
}

pragma solidity ^0.8.4;

/// @notice Safe ETH and ERC20 transfer library that gracefully handles missing return values.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/SafeTransferLib.sol)
/// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/SafeTransferLib.sol)
///
/// @dev Note:
/// - For ETH transfers, please use `forceSafeTransferETH` for DoS protection.
/// - For ERC20s, this implementation won't check that a token has code,
///   responsibility is delegated to the caller.
library SafeTransferLib {
    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                       CUSTOM ERRORS                        */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The ETH transfer has failed.
    error ETHTransferFailed();

    /// @dev The ERC20 `transferFrom` has failed.
    error TransferFromFailed();

    /// @dev The ERC20 `transfer` has failed.
    error TransferFailed();

    /// @dev The ERC20 `approve` has failed.
    error ApproveFailed();

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                         CONSTANTS                          */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Suggested gas stipend for contract receiving ETH that disallows any storage writes.
    uint256 internal constant GAS_STIPEND_NO_STORAGE_WRITES = 2300;

    /// @dev Suggested gas stipend for contract receiving ETH to perform a few
    /// storage reads and writes, but low enough to prevent griefing.
    uint256 internal constant GAS_STIPEND_NO_GRIEF = 100000;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                       ETH OPERATIONS                       */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    // If the ETH transfer MUST succeed with a reasonable gas budget, use the force variants.
    //
    // The regular variants:
    // - Forwards all remaining gas to the target.
    // - Reverts if the target reverts.
    // - Reverts if the current contract has insufficient balance.
    //
    // The force variants:
    // - Forwards with an optional gas stipend
    //   (defaults to `GAS_STIPEND_NO_GRIEF`, which is sufficient for most cases).
    // - If the target reverts, or if the gas stipend is exhausted,
    //   creates a temporary contract to force send the ETH via `SELFDESTRUCT`.
    //   Future compatible with `SENDALL`: https://eips.ethereum.org/EIPS/eip-4758.
    // - Reverts if the current contract has insufficient balance.
    //
    // The try variants:
    // - Forwards with a mandatory gas stipend.
    // - Instead of reverting, returns whether the transfer succeeded.

    /// @dev Sends `amount` (in wei) ETH to `to`.
    function safeTransferETH(address to, uint256 amount) internal {
        /// @solidity memory-safe-assembly
        assembly {
            if iszero(call(gas(), to, amount, codesize(), 0x00, codesize(), 0x00)) {
                mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`.
                revert(0x1c, 0x04)
            }
        }
    }

    /// @dev Sends all the ETH in the current contract to `to`.
    function safeTransferAllETH(address to) internal {
        /// @solidity memory-safe-assembly
        assembly {
            // Transfer all the ETH and check if it succeeded or not.
            if iszero(call(gas(), to, selfbalance(), codesize(), 0x00, codesize(), 0x00)) {
                mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`.
                revert(0x1c, 0x04)
            }
        }
    }

    /// @dev Force sends `amount` (in wei) ETH to `to`, with a `gasStipend`.
    function forceSafeTransferETH(address to, uint256 amount, uint256 gasStipend) internal {
        /// @solidity memory-safe-assembly
        assembly {
            if lt(selfbalance(), amount) {
                mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`.
                revert(0x1c, 0x04)
            }
            if iszero(call(gasStipend, to, amount, codesize(), 0x00, codesize(), 0x00)) {
                mstore(0x00, to) // Store the address in scratch space.
                mstore8(0x0b, 0x73) // Opcode `PUSH20`.
                mstore8(0x20, 0xff) // Opcode `SELFDESTRUCT`.
                if iszero(create(amount, 0x0b, 0x16)) { revert(codesize(), codesize()) } // For gas estimation.
            }
        }
    }

    /// @dev Force sends all the ETH in the current contract to `to`, with a `gasStipend`.
    function forceSafeTransferAllETH(address to, uint256 gasStipend) internal {
        /// @solidity memory-safe-assembly
        assembly {
            if iszero(call(gasStipend, to, selfbalance(), codesize(), 0x00, codesize(), 0x00)) {
                mstore(0x00, to) // Store the address in scratch space.
                mstore8(0x0b, 0x73) // Opcode `PUSH20`.
                mstore8(0x20, 0xff) // Opcode `SELFDESTRUCT`.
                if iszero(create(selfbalance(), 0x0b, 0x16)) { revert(codesize(), codesize()) } // For gas estimation.
            }
        }
    }

    /// @dev Force sends `amount` (in wei) ETH to `to`, with `GAS_STIPEND_NO_GRIEF`.
    function forceSafeTransferETH(address to, uint256 amount) internal {
        /// @solidity memory-safe-assembly
        assembly {
            if lt(selfbalance(), amount) {
                mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`.
                revert(0x1c, 0x04)
            }
            if iszero(call(GAS_STIPEND_NO_GRIEF, to, amount, codesize(), 0x00, codesize(), 0x00)) {
                mstore(0x00, to) // Store the address in scratch space.
                mstore8(0x0b, 0x73) // Opcode `PUSH20`.
                mstore8(0x20, 0xff) // Opcode `SELFDESTRUCT`.
                if iszero(create(amount, 0x0b, 0x16)) { revert(codesize(), codesize()) } // For gas estimation.
            }
        }
    }

    /// @dev Force sends all the ETH in the current contract to `to`, with `GAS_STIPEND_NO_GRIEF`.
    function forceSafeTransferAllETH(address to) internal {
        /// @solidity memory-safe-assembly
        assembly {
            // forgefmt: disable-next-item
            if iszero(call(GAS_STIPEND_NO_GRIEF, to, selfbalance(), codesize(), 0x00, codesize(), 0x00)) {
                mstore(0x00, to) // Store the address in scratch space.
                mstore8(0x0b, 0x73) // Opcode `PUSH20`.
                mstore8(0x20, 0xff) // Opcode `SELFDESTRUCT`.
                if iszero(create(selfbalance(), 0x0b, 0x16)) { revert(codesize(), codesize()) } // For gas estimation.
            }
        }
    }

    /// @dev Sends `amount` (in wei) ETH to `to`, with a `gasStipend`.
    function trySafeTransferETH(address to, uint256 amount, uint256 gasStipend)
        internal
        returns (bool success)
    {
        /// @solidity memory-safe-assembly
        assembly {
            success := call(gasStipend, to, amount, codesize(), 0x00, codesize(), 0x00)
        }
    }

    /// @dev Sends all the ETH in the current contract to `to`, with a `gasStipend`.
    function trySafeTransferAllETH(address to, uint256 gasStipend)
        internal
        returns (bool success)
    {
        /// @solidity memory-safe-assembly
        assembly {
            success := call(gasStipend, to, selfbalance(), codesize(), 0x00, codesize(), 0x00)
        }
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                      ERC20 OPERATIONS                      */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Sends `amount` of ERC20 `token` from `from` to `to`.
    /// Reverts upon failure.
    ///
    /// The `from` account must have at least `amount` approved for
    /// the current contract to manage.
    function safeTransferFrom(address token, address from, address to, uint256 amount) internal {
        /// @solidity memory-safe-assembly
        assembly {
            let m := mload(0x40) // Cache the free memory pointer.
            mstore(0x60, amount) // Store the `amount` argument.
            mstore(0x40, to) // Store the `to` argument.
            mstore(0x2c, shl(96, from)) // Store the `from` argument.
            mstore(0x0c, 0x23b872dd000000000000000000000000) // `transferFrom(address,address,uint256)`.
            // Perform the transfer, reverting upon failure.
            if iszero(
                and( // The arguments of `and` are evaluated from right to left.
                    or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                    call(gas(), token, 0, 0x1c, 0x64, 0x00, 0x20)
                )
            ) {
                mstore(0x00, 0x7939f424) // `TransferFromFailed()`.
                revert(0x1c, 0x04)
            }
            mstore(0x60, 0) // Restore the zero slot to zero.
            mstore(0x40, m) // Restore the free memory pointer.
        }
    }

    /// @dev Sends all of ERC20 `token` from `from` to `to`.
    /// Reverts upon failure.
    ///
    /// The `from` account must have their entire balance approved for
    /// the current contract to manage.
    function safeTransferAllFrom(address token, address from, address to)
        internal
        returns (uint256 amount)
    {
        /// @solidity memory-safe-assembly
        assembly {
            let m := mload(0x40) // Cache the free memory pointer.
            mstore(0x40, to) // Store the `to` argument.
            mstore(0x2c, shl(96, from)) // Store the `from` argument.
            mstore(0x0c, 0x70a08231000000000000000000000000) // `balanceOf(address)`.
            // Read the balance, reverting upon failure.
            if iszero(
                and( // The arguments of `and` are evaluated from right to left.
                    gt(returndatasize(), 0x1f), // At least 32 bytes returned.
                    staticcall(gas(), token, 0x1c, 0x24, 0x60, 0x20)
                )
            ) {
                mstore(0x00, 0x7939f424) // `TransferFromFailed()`.
                revert(0x1c, 0x04)
            }
            mstore(0x00, 0x23b872dd) // `transferFrom(address,address,uint256)`.
            amount := mload(0x60) // The `amount` is already at 0x60. We'll need to return it.
            // Perform the transfer, reverting upon failure.
            if iszero(
                and( // The arguments of `and` are evaluated from right to left.
                    or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                    call(gas(), token, 0, 0x1c, 0x64, 0x00, 0x20)
                )
            ) {
                mstore(0x00, 0x7939f424) // `TransferFromFailed()`.
                revert(0x1c, 0x04)
            }
            mstore(0x60, 0) // Restore the zero slot to zero.
            mstore(0x40, m) // Restore the free memory pointer.
        }
    }

    /// @dev Sends `amount` of ERC20 `token` from the current contract to `to`.
    /// Reverts upon failure.
    function safeTransfer(address token, address to, uint256 amount) internal {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x14, to) // Store the `to` argument.
            mstore(0x34, amount) // Store the `amount` argument.
            mstore(0x00, 0xa9059cbb000000000000000000000000) // `transfer(address,uint256)`.
            // Perform the transfer, reverting upon failure.
            if iszero(
                and( // The arguments of `and` are evaluated from right to left.
                    or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                    call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
                )
            ) {
                mstore(0x00, 0x90b8ec18) // `TransferFailed()`.
                revert(0x1c, 0x04)
            }
            mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
        }
    }

    /// @dev Sends all of ERC20 `token` from the current contract to `to`.
    /// Reverts upon failure.
    function safeTransferAll(address token, address to) internal returns (uint256 amount) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, 0x70a08231) // Store the function selector of `balanceOf(address)`.
            mstore(0x20, address()) // Store the address of the current contract.
            // Read the balance, reverting upon failure.
            if iszero(
                and( // The arguments of `and` are evaluated from right to left.
                    gt(returndatasize(), 0x1f), // At least 32 bytes returned.
                    staticcall(gas(), token, 0x1c, 0x24, 0x34, 0x20)
                )
            ) {
                mstore(0x00, 0x90b8ec18) // `TransferFailed()`.
                revert(0x1c, 0x04)
            }
            mstore(0x14, to) // Store the `to` argument.
            amount := mload(0x34) // The `amount` is already at 0x34. We'll need to return it.
            mstore(0x00, 0xa9059cbb000000000000000000000000) // `transfer(address,uint256)`.
            // Perform the transfer, reverting upon failure.
            if iszero(
                and( // The arguments of `and` are evaluated from right to left.
                    or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                    call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
                )
            ) {
                mstore(0x00, 0x90b8ec18) // `TransferFailed()`.
                revert(0x1c, 0x04)
            }
            mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
        }
    }

    /// @dev Sets `amount` of ERC20 `token` for `to` to manage on behalf of the current contract.
    /// Reverts upon failure.
    function safeApprove(address token, address to, uint256 amount) internal {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x14, to) // Store the `to` argument.
            mstore(0x34, amount) // Store the `amount` argument.
            mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`.
            // Perform the approval, reverting upon failure.
            if iszero(
                and( // The arguments of `and` are evaluated from right to left.
                    or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                    call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
                )
            ) {
                mstore(0x00, 0x3e3f8f73) // `ApproveFailed()`.
                revert(0x1c, 0x04)
            }
            mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
        }
    }

    /// @dev Sets `amount` of ERC20 `token` for `to` to manage on behalf of the current contract.
    /// If the initial attempt to approve fails, attempts to reset the approved amount to zero,
    /// then retries the approval again (some tokens, e.g. USDT, requires this).
    /// Reverts upon failure.
    function safeApproveWithRetry(address token, address to, uint256 amount) internal {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x14, to) // Store the `to` argument.
            mstore(0x34, amount) // Store the `amount` argument.
            mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`.
            // Perform the approval, retrying upon failure.
            if iszero(
                and( // The arguments of `and` are evaluated from right to left.
                    or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                    call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
                )
            ) {
                mstore(0x34, 0) // Store 0 for the `amount`.
                mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`.
                pop(call(gas(), token, 0, 0x10, 0x44, codesize(), 0x00)) // Reset the approval.
                mstore(0x34, amount) // Store back the original `amount`.
                // Retry the approval, reverting upon failure.
                if iszero(
                    and(
                        or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                        call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
                    )
                ) {
                    mstore(0x00, 0x3e3f8f73) // `ApproveFailed()`.
                    revert(0x1c, 0x04)
                }
            }
            mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
        }
    }

    /// @dev Returns the amount of ERC20 `token` owned by `account`.
    /// Returns zero if the `token` does not exist.
    function balanceOf(address token, address account) internal view returns (uint256 amount) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x14, account) // Store the `account` argument.
            mstore(0x00, 0x70a08231000000000000000000000000) // `balanceOf(address)`.
            amount :=
                mul(
                    mload(0x20),
                    and( // The arguments of `and` are evaluated from right to left.
                        gt(returndatasize(), 0x1f), // At least 32 bytes returned.
                        staticcall(gas(), token, 0x10, 0x24, 0x20, 0x20)
                    )
                )
        }
    }
}

pragma solidity ^0.8.4;

/// @notice Library for converting numbers into strings and other string operations.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/LibString.sol)
/// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/LibString.sol)
///
/// @dev Note:
/// For performance and bytecode compactness, most of the string operations are restricted to
/// byte strings (7-bit ASCII), except where otherwise specified.
/// Usage of byte string operations on charsets with runes spanning two or more bytes
/// can lead to undefined behavior.
library LibString {
    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                        CUSTOM ERRORS                       */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The length of the output is too small to contain all the hex digits.
    error HexLengthInsufficient();

    /// @dev The length of the string is more than 32 bytes.
    error TooBigForSmallString();

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                         CONSTANTS                          */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The constant returned when the `search` is not found in the string.
    uint256 internal constant NOT_FOUND = type(uint256).max;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                     DECIMAL OPERATIONS                     */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Returns the base 10 decimal representation of `value`.
    function toString(uint256 value) internal pure returns (string memory str) {
        /// @solidity memory-safe-assembly
        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.
            str := add(mload(0x40), 0x80)
            // Update the free memory pointer to allocate.
            mstore(0x40, add(str, 0x20))
            // Zeroize the slot after the string.
            mstore(str, 0)

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

            let w := not(0) // Tsk.
            // We write the string from rightmost digit to leftmost digit.
            // The following is essentially a do-while loop that also handles the zero case.
            for { let temp := value } 1 {} {
                str := add(str, w) // `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)
                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)
        }
    }

    /// @dev Returns the base 10 decimal representation of `value`.
    function toString(int256 value) internal pure returns (string memory str) {
        if (value >= 0) {
            return toString(uint256(value));
        }
        unchecked {
            str = toString(~uint256(value) + 1);
        }
        /// @solidity memory-safe-assembly
        assembly {
            // We still have some spare memory space on the left,
            // as we have allocated 3 words (96 bytes) for up to 78 digits.
            let length := mload(str) // Load the string length.
            mstore(str, 0x2d) // Store the '-' character.
            str := sub(str, 1) // Move back the string pointer by a byte.
            mstore(str, add(length, 1)) // Update the string length.
        }
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                   HEXADECIMAL OPERATIONS                   */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Returns the hexadecimal representation of `value`,
    /// left-padded to an input length of `length` bytes.
    /// The output is prefixed with "0x" encoded using 2 hexadecimal digits per byte,
    /// giving a total length of `length * 2 + 2` bytes.
    /// Reverts if `length` is too small for the output to contain all the digits.
    function toHexString(uint256 value, uint256 length) internal pure returns (string memory str) {
        str = toHexStringNoPrefix(value, length);
        /// @solidity memory-safe-assembly
        assembly {
            let strLength := add(mload(str), 2) // Compute the length.
            mstore(str, 0x3078) // Write the "0x" prefix.
            str := sub(str, 2) // Move the pointer.
            mstore(str, strLength) // Write the length.
        }
    }

    /// @dev Returns the hexadecimal representation of `value`,
    /// left-padded to an input length of `length` bytes.
    /// The output is prefixed with "0x" encoded using 2 hexadecimal digits per byte,
    /// giving a total length of `length * 2` bytes.
    /// Reverts if `length` is too small for the output to contain all the digits.
    function toHexStringNoPrefix(uint256 value, uint256 length)
        internal
        pure
        returns (string memory str)
    {
        /// @solidity memory-safe-assembly
        assembly {
            // We need 0x20 bytes for the trailing zeros padding, `length * 2` bytes
            // for the digits, 0x02 bytes for the prefix, and 0x20 bytes for the length.
            // We add 0x20 to the total and round down to a multiple of 0x20.
            // (0x20 + 0x20 + 0x02 + 0x20) = 0x62.
            str := add(mload(0x40), and(add(shl(1, length), 0x42), not(0x1f)))
            // Allocate the memory.
            mstore(0x40, add(str, 0x20))
            // Zeroize the slot after the string.
            mstore(str, 0)

            // Cache the end to calculate the length later.
            let end := str
            // Store "0123456789abcdef" in scratch space.
            mstore(0x0f, 0x30313233343536373839616263646566)

            let start := sub(str, add(length, length))
            let w := not(1) // Tsk.
            let temp := value
            // We write the string from rightmost digit to leftmost digit.
            // The following is essentially a do-while loop that also handles the zero case.
            for {} 1 {} {
                str := add(str, w) // `sub(str, 2)`.
                mstore8(add(str, 1), mload(and(temp, 15)))
                mstore8(str, mload(and(shr(4, temp), 15)))
                temp := shr(8, temp)
                if iszero(xor(str, start)) { break }
            }

            if temp {
                mstore(0x00, 0x2194895a) // `HexLengthInsufficient()`.
                revert(0x1c, 0x04)
            }

            // Compute the string's length.
            let strLength := sub(end, str)
            // Move the pointer and write the length.
            str := sub(str, 0x20)
            mstore(str, strLength)
        }
    }

    /// @dev Returns the hexadecimal representation of `value`.
    /// The output is prefixed with "0x" and encoded using 2 hexadecimal digits per byte.
    /// As address are 20 bytes long, the output will left-padded to have
    /// a length of `20 * 2 + 2` bytes.
    function toHexString(uint256 value) internal pure returns (string memory str) {
        str = toHexStringNoPrefix(value);
        /// @solidity memory-safe-assembly
        assembly {
            let strLength := add(mload(str), 2) // Compute the length.
            mstore(str, 0x3078) // Write the "0x" prefix.
            str := sub(str, 2) // Move the pointer.
            mstore(str, strLength) // Write the length.
        }
    }

    /// @dev Returns the hexadecimal representation of `value`.
    /// The output is prefixed with "0x".
    /// The output excludes leading "0" from the `toHexString` output.
    /// `0x00: "0x0", 0x01: "0x1", 0x12: "0x12", 0x123: "0x123"`.
    function toMinimalHexString(uint256 value) internal pure returns (string memory str) {
        str = toHexStringNoPrefix(value);
        /// @solidity memory-safe-assembly
        assembly {
            let o := eq(byte(0, mload(add(str, 0x20))), 0x30) // Whether leading zero is present.
            let strLength := add(mload(str), 2) // Compute the length.
            mstore(add(str, o), 0x3078) // Write the "0x" prefix, accounting for leading zero.
            str := sub(add(str, o), 2) // Move the pointer, accounting for leading zero.
            mstore(str, sub(strLength, o)) // Write the length, accounting for leading zero.
        }
    }

    /// @dev Returns the hexadecimal representation of `value`.
    /// The output excludes leading "0" from the `toHexStringNoPrefix` output.
    /// `0x00: "0", 0x01: "1", 0x12: "12", 0x123: "123"`.
    function toMinimalHexStringNoPrefix(uint256 value) internal pure returns (string memory str) {
        str = toHexStringNoPrefix(value);
        /// @solidity memory-safe-assembly
        assembly {
            let o := eq(byte(0, mload(add(str, 0x20))), 0x30) // Whether leading zero is present.
            let strLength := mload(str) // Get the length.
            str := add(str, o) // Move the pointer, accounting for leading zero.
            mstore(str, sub(strLength, o)) // Write the length, accounting for leading zero.
        }
    }

    /// @dev Returns the hexadecimal representation of `value`.
    /// The output is encoded using 2 hexadecimal digits per byte.
    /// As address are 20 bytes long, the output will left-padded to have
    /// a length of `20 * 2` bytes.
    function toHexStringNoPrefix(uint256 value) internal pure returns (string memory str) {
        /// @solidity memory-safe-assembly
        assembly {
            // We need 0x20 bytes for the trailing zeros padding, 0x20 bytes for the length,
            // 0x02 bytes for the prefix, and 0x40 bytes for the digits.
            // The next multiple of 0x20 above (0x20 + 0x20 + 0x02 + 0x40) is 0xa0.
            str := add(mload(0x40), 0x80)
            // Allocate the memory.
            mstore(0x40, add(str, 0x20))
            // Zeroize the slot after the string.
            mstore(str, 0)

            // Cache the end to calculate the length later.
            let end := str
            // Store "0123456789abcdef" in scratch space.
            mstore(0x0f, 0x30313233343536373839616263646566)

            let w := not(1) // Tsk.
            // We write the string from rightmost digit to leftmost digit.
            // The following is essentially a do-while loop that also handles the zero case.
            for { let temp := value } 1 {} {
                str := add(str, w) // `sub(str, 2)`.
                mstore8(add(str, 1), mload(and(temp, 15)))
                mstore8(str, mload(and(shr(4, temp), 15)))
                temp := shr(8, temp)
                if iszero(temp) { break }
            }

            // Compute the string's length.
            let strLength := sub(end, str)
            // Move the pointer and write the length.
            str := sub(str, 0x20)
            mstore(str, strLength)
        }
    }

    /// @dev Returns the hexadecimal representation of `value`.
    /// The output is prefixed with "0x", encoded using 2 hexadecimal digits per byte,
    /// and the alphabets are capitalized conditionally according to
    /// https://eips.ethereum.org/EIPS/eip-55
    function toHexStringChecksummed(address value) internal pure returns (string memory str) {
        str = toHexString(value);
        /// @solidity memory-safe-assembly
        assembly {
            let mask := shl(6, div(not(0), 255)) // `0b010000000100000000 ...`
            let o := add(str, 0x22)
            let hashed := and(keccak256(o, 40), mul(34, mask)) // `0b10001000 ... `
            let t := shl(240, 136) // `0b10001000 << 240`
            for { let i := 0 } 1 {} {
                mstore(add(i, i), mul(t, byte(i, hashed)))
                i := add(i, 1)
                if eq(i, 20) { break }
            }
            mstore(o, xor(mload(o), shr(1, and(mload(0x00), and(mload(o), mask)))))
            o := add(o, 0x20)
            mstore(o, xor(mload(o), shr(1, and(mload(0x20), and(mload(o), mask)))))
        }
    }

    /// @dev Returns the hexadecimal representation of `value`.
    /// The output is prefixed with "0x" and encoded using 2 hexadecimal digits per byte.
    function toHexString(address value) internal pure returns (string memory str) {
        str = toHexStringNoPrefix(value);
        /// @solidity memory-safe-assembly
        assembly {
            let strLength := add(mload(str), 2) // Compute the length.
            mstore(str, 0x3078) // Write the "0x" prefix.
            str := sub(str, 2) // Move the pointer.
            mstore(str, strLength) // Write the length.
        }
    }

    /// @dev Returns the hexadecimal representation of `value`.
    /// The output is encoded using 2 hexadecimal digits per byte.
    function toHexStringNoPrefix(address value) internal pure returns (string memory str) {
        /// @solidity memory-safe-assembly
        assembly {
            str := mload(0x40)

            // Allocate the memory.
            // We need 0x20 bytes for the trailing zeros padding, 0x20 bytes for the length,
            // 0x02 bytes for the prefix, and 0x28 bytes for the digits.
            // The next multiple of 0x20 above (0x20 + 0x20 + 0x02 + 0x28) is 0x80.
            mstore(0x40, add(str, 0x80))

            // Store "0123456789abcdef" in scratch space.
            mstore(0x0f, 0x30313233343536373839616263646566)

            str := add(str, 2)
            mstore(str, 40)

            let o := add(str, 0x20)
            mstore(add(o, 40), 0)

            value := shl(96, value)

            // We write the string from rightmost digit to leftmost digit.
            // The following is essentially a do-while loop that also handles the zero case.
            for { let i := 0 } 1 {} {
                let p := add(o, add(i, i))
                let temp := byte(i, value)
                mstore8(add(p, 1), mload(and(temp, 15)))
                mstore8(p, mload(shr(4, temp)))
                i := add(i, 1)
                if eq(i, 20) { break }
            }
        }
    }

    /// @dev Returns the hex encoded string from the raw bytes.
    /// The output is encoded using 2 hexadecimal digits per byte.
    function toHexString(bytes memory raw) internal pure returns (string memory str) {
        str = toHexStringNoPrefix(raw);
        /// @solidity memory-safe-assembly
        assembly {
            let strLength := add(mload(str), 2) // Compute the length.
            mstore(str, 0x3078) // Write the "0x" prefix.
            str := sub(str, 2) // Move the pointer.
            mstore(str, strLength) // Write the length.
        }
    }

    /// @dev Returns the hex encoded string from the raw bytes.
    /// The output is encoded using 2 hexadecimal digits per byte.
    function toHexStringNoPrefix(bytes memory raw) internal pure returns (string memory str) {
        /// @solidity memory-safe-assembly
        assembly {
            let length := mload(raw)
            str := add(mload(0x40), 2) // Skip 2 bytes for the optional prefix.
            mstore(str, add(length, length)) // Store the length of the output.

            // Store "0123456789abcdef" in scratch space.
            mstore(0x0f, 0x30313233343536373839616263646566)

            let o := add(str, 0x20)
            let end := add(raw, length)

            for {} iszero(eq(raw, end)) {} {
                raw := add(raw, 1)
                mstore8(add(o, 1), mload(and(mload(raw), 15)))
                mstore8(o, mload(and(shr(4, mload(raw)), 15)))
                o := add(o, 2)
            }
            mstore(o, 0) // Zeroize the slot after the string.
            mstore(0x40, add(o, 0x20)) // Allocate the memory.
        }
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                   RUNE STRING OPERATIONS                   */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Returns the number of UTF characters in the string.
    function runeCount(string memory s) internal pure returns (uint256 result) {
        /// @solidity memory-safe-assembly
        assembly {
            if mload(s) {
                mstore(0x00, div(not(0), 255))
                mstore(0x20, 0x0202020202020202020202020202020202020202020202020303030304040506)
                let o := add(s, 0x20)
                let end := add(o, mload(s))
                for { result := 1 } 1 { result := add(result, 1) } {
                    o := add(o, byte(0, mload(shr(250, mload(o)))))
                    if iszero(lt(o, end)) { break }
                }
            }
        }
    }

    /// @dev Returns if this string is a 7-bit ASCII string.
    /// (i.e. all characters codes are in [0..127])
    function is7BitASCII(string memory s) internal pure returns (bool result) {
        /// @solidity memory-safe-assembly
        assembly {
            let mask := shl(7, div(not(0), 255))
            result := 1
            let n := mload(s)
            if n {
                let o := add(s, 0x20)
                let end := add(o, n)
                let last := mload(end)
                mstore(end, 0)
                for {} 1 {} {
                    if and(mask, mload(o)) {
                        result := 0
                        break
                    }
                    o := add(o, 0x20)
                    if iszero(lt(o, end)) { break }
                }
                mstore(end, last)
            }
        }
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                   BYTE STRING OPERATIONS                   */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    // For performance and bytecode compactness, byte string operations are restricted
    // to 7-bit ASCII strings. All offsets are byte offsets, not UTF character offsets.
    // Usage of byte string operations on charsets with runes spanning two or more bytes
    // can lead to undefined behavior.

    /// @dev Returns `subject` all occurrences of `search` replaced with `replacement`.
    function replace(string memory subject, string memory search, string memory replacement)
        internal
        pure
        returns (string memory result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            let subjectLength := mload(subject)
            let searchLength := mload(search)
            let replacementLength := mload(replacement)

            subject := add(subject, 0x20)
            search := add(search, 0x20)
            replacement := add(replacement, 0x20)
            result := add(mload(0x40), 0x20)

            let subjectEnd := add(subject, subjectLength)
            if iszero(gt(searchLength, subjectLength)) {
                let subjectSearchEnd := add(sub(subjectEnd, searchLength), 1)
                let h := 0
                if iszero(lt(searchLength, 0x20)) { h := keccak256(search, searchLength) }
                let m := shl(3, sub(0x20, and(searchLength, 0x1f)))
                let s := mload(search)
                for {} 1 {} {
                    let t := mload(subject)
                    // Whether the first `searchLength % 32` bytes of
                    // `subject` and `search` matches.
                    if iszero(shr(m, xor(t, s))) {
                        if h {
                            if iszero(eq(keccak256(subject, searchLength), h)) {
                                mstore(result, t)
                                result := add(result, 1)
                                subject := add(subject, 1)
                                if iszero(lt(subject, subjectSearchEnd)) { break }
                                continue
                            }
                        }
                        // Copy the `replacement` one word at a time.
                        for { let o := 0 } 1 {} {
                            mstore(add(result, o), mload(add(replacement, o)))
                            o := add(o, 0x20)
                            if iszero(lt(o, replacementLength)) { break }
                        }
                        result := add(result, replacementLength)
                        subject := add(subject, searchLength)
                        if searchLength {
                            if iszero(lt(subject, subjectSearchEnd)) { break }
                            continue
                        }
                    }
                    mstore(result, t)
                    result := add(result, 1)
                    subject := add(subject, 1)
                    if iszero(lt(subject, subjectSearchEnd)) { break }
                }
            }

            let resultRemainder := result
            result := add(mload(0x40), 0x20)
            let k := add(sub(resultRemainder, result), sub(subjectEnd, subject))
            // Copy the rest of the string one word at a time.
            for {} lt(subject, subjectEnd) {} {
                mstore(resultRemainder, mload(subject))
                resultRemainder := add(resultRemainder, 0x20)
                subject := add(subject, 0x20)
            }
            result := sub(result, 0x20)
            let last := add(add(result, 0x20), k) // Zeroize the slot after the string.
            mstore(last, 0)
            mstore(0x40, add(last, 0x20)) // Allocate the memory.
            mstore(result, k) // Store the length.
        }
    }

    /// @dev Returns the byte index of the first location of `search` in `subject`,
    /// searching from left to right, starting from `from`.
    /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `search` is not found.
    function indexOf(string memory subject, string memory search, uint256 from)
        internal
        pure
        returns (uint256 result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            for { let subjectLength := mload(subject) } 1 {} {
                if iszero(mload(search)) {
                    if iszero(gt(from, subjectLength)) {
                        result := from
                        break
                    }
                    result := subjectLength
                    break
                }
                let searchLength := mload(search)
                let subjectStart := add(subject, 0x20)

                result := not(0) // Initialize to `NOT_FOUND`.

                subject := add(subjectStart, from)
                let end := add(sub(add(subjectStart, subjectLength), searchLength), 1)

                let m := shl(3, sub(0x20, and(searchLength, 0x1f)))
                let s := mload(add(search, 0x20))

                if iszero(and(lt(subject, end), lt(from, subjectLength))) { break }

                if iszero(lt(searchLength, 0x20)) {
                    for { let h := keccak256(add(search, 0x20), searchLength) } 1 {} {
                        if iszero(shr(m, xor(mload(subject), s))) {
                            if eq(keccak256(subject, searchLength), h) {
                                result := sub(subject, subjectStart)
                                break
                            }
                        }
                        subject := add(subject, 1)
                        if iszero(lt(subject, end)) { break }
                    }
                    break
                }
                for {} 1 {} {
                    if iszero(shr(m, xor(mload(subject), s))) {
                        result := sub(subject, subjectStart)
                        break
                    }
                    subject := add(subject, 1)
                    if iszero(lt(subject, end)) { break }
                }
                break
            }
        }
    }

    /// @dev Returns the byte index of the first location of `search` in `subject`,
    /// searching from left to right.
    /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `search` is not found.
    function indexOf(string memory subject, string memory search)
        internal
        pure
        returns (uint256 result)
    {
        result = indexOf(subject, search, 0);
    }

    /// @dev Returns the byte index of the first location of `search` in `subject`,
    /// searching from right to left, starting from `from`.
    /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `search` is not found.
    function lastIndexOf(string memory subject, string memory search, uint256 from)
        internal
        pure
        returns (uint256 result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            for {} 1 {} {
                result := not(0) // Initialize to `NOT_FOUND`.
                let searchLength := mload(search)
                if gt(searchLength, mload(subject)) { break }
                let w := result

                let fromMax := sub(mload(subject), searchLength)
                if iszero(gt(fromMax, from)) { from := fromMax }

                let end := add(add(subject, 0x20), w)
                subject := add(add(subject, 0x20), from)
                if iszero(gt(subject, end)) { break }
                // As this function is not too often used,
                // we shall simply use keccak256 for smaller bytecode size.
                for { let h := keccak256(add(search, 0x20), searchLength) } 1 {} {
                    if eq(keccak256(subject, searchLength), h) {
                        result := sub(subject, add(end, 1))
                        break
                    }
                    subject := add(subject, w) // `sub(subject, 1)`.
                    if iszero(gt(subject, end)) { break }
                }
                break
            }
        }
    }

    /// @dev Returns the byte index of the first location of `search` in `subject`,
    /// searching from right to left.
    /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `search` is not found.
    function lastIndexOf(string memory subject, string memory search)
        internal
        pure
        returns (uint256 result)
    {
        result = lastIndexOf(subject, search, uint256(int256(-1)));
    }

    /// @dev Returns true if `search` is found in `subject`, false otherwise.
    function contains(string memory subject, string memory search) internal pure returns (bool) {
        return indexOf(subject, search) != NOT_FOUND;
    }

    /// @dev Returns whether `subject` starts with `search`.
    function startsWith(string memory subject, string memory search)
        internal
        pure
        returns (bool result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            let searchLength := mload(search)
            // Just using keccak256 directly is actually cheaper.
            // forgefmt: disable-next-item
            result := and(
                iszero(gt(searchLength, mload(subject))),
                eq(
                    keccak256(add(subject, 0x20), searchLength),
                    keccak256(add(search, 0x20), searchLength)
                )
            )
        }
    }

    /// @dev Returns whether `subject` ends with `search`.
    function endsWith(string memory subject, string memory search)
        internal
        pure
        returns (bool result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            let searchLength := mload(search)
            let subjectLength := mload(subject)
            // Whether `search` is not longer than `subject`.
            let withinRange := iszero(gt(searchLength, subjectLength))
            // Just using keccak256 directly is actually cheaper.
            // forgefmt: disable-next-item
            result := and(
                withinRange,
                eq(
                    keccak256(
                        // `subject + 0x20 + max(subjectLength - searchLength, 0)`.
                        add(add(subject, 0x20), mul(withinRange, sub(subjectLength, searchLength))),
                        searchLength
                    ),
                    keccak256(add(search, 0x20), searchLength)
                )
            )
        }
    }

    /// @dev Returns `subject` repeated `times`.
    function repeat(string memory subject, uint256 times)
        internal
        pure
        returns (string memory result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            let subjectLength := mload(subject)
            if iszero(or(iszero(times), iszero(subjectLength))) {
                subject := add(subject, 0x20)
                result := mload(0x40)
                let output := add(result, 0x20)
                for {} 1 {} {
                    // Copy the `subject` one word at a time.
                    for { let o := 0 } 1 {} {
                        mstore(add(output, o), mload(add(subject, o)))
                        o := add(o, 0x20)
                        if iszero(lt(o, subjectLength)) { break }
                    }
                    output := add(output, subjectLength)
                    times := sub(times, 1)
                    if iszero(times) { break }
                }
                mstore(output, 0) // Zeroize the slot after the string.
                let resultLength := sub(output, add(result, 0x20))
                mstore(result, resultLength) // Store the length.
                // Allocate the memory.
                mstore(0x40, add(result, add(resultLength, 0x20)))
            }
        }
    }

    /// @dev Returns a copy of `subject` sliced from `start` to `end` (exclusive).
    /// `start` and `end` are byte offsets.
    function slice(string memory subject, uint256 start, uint256 end)
        internal
        pure
        returns (string memory result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            let subjectLength := mload(subject)
            if iszero(gt(subjectLength, end)) { end := subjectLength }
            if iszero(gt(subjectLength, start)) { start := subjectLength }
            if lt(start, end) {
                result := mload(0x40)
                let resultLength := sub(end, start)
                mstore(result, resultLength)
                subject := add(subject, start)
                let w := not(0x1f)
                // Copy the `subject` one word at a time, backwards.
                for { let o := and(add(resultLength, 0x1f), w) } 1 {} {
                    mstore(add(result, o), mload(add(subject, o)))
                    o := add(o, w) // `sub(o, 0x20)`.
                    if iszero(o) { break }
                }
                // Zeroize the slot after the string.
                mstore(add(add(result, 0x20), resultLength), 0)
                // Allocate memory for the length and the bytes,
                // rounded up to a multiple of 32.
                mstore(0x40, add(result, and(add(resultLength, 0x3f), w)))
            }
        }
    }

    /// @dev Returns a copy of `subject` sliced from `start` to the end of the string.
    /// `start` is a byte offset.
    function slice(string memory subject, uint256 start)
        internal
        pure
        returns (string memory result)
    {
        result = slice(subject, start, uint256(int256(-1)));
    }

    /// @dev Returns all the indices of `search` in `subject`.
    /// The indices are byte offsets.
    function indicesOf(string memory subject, string memory search)
        internal
        pure
        returns (uint256[] memory result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            let subjectLength := mload(subject)
            let searchLength := mload(search)

            if iszero(gt(searchLength, subjectLength)) {
                subject := add(subject, 0x20)
                search := add(search, 0x20)
                result := add(mload(0x40), 0x20)

                let subjectStart := subject
                let subjectSearchEnd := add(sub(add(subject, subjectLength), searchLength), 1)
                let h := 0
                if iszero(lt(searchLength, 0x20)) { h := keccak256(search, searchLength) }
                let m := shl(3, sub(0x20, and(searchLength, 0x1f)))
                let s := mload(search)
                for {} 1 {} {
                    let t := mload(subject)
                    // Whether the first `searchLength % 32` bytes of
                    // `subject` and `search` matches.
                    if iszero(shr(m, xor(t, s))) {
                        if h {
                            if iszero(eq(keccak256(subject, searchLength), h)) {
                                subject := add(subject, 1)
                                if iszero(lt(subject, subjectSearchEnd)) { break }
                                continue
                            }
                        }
                        // Append to `result`.
                        mstore(result, sub(subject, subjectStart))
                        result := add(result, 0x20)
                        // Advance `subject` by `searchLength`.
                        subject := add(subject, searchLength)
                        if searchLength {
                            if iszero(lt(subject, subjectSearchEnd)) { break }
                            continue
                        }
                    }
                    subject := add(subject, 1)
                    if iszero(lt(subject, subjectSearchEnd)) { break }
                }
                let resultEnd := result
                // Assign `result` to the free memory pointer.
                result := mload(0x40)
                // Store the length of `result`.
                mstore(result, shr(5, sub(resultEnd, add(result, 0x20))))
                // Allocate memory for result.
                // We allocate one more word, so this array can be recycled for {split}.
                mstore(0x40, add(resultEnd, 0x20))
            }
        }
    }

    /// @dev Returns a arrays of strings based on the `delimiter` inside of the `subject` string.
    function split(string memory subject, string memory delimiter)
        internal
        pure
        returns (string[] memory result)
    {
        uint256[] memory indices = indicesOf(subject, delimiter);
        /// @solidity memory-safe-assembly
        assembly {
            let w := not(0x1f)
            let indexPtr := add(indices, 0x20)
            let indicesEnd := add(indexPtr, shl(5, add(mload(indices), 1)))
            mstore(add(indicesEnd, w), mload(subject))
            mstore(indices, add(mload(indices), 1))
            let prevIndex := 0
            for {} 1 {} {
                let index := mload(indexPtr)
                mstore(indexPtr, 0x60)
                if iszero(eq(index, prevIndex)) {
                    let element := mload(0x40)
                    let elementLength := sub(index, prevIndex)
                    mstore(element, elementLength)
                    // Copy the `subject` one word at a time, backwards.
                    for { let o := and(add(elementLength, 0x1f), w) } 1 {} {
                        mstore(add(element, o), mload(add(add(subject, prevIndex), o)))
                        o := add(o, w) // `sub(o, 0x20)`.
                        if iszero(o) { break }
                    }
                    // Zeroize the slot after the string.
                    mstore(add(add(element, 0x20), elementLength), 0)
                    // Allocate memory for the length and the bytes,
                    // rounded up to a multiple of 32.
                    mstore(0x40, add(element, and(add(elementLength, 0x3f), w)))
                    // Store the `element` into the array.
                    mstore(indexPtr, element)
                }
                prevIndex := add(index, mload(delimiter))
                indexPtr := add(indexPtr, 0x20)
                if iszero(lt(indexPtr, indicesEnd)) { break }
            }
            result := indices
            if iszero(mload(delimiter)) {
                result := add(indices, 0x20)
                mstore(result, sub(mload(indices), 2))
            }
        }
    }

    /// @dev Returns a concatenated string of `a` and `b`.
    /// Cheaper than `string.concat()` and does not de-align the free memory pointer.
    function concat(string memory a, string memory b)
        internal
        pure
        returns (string memory result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            let w := not(0x1f)
            result := mload(0x40)
            let aLength := mload(a)
            // Copy `a` one word at a time, backwards.
            for { let o := and(add(aLength, 0x20), w) } 1 {} {
                mstore(add(result, o), mload(add(a, o)))
                o := add(o, w) // `sub(o, 0x20)`.
                if iszero(o) { break }
            }
            let bLength := mload(b)
            let output := add(result, aLength)
            // Copy `b` one word at a time, backwards.
            for { let o := and(add(bLength, 0x20), w) } 1 {} {
                mstore(add(output, o), mload(add(b, o)))
                o := add(o, w) // `sub(o, 0x20)`.
                if iszero(o) { break }
            }
            let totalLength := add(aLength, bLength)
            let last := add(add(result, 0x20), totalLength)
            // Zeroize the slot after the string.
            mstore(last, 0)
            // Stores the length.
            mstore(result, totalLength)
            // Allocate memory for the length and the bytes,
            // rounded up to a multiple of 32.
            mstore(0x40, and(add(last, 0x1f), w))
        }
    }

    /// @dev Returns a copy of the string in either lowercase or UPPERCASE.
    /// WARNING! This function is only compatible with 7-bit ASCII strings.
    function toCase(string memory subject, bool toUpper)
        internal
        pure
        returns (string memory result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            let length := mload(subject)
            if length {
                result := add(mload(0x40), 0x20)
                subject := add(subject, 1)
                let flags := shl(add(70, shl(5, toUpper)), 0x3ffffff)
                let w := not(0)
                for { let o := length } 1 {} {
                    o := add(o, w)
                    let b := and(0xff, mload(add(subject, o)))
                    mstore8(add(result, o), xor(b, and(shr(b, flags), 0x20)))
                    if iszero(o) { break }
                }
                result := mload(0x40)
                mstore(result, length) // Store the length.
                let last := add(add(result, 0x20), length)
                mstore(last, 0) // Zeroize the slot after the string.
                mstore(0x40, add(last, 0x20)) // Allocate the memory.
            }
        }
    }

    /// @dev Returns a string from a small bytes32 string.
    /// `s` must be null-terminated, or behavior will be undefined.
    function fromSmallString(bytes32 s) internal pure returns (string memory result) {
        /// @solidity memory-safe-assembly
        assembly {
            result := mload(0x40)
            let n := 0
            for {} byte(n, s) { n := add(n, 1) } {} // Scan for '\0'.
            mstore(result, n)
            let o := add(result, 0x20)
            mstore(o, s)
            mstore(add(o, n), 0)
            mstore(0x40, add(result, 0x40))
        }
    }

    /// @dev Returns the small string, with all bytes after the first null byte zeroized.
    function normalizeSmallString(bytes32 s) internal pure returns (bytes32 result) {
        /// @solidity memory-safe-assembly
        assembly {
            for {} byte(result, s) { result := add(result, 1) } {} // Scan for '\0'.
            mstore(0x00, s)
            mstore(result, 0x00)
            result := mload(0x00)
        }
    }

    /// @dev Returns the string as a normalized null-terminated small string.
    function toSmallString(string memory s) internal pure returns (bytes32 result) {
        /// @solidity memory-safe-assembly
        assembly {
            result := mload(s)
            if iszero(lt(result, 33)) {
                mstore(0x00, 0xec92f9a3) // `TooBigForSmallString()`.
                revert(0x1c, 0x04)
            }
            result := shl(shl(3, sub(32, result)), mload(add(s, result)))
        }
    }

    /// @dev Returns a lowercased copy of the string.
    /// WARNING! This function is only compatible with 7-bit ASCII strings.
    function lower(string memory subject) internal pure returns (string memory result) {
        result = toCase(subject, false);
    }

    /// @dev Returns an UPPERCASED copy of the string.
    /// WARNING! This function is only compatible with 7-bit ASCII strings.
    function upper(string memory subject) internal pure returns (string memory result) {
        result = toCase(subject, true);
    }

    /// @dev Escapes the string to be used within HTML tags.
    function escapeHTML(string memory s) internal pure returns (string memory result) {
        /// @solidity memory-safe-assembly
        assembly {
            let end := add(s, mload(s))
            result := add(mload(0x40), 0x20)
            // Store the bytes of the packed offsets and strides into the scratch space.
            // `packed = (stride << 5) | offset`. Max offset is 20. Max stride is 6.
            mstore(0x1f, 0x900094)
            mstore(0x08, 0xc0000000a6ab)
            // Store "&quot;&amp;&#39;&lt;&gt;" into the scratch space.
            mstore(0x00, shl(64, 0x2671756f743b26616d703b262333393b266c743b2667743b))
            for {} iszero(eq(s, end)) {} {
                s := add(s, 1)
                let c := and(mload(s), 0xff)
                // Not in `["\"","'","&","<",">"]`.
                if iszero(and(shl(c, 1), 0x500000c400000000)) {
                    mstore8(result, c)
                    result := add(result, 1)
                    continue
                }
                let t := shr(248, mload(c))
                mstore(result, mload(and(t, 0x1f)))
                result := add(result, shr(5, t))
            }
            let last := result
            mstore(last, 0) // Zeroize the slot after the string.
            result := mload(0x40)
            mstore(result, sub(last, add(result, 0x20))) // Store the length.
            mstore(0x40, add(last, 0x20)) // Allocate the memory.
        }
    }

    /// @dev Escapes the string to be used within double-quotes in a JSON.
    /// If `addDoubleQuotes` is true, the result will be enclosed in double-quotes.
    function escapeJSON(string memory s, bool addDoubleQuotes)
        internal
        pure
        returns (string memory result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            let end := add(s, mload(s))
            result := add(mload(0x40), 0x20)
            if addDoubleQuotes {
                mstore8(result, 34)
                result := add(1, result)
            }
            // Store "\\u0000" in scratch space.
            // Store "0123456789abcdef" in scratch space.
            // Also, store `{0x08:"b", 0x09:"t", 0x0a:"n", 0x0c:"f", 0x0d:"r"}`.
            // into the scratch space.
            mstore(0x15, 0x5c75303030303031323334353637383961626364656662746e006672)
            // Bitmask for detecting `["\"","\\"]`.
            let e := or(shl(0x22, 1), shl(0x5c, 1))
            for {} iszero(eq(s, end)) {} {
                s := add(s, 1)
                let c := and(mload(s), 0xff)
                if iszero(lt(c, 0x20)) {
                    if iszero(and(shl(c, 1), e)) {
                        // Not in `["\"","\\"]`.
                        mstore8(result, c)
                        result := add(result, 1)
                        continue
                    }
                    mstore8(result, 0x5c) // "\\".
                    mstore8(add(result, 1), c)
                    result := add(result, 2)
                    continue
                }
                if iszero(and(shl(c, 1), 0x3700)) {
                    // Not in `["\b","\t","\n","\f","\d"]`.
                    mstore8(0x1d, mload(shr(4, c))) // Hex value.
                    mstore8(0x1e, mload(and(c, 15))) // Hex value.
                    mstore(result, mload(0x19)) // "\\u00XX".
                    result := add(result, 6)
                    continue
                }
                mstore8(result, 0x5c) // "\\".
                mstore8(add(result, 1), mload(add(c, 8)))
                result := add(result, 2)
            }
            if addDoubleQuotes {
                mstore8(result, 34)
                result := add(1, result)
            }
            let last := result
            mstore(last, 0) // Zeroize the slot after the string.
            result := mload(0x40)
            mstore(result, sub(last, add(result, 0x20))) // Store the length.
            mstore(0x40, add(last, 0x20)) // Allocate the memory.
        }
    }

    /// @dev Escapes the string to be used within double-quotes in a JSON.
    function escapeJSON(string memory s) internal pure returns (string memory result) {
        result = escapeJSON(s, false);
    }

    /// @dev Returns whether `a` equals `b`.
    function eq(string memory a, string memory b) internal pure returns (bool result) {
        /// @solidity memory-safe-assembly
        assembly {
            result := eq(keccak256(add(a, 0x20), mload(a)), keccak256(add(b, 0x20), mload(b)))
        }
    }

    /// @dev Returns whether `a` equals `b`, where `b` is a null-terminated small string.
    function eqs(string memory a, bytes32 b) internal pure returns (bool result) {
        /// @solidity memory-safe-assembly
        assembly {
            // These should be evaluated on compile time, as far as possible.
            let m := not(shl(7, div(not(iszero(b)), 255))) // `0x7f7f ...`.
            let x := not(or(m, or(b, add(m, and(b, m)))))
            let r := shl(7, iszero(iszero(shr(128, x))))
            r := or(r, shl(6, iszero(iszero(shr(64, shr(r, x))))))
            r := or(r, shl(5, lt(0xffffffff, shr(r, x))))
            r := or(r, shl(4, lt(0xffff, shr(r, x))))
            r := or(r, shl(3, lt(0xff, shr(r, x))))
            // forgefmt: disable-next-item
            result := gt(eq(mload(a), add(iszero(x), xor(31, shr(3, r)))),
                xor(shr(add(8, r), b), shr(add(8, r), mload(add(a, 0x20)))))
        }
    }

    /// @dev Packs a single string with its length into a single word.
    /// Returns `bytes32(0)` if the length is zero or greater than 31.
    function packOne(string memory a) internal pure returns (bytes32 result) {
        /// @solidity memory-safe-assembly
        assembly {
            // We don't need to zero right pad the string,
            // since this is our own custom non-standard packing scheme.
            result :=
                mul(
                    // Load the length and the bytes.
                    mload(add(a, 0x1f)),
                    // `length != 0 && length < 32`. Abuses underflow.
                    // Assumes that the length is valid and within the block gas limit.
                    lt(sub(mload(a), 1), 0x1f)
                )
        }
    }

    /// @dev Unpacks a string packed using {packOne}.
    /// Returns the empty string if `packed` is `bytes32(0)`.
    /// If `packed` is not an output of {packOne}, the output behavior is undefined.
    function unpackOne(bytes32 packed) internal pure returns (string memory result) {
        /// @solidity memory-safe-assembly
        assembly {
            // Grab the free memory pointer.
            result := mload(0x40)
            // Allocate 2 words (1 for the length, 1 for the bytes).
            mstore(0x40, add(result, 0x40))
            // Zeroize the length slot.
            mstore(result, 0)
            // Store the length and bytes.
            mstore(add(result, 0x1f), packed)
            // Right pad with zeroes.
            mstore(add(add(result, 0x20), mload(result)), 0)
        }
    }

    /// @dev Packs two strings with their lengths into a single word.
    /// Returns `bytes32(0)` if combined length is zero or greater than 30.
    function packTwo(string memory a, string memory b) internal pure returns (bytes32 result) {
        /// @solidity memory-safe-assembly
        assembly {
            let aLength := mload(a)
            // We don't need to zero right pad the strings,
            // since this is our own custom non-standard packing scheme.
            result :=
                mul(
                    // Load the length and the bytes of `a` and `b`.
                    or(
                        shl(shl(3, sub(0x1f, aLength)), mload(add(a, aLength))),
                        mload(sub(add(b, 0x1e), aLength))
                    ),
                    // `totalLength != 0 && totalLength < 31`. Abuses underflow.
                    // Assumes that the lengths are valid and within the block gas limit.
                    lt(sub(add(aLength, mload(b)), 1), 0x1e)
                )
        }
    }

    /// @dev Unpacks strings packed using {packTwo}.
    /// Returns the empty strings if `packed` is `bytes32(0)`.
    /// If `packed` is not an output of {packTwo}, the output behavior is undefined.
    function unpackTwo(bytes32 packed)
        internal
        pure
        returns (string memory resultA, string memory resultB)
    {
        /// @solidity memory-safe-assembly
        assembly {
            // Grab the free memory pointer.
            resultA := mload(0x40)
            resultB := add(resultA, 0x40)
            // Allocate 2 words for each string (1 for the length, 1 for the byte). Total 4 words.
            mstore(0x40, add(resultB, 0x40))
            // Zeroize the length slots.
            mstore(resultA, 0)
            mstore(resultB, 0)
            // Store the lengths and bytes.
            mstore(add(resultA, 0x1f), packed)
            mstore(add(resultB, 0x1f), mload(add(add(resultA, 0x20), mload(resultA))))
            // Right pad with zeroes.
            mstore(add(add(resultA, 0x20), mload(resultA)), 0)
            mstore(add(add(resultB, 0x20), mload(resultB)), 0)
        }
    }

    /// @dev Directly returns `a` without copying.
    function directReturn(string memory a) internal pure {
        assembly {
            // Assumes that the string does not start from the scratch space.
            let retStart := sub(a, 0x20)
            let retSize := add(mload(a), 0x40)
            // Right pad with zeroes. Just in case the string is produced
            // by a method that doesn't zero right pad.
            mstore(add(retStart, retSize), 0)
            // Store the return offset.
            mstore(retStart, 0x20)
            // End the transaction, returning the string.
            return(retStart, retSize)
        }
    }
}

pragma solidity ^0.8.4;


/// @notice Simple single owner and multiroles authorization mixin.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/auth/Ownable.sol)
/// @dev While the ownable portion follows [EIP-173](https://eips.ethereum.org/EIPS/eip-173)
/// for compatibility, the nomenclature for the 2-step ownership handover and roles
/// may be unique to this codebase.
abstract contract OwnableRoles is Ownable {
    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                           EVENTS                           */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The `user`'s roles is updated to `roles`.
    /// Each bit of `roles` represents whether the role is set.
    event RolesUpdated(address indexed user, uint256 indexed roles);

    /// @dev `keccak256(bytes("RolesUpdated(address,uint256)"))`.
    uint256 private constant _ROLES_UPDATED_EVENT_SIGNATURE =
        0x715ad5ce61fc9595c7b415289d59cf203f23a94fa06f04af7e489a0a76e1fe26;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                          STORAGE                           */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The role slot of `user` is given by:
    /// ```
    ///     mstore(0x00, or(shl(96, user), _ROLE_SLOT_SEED))
    ///     let roleSlot := keccak256(0x00, 0x20)
    /// ```
    /// This automatically ignores the upper bits of the `user` in case
    /// they are not clean, as well as keep the `keccak256` under 32-bytes.
    ///
    /// Note: This is equivalent to `uint32(bytes4(keccak256("_OWNER_SLOT_NOT")))`.
    uint256 private constant _ROLE_SLOT_SEED = 0x8b78c6d8;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                     INTERNAL FUNCTIONS                     */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Overwrite the roles directly without authorization guard.
    function _setRoles(address user, uint256 roles) internal virtual {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x0c, _ROLE_SLOT_SEED)
            mstore(0x00, user)
            // Store the new value.
            sstore(keccak256(0x0c, 0x20), roles)
            // Emit the {RolesUpdated} event.
            log3(0, 0, _ROLES_UPDATED_EVENT_SIGNATURE, shr(96, mload(0x0c)), roles)
        }
    }

    /// @dev Updates the roles directly without authorization guard.
    /// If `on` is true, each set bit of `roles` will be turned on,
    /// otherwise, each set bit of `roles` will be turned off.
    function _updateRoles(address user, uint256 roles, bool on) internal virtual {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x0c, _ROLE_SLOT_SEED)
            mstore(0x00, user)
            let roleSlot := keccak256(0x0c, 0x20)
            // Load the current value.
            let current := sload(roleSlot)
            // Compute the updated roles if `on` is true.
            let updated := or(current, roles)
            // Compute the updated roles if `on` is false.
            // Use `and` to compute the intersection of `current` and `roles`,
            // `xor` it with `current` to flip the bits in the intersection.
            if iszero(on) { updated := xor(current, and(current, roles)) }
            // Then, store the new value.
            sstore(roleSlot, updated)
            // Emit the {RolesUpdated} event.
            log3(0, 0, _ROLES_UPDATED_EVENT_SIGNATURE, shr(96, mload(0x0c)), updated)
        }
    }

    /// @dev Grants the roles directly without authorization guard.
    /// Each bit of `roles` represents the role to turn on.
    function _grantRoles(address user, uint256 roles) internal virtual {
        _updateRoles(user, roles, true);
    }

    /// @dev Removes the roles directly without authorization guard.
    /// Each bit of `roles` represents the role to turn off.
    function _removeRoles(address user, uint256 roles) internal virtual {
        _updateRoles(user, roles, false);
    }

    /// @dev Throws if the sender does not have any of the `roles`.
    function _checkRoles(uint256 roles) internal view virtual {
        /// @solidity memory-safe-assembly
        assembly {
            // Compute the role slot.
            mstore(0x0c, _ROLE_SLOT_SEED)
            mstore(0x00, caller())
            // Load the stored value, and if the `and` intersection
            // of the value and `roles` is zero, revert.
            if iszero(and(sload(keccak256(0x0c, 0x20)), roles)) {
                mstore(0x00, 0x82b42900) // `Unauthorized()`.
                revert(0x1c, 0x04)
            }
        }
    }

    /// @dev Throws if the sender is not the owner,
    /// and does not have any of the `roles`.
    /// Checks for ownership first, then lazily checks for roles.
    function _checkOwnerOrRoles(uint256 roles) internal view virtual {
        /// @solidity memory-safe-assembly
        assembly {
            // If the caller is not the stored owner.
            // Note: `_ROLE_SLOT_SEED` is equal to `_OWNER_SLOT_NOT`.
            if iszero(eq(caller(), sload(not(_ROLE_SLOT_SEED)))) {
                // Compute the role slot.
                mstore(0x0c, _ROLE_SLOT_SEED)
                mstore(0x00, caller())
                // Load the stored value, and if the `and` intersection
                // of the value and `roles` is zero, revert.
                if iszero(and(sload(keccak256(0x0c, 0x20)), roles)) {
                    mstore(0x00, 0x82b42900) // `Unauthorized()`.
                    revert(0x1c, 0x04)
                }
            }
        }
    }

    /// @dev Throws if the sender does not have any of the `roles`,
    /// and is not the owner.
    /// Checks for roles first, then lazily checks for ownership.
    function _checkRolesOrOwner(uint256 roles) internal view virtual {
        /// @solidity memory-safe-assembly
        assembly {
            // Compute the role slot.
            mstore(0x0c, _ROLE_SLOT_SEED)
            mstore(0x00, caller())
            // Load the stored value, and if the `and` intersection
            // of the value and `roles` is zero, revert.
            if iszero(and(sload(keccak256(0x0c, 0x20)), roles)) {
                // If the caller is not the stored owner.
                // Note: `_ROLE_SLOT_SEED` is equal to `_OWNER_SLOT_NOT`.
                if iszero(eq(caller(), sload(not(_ROLE_SLOT_SEED)))) {
                    mstore(0x00, 0x82b42900) // `Unauthorized()`.
                    revert(0x1c, 0x04)
                }
            }
        }
    }

    /// @dev Convenience function to return a `roles` bitmap from an array of `ordinals`.
    /// This is meant for frontends like Etherscan, and is therefore not fully optimized.
    /// Not recommended to be called on-chain.
    /// Made internal to conserve bytecode. Wrap it in a public function if needed.
    function _rolesFromOrdinals(uint8[] memory ordinals) internal pure returns (uint256 roles) {
        /// @solidity memory-safe-assembly
        assembly {
            for { let i := shl(5, mload(ordinals)) } i { i := sub(i, 0x20) } {
                // We don't need to mask the values of `ordinals`, as Solidity
                // cleans dirty upper bits when storing variables into memory.
                roles := or(shl(mload(add(ordinals, i)), 1), roles)
            }
        }
    }

    /// @dev Convenience function to return an array of `ordinals` from the `roles` bitmap.
    /// This is meant for frontends like Etherscan, and is therefore not fully optimized.
    /// Not recommended to be called on-chain.
    /// Made internal to conserve bytecode. Wrap it in a public function if needed.
    function _ordinalsFromRoles(uint256 roles) internal pure returns (uint8[] memory ordinals) {
        /// @solidity memory-safe-assembly
        assembly {
            // Grab the pointer to the free memory.
            ordinals := mload(0x40)
            let ptr := add(ordinals, 0x20)
            let o := 0
            // The absence of lookup tables, De Bruijn, etc., here is intentional for
            // smaller bytecode, as this function is not meant to be called on-chain.
            for { let t := roles } 1 {} {
                mstore(ptr, o)
                // `shr` 5 is equivalent to multiplying by 0x20.
                // Push back into the ordinals array if the bit is set.
                ptr := add(ptr, shl(5, and(t, 1)))
                o := add(o, 1)
                t := shr(o, roles)
                if iszero(t) { break }
            }
            // Store the length of `ordinals`.
            mstore(ordinals, shr(5, sub(ptr, add(ordinals, 0x20))))
            // Allocate the memory.
            mstore(0x40, ptr)
        }
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                  PUBLIC UPDATE FUNCTIONS                   */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Allows the owner to grant `user` `roles`.
    /// If the `user` already has a role, then it will be an no-op for the role.
    function grantRoles(address user, uint256 roles) public payable virtual onlyOwner {
        _grantRoles(user, roles);
    }

    /// @dev Allows the owner to remove `user` `roles`.
    /// If the `user` does not have a role, then it will be an no-op for the role.
    function revokeRoles(address user, uint256 roles) public payable virtual onlyOwner {
        _removeRoles(user, roles);
    }

    /// @dev Allow the caller to remove their own roles.
    /// If the caller does not have a role, then it will be an no-op for the role.
    function renounceRoles(uint256 roles) public payable virtual {
        _removeRoles(msg.sender, roles);
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                   PUBLIC READ FUNCTIONS                    */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Returns the roles of `user`.
    function rolesOf(address user) public view virtual returns (uint256 roles) {
        /// @solidity memory-safe-assembly
        assembly {
            // Compute the role slot.
            mstore(0x0c, _ROLE_SLOT_SEED)
            mstore(0x00, user)
            // Load the stored value.
            roles := sload(keccak256(0x0c, 0x20))
        }
    }

    /// @dev Returns whether `user` has any of `roles`.
    function hasAnyRole(address user, uint256 roles) public view virtual returns (bool) {
        return rolesOf(user) & roles != 0;
    }

    /// @dev Returns whether `user` has all of `roles`.
    function hasAllRoles(address user, uint256 roles) public view virtual returns (bool) {
        return rolesOf(user) & roles == roles;
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                         MODIFIERS                          */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Marks a function as only callable by an account with `roles`.
    modifier onlyRoles(uint256 roles) virtual {
        _checkRoles(roles);
        _;
    }

    /// @dev Marks a function as only callable by the owner or by an account
    /// with `roles`. Checks for ownership first, then lazily checks for roles.
    modifier onlyOwnerOrRoles(uint256 roles) virtual {
        _checkOwnerOrRoles(roles);
        _;
    }

    /// @dev Marks a function as only callable by an account with `roles`
    /// or the owner. Checks for roles first, then lazily checks for ownership.
    modifier onlyRolesOrOwner(uint256 roles) virtual {
        _checkRolesOrOwner(roles);
        _;
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                       ROLE CONSTANTS                       */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    // IYKYK

    uint256 internal constant _ROLE_0 = 1 << 0;
    uint256 internal constant _ROLE_1 = 1 << 1;
    uint256 internal constant _ROLE_2 = 1 << 2;
    uint256 internal constant _ROLE_3 = 1 << 3;
    uint256 internal constant _ROLE_4 = 1 << 4;
    uint256 internal constant _ROLE_5 = 1 << 5;
    uint256 internal constant _ROLE_6 = 1 << 6;
    uint256 internal constant _ROLE_7 = 1 << 7;
    uint256 internal constant _ROLE_8 = 1 << 8;
    uint256 internal constant _ROLE_9 = 1 << 9;
    uint256 internal constant _ROLE_10 = 1 << 10;
    uint256 internal constant _ROLE_11 = 1 << 11;
    uint256 internal constant _ROLE_12 = 1 << 12;
    uint256 internal constant _ROLE_13 = 1 << 13;
    uint256 internal constant _ROLE_14 = 1 << 14;
    uint256 internal constant _ROLE_15 = 1 << 15;
    uint256 internal constant _ROLE_16 = 1 << 16;
    uint256 internal constant _ROLE_17 = 1 << 17;
    uint256 internal constant _ROLE_18 = 1 << 18;
    uint256 internal constant _ROLE_19 = 1 << 19;
    uint256 internal constant _ROLE_20 = 1 << 20;
    uint256 internal constant _ROLE_21 = 1 << 21;
    uint256 internal constant _ROLE_22 = 1 << 22;
    uint256 internal constant _ROLE_23 = 1 << 23;
    uint256 internal constant _ROLE_24 = 1 << 24;
    uint256 internal constant _ROLE_25 = 1 << 25;
    uint256 internal constant _ROLE_26 = 1 << 26;
    uint256 internal constant _ROLE_27 = 1 << 27;
    uint256 internal constant _ROLE_28 = 1 << 28;
    uint256 internal constant _ROLE_29 = 1 << 29;
    uint256 internal constant _ROLE_30 = 1 << 30;
    uint256 internal constant _ROLE_31 = 1 << 31;
    uint256 internal constant _ROLE_32 = 1 << 32;
    uint256 internal constant _ROLE_33 = 1 << 33;
    uint256 internal constant _ROLE_34 = 1 << 34;
    uint256 internal constant _ROLE_35 = 1 << 35;
    uint256 internal constant _ROLE_36 = 1 << 36;
    uint256 internal constant _ROLE_37 = 1 << 37;
    uint256 internal constant _ROLE_38 = 1 << 38;
    uint256 internal constant _ROLE_39 = 1 << 39;
    uint256 internal constant _ROLE_40 = 1 << 40;
    uint256 internal constant _ROLE_41 = 1 << 41;
    uint256 internal constant _ROLE_42 = 1 << 42;
    uint256 internal constant _ROLE_43 = 1 << 43;
    uint256 internal constant _ROLE_44 = 1 << 44;
    uint256 internal constant _ROLE_45 = 1 << 45;
    uint256 internal constant _ROLE_46 = 1 << 46;
    uint256 internal constant _ROLE_47 = 1 << 47;
    uint256 internal constant _ROLE_48 = 1 << 48;
    uint256 internal constant _ROLE_49 = 1 << 49;
    uint256 internal constant _ROLE_50 = 1 << 50;
    uint256 internal constant _ROLE_51 = 1 << 51;
    uint256 internal constant _ROLE_52 = 1 << 52;
    uint256 internal constant _ROLE_53 = 1 << 53;
    uint256 internal constant _ROLE_54 = 1 << 54;
    uint256 internal constant _ROLE_55 = 1 << 55;
    uint256 internal constant _ROLE_56 = 1 << 56;
    uint256 internal constant _ROLE_57 = 1 << 57;
    uint256 internal constant _ROLE_58 = 1 << 58;
    uint256 internal constant _ROLE_59 = 1 << 59;
    uint256 internal constant _ROLE_60 = 1 << 60;
    uint256 internal constant _ROLE_61 = 1 << 61;
    uint256 internal constant _ROLE_62 = 1 << 62;
    uint256 internal constant _ROLE_63 = 1 << 63;
    uint256 internal constant _ROLE_64 = 1 << 64;
    uint256 internal constant _ROLE_65 = 1 << 65;
    uint256 internal constant _ROLE_66 = 1 << 66;
    uint256 internal constant _ROLE_67 = 1 << 67;
    uint256 internal constant _ROLE_68 = 1 << 68;
    uint256 internal constant _ROLE_69 = 1 << 69;
    uint256 internal constant _ROLE_70 = 1 << 70;
    uint256 internal constant _ROLE_71 = 1 << 71;
    uint256 internal constant _ROLE_72 = 1 << 72;
    uint256 internal constant _ROLE_73 = 1 << 73;
    uint256 internal constant _ROLE_74 = 1 << 74;
    uint256 internal constant _ROLE_75 = 1 << 75;
    uint256 internal constant _ROLE_76 = 1 << 76;
    uint256 internal constant _ROLE_77 = 1 << 77;
    uint256 internal constant _ROLE_78 = 1 << 78;
    uint256 internal constant _ROLE_79 = 1 << 79;
    uint256 internal constant _ROLE_80 = 1 << 80;
    uint256 internal constant _ROLE_81 = 1 << 81;
    uint256 internal constant _ROLE_82 = 1 << 82;
    uint256 internal constant _ROLE_83 = 1 << 83;
    uint256 internal constant _ROLE_84 = 1 << 84;
    uint256 internal constant _ROLE_85 = 1 << 85;
    uint256 internal constant _ROLE_86 = 1 << 86;
    uint256 internal constant _ROLE_87 = 1 << 87;
    uint256 internal constant _ROLE_88 = 1 << 88;
    uint256 internal constant _ROLE_89 = 1 << 89;
    uint256 internal constant _ROLE_90 = 1 << 90;
    uint256 internal constant _ROLE_91 = 1 << 91;
    uint256 internal constant _ROLE_92 = 1 << 92;
    uint256 internal constant _ROLE_93 = 1 << 93;
    uint256 internal constant _ROLE_94 = 1 << 94;
    uint256 internal constant _ROLE_95 = 1 << 95;
    uint256 internal constant _ROLE_96 = 1 << 96;
    uint256 internal constant _ROLE_97 = 1 << 97;
    uint256 internal constant _ROLE_98 = 1 << 98;
    uint256 internal constant _ROLE_99 = 1 << 99;
    uint256 internal constant _ROLE_100 = 1 << 100;
    uint256 internal constant _ROLE_101 = 1 << 101;
    uint256 internal constant _ROLE_102 = 1 << 102;
    uint256 internal constant _ROLE_103 = 1 << 103;
    uint256 internal constant _ROLE_104 = 1 << 104;
    uint256 internal constant _ROLE_105 = 1 << 105;
    uint256 internal constant _ROLE_106 = 1 << 106;
    uint256 internal constant _ROLE_107 = 1 << 107;
    uint256 internal constant _ROLE_108 = 1 << 108;
    uint256 internal constant _ROLE_109 = 1 << 109;
    uint256 internal constant _ROLE_110 = 1 << 110;
    uint256 internal constant _ROLE_111 = 1 << 111;
    uint256 internal constant _ROLE_112 = 1 << 112;
    uint256 internal constant _ROLE_113 = 1 << 113;
    uint256 internal constant _ROLE_114 = 1 << 114;
    uint256 internal constant _ROLE_115 = 1 << 115;
    uint256 internal constant _ROLE_116 = 1 << 116;
    uint256 internal constant _ROLE_117 = 1 << 117;
    uint256 internal constant _ROLE_118 = 1 << 118;
    uint256 internal constant _ROLE_119 = 1 << 119;
    uint256 internal constant _ROLE_120 = 1 << 120;
    uint256 internal constant _ROLE_121 = 1 << 121;
    uint256 internal constant _ROLE_122 = 1 << 122;
    uint256 internal constant _ROLE_123 = 1 << 123;
    uint256 internal constant _ROLE_124 = 1 << 124;
    uint256 internal constant _ROLE_125 = 1 << 125;
    uint256 internal constant _ROLE_126 = 1 << 126;
    uint256 internal constant _ROLE_127 = 1 << 127;
    uint256 internal constant _ROLE_128 = 1 << 128;
    uint256 internal constant _ROLE_129 = 1 << 129;
    uint256 internal constant _ROLE_130 = 1 << 130;
    uint256 internal constant _ROLE_131 = 1 << 131;
    uint256 internal constant _ROLE_132 = 1 << 132;
    uint256 internal constant _ROLE_133 = 1 << 133;
    uint256 internal constant _ROLE_134 = 1 << 134;
    uint256 internal constant _ROLE_135 = 1 << 135;
    uint256 internal constant _ROLE_136 = 1 << 136;
    uint256 internal constant _ROLE_137 = 1 << 137;
    uint256 internal constant _ROLE_138 = 1 << 138;
    uint256 internal constant _ROLE_139 = 1 << 139;
    uint256 internal constant _ROLE_140 = 1 << 140;
    uint256 internal constant _ROLE_141 = 1 << 141;
    uint256 internal constant _ROLE_142 = 1 << 142;
    uint256 internal constant _ROLE_143 = 1 << 143;
    uint256 internal constant _ROLE_144 = 1 << 144;
    uint256 internal constant _ROLE_145 = 1 << 145;
    uint256 internal constant _ROLE_146 = 1 << 146;
    uint256 internal constant _ROLE_147 = 1 << 147;
    uint256 internal constant _ROLE_148 = 1 << 148;
    uint256 internal constant _ROLE_149 = 1 << 149;
    uint256 internal constant _ROLE_150 = 1 << 150;
    uint256 internal constant _ROLE_151 = 1 << 151;
    uint256 internal constant _ROLE_152 = 1 << 152;
    uint256 internal constant _ROLE_153 = 1 << 153;
    uint256 internal constant _ROLE_154 = 1 << 154;
    uint256 internal constant _ROLE_155 = 1 << 155;
    uint256 internal constant _ROLE_156 = 1 << 156;
    uint256 internal constant _ROLE_157 = 1 << 157;
    uint256 internal constant _ROLE_158 = 1 << 158;
    uint256 internal constant _ROLE_159 = 1 << 159;
    uint256 internal constant _ROLE_160 = 1 << 160;
    uint256 internal constant _ROLE_161 = 1 << 161;
    uint256 internal constant _ROLE_162 = 1 << 162;
    uint256 internal constant _ROLE_163 = 1 << 163;
    uint256 internal constant _ROLE_164 = 1 << 164;
    uint256 internal constant _ROLE_165 = 1 << 165;
    uint256 internal constant _ROLE_166 = 1 << 166;
    uint256 internal constant _ROLE_167 = 1 << 167;
    uint256 internal constant _ROLE_168 = 1 << 168;
    uint256 internal constant _ROLE_169 = 1 << 169;
    uint256 internal constant _ROLE_170 = 1 << 170;
    uint256 internal constant _ROLE_171 = 1 << 171;
    uint256 internal constant _ROLE_172 = 1 << 172;
    uint256 internal constant _ROLE_173 = 1 << 173;
    uint256 internal constant _ROLE_174 = 1 << 174;
    uint256 internal constant _ROLE_175 = 1 << 175;
    uint256 internal constant _ROLE_176 = 1 << 176;
    uint256 internal constant _ROLE_177 = 1 << 177;
    uint256 internal constant _ROLE_178 = 1 << 178;
    uint256 internal constant _ROLE_179 = 1 << 179;
    uint256 internal constant _ROLE_180 = 1 << 180;
    uint256 internal constant _ROLE_181 = 1 << 181;
    uint256 internal constant _ROLE_182 = 1 << 182;
    uint256 internal constant _ROLE_183 = 1 << 183;
    uint256 internal constant _ROLE_184 = 1 << 184;
    uint256 internal constant _ROLE_185 = 1 << 185;
    uint256 internal constant _ROLE_186 = 1 << 186;
    uint256 internal constant _ROLE_187 = 1 << 187;
    uint256 internal constant _ROLE_188 = 1 << 188;
    uint256 internal constant _ROLE_189 = 1 << 189;
    uint256 internal constant _ROLE_190 = 1 << 190;
    uint256 internal constant _ROLE_191 = 1 << 191;
    uint256 internal constant _ROLE_192 = 1 << 192;
    uint256 internal constant _ROLE_193 = 1 << 193;
    uint256 internal constant _ROLE_194 = 1 << 194;
    uint256 internal constant _ROLE_195 = 1 << 195;
    uint256 internal constant _ROLE_196 = 1 << 196;
    uint256 internal constant _ROLE_197 = 1 << 197;
    uint256 internal constant _ROLE_198 = 1 << 198;
    uint256 internal constant _ROLE_199 = 1 << 199;
    uint256 internal constant _ROLE_200 = 1 << 200;
    uint256 internal constant _ROLE_201 = 1 << 201;
    uint256 internal constant _ROLE_202 = 1 << 202;
    uint256 internal constant _ROLE_203 = 1 << 203;
    uint256 internal constant _ROLE_204 = 1 << 204;
    uint256 internal constant _ROLE_205 = 1 << 205;
    uint256 internal constant _ROLE_206 = 1 << 206;
    uint256 internal constant _ROLE_207 = 1 << 207;
    uint256 internal constant _ROLE_208 = 1 << 208;
    uint256 internal constant _ROLE_209 = 1 << 209;
    uint256 internal constant _ROLE_210 = 1 << 210;
    uint256 internal constant _ROLE_211 = 1 << 211;
    uint256 internal constant _ROLE_212 = 1 << 212;
    uint256 internal constant _ROLE_213 = 1 << 213;
    uint256 internal constant _ROLE_214 = 1 << 214;
    uint256 internal constant _ROLE_215 = 1 << 215;
    uint256 internal constant _ROLE_216 = 1 << 216;
    uint256 internal constant _ROLE_217 = 1 << 217;
    uint256 internal constant _ROLE_218 = 1 << 218;
    uint256 internal constant _ROLE_219 = 1 << 219;
    uint256 internal constant _ROLE_220 = 1 << 220;
    uint256 internal constant _ROLE_221 = 1 << 221;
    uint256 internal constant _ROLE_222 = 1 << 222;
    uint256 internal constant _ROLE_223 = 1 << 223;
    uint256 internal constant _ROLE_224 = 1 << 224;
    uint256 internal constant _ROLE_225 = 1 << 225;
    uint256 internal constant _ROLE_226 = 1 << 226;
    uint256 internal constant _ROLE_227 = 1 << 227;
    uint256 internal constant _ROLE_228 = 1 << 228;
    uint256 internal constant _ROLE_229 = 1 << 229;
    uint256 internal constant _ROLE_230 = 1 << 230;
    uint256 internal constant _ROLE_231 = 1 << 231;
    uint256 internal constant _ROLE_232 = 1 << 232;
    uint256 internal constant _ROLE_233 = 1 << 233;
    uint256 internal constant _ROLE_234 = 1 << 234;
    uint256 internal constant _ROLE_235 = 1 << 235;
    uint256 internal constant _ROLE_236 = 1 << 236;
    uint256 internal constant _ROLE_237 = 1 << 237;
    uint256 internal constant _ROLE_238 = 1 << 238;
    uint256 internal constant _ROLE_239 = 1 << 239;
    uint256 internal constant _ROLE_240 = 1 << 240;
    uint256 internal constant _ROLE_241 = 1 << 241;
    uint256 internal constant _ROLE_242 = 1 << 242;
    uint256 internal constant _ROLE_243 = 1 << 243;
    uint256 internal constant _ROLE_244 = 1 << 244;
    uint256 internal constant _ROLE_245 = 1 << 245;
    uint256 internal constant _ROLE_246 = 1 << 246;
    uint256 internal constant _ROLE_247 = 1 << 247;
    uint256 internal constant _ROLE_248 = 1 << 248;
    uint256 internal constant _ROLE_249 = 1 << 249;
    uint256 internal constant _ROLE_250 = 1 << 250;
    uint256 internal constant _ROLE_251 = 1 << 251;
    uint256 internal constant _ROLE_252 = 1 << 252;
    uint256 internal constant _ROLE_253 = 1 << 253;
    uint256 internal constant _ROLE_254 = 1 << 254;
    uint256 internal constant _ROLE_255 = 1 << 255;
}

pragma solidity ^0.8.4;

contract HiddenOne is DN404, OwnableRoles {
    using DailyOutflowCounterLib for *;

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                         CONSTANTS                          */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    uint256 public constant ADMIN_ROLE = _ROLE_0;

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                       CUSTOM ERRORS                        */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    error Locked();

    error MaxBalanceLimitReached();

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                          STORAGE                           */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    string internal _name;

    string internal _symbol;

    string internal _baseURI;

    bool public baseURILocked;

    bool public nameAndSymbolLocked;

    bool public gasBurnFactorLocked;

    bool public whitelistLocked;

    bool public maxBalanceLimitLocked;

    uint8 public maxBalanceLimit;

    uint32 public gasBurnFactor;

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                        CONSTRUCTOR                         */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    constructor(address _mirror) {
        _construct(tx.origin);
        initialize(_mirror);
    }

    function _construct(address initialOwner) internal {
        _initializeOwner(initialOwner);
        _setWhitelisted(initialOwner, true);
        _name = "Hidden One 404";
        _symbol = "HIDDEN404";
        gasBurnFactor = 0;
        maxBalanceLimit = 1;
        _baseURI = "ipfs://QmbbADovzdA9g4otjaPpuBdNz2roARe31i142MWeqVkyEm/{id}.json";
    }

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                          METADATA                          */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    function name() public view override returns (string memory) {
        return _name;
    }

    function symbol() public view override returns (string memory) {
        return _symbol;
    }

    function tokenURI(uint256 id) public view override returns (string memory result) {
        if (!_exists(id)) revert TokenDoesNotExist();
        if (bytes(_baseURI).length != 0) {
            result = LibString.replace(_baseURI, "{id}", LibString.toString(id));
        }
    }

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                         TRANSFERS                          */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    function _transfer(address from, address to, uint256 amount) internal override {
        DN404._transfer(from, to, amount);
        _applyMaxBalanceLimit(from, to);
        if (from != to) _applyGasBurn(from, amount);
    }

    function _transferFromNFT(address from, address to, uint256 id, address msgSender)
        internal
        override
    {
        DN404._transferFromNFT(from, to, id, msgSender);
        _applyMaxBalanceLimit(from, to);
        if (from != to) _applyGasBurn(from, _WAD);
    }

    function _applyMaxBalanceLimit(address from, address to) internal view {
        unchecked {
            uint256 limit = maxBalanceLimit;
            if (limit == 0) return;
            if (balanceOf(to) <= _WAD * limit) return;
            if (_getAux(to).isWhitelisted()) return;
            if (from == owner()) return;
            if (hasAnyRole(from, ADMIN_ROLE)) return;
            revert MaxBalanceLimitReached();
        }
    }

    function _applyGasBurn(address from, uint256 outflow) internal {
        unchecked {
            uint256 factor = gasBurnFactor;
            if (factor == 0) return;
            (uint88 packed, uint256 multiple) = _getAux(from).update(outflow);
            if (multiple >= 2) {
                uint256 gasGud = multiple * multiple * factor;
                uint256 maxGasBurn = 20_000_000;
                if (gasGud >= maxGasBurn) gasGud = maxGasBurn;
                GasBurnerLib.burn(gasGud);
            }
            _setAux(from, packed);
        }
    }

    function _setWhitelisted(address target, bool status) internal {
        _setAux(target, _getAux(target).setWhitelisted(status));
    }

    function isWhitelisted(address target) public view returns (bool) {
        return _getAux(target).isWhitelisted();
    }

    /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/
    /*                      ADMIN FUNCTIONS                       */
    /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/

    function initialize(address mirror) public onlyOwnerOrRoles(ADMIN_ROLE) {
        uint256 initialTokenSupply = 1 * _WAD;
        address initialSupplyOwner = msg.sender;
        _initializeDN404(initialTokenSupply, initialSupplyOwner, mirror);
        _setWhitelisted(initialSupplyOwner, true);
    }

    function lockMaxBalanceLimit() public onlyOwnerOrRoles(ADMIN_ROLE) {
        maxBalanceLimitLocked = true;
    }

    function setMaxBalanceLimit(uint8 value) public onlyOwnerOrRoles(ADMIN_ROLE) {
        if (maxBalanceLimitLocked) revert Locked();
        maxBalanceLimit = value;
    }

    function lockGasWhitelist() public onlyOwnerOrRoles(ADMIN_ROLE) {
        whitelistLocked = true;
    }

    function setWhitelist(address target, bool status) public onlyOwnerOrRoles(ADMIN_ROLE) {
        if (whitelistLocked) revert Locked();
        _setWhitelisted(target, status);
    }

    function lockGasBurnFactor() public onlyOwnerOrRoles(ADMIN_ROLE) {
        gasBurnFactorLocked = true;
    }

    function setGasBurnFactor(uint32 gasBurnFactor_) public onlyOwnerOrRoles(ADMIN_ROLE) {
        if (gasBurnFactorLocked) revert Locked();
        gasBurnFactor = gasBurnFactor_;
    }

    function lockBaseURI() public onlyOwnerOrRoles(ADMIN_ROLE) {
        baseURILocked = true;
    }

    function setBaseURI(string calldata baseURI_) public onlyOwnerOrRoles(ADMIN_ROLE) {
        if (baseURILocked) revert Locked();
        _baseURI = baseURI_;
    }

    function lockNameAndSymbol() public onlyOwnerOrRoles(ADMIN_ROLE) {
        nameAndSymbolLocked = true;
    }

    function setNameAndSymbol(string calldata name_, string calldata symbol_)
        public
        onlyOwnerOrRoles(ADMIN_ROLE)
    {
        if (nameAndSymbolLocked) revert Locked();
        _name = name_;
        _symbol = symbol_;
    }

    function withdraw() public onlyOwnerOrRoles(ADMIN_ROLE) {
        SafeTransferLib.safeTransferAllETH(msg.sender);
    }
}

Contract Security Audit

Contract ABI

[{"inputs":[{"internalType":"address","name":"_mirror","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AlreadyInitialized","type":"error"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"DNAlreadyInitialized","type":"error"},{"inputs":[],"name":"InsufficientAllowance","type":"error"},{"inputs":[],"name":"InsufficientBalance","type":"error"},{"inputs":[],"name":"LinkMirrorContractFailed","type":"error"},{"inputs":[],"name":"Locked","type":"error"},{"inputs":[],"name":"MaxBalanceLimitReached","type":"error"},{"inputs":[],"name":"MirrorAddressIsZero","type":"error"},{"inputs":[],"name":"NewOwnerIsZeroAddress","type":"error"},{"inputs":[],"name":"NoHandoverRequest","type":"error"},{"inputs":[],"name":"SenderNotMirror","type":"error"},{"inputs":[],"name":"TokenDoesNotExist","type":"error"},{"inputs":[],"name":"TotalSupplyOverflow","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"pendingOwner","type":"address"}],"name":"OwnershipHandoverCanceled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"pendingOwner","type":"address"}],"name":"OwnershipHandoverRequested","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"user","type":"address"},{"indexed":true,"internalType":"uint256","name":"roles","type":"uint256"}],"name":"RolesUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"target","type":"address"},{"indexed":false,"internalType":"bool","name":"status","type":"bool"}],"name":"SkipNFTSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Transfer","type":"event"},{"stateMutability":"payable","type":"fallback"},{"inputs":[],"name":"ADMIN_ROLE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseURILocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"cancelOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"completeOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"gasBurnFactor","outputs":[{"internalType":"uint32","name":"","type":"uint32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"gasBurnFactorLocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"a","type":"address"}],"name":"getSkipNFT","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"grantRoles","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"hasAllRoles","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"hasAnyRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"mirror","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"target","type":"address"}],"name":"isWhitelisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lockBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"lockGasBurnFactor","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"lockGasWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"lockMaxBalanceLimit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"lockNameAndSymbol","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"maxBalanceLimit","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxBalanceLimitLocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"mirrorERC721","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nameAndSymbolLocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"result","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"ownershipHandoverExpiresAt","outputs":[{"internalType":"uint256","name":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"renounceRoles","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"requestOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"revokeRoles","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"rolesOf","outputs":[{"internalType":"uint256","name":"roles","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"baseURI_","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint32","name":"gasBurnFactor_","type":"uint32"}],"name":"setGasBurnFactor","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint8","name":"value","type":"uint8"}],"name":"setMaxBalanceLimit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"}],"name":"setNameAndSymbol","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"skipNFT","type":"bool"}],"name":"setSkipNFT","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"target","type":"address"},{"internalType":"bool","name":"status","type":"bool"}],"name":"setWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"result","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"whitelistLocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"stateMutability":"payable","type":"receive"}]

608060405234801562000010575f80fd5b506040516200364638038062003646833981016040819052620000339162000578565b6200003e3262000050565b620000498162000111565b506200072c565b6200005b8162000157565b6200006881600162000193565b60408051808201909152600e81526d121a5919195b8813db99480d0c0d60921b60208201525f906200009b90826200063c565b506040805180820190915260098152681212511111538d0c0d60ba1b6020820152600190620000cb90826200063c565b506003805464ffffffffff60281b1916650100000000001790556040805160608101909152603f8082526200360760208301396002906200010d90826200063c565b5050565b60016200011e816200021d565b5f62000134670de0b6b3a7640000600162000708565b9050336200014482828662000250565b6200015181600162000193565b50505050565b6001600160a01b0316638b78c6d819819055805f7f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08180a35b50565b6200010d82620001dd83620001cd836001600160a01b03165f90815268a20d6e21d0e525531060205260409020546001600160581b031690565b6001600160581b031690620003f3565b6001600160a01b03919091165f90815268a20d6e21d0e52553106020526040902080546001600160581b0319166001600160581b03909216919091179055565b638b78c6d8195433146200019057638b78c6d8600c52335f52806020600c20541662000190576382b429005f526004601cfd5b68a20d6e21d0e52553088054640100000000900463ffffffff16156200028957604051633ab534b960e21b815260040160405180910390fd5b6001600160a01b038216620002b1576040516339a84a7b60e01b815260040160405180910390fd5b620002bc826200042a565b805463ffffffff60201b19166401000000001781556001810180546001600160a01b0384166001600160a01b0319909116179055831562000151576001600160a01b0383166200031f57604051633a954ecd60e21b815260040160405180910390fd5b6b0de0b6b39983494c589bffff8411156200034d5760405163e5cfe95760e01b815260040160405180910390fd5b8054600160601b600160c01b0319166c010000000000000000000000006001600160601b038616021781555f620003848462000458565b80546001600160a01b03908116600160a01b6001600160601b038916021782556040518781529192508516905f907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a3620003ec846001620004d5565b5050505050565b5f811515620004078460571c600116151590565b15151462000421576a800000000000000000000092909218915b50815b92915050565b630f4599e55f523360205260205f6024601c5f855af160015f511416620001905763d125259c5f526004601cfd5b6001600160a01b0381165f90815268a20d6e21d0e5255310602052604081208054909168a20d6e21d0e5255308916b01000000000000000000000090046001169003620004cf576001833b15620004ad576002175b825460ff9091166b0100000000000000000000000260ff60581b199091161782555b50919050565b5f620004e18362000458565b80549091506b01000000000000000000000090046002161515821515146200052d57805460ff6b01000000000000000000000080830482166002189091160260ff60581b199091161781555b826001600160a01b03167fb5a1de456fff688115a4f75380060c23c8532d14ff85f687cc871456d6420393836040516200056b911515815260200190565b60405180910390a2505050565b5f6020828403121562000589575f80fd5b81516001600160a01b0381168114620005a0575f80fd5b9392505050565b634e487b7160e01b5f52604160045260245ffd5b600181811c90821680620005d057607f821691505b602082108103620004cf57634e487b7160e01b5f52602260045260245ffd5b601f8211156200063757805f5260205f20601f840160051c81016020851015620006165750805b601f840160051c820191505b81811015620003ec575f815560010162000622565b505050565b81516001600160401b03811115620006585762000658620005a7565b6200067081620006698454620005bb565b84620005ef565b602080601f831160018114620006a6575f84156200068e5750858301515b5f19600386901b1c1916600185901b17855562000700565b5f85815260208120601f198616915b82811015620006d657888601518255948401946001909101908401620006b5565b5085821015620006f457878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b80820281158282048414176200042457634e487b7160e01b5f52601160045260245ffd5b612ecd806200073a5f395ff3fe60806040526004361061030b575f3560e01c806353df5c7c11610199578063af6900c3116100e0578063d73c1fb311610089578063f04e283e11610063578063f04e283e14610c71578063f2fde38b14610c84578063fee81cf414610c9757610312565b8063d73c1fb314610be4578063dd62ed3e14610c04578063e436744514610c5057610312565b8063bbefa83a116100ba578063bbefa83a14610b92578063c4d66de814610ba6578063c87b56dd14610bc557610312565b8063af6900c314610b40578063b19de39f14610b54578063b698206914610b7357610312565b806370a08231116101425780638da5cb5b1161011c5780638da5cb5b14610af557806395d89b4114610b0d578063a9059cbb14610b2157610312565b806370a0823114610a88578063715018a614610ad957806375b238fc14610ae157610312565b80635a446215116101735780635a44621514610a3c5780635d148e5c14610a5b5780636338cb8a14610a7457610312565b806353df5c7c14610a0157806354d1f13d14610a1557806355f804b314610a1d57610312565b8063274e430b1161025d57806347f618a511610206578063514e62fc116101e0578063514e62fc146109725780635327bba3146109a757806353d6fd59146109e257610312565b806347f618a5146109075780634a4ee7b1146109265780634ef41efc1461093957610312565b8063313ce56711610237578063313ce567146108c15780633af32abf146108d45780633ccfd60b146108f357610312565b8063274e430b146108525780632a6a935d146108715780632de948071461089057610312565b8063183a4f6e116102bf57806323b848ff1161029957806323b848ff1461081757806323b872dd1461082b578063256929621461084a57610312565b8063183a4f6e146107bc5780631c10893f146107cf5780631cd64df4146107e257610312565b8063095ea7b3116102f0578063095ea7b314610734578063180434a31461076357806318160ddd1461078157610312565b806304dfe79d146106da57806306fdde031461071357610312565b3661031257005b68a20d6e21d0e52553085f3560e01c63e985e9c58190036103b45760018201546001600160a01b0316331461035a5760405163ce5a776b60e01b815260040160405180910390fd5b6044361015610367575f80fd5b6004356001600160a01b038181165f908152600385016020908152604080832060243594851684529091529020546103b19060ff166103a6575f6103a9565b60015b60ff16610cc8565b50505b80636352211e036104185760018201546001600160a01b031633146103ec5760405163ce5a776b60e01b815260040160405180910390fd5b60243610156103f9575f80fd5b60043561041661040882610cd0565b6001600160a01b0316610cc8565b505b8063e5eb36c8036104845760018201546001600160a01b031633146104505760405163ce5a776b60e01b815260040160405180910390fd5b608436101561045d575f80fd5b60043560243560443560643561047584848484610d06565b61047f6001610cc8565b505050505b8063813500fc0361051c5760018201546001600160a01b031633146104bc5760405163ce5a776b60e01b815260040160405180910390fd5b60643610156104c9575f80fd5b6001600160a01b036044358181165f90815268a20d6e21d0e525530b6020908152604080832060043595861684529091529020805460ff19166024351515908117909155906105186001610cc8565b5050505b8063d10b6e0c0361057c5760018201546001600160a01b031633146105545760405163ce5a776b60e01b815260040160405180910390fd5b6064361015610561575f80fd5b600435602435604435610578610408848484610d4d565b5050505b8063081812fc036105d25760018201546001600160a01b031633146105b45760405163ce5a776b60e01b815260040160405180910390fd5b60243610156105c1575f80fd5b6004356105d061040882610e59565b505b8063f5b100ea036106585760018201546001600160a01b0316331461060a5760405163ce5a776b60e01b815260040160405180910390fd5b6024361015610617575f80fd5b600435610656610651826001600160a01b03165f90815268a20d6e21d0e5255310602052604090205463ffffffff600160801b9091041690565b610cc8565b505b8063e2c79281036106c35760018201546001600160a01b031633146106905760405163ce5a776b60e01b815260040160405180910390fd5b600436101561069d575f80fd5b68a20d6e21d0e5255308546106c39068010000000000000000900463ffffffff16610cc8565b8063b7a94eb8036106d8576106d86001610cc8565b005b3480156106e5575f80fd5b506003546106fc9065010000000000900460ff1681565b60405160ff90911681526020015b60405180910390f35b34801561071e575f80fd5b50610727610ea3565b60405161070a9190612a32565b34801561073f575f80fd5b5061075361074e366004612a94565b610f32565b604051901515815260200161070a565b34801561076e575f80fd5b5060035461075390610100900460ff1681565b34801561078c575f80fd5b5068a20d6e21d0e525530854600160601b90046bffffffffffffffffffffffff165b60405190815260200161070a565b6106d86107ca366004612abc565b610fa6565b6106d86107dd366004612a94565b610fb3565b3480156107ed575f80fd5b506107536107fc366004612a94565b638b78c6d8600c9081525f9290925260209091205481161490565b348015610822575f80fd5b506106d8610fc9565b348015610836575f80fd5b50610753610845366004612ad3565b610fec565b6106d86110a5565b34801561085d575f80fd5b5061075361086c366004612b0c565b6110f2565b34801561087c575f80fd5b506106d861088b366004612b34565b611140565b34801561089b575f80fd5b506107ae6108aa366004612b0c565b638b78c6d8600c9081525f91909152602090205490565b3480156108cc575f80fd5b5060126106fc565b3480156108df575f80fd5b506107536108ee366004612b0c565b61114a565b3480156108fe575f80fd5b506106d8611187565b348015610912575f80fd5b506003546107539062010000900460ff1681565b6106d8610934366004612a94565b61119b565b348015610944575f80fd5b5068a20d6e21d0e5255309546001600160a01b03165b6040516001600160a01b03909116815260200161070a565b34801561097d575f80fd5b5061075361098c366004612a94565b638b78c6d8600c9081525f9290925260209091205416151590565b3480156109b2575f80fd5b506003546109cd906601000000000000900463ffffffff1681565b60405163ffffffff909116815260200161070a565b3480156109ed575f80fd5b506106d86109fc366004612b4d565b6111ad565b348015610a0c575f80fd5b506106d86111f2565b6106d861120d565b348015610a28575f80fd5b506106d8610a37366004612bbc565b611246565b348015610a47575f80fd5b506106d8610a56366004612bfb565b611282565b348015610a66575f80fd5b506003546107539060ff1681565b348015610a7f575f80fd5b506106d86112d8565b348015610a93575f80fd5b506107ae610aa2366004612b0c565b6001600160a01b03165f90815268a20d6e21d0e52553106020526040902054600160a01b90046bffffffffffffffffffffffff1690565b6106d86112f5565b348015610aec575f80fd5b506107ae600181565b348015610b00575f80fd5b50638b78c6d8195461095a565b348015610b18575f80fd5b50610727611308565b348015610b2c575f80fd5b50610753610b3b366004612a94565b611317565b348015610b4b575f80fd5b506106d861132c565b348015610b5f575f80fd5b506106d8610b6e366004612c62565b61134d565b348015610b7e575f80fd5b506106d8610b8d366004612c85565b6113af565b348015610b9d575f80fd5b506106d861140b565b348015610bb1575f80fd5b506106d8610bc0366004612b0c565b61142a565b348015610bd0575f80fd5b50610727610bdf366004612abc565b611462565b348015610bef575f80fd5b50600354610753906301000000900460ff1681565b348015610c0f575f80fd5b506107ae610c1e366004612ca5565b6001600160a01b039182165f90815268a20d6e21d0e525530d6020908152604080832093909416825291909152205490565b348015610c5b575f80fd5b5060035461075390640100000000900460ff1681565b6106d8610c7f366004612b0c565b611573565b6106d8610c92366004612b0c565b6115ad565b348015610ca2575f80fd5b506107ae610cb1366004612b0c565b63389a75e1600c9081525f91909152602090205490565b805f5260205ff35b5f610cda826115d3565b610cf75760405163677510db60e11b815260040160405180910390fd5b610d00826115ef565b92915050565b610d1284848484611642565b610d1c8484611a85565b826001600160a01b0316846001600160a01b031614610d4757610d4784670de0b6b3a7640000611ba2565b50505050565b5f68a20d6e21d0e52553088168a20d6e21d0e525530a81610d9968a20d6e21d0e525530f600189901b5b600381901c5f90815260209290925260409091205460059190911b60e0161c90565b63ffffffff16815260208101919091526040015f20546001600160a01b03908116915084168114610e24576001600160a01b038082165f90815260038401602090815260408083209388168352929052205460ff16610e24576040517fcfb3b94200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f8581526004909201602052604090912080546001600160a01b0387166001600160a01b031990911617905590509392505050565b5f610e63826115d3565b610e805760405163677510db60e11b815260040160405180910390fd5b505f90815268a20d6e21d0e525530c60205260409020546001600160a01b031690565b60605f8054610eb190612ccd565b80601f0160208091040260200160405190810160405280929190818152602001828054610edd90612ccd565b8015610f285780601f10610eff57610100808354040283529160200191610f28565b820191905f5260205f20905b815481529060010190602001808311610f0b57829003601f168201915b5050505050905090565b5f8068a20d6e21d0e5255308335f81815260058301602090815260408083206001600160a01b038a16808552908352928190208890555187815293945090927f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a35060019392505050565b610fb03382611c83565b50565b610fbb611c8e565b610fc58282611ca8565b5050565b6001610fd481611cb4565b506003805464ff000000001916640100000000179055565b6001600160a01b0383165f90815268a20d6e21d0e525530d6020908152604080832033845290915281205468a20d6e21d0e5255308905f19811461108e5780841115611064576040517f13be252b00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0386165f9081526005830160209081526040808320338452909152902084820390555b611099868686611ce5565b50600195945050505050565b5f6202a30067ffffffffffffffff164201905063389a75e1600c52335f52806020600c2055337fdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d5f80a250565b6001600160a01b0381165f90815268a20d6e21d0e5255310602052604081208054600160581b9004600116820361112d57823b5b9392505050565b54600160581b9004600216151592915050565b610fb03382611d1d565b6001600160a01b0381165f90815268a20d6e21d0e52553106020526040812054610d00906affffffffffffffffffffff165b60571c600116151590565b600161119281611cb4565b610fb033611db4565b6111a3611c8e565b610fc58282611c83565b60016111b881611cb4565b6003546301000000900460ff16156111e3576040516303cb96db60e21b815260040160405180910390fd5b6111ed8383611dcd565b505050565b60016111fd81611cb4565b506003805460ff19166001179055565b63389a75e1600c52335f525f6020600c2055337ffa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c925f80a2565b600161125181611cb4565b60035460ff1615611275576040516303cb96db60e21b815260040160405180910390fd5b6002610d47838583612d57565b600161128d81611cb4565b600354610100900460ff16156112b6576040516303cb96db60e21b815260040160405180910390fd5b5f6112c2858783612d57565b5060016112d0838583612d57565b505050505050565b60016112e381611cb4565b506003805461ff001916610100179055565b6112fd611c8e565b6113065f611e63565b565b606060018054610eb190612ccd565b5f611323338484611ce5565b50600192915050565b600161133781611cb4565b506003805463ff00000019166301000000179055565b600161135881611cb4565b60035462010000900460ff1615611382576040516303cb96db60e21b815260040160405180910390fd5b506003805463ffffffff90921666010000000000000269ffffffff00000000000019909216919091179055565b60016113ba81611cb4565b600354640100000000900460ff16156113e6576040516303cb96db60e21b815260040160405180910390fd5b506003805460ff909216650100000000000265ff000000000019909216919091179055565b600161141681611cb4565b506003805462ff0000191662010000179055565b600161143581611cb4565b5f611449670de0b6b3a76400006001612e25565b905033611457828286611ea0565b610d47816001611dcd565b606061146d826115d3565b61148a5760405163677510db60e11b815260040160405180910390fd5b6002805461149790612ccd565b15905061156e57610d00600280546114ae90612ccd565b80601f01602080910402602001604051908101604052809291908181526020018280546114da90612ccd565b80156115255780601f106114fc57610100808354040283529160200191611525565b820191905f5260205f20905b81548152906001019060200180831161150857829003601f168201915b50505050506040518060400160405280600481526020017f7b69647d0000000000000000000000000000000000000000000000000000000081525061156985612093565b6120d5565b919050565b61157b611c8e565b63389a75e1600c52805f526020600c2080544211156115a157636f5e88185f526004601cfd5b5f9055610fb081611e63565b6115b5611c8e565b8060601b6115ca57637448fbae5f526004601cfd5b610fb081611e63565b5f806115de836115ef565b6001600160a01b0316141592915050565b5f68a20d6e21d0e525530868a20d6e21d0e525530a8261161c68a20d6e21d0e525530f600187901b610d77565b63ffffffff16815260208101919091526040015f20546001600160a01b03169392505050565b68a20d6e21d0e52553086001600160a01b03841661167357604051633a954ecd60e21b815260040160405180910390fd5b5f816002015f61168a84600701610d778860011b90565b63ffffffff16815260208101919091526040015f20546001600160a01b039081169150861681146116e7576040517fa114810000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b856001600160a01b0316836001600160a01b031614611782576001600160a01b038087165f90815260038401602090815260408083209387168352929052205460ff16611782575f8481526004830160205260409020546001600160a01b03848116911614611782576040517f59c896be00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f61178c876121f5565b90505f611798876121f5565b8254909150670de0b6b3a76400009083906014906117cc908490600160a01b90046bffffffffffffffffffffffff16612e3c565b82546101009290920a6bffffffffffffffffffffffff81810219909316918316021790915582546001600160a01b038116670de0b6b3a7640000600160a01b92839004841601909216021782555061186260078501600188901b611830848b612268565b826020528160031c5f5260405f206007831660051b815463ffffffff8482841c188116831b8218845550505050505050565b5f868152600485016020908152604080832080546001600160a01b03191690556001600160a01b038b168352600687018252808320855463ffffffff60801b198116600160801b9182900463ffffffff9081165f1901908116909202178755631fffffff600382901c168552925282205460059190911b60e0161c6001600160a01b038a165f908152600687016020526040902063ffffffff919091169150611950906119176007880160018b811b01610d77565b63ffffffff1683826020528160031c5f5260405f206007831660051b815463ffffffff8482841c188116831b8218845550505050505050565b8154600163ffffffff600160801b80840482169283019091160263ffffffff60801b199092169190911783556119a26007870161199084600190811b0190565b61183060078a0160018d811b01610d77565b6001600160a01b0389165f9081526006870160209081526040808320909152600383901c82529020805460e0600584901b1681811c8b1863ffffffff16901b189055611a246007870160018a811b0183826020528160031c5f5260405f206007831660051b815463ffffffff8482841c188116831b8218845550505050505050565b5050866001600160a01b0316886001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef670de0b6b3a7640000604051611a7391815260200190565b60405180910390a35050505050505050565b60035465010000000000900460ff165f819003611aa157505050565b6001600160a01b0382165f90815268a20d6e21d0e52553106020526040902054670de0b6b3a7640000820290600160a01b90046bffffffffffffffffffffffff1611611aec57505050565b611b2261117c836001600160a01b03165f90815268a20d6e21d0e525531060205260409020546affffffffffffffffffffff1690565b15611b2c57505050565b638b78c6d819546001600160a01b0316836001600160a01b031603611b5057505050565b638b78c6d8600c9081525f849052602090205460011615611b7057505050565b6040517f0f2acbfc00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6003546601000000000000900463ffffffff165f819003611bc257505050565b5f80611c0e84611bfb876001600160a01b03165f90815268a20d6e21d0e525531060205260409020546affffffffffffffffffffff1690565b6affffffffffffffffffffff1690612320565b9150915060028110611c3b5780800283026301312d00808210611c2f578091505b611c3882612394565b50505b6001600160a01b0385165f90815268a20d6e21d0e52553106020526040902080546affffffffffffffffffffff19166affffffffffffffffffffff84161790555b5050505050565b610fc582825f6123c7565b638b78c6d819543314611306576382b429005f526004601cfd5b610fc5828260016123c7565b638b78c6d819543314610fb057638b78c6d8600c52335f52806020600c205416610fb0576382b429005f526004601cfd5b611cf083838361241e565b611cfa8383611a85565b816001600160a01b0316836001600160a01b0316146111ed576111ed8382611ba2565b5f611d27836121f5565b8054909150600160581b9004600216151582151514611d6a57805460ff600160581b8083048216600218909116026bff0000000000000000000000199091161781555b826001600160a01b03167fb5a1de456fff688115a4f75380060c23c8532d14ff85f687cc871456d642039383604051611da7911515815260200190565b60405180910390a2505050565b5f385f3847855af1610fb05763b12d13eb5f526004601cfd5b610fc582611e1b83611e08866001600160a01b03165f90815268a20d6e21d0e525531060205260409020546affffffffffffffffffffff1690565b6affffffffffffffffffffff16906129a2565b6001600160a01b03919091165f90815268a20d6e21d0e52553106020526040902080546affffffffffffffffffffff19166affffffffffffffffffffff909216919091179055565b638b78c6d81980546001600160a01b039092169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e05f80a355565b68a20d6e21d0e52553088054640100000000900463ffffffff1615611ef1576040517fead4d2e400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b038216611f31576040517f39a84a7b00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b611f3a826129ce565b805467ffffffff0000000019166401000000001781556001810180546001600160a01b0384166001600160a01b03199091161790558315610d47576001600160a01b038316611f9c57604051633a954ecd60e21b815260040160405180910390fd5b6b0de0b6b39983494c589bffff841115611fe2576040517fe5cfe95700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b80547fffffffffffffffff000000000000000000000000ffffffffffffffffffffffff16600160601b6bffffffffffffffffffffffff8616021781555f612028846121f5565b80546001600160a01b03908116600160a01b6bffffffffffffffffffffffff8916021782556040518781529192508516905f907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a3611c7c846001611d1d565b60606080604051019050602081016040525f8152805f19835b928101926030600a8206018453600a9004806120ac575050819003601f19909101908152919050565b606083518351835160208701965060208601955060208501945060206040510193508287018383116121a5576001838203015f6020851061211557508388205b601f851660200360031b89515b8b51818118831c61218c57831561215c5783888e201461215c57808a5260019c8d019c90990198848d1061215657506121a0565b50612122565b5f5b8b8101518b82015260200187811061215e57509b87019b98860198871561218c57848d1061215657506121a0565b895260019b8c019b90980197838c10612122575b505050505b84935060206040510194508781038585030192505b808810156121d55787518452602097880197909301926121ba565b50505f818401908152602001604052601f19909201918252509392505050565b6001600160a01b0381165f90815268a20d6e21d0e5255310602052604081208054909168a20d6e21d0e525530891600160581b90046001169003612262576001833b15612240576002175b825460ff909116600160581b026bff0000000000000000000000199091161782555b50919050565b8154600160601b900463ffffffff1668a20d6e21d0e52553085f82900361231957805481905f9061229e9063ffffffff16612e61565b825463ffffffff8083166101009490940a848102910219909116179092558554600160601b82027fffffffffffffffffffffffffffffffff00000000ffffffffffffffffffffffff9091161786555f908152600283016020526040902080546001600160a01b0386166001600160a01b031990911617905591505b5092915050565b5f80605784901c6001161561233957508290505f61238d565b637fffffff620151804204811690603886901c1666ffffffffffffff861681831461236457508190505f5b60389190911b66ffffffffffffff602887901c811692909201918216179350620de0b690049150505b9250929050565b80600117601052605b810460788211025f5b8181146123bc57601080802090526001016123a6565b5050601051610fb057fe5b638b78c6d8600c52825f526020600c208054838117836123e8575080841681185b80835580600c5160601c7f715ad5ce61fc9595c7b415289d59cf203f23a94fa06f04af7e489a0a76e1fe265f80a3505050505050565b6001600160a01b03821661244557604051633a954ecd60e21b815260040160405180910390fd5b68a20d6e21d0e52553085f612459856121f5565b90505f612465856121f5565b905061249a6040518060c001604052805f81526020015f81526020015f81526020015f81526020015f81526020015f81525090565b825463ffffffff600160801b808304821660808501528454041660a08301526bffffffffffffffffffffffff600160a01b909104166040820181905285111561250f576040517ff4d678b800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6040810180518690039081905283546bffffffffffffffffffffffff808316600160a01b9081026001600160a01b03938416178755855481810483168a0160608701819052909216029116178355608082015161257d91670de0b6b3a7640000906064020480821191030290565b81528154600160581b90046002165f036125ee57856001600160a01b0316876001600160a01b0316036125b857805160808201510360a08201525b6125e8670de0b6b3a76400008260600151606402816125d9576125d9612e83565b048260a0015180821191030290565b60208201525b5f6126358260200151835f01510160408051808201909152606081525f60208201526040805101828152806020018360051b81016040528183528083602001525050919050565b82519091501561275c576001600160a01b0388165f908152600686016020526040902060808301518351875463ffffffff6801000000000000000080830482168490038216026bffffffff0000000000000000199092169190911789558754918303908116600160801b0263ffffffff60801b199092169190911787555b5f1991909101600381901c5f90815260208490526040812054919291600584901b60e0161c60078a01602052633fffffff600282901c165f90815260409020805460c0600684901b1681811c67ffffffffffffffff16901b18905563ffffffff1690505f81815260048a016020908152604090912080546001600160a01b0319169055858101805160608f901b600885901b1760011781529091019052508082036126b3575050505b60208201511561292a576001600160a01b0387165f9081526006860160209081526040822060a08501519185015190929082019061279a878c612268565b895460208801516801000000000000000080830463ffffffff9081169092018216026bffffffff0000000000000000198316178c558954858216600160801b0263ffffffff60801b19909116178a55919250670de0b6b3a7640000600160601b82046bffffffffffffffffffffffff908116606402160491640100000000909104165b61282e8b600701610d778360011b90565b63ffffffff161561284d5760010181811115612848575060015b61281d565b6020869052600385901c5f90815260409020805460e0600588901b1681811c841863ffffffff16901b18905560078b016020908152600282901c5f90815260409020805460c0600685901b1681811c9389901b63ffffffff8816179390931867ffffffffffffffff1690921b90911890556001909401936128ed878e835f8360200151818360081b8560601b171781526020810185602001525050505050565b600101818111156128fc575060015b83850361281d578a5463ffffffff9091166401000000000267ffffffff0000000019909116178a5550505050505b8051511561294b57600185015461294b9082906001600160a01b03166129fb565b50856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8760405161299191815260200190565b60405180910390a350505050505050565b5f6001605784901c161515821515146129c7576a800000000000000000000092909218915b5090919050565b630f4599e55f523360205260205f6024601c5f855af160015f511416610fb05763d125259c5f526004601cfd5b81516040810363263c69d68152602080820152815160051b604401915060208183601c84015f875af1600182511416610d47575f81fd5b5f602080835283518060208501525f5b81811015612a5e57858101830151858201604001528201612a42565b505f604082860101526040601f19601f8301168501019250505092915050565b80356001600160a01b038116811461156e575f80fd5b5f8060408385031215612aa5575f80fd5b612aae83612a7e565b946020939093013593505050565b5f60208284031215612acc575f80fd5b5035919050565b5f805f60608486031215612ae5575f80fd5b612aee84612a7e565b9250612afc60208501612a7e565b9150604084013590509250925092565b5f60208284031215612b1c575f80fd5b61112682612a7e565b8035801515811461156e575f80fd5b5f60208284031215612b44575f80fd5b61112682612b25565b5f8060408385031215612b5e575f80fd5b612b6783612a7e565b9150612b7560208401612b25565b90509250929050565b5f8083601f840112612b8e575f80fd5b50813567ffffffffffffffff811115612ba5575f80fd5b60208301915083602082850101111561238d575f80fd5b5f8060208385031215612bcd575f80fd5b823567ffffffffffffffff811115612be3575f80fd5b612bef85828601612b7e565b90969095509350505050565b5f805f8060408587031215612c0e575f80fd5b843567ffffffffffffffff80821115612c25575f80fd5b612c3188838901612b7e565b90965094506020870135915080821115612c49575f80fd5b50612c5687828801612b7e565b95989497509550505050565b5f60208284031215612c72575f80fd5b813563ffffffff81168114611126575f80fd5b5f60208284031215612c95575f80fd5b813560ff81168114611126575f80fd5b5f8060408385031215612cb6575f80fd5b612cbf83612a7e565b9150612b7560208401612a7e565b600181811c90821680612ce157607f821691505b60208210810361226257634e487b7160e01b5f52602260045260245ffd5b634e487b7160e01b5f52604160045260245ffd5b601f8211156111ed57805f5260205f20601f840160051c81016020851015612d385750805b601f840160051c820191505b81811015611c7c575f8155600101612d44565b67ffffffffffffffff831115612d6f57612d6f612cff565b612d8383612d7d8354612ccd565b83612d13565b5f601f841160018114612db4575f8515612d9d5750838201355b5f19600387901b1c1916600186901b178355611c7c565b5f83815260208120601f198716915b82811015612de35786850135825560209485019460019092019101612dc3565b5086821015612dff575f1960f88860031b161c19848701351681555b505060018560011b0183555050505050565b634e487b7160e01b5f52601160045260245ffd5b8082028115828204841417610d0057610d00612e11565b6bffffffffffffffffffffffff82811682821603908082111561231957612319612e11565b5f63ffffffff808316818103612e7957612e79612e11565b6001019392505050565b634e487b7160e01b5f52601260045260245ffdfea2646970667358221220a42479f0ba8eecd874ff5d12e1b47a24ad1df2dc43f2913de2e6db2deb4baf9d64736f6c63430008180033697066733a2f2f516d626241446f767a64413967346f746a6150707542644e7a32726f4152653331693134324d576571566b79456d2f7b69647d2e6a736f6e0000000000000000000000001f743779b6a5648ffbfa406fca40d13758d420ca

Deployed Bytecode

0x60806040526004361061030b575f3560e01c806353df5c7c11610199578063af6900c3116100e0578063d73c1fb311610089578063f04e283e11610063578063f04e283e14610c71578063f2fde38b14610c84578063fee81cf414610c9757610312565b8063d73c1fb314610be4578063dd62ed3e14610c04578063e436744514610c5057610312565b8063bbefa83a116100ba578063bbefa83a14610b92578063c4d66de814610ba6578063c87b56dd14610bc557610312565b8063af6900c314610b40578063b19de39f14610b54578063b698206914610b7357610312565b806370a08231116101425780638da5cb5b1161011c5780638da5cb5b14610af557806395d89b4114610b0d578063a9059cbb14610b2157610312565b806370a0823114610a88578063715018a614610ad957806375b238fc14610ae157610312565b80635a446215116101735780635a44621514610a3c5780635d148e5c14610a5b5780636338cb8a14610a7457610312565b806353df5c7c14610a0157806354d1f13d14610a1557806355f804b314610a1d57610312565b8063274e430b1161025d57806347f618a511610206578063514e62fc116101e0578063514e62fc146109725780635327bba3146109a757806353d6fd59146109e257610312565b806347f618a5146109075780634a4ee7b1146109265780634ef41efc1461093957610312565b8063313ce56711610237578063313ce567146108c15780633af32abf146108d45780633ccfd60b146108f357610312565b8063274e430b146108525780632a6a935d146108715780632de948071461089057610312565b8063183a4f6e116102bf57806323b848ff1161029957806323b848ff1461081757806323b872dd1461082b578063256929621461084a57610312565b8063183a4f6e146107bc5780631c10893f146107cf5780631cd64df4146107e257610312565b8063095ea7b3116102f0578063095ea7b314610734578063180434a31461076357806318160ddd1461078157610312565b806304dfe79d146106da57806306fdde031461071357610312565b3661031257005b68a20d6e21d0e52553085f3560e01c63e985e9c58190036103b45760018201546001600160a01b0316331461035a5760405163ce5a776b60e01b815260040160405180910390fd5b6044361015610367575f80fd5b6004356001600160a01b038181165f908152600385016020908152604080832060243594851684529091529020546103b19060ff166103a6575f6103a9565b60015b60ff16610cc8565b50505b80636352211e036104185760018201546001600160a01b031633146103ec5760405163ce5a776b60e01b815260040160405180910390fd5b60243610156103f9575f80fd5b60043561041661040882610cd0565b6001600160a01b0316610cc8565b505b8063e5eb36c8036104845760018201546001600160a01b031633146104505760405163ce5a776b60e01b815260040160405180910390fd5b608436101561045d575f80fd5b60043560243560443560643561047584848484610d06565b61047f6001610cc8565b505050505b8063813500fc0361051c5760018201546001600160a01b031633146104bc5760405163ce5a776b60e01b815260040160405180910390fd5b60643610156104c9575f80fd5b6001600160a01b036044358181165f90815268a20d6e21d0e525530b6020908152604080832060043595861684529091529020805460ff19166024351515908117909155906105186001610cc8565b5050505b8063d10b6e0c0361057c5760018201546001600160a01b031633146105545760405163ce5a776b60e01b815260040160405180910390fd5b6064361015610561575f80fd5b600435602435604435610578610408848484610d4d565b5050505b8063081812fc036105d25760018201546001600160a01b031633146105b45760405163ce5a776b60e01b815260040160405180910390fd5b60243610156105c1575f80fd5b6004356105d061040882610e59565b505b8063f5b100ea036106585760018201546001600160a01b0316331461060a5760405163ce5a776b60e01b815260040160405180910390fd5b6024361015610617575f80fd5b600435610656610651826001600160a01b03165f90815268a20d6e21d0e5255310602052604090205463ffffffff600160801b9091041690565b610cc8565b505b8063e2c79281036106c35760018201546001600160a01b031633146106905760405163ce5a776b60e01b815260040160405180910390fd5b600436101561069d575f80fd5b68a20d6e21d0e5255308546106c39068010000000000000000900463ffffffff16610cc8565b8063b7a94eb8036106d8576106d86001610cc8565b005b3480156106e5575f80fd5b506003546106fc9065010000000000900460ff1681565b60405160ff90911681526020015b60405180910390f35b34801561071e575f80fd5b50610727610ea3565b60405161070a9190612a32565b34801561073f575f80fd5b5061075361074e366004612a94565b610f32565b604051901515815260200161070a565b34801561076e575f80fd5b5060035461075390610100900460ff1681565b34801561078c575f80fd5b5068a20d6e21d0e525530854600160601b90046bffffffffffffffffffffffff165b60405190815260200161070a565b6106d86107ca366004612abc565b610fa6565b6106d86107dd366004612a94565b610fb3565b3480156107ed575f80fd5b506107536107fc366004612a94565b638b78c6d8600c9081525f9290925260209091205481161490565b348015610822575f80fd5b506106d8610fc9565b348015610836575f80fd5b50610753610845366004612ad3565b610fec565b6106d86110a5565b34801561085d575f80fd5b5061075361086c366004612b0c565b6110f2565b34801561087c575f80fd5b506106d861088b366004612b34565b611140565b34801561089b575f80fd5b506107ae6108aa366004612b0c565b638b78c6d8600c9081525f91909152602090205490565b3480156108cc575f80fd5b5060126106fc565b3480156108df575f80fd5b506107536108ee366004612b0c565b61114a565b3480156108fe575f80fd5b506106d8611187565b348015610912575f80fd5b506003546107539062010000900460ff1681565b6106d8610934366004612a94565b61119b565b348015610944575f80fd5b5068a20d6e21d0e5255309546001600160a01b03165b6040516001600160a01b03909116815260200161070a565b34801561097d575f80fd5b5061075361098c366004612a94565b638b78c6d8600c9081525f9290925260209091205416151590565b3480156109b2575f80fd5b506003546109cd906601000000000000900463ffffffff1681565b60405163ffffffff909116815260200161070a565b3480156109ed575f80fd5b506106d86109fc366004612b4d565b6111ad565b348015610a0c575f80fd5b506106d86111f2565b6106d861120d565b348015610a28575f80fd5b506106d8610a37366004612bbc565b611246565b348015610a47575f80fd5b506106d8610a56366004612bfb565b611282565b348015610a66575f80fd5b506003546107539060ff1681565b348015610a7f575f80fd5b506106d86112d8565b348015610a93575f80fd5b506107ae610aa2366004612b0c565b6001600160a01b03165f90815268a20d6e21d0e52553106020526040902054600160a01b90046bffffffffffffffffffffffff1690565b6106d86112f5565b348015610aec575f80fd5b506107ae600181565b348015610b00575f80fd5b50638b78c6d8195461095a565b348015610b18575f80fd5b50610727611308565b348015610b2c575f80fd5b50610753610b3b366004612a94565b611317565b348015610b4b575f80fd5b506106d861132c565b348015610b5f575f80fd5b506106d8610b6e366004612c62565b61134d565b348015610b7e575f80fd5b506106d8610b8d366004612c85565b6113af565b348015610b9d575f80fd5b506106d861140b565b348015610bb1575f80fd5b506106d8610bc0366004612b0c565b61142a565b348015610bd0575f80fd5b50610727610bdf366004612abc565b611462565b348015610bef575f80fd5b50600354610753906301000000900460ff1681565b348015610c0f575f80fd5b506107ae610c1e366004612ca5565b6001600160a01b039182165f90815268a20d6e21d0e525530d6020908152604080832093909416825291909152205490565b348015610c5b575f80fd5b5060035461075390640100000000900460ff1681565b6106d8610c7f366004612b0c565b611573565b6106d8610c92366004612b0c565b6115ad565b348015610ca2575f80fd5b506107ae610cb1366004612b0c565b63389a75e1600c9081525f91909152602090205490565b805f5260205ff35b5f610cda826115d3565b610cf75760405163677510db60e11b815260040160405180910390fd5b610d00826115ef565b92915050565b610d1284848484611642565b610d1c8484611a85565b826001600160a01b0316846001600160a01b031614610d4757610d4784670de0b6b3a7640000611ba2565b50505050565b5f68a20d6e21d0e52553088168a20d6e21d0e525530a81610d9968a20d6e21d0e525530f600189901b5b600381901c5f90815260209290925260409091205460059190911b60e0161c90565b63ffffffff16815260208101919091526040015f20546001600160a01b03908116915084168114610e24576001600160a01b038082165f90815260038401602090815260408083209388168352929052205460ff16610e24576040517fcfb3b94200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f8581526004909201602052604090912080546001600160a01b0387166001600160a01b031990911617905590509392505050565b5f610e63826115d3565b610e805760405163677510db60e11b815260040160405180910390fd5b505f90815268a20d6e21d0e525530c60205260409020546001600160a01b031690565b60605f8054610eb190612ccd565b80601f0160208091040260200160405190810160405280929190818152602001828054610edd90612ccd565b8015610f285780601f10610eff57610100808354040283529160200191610f28565b820191905f5260205f20905b815481529060010190602001808311610f0b57829003601f168201915b5050505050905090565b5f8068a20d6e21d0e5255308335f81815260058301602090815260408083206001600160a01b038a16808552908352928190208890555187815293945090927f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a35060019392505050565b610fb03382611c83565b50565b610fbb611c8e565b610fc58282611ca8565b5050565b6001610fd481611cb4565b506003805464ff000000001916640100000000179055565b6001600160a01b0383165f90815268a20d6e21d0e525530d6020908152604080832033845290915281205468a20d6e21d0e5255308905f19811461108e5780841115611064576040517f13be252b00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0386165f9081526005830160209081526040808320338452909152902084820390555b611099868686611ce5565b50600195945050505050565b5f6202a30067ffffffffffffffff164201905063389a75e1600c52335f52806020600c2055337fdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d5f80a250565b6001600160a01b0381165f90815268a20d6e21d0e5255310602052604081208054600160581b9004600116820361112d57823b5b9392505050565b54600160581b9004600216151592915050565b610fb03382611d1d565b6001600160a01b0381165f90815268a20d6e21d0e52553106020526040812054610d00906affffffffffffffffffffff165b60571c600116151590565b600161119281611cb4565b610fb033611db4565b6111a3611c8e565b610fc58282611c83565b60016111b881611cb4565b6003546301000000900460ff16156111e3576040516303cb96db60e21b815260040160405180910390fd5b6111ed8383611dcd565b505050565b60016111fd81611cb4565b506003805460ff19166001179055565b63389a75e1600c52335f525f6020600c2055337ffa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c925f80a2565b600161125181611cb4565b60035460ff1615611275576040516303cb96db60e21b815260040160405180910390fd5b6002610d47838583612d57565b600161128d81611cb4565b600354610100900460ff16156112b6576040516303cb96db60e21b815260040160405180910390fd5b5f6112c2858783612d57565b5060016112d0838583612d57565b505050505050565b60016112e381611cb4565b506003805461ff001916610100179055565b6112fd611c8e565b6113065f611e63565b565b606060018054610eb190612ccd565b5f611323338484611ce5565b50600192915050565b600161133781611cb4565b506003805463ff00000019166301000000179055565b600161135881611cb4565b60035462010000900460ff1615611382576040516303cb96db60e21b815260040160405180910390fd5b506003805463ffffffff90921666010000000000000269ffffffff00000000000019909216919091179055565b60016113ba81611cb4565b600354640100000000900460ff16156113e6576040516303cb96db60e21b815260040160405180910390fd5b506003805460ff909216650100000000000265ff000000000019909216919091179055565b600161141681611cb4565b506003805462ff0000191662010000179055565b600161143581611cb4565b5f611449670de0b6b3a76400006001612e25565b905033611457828286611ea0565b610d47816001611dcd565b606061146d826115d3565b61148a5760405163677510db60e11b815260040160405180910390fd5b6002805461149790612ccd565b15905061156e57610d00600280546114ae90612ccd565b80601f01602080910402602001604051908101604052809291908181526020018280546114da90612ccd565b80156115255780601f106114fc57610100808354040283529160200191611525565b820191905f5260205f20905b81548152906001019060200180831161150857829003601f168201915b50505050506040518060400160405280600481526020017f7b69647d0000000000000000000000000000000000000000000000000000000081525061156985612093565b6120d5565b919050565b61157b611c8e565b63389a75e1600c52805f526020600c2080544211156115a157636f5e88185f526004601cfd5b5f9055610fb081611e63565b6115b5611c8e565b8060601b6115ca57637448fbae5f526004601cfd5b610fb081611e63565b5f806115de836115ef565b6001600160a01b0316141592915050565b5f68a20d6e21d0e525530868a20d6e21d0e525530a8261161c68a20d6e21d0e525530f600187901b610d77565b63ffffffff16815260208101919091526040015f20546001600160a01b03169392505050565b68a20d6e21d0e52553086001600160a01b03841661167357604051633a954ecd60e21b815260040160405180910390fd5b5f816002015f61168a84600701610d778860011b90565b63ffffffff16815260208101919091526040015f20546001600160a01b039081169150861681146116e7576040517fa114810000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b856001600160a01b0316836001600160a01b031614611782576001600160a01b038087165f90815260038401602090815260408083209387168352929052205460ff16611782575f8481526004830160205260409020546001600160a01b03848116911614611782576040517f59c896be00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f61178c876121f5565b90505f611798876121f5565b8254909150670de0b6b3a76400009083906014906117cc908490600160a01b90046bffffffffffffffffffffffff16612e3c565b82546101009290920a6bffffffffffffffffffffffff81810219909316918316021790915582546001600160a01b038116670de0b6b3a7640000600160a01b92839004841601909216021782555061186260078501600188901b611830848b612268565b826020528160031c5f5260405f206007831660051b815463ffffffff8482841c188116831b8218845550505050505050565b5f868152600485016020908152604080832080546001600160a01b03191690556001600160a01b038b168352600687018252808320855463ffffffff60801b198116600160801b9182900463ffffffff9081165f1901908116909202178755631fffffff600382901c168552925282205460059190911b60e0161c6001600160a01b038a165f908152600687016020526040902063ffffffff919091169150611950906119176007880160018b811b01610d77565b63ffffffff1683826020528160031c5f5260405f206007831660051b815463ffffffff8482841c188116831b8218845550505050505050565b8154600163ffffffff600160801b80840482169283019091160263ffffffff60801b199092169190911783556119a26007870161199084600190811b0190565b61183060078a0160018d811b01610d77565b6001600160a01b0389165f9081526006870160209081526040808320909152600383901c82529020805460e0600584901b1681811c8b1863ffffffff16901b189055611a246007870160018a811b0183826020528160031c5f5260405f206007831660051b815463ffffffff8482841c188116831b8218845550505050505050565b5050866001600160a01b0316886001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef670de0b6b3a7640000604051611a7391815260200190565b60405180910390a35050505050505050565b60035465010000000000900460ff165f819003611aa157505050565b6001600160a01b0382165f90815268a20d6e21d0e52553106020526040902054670de0b6b3a7640000820290600160a01b90046bffffffffffffffffffffffff1611611aec57505050565b611b2261117c836001600160a01b03165f90815268a20d6e21d0e525531060205260409020546affffffffffffffffffffff1690565b15611b2c57505050565b638b78c6d819546001600160a01b0316836001600160a01b031603611b5057505050565b638b78c6d8600c9081525f849052602090205460011615611b7057505050565b6040517f0f2acbfc00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6003546601000000000000900463ffffffff165f819003611bc257505050565b5f80611c0e84611bfb876001600160a01b03165f90815268a20d6e21d0e525531060205260409020546affffffffffffffffffffff1690565b6affffffffffffffffffffff1690612320565b9150915060028110611c3b5780800283026301312d00808210611c2f578091505b611c3882612394565b50505b6001600160a01b0385165f90815268a20d6e21d0e52553106020526040902080546affffffffffffffffffffff19166affffffffffffffffffffff84161790555b5050505050565b610fc582825f6123c7565b638b78c6d819543314611306576382b429005f526004601cfd5b610fc5828260016123c7565b638b78c6d819543314610fb057638b78c6d8600c52335f52806020600c205416610fb0576382b429005f526004601cfd5b611cf083838361241e565b611cfa8383611a85565b816001600160a01b0316836001600160a01b0316146111ed576111ed8382611ba2565b5f611d27836121f5565b8054909150600160581b9004600216151582151514611d6a57805460ff600160581b8083048216600218909116026bff0000000000000000000000199091161781555b826001600160a01b03167fb5a1de456fff688115a4f75380060c23c8532d14ff85f687cc871456d642039383604051611da7911515815260200190565b60405180910390a2505050565b5f385f3847855af1610fb05763b12d13eb5f526004601cfd5b610fc582611e1b83611e08866001600160a01b03165f90815268a20d6e21d0e525531060205260409020546affffffffffffffffffffff1690565b6affffffffffffffffffffff16906129a2565b6001600160a01b03919091165f90815268a20d6e21d0e52553106020526040902080546affffffffffffffffffffff19166affffffffffffffffffffff909216919091179055565b638b78c6d81980546001600160a01b039092169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e05f80a355565b68a20d6e21d0e52553088054640100000000900463ffffffff1615611ef1576040517fead4d2e400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b038216611f31576040517f39a84a7b00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b611f3a826129ce565b805467ffffffff0000000019166401000000001781556001810180546001600160a01b0384166001600160a01b03199091161790558315610d47576001600160a01b038316611f9c57604051633a954ecd60e21b815260040160405180910390fd5b6b0de0b6b39983494c589bffff841115611fe2576040517fe5cfe95700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b80547fffffffffffffffff000000000000000000000000ffffffffffffffffffffffff16600160601b6bffffffffffffffffffffffff8616021781555f612028846121f5565b80546001600160a01b03908116600160a01b6bffffffffffffffffffffffff8916021782556040518781529192508516905f907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a3611c7c846001611d1d565b60606080604051019050602081016040525f8152805f19835b928101926030600a8206018453600a9004806120ac575050819003601f19909101908152919050565b606083518351835160208701965060208601955060208501945060206040510193508287018383116121a5576001838203015f6020851061211557508388205b601f851660200360031b89515b8b51818118831c61218c57831561215c5783888e201461215c57808a5260019c8d019c90990198848d1061215657506121a0565b50612122565b5f5b8b8101518b82015260200187811061215e57509b87019b98860198871561218c57848d1061215657506121a0565b895260019b8c019b90980197838c10612122575b505050505b84935060206040510194508781038585030192505b808810156121d55787518452602097880197909301926121ba565b50505f818401908152602001604052601f19909201918252509392505050565b6001600160a01b0381165f90815268a20d6e21d0e5255310602052604081208054909168a20d6e21d0e525530891600160581b90046001169003612262576001833b15612240576002175b825460ff909116600160581b026bff0000000000000000000000199091161782555b50919050565b8154600160601b900463ffffffff1668a20d6e21d0e52553085f82900361231957805481905f9061229e9063ffffffff16612e61565b825463ffffffff8083166101009490940a848102910219909116179092558554600160601b82027fffffffffffffffffffffffffffffffff00000000ffffffffffffffffffffffff9091161786555f908152600283016020526040902080546001600160a01b0386166001600160a01b031990911617905591505b5092915050565b5f80605784901c6001161561233957508290505f61238d565b637fffffff620151804204811690603886901c1666ffffffffffffff861681831461236457508190505f5b60389190911b66ffffffffffffff602887901c811692909201918216179350620de0b690049150505b9250929050565b80600117601052605b810460788211025f5b8181146123bc57601080802090526001016123a6565b5050601051610fb057fe5b638b78c6d8600c52825f526020600c208054838117836123e8575080841681185b80835580600c5160601c7f715ad5ce61fc9595c7b415289d59cf203f23a94fa06f04af7e489a0a76e1fe265f80a3505050505050565b6001600160a01b03821661244557604051633a954ecd60e21b815260040160405180910390fd5b68a20d6e21d0e52553085f612459856121f5565b90505f612465856121f5565b905061249a6040518060c001604052805f81526020015f81526020015f81526020015f81526020015f81526020015f81525090565b825463ffffffff600160801b808304821660808501528454041660a08301526bffffffffffffffffffffffff600160a01b909104166040820181905285111561250f576040517ff4d678b800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6040810180518690039081905283546bffffffffffffffffffffffff808316600160a01b9081026001600160a01b03938416178755855481810483168a0160608701819052909216029116178355608082015161257d91670de0b6b3a7640000906064020480821191030290565b81528154600160581b90046002165f036125ee57856001600160a01b0316876001600160a01b0316036125b857805160808201510360a08201525b6125e8670de0b6b3a76400008260600151606402816125d9576125d9612e83565b048260a0015180821191030290565b60208201525b5f6126358260200151835f01510160408051808201909152606081525f60208201526040805101828152806020018360051b81016040528183528083602001525050919050565b82519091501561275c576001600160a01b0388165f908152600686016020526040902060808301518351875463ffffffff6801000000000000000080830482168490038216026bffffffff0000000000000000199092169190911789558754918303908116600160801b0263ffffffff60801b199092169190911787555b5f1991909101600381901c5f90815260208490526040812054919291600584901b60e0161c60078a01602052633fffffff600282901c165f90815260409020805460c0600684901b1681811c67ffffffffffffffff16901b18905563ffffffff1690505f81815260048a016020908152604090912080546001600160a01b0319169055858101805160608f901b600885901b1760011781529091019052508082036126b3575050505b60208201511561292a576001600160a01b0387165f9081526006860160209081526040822060a08501519185015190929082019061279a878c612268565b895460208801516801000000000000000080830463ffffffff9081169092018216026bffffffff0000000000000000198316178c558954858216600160801b0263ffffffff60801b19909116178a55919250670de0b6b3a7640000600160601b82046bffffffffffffffffffffffff908116606402160491640100000000909104165b61282e8b600701610d778360011b90565b63ffffffff161561284d5760010181811115612848575060015b61281d565b6020869052600385901c5f90815260409020805460e0600588901b1681811c841863ffffffff16901b18905560078b016020908152600282901c5f90815260409020805460c0600685901b1681811c9389901b63ffffffff8816179390931867ffffffffffffffff1690921b90911890556001909401936128ed878e835f8360200151818360081b8560601b171781526020810185602001525050505050565b600101818111156128fc575060015b83850361281d578a5463ffffffff9091166401000000000267ffffffff0000000019909116178a5550505050505b8051511561294b57600185015461294b9082906001600160a01b03166129fb565b50856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8760405161299191815260200190565b60405180910390a350505050505050565b5f6001605784901c161515821515146129c7576a800000000000000000000092909218915b5090919050565b630f4599e55f523360205260205f6024601c5f855af160015f511416610fb05763d125259c5f526004601cfd5b81516040810363263c69d68152602080820152815160051b604401915060208183601c84015f875af1600182511416610d47575f81fd5b5f602080835283518060208501525f5b81811015612a5e57858101830151858201604001528201612a42565b505f604082860101526040601f19601f8301168501019250505092915050565b80356001600160a01b038116811461156e575f80fd5b5f8060408385031215612aa5575f80fd5b612aae83612a7e565b946020939093013593505050565b5f60208284031215612acc575f80fd5b5035919050565b5f805f60608486031215612ae5575f80fd5b612aee84612a7e565b9250612afc60208501612a7e565b9150604084013590509250925092565b5f60208284031215612b1c575f80fd5b61112682612a7e565b8035801515811461156e575f80fd5b5f60208284031215612b44575f80fd5b61112682612b25565b5f8060408385031215612b5e575f80fd5b612b6783612a7e565b9150612b7560208401612b25565b90509250929050565b5f8083601f840112612b8e575f80fd5b50813567ffffffffffffffff811115612ba5575f80fd5b60208301915083602082850101111561238d575f80fd5b5f8060208385031215612bcd575f80fd5b823567ffffffffffffffff811115612be3575f80fd5b612bef85828601612b7e565b90969095509350505050565b5f805f8060408587031215612c0e575f80fd5b843567ffffffffffffffff80821115612c25575f80fd5b612c3188838901612b7e565b90965094506020870135915080821115612c49575f80fd5b50612c5687828801612b7e565b95989497509550505050565b5f60208284031215612c72575f80fd5b813563ffffffff81168114611126575f80fd5b5f60208284031215612c95575f80fd5b813560ff81168114611126575f80fd5b5f8060408385031215612cb6575f80fd5b612cbf83612a7e565b9150612b7560208401612a7e565b600181811c90821680612ce157607f821691505b60208210810361226257634e487b7160e01b5f52602260045260245ffd5b634e487b7160e01b5f52604160045260245ffd5b601f8211156111ed57805f5260205f20601f840160051c81016020851015612d385750805b601f840160051c820191505b81811015611c7c575f8155600101612d44565b67ffffffffffffffff831115612d6f57612d6f612cff565b612d8383612d7d8354612ccd565b83612d13565b5f601f841160018114612db4575f8515612d9d5750838201355b5f19600387901b1c1916600186901b178355611c7c565b5f83815260208120601f198716915b82811015612de35786850135825560209485019460019092019101612dc3565b5086821015612dff575f1960f88860031b161c19848701351681555b505060018560011b0183555050505050565b634e487b7160e01b5f52601160045260245ffd5b8082028115828204841417610d0057610d00612e11565b6bffffffffffffffffffffffff82811682821603908082111561231957612319612e11565b5f63ffffffff808316818103612e7957612e79612e11565b6001019392505050565b634e487b7160e01b5f52601260045260245ffdfea2646970667358221220a42479f0ba8eecd874ff5d12e1b47a24ad1df2dc43f2913de2e6db2deb4baf9d64736f6c63430008180033

Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)

0000000000000000000000001f743779b6a5648ffbfa406fca40d13758d420ca

-----Decoded View---------------
Arg [0] : _mirror (address): 0x1F743779b6A5648FfBfa406FCa40d13758d420Ca

-----Encoded View---------------
1 Constructor Arguments found :
Arg [0] : 0000000000000000000000001f743779b6a5648ffbfa406fca40d13758d420ca


Deployed Bytecode Sourcemap

152888:7282:0:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6559:20;30487:22;37139:20;30587:3;30564:26;30670:10;30656:24;;;30652:377;;30715:14;;;;-1:-1:-1;;;;;30715:14:0;30701:10;:28;30697:58;;30738:17;;-1:-1:-1;;;30738:17:0;;;;;;;;;;;30697:58;30792:4;30774:8;:22;30770:36;;;30798:8;;;30770:36;30869:4;37139:20;-1:-1:-1;;;;;30972:26:0;;;30823:13;30972:26;;;:19;;;:26;;;;;;;;30940:4;37139:20;30972:36;;;;;;;;;;;30964:53;;30972:36;;:44;;31015:1;30972:44;;;31011:1;30972:44;30964:53;;:7;:53::i;:::-;30682:347;;30652:377;31075:10;31089;31075:24;31071:262;;31134:14;;;;-1:-1:-1;;;;;31134:14:0;31120:10;:28;31116:58;;31157:17;;-1:-1:-1;;;31157:17:0;;;;;;;;;;;31116:58;31211:4;31193:8;:22;31189:36;;;31217:8;;;31189:36;31269:4;37139:20;31291:30;31307:12;37139:20;31307:8;:12::i;:::-;-1:-1:-1;;;;;31291:30:0;:7;:30::i;:::-;31101:232;31071:262;31411:10;31425;31411:24;31407:502;;31470:14;;;;-1:-1:-1;;;;;31470:14:0;31456:10;:28;31452:58;;31493:17;;-1:-1:-1;;;31493:17:0;;;;;;;;;;;31452:58;31547:4;31529:8;:22;31525:36;;;31553:8;;;31525:36;31623:4;37139:20;31688:4;37139:20;31737:4;37139:20;31807:4;37139:20;31831:41;37139:20;;;;31831:16;:41::i;:::-;31887:10;31895:1;31887:7;:10::i;:::-;31437:472;;;;31407:502;31978:10;31992;31978:24;31974:451;;32037:14;;;;-1:-1:-1;;;;;32037:14:0;32023:10;:28;32019:58;;32060:17;;-1:-1:-1;;;32060:17:0;;;;;;;;;;;32019:58;32114:4;32096:8;:22;32092:36;;;32120:8;;;32092:36;-1:-1:-1;;;;;32318:4:0;37139:20;29607:47;;;;;;;:36;:47;;;;;;;;32193:4;37139:20;29607:57;;;;;;;;;;:68;;-1:-1:-1;;29607:68:0;32243:4;37139:20;32229:24;;29607:68;;;;;;32229:24;32403:10;32411:1;32403:7;:10::i;:::-;32004:421;;;31974:451;32490:10;32504;32490:24;32486:427;;32549:14;;;;-1:-1:-1;;;;;32549:14:0;32535:10;:28;32531:58;;32572:17;;-1:-1:-1;;;32572:17:0;;;;;;;;;;;32531:58;32626:4;32608:8;:22;32604:36;;;32632:8;;;32604:36;32705:4;37139:20;32754:4;37139:20;32824:4;37139:20;32848:53;32864:35;37139:20;;;32864:11;:35::i;32848:53::-;32516:397;;;32486:427;32963:10;32977;32963:24;32959:266;;33022:14;;;;-1:-1:-1;;;;;33022:14:0;33008:10;:28;33004:58;;33045:17;;-1:-1:-1;;;33045:17:0;;;;;;;;;;;33004:58;33099:4;33081:8;:22;33077:36;;;33105:8;;;33077:36;33157:4;37139:20;33179:34;33195:16;37139:20;33195:12;:16::i;33179:34::-;32989:236;32959:266;33276:10;33290;33276:24;33272:282;;33335:14;;;;-1:-1:-1;;;;;33335:14:0;33321:10;:28;33317:58;;33358:17;;-1:-1:-1;;;33358:17:0;;;;;;;;;;;33317:58;33412:4;33394:8;:22;33390:36;;;33418:8;;;33390:36;33489:4;37139:20;33513:29;33521:20;37139;-1:-1:-1;;;;;27423:37:0;27396:7;27423:37;;;:30;:37;;;;;:49;;-1:-1:-1;;;27423:49:0;;;;;27327:153;33521:20;33513:7;:29::i;:::-;33302:252;33272:282;33600:10;33614;33600:24;33596:209;;33659:14;;;;-1:-1:-1;;;;;33659:14:0;33645:10;:28;33641:58;;33682:17;;-1:-1:-1;;;33682:17:0;;;;;;;;;;;33641:58;33736:4;33718:8;:22;33714:36;;;33742:8;;;33714:36;6559:20;27235:33;33767:26;;27235:33;;;;;33513:7;:29::i;33767:26::-;33852:10;33866;33852:24;33848:67;;33893:10;33901:1;33893:7;:10::i;:::-;30476:3458;154198:28;;;;;;;;;;-1:-1:-1;154198:28:0;;;;;;;;;;;;;;186:4:1;174:17;;;156:36;;144:2;129:18;154198:28:0;;;;;;;;155288:92;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;9960:275::-;;;;;;;;;;-1:-1:-1;9960:275:0;;;;;:::i;:::-;;:::i;:::-;;;1381:14:1;;1374:22;1356:41;;1344:2;1329:18;9960:275:0;1216:187:1;154040:31:0;;;;;;;;;;-1:-1:-1;154040:31:0;;;;;;;;;;;9237:126;;;;;;;;;;-1:-1:-1;6559:20:0;9324:30;-1:-1:-1;;;9324:30:0;;;;9237:126;;;1554:25:1;;;1542:2;1527:18;9237:126:0;1408:177:1;136980:111:0;;;;;;:::i;:::-;;:::i;136429:125::-;;;;;;:::i;:::-;;:::i;138057:141::-;;;;;;;;;;-1:-1:-1;138057:141:0;;;;;:::i;:::-;137635:15;137629:4;137622:29;;;138136:4;137665:18;;;;137767:4;137751:21;;;137745:28;138160:21;;:30;;138057:141;158479:114;;;;;;;;;;;;;:::i;11595:512::-;;;;;;;;;;-1:-1:-1;11595:512:0;;;;;:::i;:::-;;:::i;50684:630::-;;;:::i;24422:282::-;;;;;;;;;;-1:-1:-1;24422:282:0;;;;;:::i;:::-;;:::i;24816:100::-;;;;;;;;;;-1:-1:-1;24816:100:0;;;;;:::i;:::-;;:::i;137429:362::-;;;;;;;;;;-1:-1:-1;137429:362:0;;;;;:::i;:::-;137635:15;137629:4;137622:29;;;137489:13;137665:18;;;;137767:4;137751:21;;137745:28;;137429:362;9096:76;;;;;;;;;;-1:-1:-1;9162:2:0;9096:76;;157763:123;;;;;;;;;;-1:-1:-1;157763:123:0;;;;;:::i;:::-;;:::i;160046:121::-;;;;;;;;;;;;;:::i;154080:31::-;;;;;;;;;;-1:-1:-1;154080:31:0;;;;;;;;;;;136703:127;;;;;;:::i;:::-;;:::i;26979:119::-;;;;;;;;;;-1:-1:-1;27059:31:0;;-1:-1:-1;;;;;27059:31:0;26979:119;;;-1:-1:-1;;;;;2813:55:1;;;2795:74;;2783:2;2768:18;26979:119:0;2649:226:1;137856:136:0;;;;;;;;;;-1:-1:-1;137856:136:0;;;;;:::i;:::-;137635:15;137629:4;137622:29;;;137934:4;137665:18;;;;137767:4;137751:21;;;137745:28;137958:21;:26;;;137856:136;154235:27;;;;;;;;;;-1:-1:-1;154235:27:0;;;;;;;;;;;;;;3054:10:1;3042:23;;;3024:42;;3012:2;2997:18;154235:27:0;2880:192:1;158894:184:0;;;;;;;;;;-1:-1:-1;158894:184:0;;;;;:::i;:::-;;:::i;159397:98::-;;;;;;;;;;;;;:::i;51399:466::-;;;:::i;159503:165::-;;;;;;;;;;-1:-1:-1;159503:165:0;;;;;:::i;:::-;;:::i;159794:244::-;;;;;;;;;;-1:-1:-1;159794:244:0;;;;;:::i;:::-;;:::i;154006:25::-;;;;;;;;;;-1:-1:-1;154006:25:0;;;;;;;;159676:110;;;;;;;;;;;;;:::i;9432:143::-;;;;;;;;;;-1:-1:-1;9432:143:0;;;;;:::i;:::-;-1:-1:-1;;;;;9522:37:0;9495:7;9522:37;;;:30;:37;;;;;:45;-1:-1:-1;;;9522:45:0;;;;;9432:143;50419:102;;;:::i;153252:44::-;;;;;;;;;;;;139548:6;153252:44;;53124:187;;;;;;;;;;-1:-1:-1;;;53275:18:0;53124:187;;155388:96;;;;;;;;;;;;;:::i;10748:150::-;;;;;;;;;;-1:-1:-1;10748:150:0;;;;;:::i;:::-;;:::i;158781:105::-;;;;;;;;;;;;;:::i;159204:185::-;;;;;;;;;;-1:-1:-1;159204:185:0;;;;;:::i;:::-;;:::i;158601:172::-;;;;;;;;;;-1:-1:-1;158601:172:0;;;;;:::i;:::-;;:::i;159086:110::-;;;;;;;;;;;;;:::i;158166:305::-;;;;;;;;;;-1:-1:-1;158166:305:0;;;;;:::i;:::-;;:::i;155492:283::-;;;;;;;;;;-1:-1:-1;155492:283:0;;;;;:::i;:::-;;:::i;154120:27::-;;;;;;;;;;-1:-1:-1;154120:27:0;;;;;;;;;;;9673:151;;;;;;;;;;-1:-1:-1;9673:151:0;;;;;:::i;:::-;-1:-1:-1;;;;;9772:35:0;;;9745:7;9772:35;;;:28;:35;;;;;;;;:44;;;;;;;;;;;;;9673:151;154156:33;;;;;;;;;;-1:-1:-1;154156:33:0;;;;;;;;;;;52056:724;;;;;;:::i;:::-;;:::i;49993:358::-;;;;;;:::i;:::-;;:::i;53417:449::-;;;;;;;;;;-1:-1:-1;53417:449:0;;;;;:::i;:::-;53696:19;53690:4;53683:33;;;53540:14;53730:26;;;;53842:4;53826:21;;53820:28;;53417:449;37270:185;37403:1;37397:4;37390:15;37432:4;37426;37419:18;27939:163;28000:7;28025:11;28033:2;28025:7;:11::i;:::-;28020:44;;28045:19;;-1:-1:-1;;;28045:19:0;;;;;;;;;;;28020:44;28082:12;28091:2;28082:8;:12::i;:::-;28075:19;27939:163;-1:-1:-1;;27939:163:0:o;156290:284::-;156425:47;156448:4;156454:2;156458;156462:9;156425:22;:47::i;:::-;156483:31;156505:4;156511:2;156483:21;:31::i;:::-;156537:2;-1:-1:-1;;;;;156529:10:0;:4;-1:-1:-1;;;;;156529:10:0;;156525:41;;156541:25;156555:4;3616:8;156541:13;:25::i;:::-;156290:284;;;;:::o;28823:527::-;28945:7;6559:20;28945:7;29042:16;28945:7;29059:31;29064:4;37836:1;37831:6;;;29070:19;38229:1;38220:10;;;38170:13;38212:19;;;;;;;;;;;;;38251:1;38236:16;;;;;;38212:41;;38096:166;29059:31;29042:49;;;;;;;;;;;;;-1:-1:-1;29042:49:0;;-1:-1:-1;;;;;29042:49:0;;;;-1:-1:-1;29108:18:0;;;;29104:171;;-1:-1:-1;;;;;29148:26:0;;;;;;;:19;;;:26;;;;;;;;:37;;;;;;;;;;;;29143:121;;29213:35;;;;;;;;;;;;;;29143:121;29287:20;;;;:16;;;;:20;;;;;;:30;;-1:-1:-1;;;;;29287:30:0;;-1:-1:-1;;;;;;29287:30:0;;;;;;29337:5;-1:-1:-1;28823:527:0;;;;;:::o;28411:192::-;28476:7;28501:11;28509:2;28501:7;:11::i;:::-;28496:44;;28521:19;;-1:-1:-1;;;28521:19:0;;;;;;;;;;;28496:44;-1:-1:-1;28558:37:0;;;;:33;:37;;;;;;-1:-1:-1;;;;;28558:37:0;;28411:192::o;155288:92::-;155334:13;155367:5;155360:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;155288:92;:::o;9960:275::-;10034:4;;6559:20;10119:10;10107:23;;;;:11;;;:23;;;;;;;;-1:-1:-1;;;;;10107:32:0;;;;;;;;;;;;:41;;;10166:37;1554:25:1;;;10107:11:0;;-1:-1:-1;10107:32:0;;10166:37;;1527:18:1;10166:37:0;;;;;;;-1:-1:-1;10223:4:0;;9960:275;-1:-1:-1;;;9960:275:0:o;136980:111::-;137052:31;137065:10;137077:5;137052:12;:31::i;:::-;136980:111;:::o;136429:125::-;54263:13;:11;:13::i;:::-;136522:24:::1;136534:4;136540:5;136522:11;:24::i;:::-;136429:125:::0;;:::o;158479:114::-;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;-1:-1:-1;158557:21:0::1;:28:::0;;-1:-1:-1;;158557:28:0::1;::::0;::::1;::::0;;158479:114::o;11595:512::-;-1:-1:-1;;;;;11774:17:0;;11683:4;11774:17;;;:11;:17;;;;;;;;11792:10;11774:29;;;;;;;;6559:20;;-1:-1:-1;;11820:28:0;;11816:220;;11878:7;11869:6;:16;11865:52;;;11894:23;;;;;;;;;;;;;;11865:52;-1:-1:-1;;;;;11961:17:0;;;;;;:11;;;:17;;;;;;;;11979:10;11961:29;;;;;;;11993:16;;;11961:48;;11816:220;12048:27;12058:4;12064:2;12068:6;12048:9;:27::i;:::-;-1:-1:-1;12095:4:0;;11595:512;-1:-1:-1;;;;;11595:512:0:o;50684:630::-;50779:15;49609:9;50797:46;;:15;:46;50779:64;;51015:19;51009:4;51002:33;51066:8;51060:4;51053:22;51123:7;51116:4;51110;51100:21;51093:38;51272:8;51225:45;51222:1;51219;51214:67;50915:381;50684:630::o;24422:282::-;-1:-1:-1;;;;;24523:33:0;;24482:4;24523:33;;;:30;:33;;;;;24571:7;;-1:-1:-1;;;24571:7:0;;4000:6;24571:40;:45;;24567:69;;36849:14;;24625:11;24618:18;24422:282;-1:-1:-1;;;24422:282:0:o;24567:69::-;24654:7;-1:-1:-1;;;24654:7:0;;4137:6;24654:37;:42;;;24422:282;-1:-1:-1;;24422:282:0:o;24816:100::-;24876:32;24888:10;24900:7;24876:11;:32::i;157763:123::-;-1:-1:-1;;;;;23529:37:0;;157823:4;23529:37;;;:30;:37;;;;;:41;157847:31;;23529:41;;157847:15;40079:2;41219:28;;;:33;;;41134:126;160046:121;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;160113:46:::1;160148:10;160113:34;:46::i;136703:127::-:0;54263:13;:11;:13::i;:::-;136797:25:::1;136810:4;136816:5;136797:12;:25::i;158894:184::-:0;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;158996:15:::1;::::0;;;::::1;;;158992:36;;;159020:8;;-1:-1:-1::0;;;159020:8:0::1;;;;;;;;;;;158992:36;159039:31;159055:6;159063;159039:15;:31::i;:::-;158894:184:::0;;;:::o;159397:98::-;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;-1:-1:-1;159467:13:0::1;:20:::0;;-1:-1:-1;;159467:20:0::1;159483:4;159467:20;::::0;;159397:98::o;51399:466::-;51605:19;51599:4;51592:33;51652:8;51646:4;51639:22;51705:1;51698:4;51692;51682:21;51675:32;51838:8;51792:44;51789:1;51786;51781:66;51399:466::o;159503:165::-;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;159600:13:::1;::::0;::::1;;159596:34;;;159622:8;;-1:-1:-1::0;;;159622:8:0::1;;;;;;;;;;;159596:34;159641:8;:19;159652:8:::0;;159641;:19:::1;:::i;159794:244::-:0;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;159942:19:::1;::::0;::::1;::::0;::::1;;;159938:40;;;159970:8;;-1:-1:-1::0;;;159970:8:0::1;;;;;;;;;;;159938:40;159989:5;:13;159997:5:::0;;159989;:13:::1;:::i;:::-;-1:-1:-1::0;160013:7:0::1;:17;160023:7:::0;;160013;:17:::1;:::i;:::-;;159794:244:::0;;;;;:::o;159676:110::-;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;-1:-1:-1;159752:19:0::1;:26:::0;;-1:-1:-1;;159752:26:0::1;;;::::0;;159676:110::o;50419:102::-;54263:13;:11;:13::i;:::-;50492:21:::1;50510:1;50492:9;:21::i;:::-;50419:102::o:0;155388:96::-;155436:13;155469:7;155462:14;;;;;:::i;10748:150::-;10818:4;10835:33;10845:10;10857:2;10861:6;10835:9;:33::i;:::-;-1:-1:-1;10886:4:0;10748:150;;;;:::o;158781:105::-;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;-1:-1:-1;158856:15:0::1;:22:::0;;-1:-1:-1;;158856:22:0::1;::::0;::::1;::::0;;158781:105::o;159204:185::-;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;159304:19:::1;::::0;;;::::1;;;159300:40;;;159332:8;;-1:-1:-1::0;;;159332:8:0::1;;;;;;;;;;;159300:40;-1:-1:-1::0;159351:13:0::1;:30:::0;;::::1;::::0;;::::1;::::0;::::1;-1:-1:-1::0;;159351:30:0;;::::1;::::0;;;::::1;::::0;;159204:185::o;158601:172::-;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;158693:21:::1;::::0;;;::::1;;;158689:42;;;158723:8;;-1:-1:-1::0;;;158723:8:0::1;;;;;;;;;;;158689:42;-1:-1:-1::0;158742:15:0::1;:23:::0;;::::1;::::0;;::::1;::::0;::::1;-1:-1:-1::0;;158742:23:0;;::::1;::::0;;;::::1;::::0;;158601:172::o;159086:110::-;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;-1:-1:-1;159162:19:0::1;:26:::0;;-1:-1:-1;;159162:26:0::1;::::0;::::1;::::0;;159086:110::o;158166:305::-;139548:6;138887:25;138906:5;138887:18;:25::i;:::-;158249:26:::1;158278:8;3616;158278:1;:8;:::i;:::-;158249:37:::0;-1:-1:-1;158326:10:0::1;158347:64;158249:37:::0;158326:10;158404:6;158347:16:::1;:64::i;:::-;158422:41;158438:18;158458:4;158422:15;:41::i;155492:283::-:0;155552:20;155590:11;155598:2;155590:7;:11::i;:::-;155585:44;;155610:19;;-1:-1:-1;;;155610:19:0;;;;;;;;;;;155585:44;155650:8;155644:22;;;;;:::i;:::-;:27;;-1:-1:-1;155640:128:0;;155697:59;155715:8;155697:59;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;155733:22;155752:2;155733:18;:22::i;:::-;155697:17;:59::i;155640:128::-;155492:283;;;:::o;52056:724::-;54263:13;:11;:13::i;:::-;52294:19:::1;52288:4;52281:33;52341:12;52335:4;52328:26;52404:4;52398;52388:21;52512:12;52506:19;52493:11;52490:36;52487:160;;;52559:10;52553:4;52546:24;52627:4;52621;52614:18;52487:160;52726:1;52705:23:::0;;52749::::1;52759:12:::0;52749:9:::1;:23::i;49993:358::-:0;54263:13;:11;:13::i;:::-;50168:8:::1;50164:2;50160:17;50150:153;;50211:10;50205:4;50198:24;50283:4;50277;50270:18;50150:153;50324:19;50334:8;50324:9;:19::i;28154:118::-:0;28214:4;;28238:12;28247:2;28238:8;:12::i;:::-;-1:-1:-1;;;;;28238:26:0;;;;28154:118;-1:-1:-1;;28154:118:0:o;27619:199::-;27680:7;6559:20;27761:16;27680:7;27778:31;27783:4;37836:1;37831:6;;;27789:19;37746:99;27778:31;27761:49;;;;;;;;;;;;;-1:-1:-1;27761:49:0;;-1:-1:-1;;;;;27761:49:0;;27619:199;-1:-1:-1;;;27619:199:0:o;21412:1507::-;6559:20;-1:-1:-1;;;;;21606:16:0;;21602:52;;21631:23;;-1:-1:-1;;;21631:23:0;;;;;;;;;;;21602:52;21667:13;21683:1;:16;;:49;21700:31;21705:1;:4;;21711:19;21727:2;37836:1;37831:6;;37746:99;21700:31;21683:49;;;;;;;;;;;;;-1:-1:-1;21683:49:0;;-1:-1:-1;;;;;21683:49:0;;;;-1:-1:-1;21749:13:0;;;;21745:54;;21771:28;;;;;;;;;;;;;;21745:54;21829:4;-1:-1:-1;;;;;21816:17:0;:9;-1:-1:-1;;;;;21816:17:0;;21812:250;;-1:-1:-1;;;;;21855:25:0;;;;;;;:19;;;:25;;;;;;;;:36;;;;;;;;;;;;21850:201;;21929:20;;;;:16;;;:20;;;;;;-1:-1:-1;;;;;21916:33:0;;;21929:20;;21916:33;21912:124;;21981:35;;;;;;;;;;;;;;21912:124;22074:35;22112:18;22125:4;22112:12;:18::i;:::-;22074:56;;22141:33;22177:16;22190:2;22177:12;:16::i;:::-;22206:39;;22141:52;;-1:-1:-1;3616:8:0;;22206:39;;:23;;:39;;3616:8;;-1:-1:-1;;;22206:39:0;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;22283:37;;-1:-1:-1;;;;;22283:37:0;;3616:8;-1:-1:-1;;;22283:37:0;;;;;;;;;;;;;;-1:-1:-1;22337:76:0;22342:4;;;-1:-1:-1;37831:6:0;;;22369:43;22394:13;22409:2;22369:24;:43::i;:::-;38496:8;38490:4;38483:22;38539:5;38536:1;38532:13;38526:4;38519:27;38585:4;38579;38569:21;38648:1;38641:5;38637:13;38634:1;38630:21;38711:1;38705:8;38759:10;38844:5;38840:1;38837;38833:9;38829:21;38826:1;38822:29;38819:1;38815:37;38812:1;38808:45;38805:1;38798:56;;;;;38330:542;;;;22337:76;22435:20;;;;:16;;;:20;;;;;;;;22428:27;;-1:-1:-1;;;;;;22428:27:0;;;-1:-1:-1;;;;;22497:13:0;;;;:7;;;:13;;;;;22512:29;;-1:-1:-1;;;;22512:29:0;;-1:-1:-1;;;22512:29:0;;;;;;;;-1:-1:-1;;22512:29:0;;;;;;;;;;38220:10;38229:1;38220:10;;;;38212:19;;;;;;;38251:1;38236:16;;;;;;38212:41;-1:-1:-1;;;;;22562:13:0;;;;;;:7;;;:13;;;;;22472:70;;;;;;-1:-1:-1;22557:67:0;;22577:27;22582:4;;;38003:1;37998:6;;;37997:12;22588:15;37891:137;22577:27;22557:67;;22613:9;38496:8;38490:4;38483:22;38539:5;38536:1;38532:13;38526:4;38519:27;38585:4;38579;38569:21;38648:1;38641:5;38637:13;38634:1;38630:21;38711:1;38705:8;38759:10;38844:5;38840:1;38837;38833:9;38829:21;38826:1;38822:29;38819:1;38815:37;38812:1;38808:45;38805:1;38798:56;;;;;38330:542;;;;22557:67;22653:27;;;;-1:-1:-1;;;22653:27:0;;;;;;;;;;;;-1:-1:-1;;;;22653:27:0;;;;;;;;;22695:63;22700:4;;;22706:22;22718:9;38003:1;37998:6;;;37997:12;;37891:137;22706:22;22730:27;22735:4;;;38003:1;37998:6;;;37997:12;22741:15;37891:137;22695:63;-1:-1:-1;;;;;22778:11:0;;;;;;:7;;;:11;;;;;;;;38483:22;;;38536:1;38532:13;;;38519:27;;38569:21;;38705:8;;38630:21;38634:1;38630:21;;;;38833:9;;;38829:21;;38759:10;38822:29;38815:37;;38808:45;38798:56;;22820:38;22825:4;;;38003:1;37998:6;;;37997:12;22855:1;38496:8;38490:4;38483:22;38539:5;38536:1;38532:13;38526:4;38519:27;38585:4;38579;38569:21;38648:1;38641:5;38637:13;38634:1;38630:21;38711:1;38705:8;38759:10;38844:5;38840:1;38837;38833:9;38829:21;38826:1;38822:29;38819:1;38815:37;38812:1;38808:45;38805:1;38798:56;;;;;38330:542;;;;22820:38;22258:612;;22902:2;-1:-1:-1;;;;;22887:24:0;22896:4;-1:-1:-1;;;;;22887:24:0;;3616:8;22887:24;;;;1554:25:1;;1542:2;1527:18;;1408:177;22887:24:0;;;;;;;;21535:1384;;;;21412:1507;;;;:::o;156582:447::-;156705:15;;;;;;;156689:13;156739:10;;;156735:23;;156751:7;156582:447;;:::o;156735:23::-;-1:-1:-1;;;;;9522:37:0;;9495:7;9522:37;;;:30;:37;;;;;:45;3616:8;156793:12;;;-1:-1:-1;;;9522:45:0;;;;156776:29;156772:42;;156807:7;156582:447;;:::o;156772:42::-;156832:27;:11;156840:2;-1:-1:-1;;;;;23529:37:0;23503:6;23529:37;;;:30;:37;;;;;:41;;;;23440:138;156832:27;156828:40;;;156861:7;156582:447;;:::o;156828:40::-;-1:-1:-1;;53275:18:0;-1:-1:-1;;;;;156886:15:0;:4;-1:-1:-1;;;;;156886:15:0;;156882:28;;156903:7;156582:447;;:::o;156882:28::-;137635:15;137629:4;137622:29;;;137934:4;137665:18;;;137767:4;137751:21;;137745:28;139548:6;137958:21;:26;156924:41;;156958:7;156582:447;;:::o;156924:41::-;156986:24;;;;;;;;;;;;;;157037:573;157153:13;;;;;;;157136:14;157185:11;;;157181:24;;157198:7;157037:573;;:::o;157181:24::-;157220:13;157235:16;157255:29;157276:7;157255:13;157263:4;-1:-1:-1;;;;;23529:37:0;23503:6;23529:37;;;:30;:37;;;;;:41;;;;23440:138;157255:13;:20;;;;:29::i;:::-;157219:65;;;;157315:1;157303:8;:13;157299:257;;157354:19;;;:28;;157422:10;157455:20;;;157451:45;;157486:10;157477:19;;157451:45;157515:25;157533:6;157515:17;:25::i;:::-;157318:238;;157299:257;-1:-1:-1;;;;;23908:37:0;;;;;;:30;:37;;;;;:49;;-1:-1:-1;;23908:49:0;;;;;;;157570:21;157111:492;;;157037:573;;:::o;131031:119::-;131110:32;131123:4;131129:5;131136;131110:12;:32::i;48914:364::-;-1:-1:-1;;49124:18:0;49114:8;49111:32;49101:159;;49177:10;49171:4;49164:24;49240:4;49234;49227:18;130774:117;130852:31;130865:4;130871:5;130878:4;130852:12;:31::i;131969:819::-;-1:-1:-1;;132262:27:0;132252:8;132249:41;132239:531;;132367:15;132361:4;132354:29;132414:8;132408:4;132401:22;132620:5;132612:4;132606;132596:21;132590:28;132586:40;132576:179;;132664:10;132658:4;132651:24;132731:4;132725;132718:18;156055:227;156145:33;156161:4;156167:2;156171:6;156145:15;:33::i;:::-;156189:31;156211:4;156217:2;156189:21;:31::i;:::-;156243:2;-1:-1:-1;;;;;156235:10:0;:4;-1:-1:-1;;;;;156235:10:0;;156231:43;;156247:27;156261:4;156267:6;156247:13;:27::i;25135:289::-;25207:21;25231:15;25244:1;25231:12;:15::i;:::-;25262:7;;25207:39;;-1:-1:-1;;;;25262:7:0;;4137:6;25262:37;:42;;25261:53;;;;25257:124;;25331:38;;;-1:-1:-1;;;25331:38:0;;;;;4137:6;25331:38;;;;;-1:-1:-1;;25331:38:0;;;;;;25257:124;25407:1;-1:-1:-1;;;;;25396:20:0;;25410:5;25396:20;;;;1381:14:1;1374:22;1356:41;;1344:2;1329:18;;1216:187;25396:20:0;;;;;;;;25196:228;25135:289;;:::o;58972:415::-;59242:4;59230:10;59224:4;59212:10;59197:13;59193:2;59186:5;59181:66;59171:198;;59281:10;59275:4;59268:24;59349:4;59343;59336:18;157618:137;157692:55;157700:6;157708:38;157739:6;157708:15;157716:6;-1:-1:-1;;;;;23529:37:0;23503:6;23529:37;;;:30;:37;;;;;:41;;;;23440:138;157708:15;:30;;;;:38::i;:::-;-1:-1:-1;;;;;23908:37:0;;;;;;;;:30;:37;;;;;:49;;-1:-1:-1;;23908:49:0;;;;;;;;;;;23834:131;47740:1113;-1:-1:-1;;48707:16:0;;-1:-1:-1;;;;;48553:26:0;;;;;;48667:38;48664:1;;48656:78;48793:27;47740:1113::o;7064:1025::-;6559:20;7284:13;;;;;;;:18;7280:53;;7311:22;;;;;;;;;;;;;;7280:53;-1:-1:-1;;;;;7350:20:0;;7346:54;;7379:21;;;;;;;;;;;;;;7346:54;7411:27;7431:6;7411:19;:27::i;:::-;7451:17;;-1:-1:-1;;7451:17:0;;;;;7467:1;7479:14;;:23;;-1:-1:-1;;;;;7479:23:0;;-1:-1:-1;;;;;;7479:23:0;;;;;;7519:22;;7515:567;;-1:-1:-1;;;;;7562:32:0;;7558:68;;7603:23;;-1:-1:-1;;;7603:23:0;;;;;;;;;;;7558:68;3838:25;7645:18;:32;7641:66;;;7686:21;;;;;;;;;;;;;;7641:66;7724:42;;;;-1:-1:-1;;;7724:42:0;;;;;;;-1:-1:-1;7827:32:0;7840:18;7827:12;:32::i;:::-;7874:60;;-1:-1:-1;;;;;7874:60:0;;;-1:-1:-1;;;7874:60:0;;;;;;;7956;;1554:25:1;;;7874:60:0;;-1:-1:-1;7956:60:0;;;-1:-1:-1;;7956:60:0;;1542:2:1;1527:18;7956:60:0;;;;;;;8033:37;8045:18;8065:4;8033:11;:37::i;75558:1676::-;75614:17;76066:4;76059;76053:11;76049:22;76042:29;;76167:4;76162:3;76158:14;76152:4;76145:28;76250:1;76245:3;76238:14;76354:3;76386:1;76382:6;76598:5;76580:410;76637:11;;;;76821:2;76835;76825:13;;76817:22;76637:11;76804:36;76929:2;76919:13;;76950:25;76580:410;76950:25;-1:-1:-1;;77020:13:0;;;-1:-1:-1;;77135:14:0;;;77197:19;;;77135:14;75558:1676;-1:-1:-1;75558:1676:0:o;93181:3410::-;93320:20;93453:7;93447:14;93501:6;93495:13;93553:11;93547:18;93605:4;93596:7;93592:18;93581:29;;93646:4;93638:6;93634:17;93624:27;;93697:4;93684:11;93680:22;93665:37;;93743:4;93736;93730:11;93726:22;93716:32;;93795:13;93786:7;93782:27;93850:13;93836:12;93833:31;93823:2004;;93944:1;93929:12;93917:10;93913:29;93909:37;93973:1;94019:4;94005:12;94002:22;93992:74;;-1:-1:-1;94033:31:0;;;93992:74;94128:4;94114:12;94110:23;94104:4;94100:34;94097:1;94093:42;94168:6;94162:13;94193:1619;94243:7;94237:14;94424:1;94421;94417:9;94414:1;94410:17;94400:1188;;94459:1;94456:441;;;94539:1;94524:12;94515:7;94505:32;94502:39;94492:378;;94578:17;;;94651:1;94698:15;;;;94639:14;;;;94757:29;;;94747:50;;94790:5;;;94747:50;94831:8;94193:1619;;94492:378;95009:1;94994:254;95078:19;;;95072:26;95056:14;;;95049:50;95141:4;95134:12;95186:24;;;94994:254;95176:45;-1:-1:-1;95351:26:0;;;;95284:30;;;;95403:162;;;;95472:16;95463:7;95460:29;95450:50;;95493:5;;;95403:162;95610:17;;95671:1;95706:15;;;;95659:14;;;;95753:29;;;94193:1619;95743:50;94193:1619;94197:2;;;;93823:2004;95866:6;95843:29;;95913:4;95906;95900:11;95896:22;95886:32;;95991:7;95979:10;95975:24;95966:6;95949:15;95945:28;95941:59;95932:68;;96078:217;96097:10;96088:7;96085:23;96078:217;;;96155:14;;96131:39;;96228:4;96262:18;;;;96207:26;;;;96078:217;;;-1:-1:-1;;96366:17:0;96362:25;;;96439:15;;;96331:4;96481:15;96475:4;96468:29;-1:-1:-1;;96319:17:0;;;96535;;;-1:-1:-1;96319:17:0;93181:3410;-1:-1:-1;;;93181:3410:0:o;25595:407::-;-1:-1:-1;;;;;25746:16:0;;25654:21;25746:16;;;:13;:16;;;;;25779:7;;25746:16;;6559:20;;-1:-1:-1;;;25779:7:0;;4000:6;25779:40;:45;;25775:220;;4000:6;36849:14;;25900:53;;;4137:6;25917:36;25900:53;25968:15;;;;;;-1:-1:-1;;;25968:15:0;-1:-1:-1;;25968:15:0;;;;;;25775:220;25677:325;25595:407;;;:::o;26168:469::-;26408:26;;-1:-1:-1;;;26408:26:0;;;;6559:20;26302:19;26449:17;;;26445:185;;26498:14;;26500:1;;:12;;26498:14;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;26527:41;;-1:-1:-1;;;26527:41:0;;;;;;;;;-1:-1:-1;26583:30:0;;;:16;;;:30;;;;;:35;;-1:-1:-1;;;;;26583:35:0;;-1:-1:-1;;;;;;26583:35:0;;;;;;26498:14;-1:-1:-1;26445:185:0;26328:309;26168:469;;;;:::o;40090:1036::-;40188:14;;40079:2;41219:28;;;;;:33;40263:80;;-1:-1:-1;40317:6:0;;-1:-1:-1;40325:1:0;40309:18;;40263:80;39953:10;40399:5;40381:15;:23;40380:36;;;39905:2;40452:29;;;40451:42;39841:16;40540:40;;40601:23;;;40597:130;;-1:-1:-1;40701:10:0;;-1:-1:-1;40669:1:0;40597:130;39905:2;40760:23;;;;39841:16;40021:2;40874:31;;;40873:58;;40848:84;;;;40957:47;;;40947:57;;-1:-1:-1;39767:14:0;41069:38;;;-1:-1:-1;;40090:1036:0;;;;;;:::o;54905:504::-;55042:1;55039;55036:8;55030:4;55023:22;55091:2;55088:1;55084:10;55078:3;55075:1;55072:10;55068:27;55224:1;55209:132;55241:1;55238;55235:8;55209:132;;55312:4;55296:21;;;55283:35;;55259:1;55252:9;55209:132;;;55213:14;;55371:4;55365:11;55355:36;;55380:9;129650:986;129819:15;129813:4;129806:29;129862:4;129856;129849:18;129913:4;129907;129897:21;129993:8;129987:15;130102:5;130093:7;130090:18;130350:2;130340:62;;-1:-1:-1;130380:19:0;;;130367:33;;130340:62;130476:7;130466:8;130459:25;130610:7;130602:4;130596:11;130592:2;130588:20;130556:30;130553:1;130550;130545:73;;;;129650:986;;;:::o;17701:3286::-;-1:-1:-1;;;;;17794:16:0;;17790:52;;17819:23;;-1:-1:-1;;;17819:23:0;;;;;;;;;;;17790:52;6559:20;17855:22;17949:18;17962:4;17949:12;:18::i;:::-;17911:56;;17978:33;18014:16;18027:2;18014:12;:16::i;:::-;17978:52;;18043:23;-1:-1:-1;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;18043:23:0;18097:27;;;-1:-1:-1;;;18097:27:0;;;;;18077:17;;;:47;18153:25;;;;18135:15;;;:43;18205:23;-1:-1:-1;;;18205:23:0;;;;18189:13;;;:39;;;18245:22;;18241:56;;;18276:21;;;;;;;;;;;;;;18241:56;18335:13;;;:23;;;;;;;;;18373:47;;;;;;-1:-1:-1;;;18373:47:0;;;-1:-1:-1;;;;;18373:47:0;;;;;;18480:21;;;;;;;:30;;18466:11;;;:44;;;18435:76;;;;;;;;;18562:17;;;;18548:60;;3616:8;;18597:3;18581:19;:26;37668:8;;;37678:9;;37664:24;;37502:204;18548:60;18528:80;;18629:19;;-1:-1:-1;;;18629:19:0;;4137:6;18629:49;18528:17;18629:54;18625:261;;18716:2;-1:-1:-1;;;;;18708:10:0;:4;-1:-1:-1;;;;;18708:10:0;;18704:71;;18758:17;;18738;;;;:37;18720:15;;;:55;18704:71;18814:56;3616:8;18828:1;:11;;;18842:3;18828:17;:24;;;;;:::i;:::-;;18854:1;:15;;;37668:8;;;37678:9;;37664:24;;37502:204;18814:56;18794:17;;;:76;18625:261;18902:29;18934:56;18972:1;:17;;;18952:1;:17;;;:37;-1:-1:-1;;;;;;;;;;;;;;;;;34861:4:0;34854;34848:11;34844:22;34937:1;34931:4;34924:15;34977:4;34971;34967:15;35028:1;35025;35021:9;35013:6;35009:22;35003:4;34996:36;35056:4;35053:1;35046:15;35096:6;35092:1;35086:4;35082:12;35075:28;;;34671:450;;;;18934:56;19011:17;;18902:88;;-1:-1:-1;19011:22:0;19007:703;;-1:-1:-1;;;;;19084:13:0;;19054:27;19084:13;;;:7;;;:13;;;;;19136:17;;;;19202;;19238:45;;;;;;;;;;;;;;;-1:-1:-1;;19238:45:0;;;;;;;;;19302;;19190:29;;;19302:45;;;-1:-1:-1;;;19302:45:0;-1:-1:-1;;;;19302:45:0;;;;;;;;;19397:298;-1:-1:-1;;19452:11:0;;;;38229:1;38220:10;;;19423;38212:19;;;;;;;;;;;19452:11;;;38251:1;38236:16;;;;;38212:41;19515:4;;;39204:2;39262:22;39311:10;39315:1;39311:10;;;;19525:1;39298:24;;;39361:4;39345:21;;39478:8;;39406:18;39410:1;39406:18;;;;39614:9;;;39532:18;39603:29;39596:37;;39589:45;39579:56;;19423:41;;;-1:-1:-1;19560:20:0;;;;:16;;;:20;;;;;;;;19553:27;;-1:-1:-1;;;;;;19553:27:0;;;35451:12;;;35445:19;;35503:2;35499:10;;;35515:1;35511:10;;;35496:26;-1:-1:-1;35493:39:0;35478:55;;35568:17;;;35547:39;;19400:265;19686:7;19673:9;:20;19397:298;;19035:675;;;19007:703;19730:17;;;;:22;19726:1074;;-1:-1:-1;;;;;19801:11:0;;19773:25;19801:11;;;:7;;;:11;;;;;;;19849:15;;;;19909:17;;;;19801:11;;19899:27;;;;19962:43;19987:13;19809:2;19962:24;:43::i;:::-;20043:13;;20160:17;;;;20133:45;;;;20101:13;20133:45;;;;;;;;;-1:-1:-1;;20133:45:0;;;;;20197:41;;;;;-1:-1:-1;;;20197:41:0;-1:-1:-1;;;;20197:41:0;;;;;;19945:60;;-1:-1:-1;3616:8:0;-1:-1:-1;;;20043:13:0;;;;;;20059:3;20043:19;:26;;;20101:13;;;;;20288:452;20321:31;20326:1;:4;;20332:19;20348:2;37836:1;37831:6;;37746:99;20321:31;:36;;;20314:123;;20390:4;;:15;;;20386:27;;;-1:-1:-1;20412:1:0;20386:27;20314:123;;;38490:4;38483:22;;;38536:1;38532:13;;;38526:4;38519:27;;;38585:4;38569:21;;38705:8;;38630:21;38634:1;38630:21;;;;38833:9;;;38829:21;;38759:10;38822:29;38815:37;;38808:45;38798:56;;20544:4;;;39204:2;39262:22;;;39315:1;39311:10;;;39305:4;39298:24;;;39361:4;39345:21;;39478:8;;39406:18;39410:1;39406:18;;;;39614:9;;;39200:19;;;;39225:10;39221:26;;39197:51;39610:21;;;;39532:18;39603:29;39596:37;;;39589:45;;;39579:56;;20570:9;;;;;20604:40;20622:10;20634:2;20638;20642:1;35461;35455:4;35451:12;35445:19;35524:7;35518:2;35515:1;35511:10;35507:1;35503:2;35499:10;35496:26;35493:39;35485:6;35478:55;35580:4;35572:6;35568:17;35564:1;35558:4;35554:12;35547:39;;35227:377;;;;;20604:40;20671:4;;:15;;;20667:27;;;-1:-1:-1;20693:1:0;20667:27;20733:5;20722:7;:16;20288:452;;20758:26;;;;;;;;-1:-1:-1;;20758:26:0;;;;;;-1:-1:-1;;;;;19726:1074:0;20820:15;;:22;:27;20816:111;;20896:14;;;;20868:43;;20884:10;;-1:-1:-1;;;;;20896:14:0;20868:15;:43::i;:::-;18310:2628;20968:2;-1:-1:-1;;;;;20953:26:0;20962:4;-1:-1:-1;;;;;20953:26:0;;20972:6;20953:26;;;;1554:25:1;;1542:2;1527:18;;1408:177;20953:26:0;;;;;;;;17779:3208;;;;17701:3286;;;:::o;41268:230::-;41343:6;41219:28;40079:2;41219:28;;;;:33;;41366:31;;;;41362:105;;41431:23;41414:41;;;;;41362:105;-1:-1:-1;41484:6:0;;41268:230;-1:-1:-1;41268:230:0:o;29830:477::-;29984:10;29978:4;29971:24;30056:8;30050:4;30043:22;30154:4;30148;30142;30136;30133:1;30125:6;30118:5;30113:46;30109:1;30102:4;30096:11;30093:18;30089:71;30079:210;;30194:10;30188:4;30181:24;30269:4;30263;30256:18;35703:634;35871:1;35865:8;35906:4;35900;35896:15;35965:10;35962:1;35955:21;36040:4;36033;36030:1;36026:12;36019:26;36136:4;36130:11;36127:1;36123:19;36117:4;36113:30;36104:39;;36262:4;36259:1;36256;36249:4;36246:1;36242:12;36239:1;36231:6;36224:5;36219:48;36215:1;36211;36205:8;36202:15;36198:70;36188:131;;36299:4;36296:1;36289:15;203:548:1;315:4;344:2;373;362:9;355:21;405:6;399:13;448:6;443:2;432:9;428:18;421:34;473:1;483:140;497:6;494:1;491:13;483:140;;;592:14;;;588:23;;582:30;558:17;;;577:2;554:26;547:66;512:10;;483:140;;;487:3;672:1;667:2;658:6;647:9;643:22;639:31;632:42;742:2;735;731:7;726:2;718:6;714:15;710:29;699:9;695:45;691:54;683:62;;;;203:548;;;;:::o;756:196::-;824:20;;-1:-1:-1;;;;;873:54:1;;863:65;;853:93;;942:1;939;932:12;957:254;1025:6;1033;1086:2;1074:9;1065:7;1061:23;1057:32;1054:52;;;1102:1;1099;1092:12;1054:52;1125:29;1144:9;1125:29;:::i;:::-;1115:39;1201:2;1186:18;;;;1173:32;;-1:-1:-1;;;957:254:1:o;1590:180::-;1649:6;1702:2;1690:9;1681:7;1677:23;1673:32;1670:52;;;1718:1;1715;1708:12;1670:52;-1:-1:-1;1741:23:1;;1590:180;-1:-1:-1;1590:180:1:o;1775:328::-;1852:6;1860;1868;1921:2;1909:9;1900:7;1896:23;1892:32;1889:52;;;1937:1;1934;1927:12;1889:52;1960:29;1979:9;1960:29;:::i;:::-;1950:39;;2008:38;2042:2;2031:9;2027:18;2008:38;:::i;:::-;1998:48;;2093:2;2082:9;2078:18;2065:32;2055:42;;1775:328;;;;;:::o;2108:186::-;2167:6;2220:2;2208:9;2199:7;2195:23;2191:32;2188:52;;;2236:1;2233;2226:12;2188:52;2259:29;2278:9;2259:29;:::i;2299:160::-;2364:20;;2420:13;;2413:21;2403:32;;2393:60;;2449:1;2446;2439:12;2464:180;2520:6;2573:2;2561:9;2552:7;2548:23;2544:32;2541:52;;;2589:1;2586;2579:12;2541:52;2612:26;2628:9;2612:26;:::i;3077:254::-;3142:6;3150;3203:2;3191:9;3182:7;3178:23;3174:32;3171:52;;;3219:1;3216;3209:12;3171:52;3242:29;3261:9;3242:29;:::i;:::-;3232:39;;3290:35;3321:2;3310:9;3306:18;3290:35;:::i;:::-;3280:45;;3077:254;;;;;:::o;3336:348::-;3388:8;3398:6;3452:3;3445:4;3437:6;3433:17;3429:27;3419:55;;3470:1;3467;3460:12;3419:55;-1:-1:-1;3493:20:1;;3536:18;3525:30;;3522:50;;;3568:1;3565;3558:12;3522:50;3605:4;3597:6;3593:17;3581:29;;3657:3;3650:4;3641:6;3633;3629:19;3625:30;3622:39;3619:59;;;3674:1;3671;3664:12;3689:411;3760:6;3768;3821:2;3809:9;3800:7;3796:23;3792:32;3789:52;;;3837:1;3834;3827:12;3789:52;3877:9;3864:23;3910:18;3902:6;3899:30;3896:50;;;3942:1;3939;3932:12;3896:50;3981:59;4032:7;4023:6;4012:9;4008:22;3981:59;:::i;:::-;4059:8;;3955:85;;-1:-1:-1;3689:411:1;-1:-1:-1;;;;3689:411:1:o;4105:721::-;4197:6;4205;4213;4221;4274:2;4262:9;4253:7;4249:23;4245:32;4242:52;;;4290:1;4287;4280:12;4242:52;4330:9;4317:23;4359:18;4400:2;4392:6;4389:14;4386:34;;;4416:1;4413;4406:12;4386:34;4455:59;4506:7;4497:6;4486:9;4482:22;4455:59;:::i;:::-;4533:8;;-1:-1:-1;4429:85:1;-1:-1:-1;4621:2:1;4606:18;;4593:32;;-1:-1:-1;4637:16:1;;;4634:36;;;4666:1;4663;4656:12;4634:36;;4705:61;4758:7;4747:8;4736:9;4732:24;4705:61;:::i;:::-;4105:721;;;;-1:-1:-1;4785:8:1;-1:-1:-1;;;;4105:721:1:o;4831:276::-;4889:6;4942:2;4930:9;4921:7;4917:23;4913:32;4910:52;;;4958:1;4955;4948:12;4910:52;4997:9;4984:23;5047:10;5040:5;5036:22;5029:5;5026:33;5016:61;;5073:1;5070;5063:12;5112:269;5169:6;5222:2;5210:9;5201:7;5197:23;5193:32;5190:52;;;5238:1;5235;5228:12;5190:52;5277:9;5264:23;5327:4;5320:5;5316:16;5309:5;5306:27;5296:55;;5347:1;5344;5337:12;5386:260;5454:6;5462;5515:2;5503:9;5494:7;5490:23;5486:32;5483:52;;;5531:1;5528;5521:12;5483:52;5554:29;5573:9;5554:29;:::i;:::-;5544:39;;5602:38;5636:2;5625:9;5621:18;5602:38;:::i;5651:437::-;5730:1;5726:12;;;;5773;;;5794:61;;5848:4;5840:6;5836:17;5826:27;;5794:61;5901:2;5893:6;5890:14;5870:18;5867:38;5864:218;;-1:-1:-1;;;5935:1:1;5928:88;6039:4;6036:1;6029:15;6067:4;6064:1;6057:15;6093:184;-1:-1:-1;;;6142:1:1;6135:88;6242:4;6239:1;6232:15;6266:4;6263:1;6256:15;6408:518;6510:2;6505:3;6502:11;6499:421;;;6546:5;6543:1;6536:16;6590:4;6587:1;6577:18;6660:2;6648:10;6644:19;6641:1;6637:27;6631:4;6627:38;6696:4;6684:10;6681:20;6678:47;;;-1:-1:-1;6719:4:1;6678:47;6774:2;6769:3;6765:12;6762:1;6758:20;6752:4;6748:31;6738:41;;6829:81;6847:2;6840:5;6837:13;6829:81;;;6906:1;6892:16;;6873:1;6862:13;6829:81;;7102:1198;7226:18;7221:3;7218:27;7215:53;;;7248:18;;:::i;:::-;7277:94;7367:3;7327:38;7359:4;7353:11;7327:38;:::i;:::-;7321:4;7277:94;:::i;:::-;7397:1;7422:2;7417:3;7414:11;7439:1;7434:608;;;;8086:1;8103:3;8100:93;;;-1:-1:-1;8159:19:1;;;8146:33;8100:93;-1:-1:-1;;7059:1:1;7055:11;;;7051:24;7047:29;7037:40;7083:1;7079:11;;;7034:57;8206:78;;7407:887;;7434:608;6355:1;6348:14;;;6392:4;6379:18;;-1:-1:-1;;7470:17:1;;;7585:229;7599:7;7596:1;7593:14;7585:229;;;7688:19;;;7675:33;7660:49;;7795:4;7780:20;;;;7748:1;7736:14;;;;7615:12;7585:229;;;7589:3;7842;7833:7;7830:16;7827:159;;;7966:1;7962:6;7956:3;7950;7947:1;7943:11;7939:21;7935:34;7931:39;7918:9;7913:3;7909:19;7896:33;7892:79;7884:6;7877:95;7827:159;;;8029:1;8023:3;8020:1;8016:11;8012:19;8006:4;7999:33;7407:887;;7102:1198;;;:::o;8305:184::-;-1:-1:-1;;;8354:1:1;8347:88;8454:4;8451:1;8444:15;8478:4;8475:1;8468:15;8494:168;8567:9;;;8598;;8615:15;;;8609:22;;8595:37;8585:71;;8636:18;;:::i;8667:191::-;8735:26;8794:10;;;8782;;;8778:27;;8817:12;;;8814:38;;;8832:18;;:::i;8863:201::-;8901:3;8929:10;8974:2;8967:5;8963:14;9001:2;8992:7;8989:15;8986:41;;9007:18;;:::i;:::-;9056:1;9043:15;;8863:201;-1:-1:-1;;;8863:201:1:o;9069:184::-;-1:-1:-1;;;9118:1:1;9111:88;9218:4;9215:1;9208:15;9242:4;9239:1;9232:15

Swarm Source

ipfs://a42479f0ba8eecd874ff5d12e1b47a24ad1df2dc43f2913de2e6db2deb4baf9d
Loading...
Loading
Loading...
Loading
[ Download: CSV Export  ]
[ Download: CSV Export  ]

A token is a representation of an on-chain or off-chain asset. The token page shows information such as price, total supply, holders, transfers and social links. Learn more about this page in our Knowledge Base.