ETH Price: $3,463.05 (+5.24%)

Contract

0xba798BD606d86D207ca2751510173532899117a1
 

Overview

ETH Balance

0 ETH

Eth Value

$0.00

Multichain Info

No addresses found
Transaction Hash
Method
Block
From
To
Create Sovereign...212431572024-11-22 12:05:2326 hrs ago1732277123IN
0xba798BD6...2899117a1
0 ETH0.0031741913.21211329
Create Sovereign...212272102024-11-20 6:38:113 days ago1732084691IN
0xba798BD6...2899117a1
0 ETH0.002079548.65104412
Create Sovereign...212063822024-11-17 8:58:476 days ago1731833927IN
0xba798BD6...2899117a1
0 ETH0.002136248.8926944
Create Sovereign...211897972024-11-15 1:25:358 days ago1731633935IN
0xba798BD6...2899117a1
0 ETH0.005251721.8561669
Create Sovereign...211156412024-11-04 17:00:5918 days ago1730739659IN
0xba798BD6...2899117a1
0 ETH0.0028576911.89473723
Create Sovereign...210778972024-10-30 10:35:2324 days ago1730284523IN
0xba798BD6...2899117a1
0 ETH0.0027841111.58670231
Create Sovereign...210778832024-10-30 10:32:3524 days ago1730284355IN
0xba798BD6...2899117a1
0 ETH0.002284719.51024959
Create Sovereign...210778742024-10-30 10:30:4724 days ago1730284247IN
0xba798BD6...2899117a1
0 ETH0.002237189.31055742
Create Sovereign...210716542024-10-29 13:41:3525 days ago1730209295IN
0xba798BD6...2899117a1
0 ETH0.0034378414.30806825
Create Sovereign...209769752024-10-16 8:37:2338 days ago1729067843IN
0xba798BD6...2899117a1
0 ETH0.0027028711.25424331
Create Sovereign...209499822024-10-12 14:01:2342 days ago1728741683IN
0xba798BD6...2899117a1
0 ETH0.0036276115.10015709
Create Sovereign...209479002024-10-12 7:00:5942 days ago1728716459IN
0xba798BD6...2899117a1
0 ETH0.0028541611.88299941
Create Sovereign...209441282024-10-11 18:20:2342 days ago1728670823IN
0xba798BD6...2899117a1
0 ETH0.0046007919.14439128
Create Sovereign...209177572024-10-08 2:05:5946 days ago1728353159IN
0xba798BD6...2899117a1
0 ETH0.002159638.9900526
Create Sovereign...209176912024-10-08 1:52:4746 days ago1728352367IN
0xba798BD6...2899117a1
0 ETH0.002088238.69499567
Create Sovereign...208397052024-09-27 4:55:5957 days ago1727412959IN
0xba798BD6...2899117a1
0 ETH0.0027382411.40039196
Create Sovereign...208301192024-09-25 20:51:3558 days ago1727297495IN
0xba798BD6...2899117a1
0 ETH0.008447935.15961228
Create Sovereign...208259552024-09-25 6:52:4759 days ago1727247167IN
0xba798BD6...2899117a1
0 ETH0.0026793611.14912831
Create Sovereign...208195642024-09-24 9:29:2360 days ago1727170163IN
0xba798BD6...2899117a1
0 ETH0.0050565321.04178514
Create Sovereign...208008072024-09-21 18:41:1162 days ago1726944071IN
0xba798BD6...2899117a1
0 ETH0.0034208713.02249004
Create Sovereign...207982982024-09-21 10:16:5963 days ago1726913819IN
0xba798BD6...2899117a1
0 ETH0.002126658.85145416
Create Sovereign...207735562024-09-17 23:18:5966 days ago1726615139IN
0xba798BD6...2899117a1
0 ETH0.001626166.77034068
Create Sovereign...207672112024-09-17 1:59:4767 days ago1726538387IN
0xba798BD6...2899117a1
0 ETH0.000562052.33851372
Create Sovereign...207667752024-09-17 0:31:4767 days ago1726533107IN
0xba798BD6...2899117a1
0 ETH0.000674542.80826686
Create Sovereign...207664142024-09-16 23:19:2367 days ago1726528763IN
0xba798BD6...2899117a1
0 ETH0.000625412.60369943
View all transactions

Latest 25 internal transactions (View All)

Advanced mode:
Parent Transaction Hash Block From To
212431572024-11-22 12:05:2326 hrs ago1732277123
0xba798BD6...2899117a1
 Contract Creation0 ETH
212272102024-11-20 6:38:113 days ago1732084691
0xba798BD6...2899117a1
 Contract Creation0 ETH
212063822024-11-17 8:58:476 days ago1731833927
0xba798BD6...2899117a1
 Contract Creation0 ETH
211897972024-11-15 1:25:358 days ago1731633935
0xba798BD6...2899117a1
 Contract Creation0 ETH
211156412024-11-04 17:00:5918 days ago1730739659
0xba798BD6...2899117a1
 Contract Creation0 ETH
210778972024-10-30 10:35:2324 days ago1730284523
0xba798BD6...2899117a1
 Contract Creation0 ETH
210778832024-10-30 10:32:3524 days ago1730284355
0xba798BD6...2899117a1
 Contract Creation0 ETH
210778742024-10-30 10:30:4724 days ago1730284247
0xba798BD6...2899117a1
 Contract Creation0 ETH
210716542024-10-29 13:41:3525 days ago1730209295
0xba798BD6...2899117a1
 Contract Creation0 ETH
209769752024-10-16 8:37:2338 days ago1729067843
0xba798BD6...2899117a1
 Contract Creation0 ETH
209499822024-10-12 14:01:2342 days ago1728741683
0xba798BD6...2899117a1
 Contract Creation0 ETH
209479002024-10-12 7:00:5942 days ago1728716459
0xba798BD6...2899117a1
 Contract Creation0 ETH
209441282024-10-11 18:20:2342 days ago1728670823
0xba798BD6...2899117a1
 Contract Creation0 ETH
209177572024-10-08 2:05:5946 days ago1728353159
0xba798BD6...2899117a1
 Contract Creation0 ETH
209176912024-10-08 1:52:4746 days ago1728352367
0xba798BD6...2899117a1
 Contract Creation0 ETH
208397052024-09-27 4:55:5957 days ago1727412959
0xba798BD6...2899117a1
 Contract Creation0 ETH
208301192024-09-25 20:51:3558 days ago1727297495
0xba798BD6...2899117a1
 Contract Creation0 ETH
208259552024-09-25 6:52:4759 days ago1727247167
0xba798BD6...2899117a1
 Contract Creation0 ETH
208195642024-09-24 9:29:2360 days ago1727170163
0xba798BD6...2899117a1
 Contract Creation0 ETH
208008072024-09-21 18:41:1162 days ago1726944071
0xba798BD6...2899117a1
 Contract Creation0 ETH
207982982024-09-21 10:16:5963 days ago1726913819
0xba798BD6...2899117a1
 Contract Creation0 ETH
207735562024-09-17 23:18:5966 days ago1726615139
0xba798BD6...2899117a1
 Contract Creation0 ETH
207672112024-09-17 1:59:4767 days ago1726538387
0xba798BD6...2899117a1
 Contract Creation0 ETH
207667752024-09-17 0:31:4767 days ago1726533107
0xba798BD6...2899117a1
 Contract Creation0 ETH
207664142024-09-16 23:19:2367 days ago1726528763
0xba798BD6...2899117a1
 Contract Creation0 ETH
View All Internal Transactions
Loading...
Loading

Contract Source Code Verified (Exact Match)

Contract Name:
LazySovereignNFTFactory

Compiler Version
v0.8.15+commit.e14f2714

Optimization Enabled:
Yes with 200 runs

Other Settings:
london EvmVersion
File 1 of 31 : LazySovereignNFTFactory.sol
// contracts/token/ERC721/sovereign/SovereignNFTContractFactory.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.15;

import "openzeppelin-contracts/access/Ownable.sol";
import "openzeppelin-contracts/proxy/Clones.sol";
import "./LazySovereignNFT.sol";
import "./extensions/LazySovereignNFTRoyaltyGuard.sol";
import "./extensions/LazySovereignNFTRoyaltyGuardDeadmanTrigger.sol";

contract LazySovereignNFTFactory is Ownable {

    bytes32 public constant LAZY_SOVEREIGN_NFT = keccak256("LAZY_SOVEREIGN_NFT");
    bytes32 public constant LAZY_ROYALTY_GUARD = keccak256("LAZY_ROYALTY_GUARD");
    bytes32 public constant LAZY_ROYALTY_GUARD_DEADMAN = keccak256("LAZY_ROYALTY_GUARD_DEADMAN");

    address public lazySovereignNFT;
    address public lazySovereignNFTRoyaltyGuard;
    address public lazySovereignNFTRoyaltyGuardDeadmanTrigger;

    event SovereignNFTContractCreated(
        address indexed contractAddress,
        address indexed owner
    );

    event SovereignNFTContractCreated(
        address indexed contractAddress,
        address indexed owner,
        bytes32 indexed contractType
    );

    constructor() {
        LazySovereignNFT lsovNFT = new LazySovereignNFT();
        lazySovereignNFT = address(lsovNFT);

        LazySovereignNFTRoyaltyGuard lsovNFTRG = new LazySovereignNFTRoyaltyGuard();
        lazySovereignNFTRoyaltyGuard = address(lsovNFTRG);

        LazySovereignNFTRoyaltyGuardDeadmanTrigger lsovNFTRGDT = new LazySovereignNFTRoyaltyGuardDeadmanTrigger();
        lazySovereignNFTRoyaltyGuardDeadmanTrigger = address(lsovNFTRGDT);
    }

    function setSovereignNFT(address _sovereignNFT, bytes32 _contractType)
        external
        onlyOwner
    {
        require(_sovereignNFT != address(0));
        if (_contractType == LAZY_SOVEREIGN_NFT) {
            lazySovereignNFT = _sovereignNFT;
            return;
        }
        if (_contractType == LAZY_ROYALTY_GUARD) {
            lazySovereignNFTRoyaltyGuard = _sovereignNFT;
            return;
        }
        if (_contractType == LAZY_ROYALTY_GUARD_DEADMAN) {
            lazySovereignNFTRoyaltyGuardDeadmanTrigger = _sovereignNFT;
            return;
        }
        require(false, "setSovereignNFT::Unsupported _contractType.");
    }


    function createSovereignNFTContract(
        string memory _name,
        string memory _symbol,
        uint256 _maxTokens,
        bytes32 _contractType
    ) public returns (address) {
        require(
            _maxTokens != 0,
            "createSovereignNFTContract::_maxTokens cant be zero"
        );

        address sovAddr;
        if (_contractType == LAZY_SOVEREIGN_NFT) {
            sovAddr = Clones.clone(lazySovereignNFT);
            LazySovereignNFT(sovAddr).init(_name, _symbol, msg.sender, _maxTokens);
        }
        if (_contractType == LAZY_ROYALTY_GUARD) {
            sovAddr = Clones.clone(lazySovereignNFTRoyaltyGuard);
            LazySovereignNFTRoyaltyGuard(sovAddr).init(
                _name,
                _symbol,
                msg.sender,
                _maxTokens
            );
        }
        if (_contractType == LAZY_ROYALTY_GUARD_DEADMAN) {
            sovAddr = Clones.clone(lazySovereignNFTRoyaltyGuardDeadmanTrigger);
            LazySovereignNFTRoyaltyGuardDeadmanTrigger(sovAddr).init(
                _name,
                _symbol,
                msg.sender,
                _maxTokens
            );
        }
        require(
            sovAddr != address(0),
            "createSovereignNFTContract::_contractType unsupported contract type."
        );
        emit SovereignNFTContractCreated(sovAddr, msg.sender);
        emit SovereignNFTContractCreated(sovAddr, msg.sender, _contractType);

        return address(sovAddr);
    }
}

File 2 of 31 : Ownable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/Ownable.sol)

pragma solidity ^0.8.0;

import "../utils/Context.sol";

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

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

    /**
     * @dev Initializes the contract setting the deployer as the initial owner.
     */
    constructor() {
        _transferOwnership(_msgSender());
    }

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

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        require(owner() == _msgSender(), "Ownable: caller is not the owner");
        _;
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions anymore. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby removing any functionality that is only available to the owner.
     */
    function renounceOwnership() public virtual onlyOwner {
        _transferOwnership(address(0));
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual onlyOwner {
        require(newOwner != address(0), "Ownable: new owner is the zero address");
        _transferOwnership(newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual {
        address oldOwner = _owner;
        _owner = newOwner;
        emit OwnershipTransferred(oldOwner, newOwner);
    }
}

File 3 of 31 : Clones.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (proxy/Clones.sol)

pragma solidity ^0.8.0;

/**
 * @dev https://eips.ethereum.org/EIPS/eip-1167[EIP 1167] is a standard for
 * deploying minimal proxy contracts, also known as "clones".
 *
 * > To simply and cheaply clone contract functionality in an immutable way, this standard specifies
 * > a minimal bytecode implementation that delegates all calls to a known, fixed address.
 *
 * The library includes functions to deploy a proxy using either `create` (traditional deployment) or `create2`
 * (salted deterministic deployment). It also includes functions to predict the addresses of clones deployed using the
 * deterministic method.
 *
 * _Available since v3.4._
 */
library Clones {
    /**
     * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`.
     *
     * This function uses the create opcode, which should never revert.
     */
    function clone(address implementation) internal returns (address instance) {
        assembly {
            let ptr := mload(0x40)
            mstore(ptr, 0x602d8060093d393df3363d3d373d3d3d363d7300000000000000000000000000)
            mstore(add(ptr, 0x13), shl(0x60, implementation))
            mstore(add(ptr, 0x27), 0x5af43d82803e903d91602b57fd5bf30000000000000000000000000000000000)
            instance := create(0, ptr, 0x36)
        }
        require(instance != address(0), "ERC1167: create failed");
    }

    /**
     * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`.
     *
     * This function uses the create2 opcode and a `salt` to deterministically deploy
     * the clone. Using the same `implementation` and `salt` multiple time will revert, since
     * the clones cannot be deployed twice at the same address.
     */
    function cloneDeterministic(address implementation, bytes32 salt) internal returns (address instance) {
        assembly {
            let ptr := mload(0x40)
            mstore(ptr, 0x602d8060093d393df3363d3d373d3d3d363d7300000000000000000000000000)
            mstore(add(ptr, 0x13), shl(0x60, implementation))
            mstore(add(ptr, 0x27), 0x5af43d82803e903d91602b57fd5bf30000000000000000000000000000000000)
            instance := create2(0, ptr, 0x36, salt)
        }
        require(instance != address(0), "ERC1167: create2 failed");
    }

    /**
     * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}.
     */
    function predictDeterministicAddress(
        address implementation,
        bytes32 salt,
        address deployer
    ) internal pure returns (address predicted) {
        assembly {
            let ptr := mload(0x40)
            mstore(ptr, 0x602d8060093d393df3363d3d373d3d3d363d7300000000000000000000000000)
            mstore(add(ptr, 0x13), shl(0x60, implementation))
            mstore(add(ptr, 0x27), 0x5af43d82803e903d91602b57fd5bf3ff00000000000000000000000000000000)
            mstore(add(ptr, 0x37), shl(0x60, deployer))
            mstore(add(ptr, 0x4b), salt)
            mstore(add(ptr, 0x6b), keccak256(ptr, 0x36))
            predicted := keccak256(add(ptr, 0x36), 0x55)
        }
    }

    /**
     * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}.
     */
    function predictDeterministicAddress(address implementation, bytes32 salt)
        internal
        view
        returns (address predicted)
    {
        return predictDeterministicAddress(implementation, salt, address(this));
    }
}

File 4 of 31 : LazySovereignNFT.sol
// contracts/token/ERC721/sovereign/SovereignNFT.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.15;

import "openzeppelin-contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol";
import "openzeppelin-contracts-upgradeable/token/ERC721/extensions/ERC721BurnableUpgradeable.sol";
import "openzeppelin-contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol";
import "openzeppelin-contracts-upgradeable/access/OwnableUpgradeable.sol";
import "openzeppelin-contracts-upgradeable/utils/CountersUpgradeable.sol";
import "openzeppelin-contracts-upgradeable/utils/math/SafeMathUpgradeable.sol";
import "../../../extensions/ITokenCreator.sol";
import "../../../extensions/ERC2981Upgradeable.sol";

/**
 * @title LazySovereignNFT
 * @dev This contract implements an ERC721 compliant NFT (Non-Fungible Token) with lazy minting.
 */

contract LazySovereignNFT is
    OwnableUpgradeable,
    ERC165Upgradeable,
    ERC721Upgradeable,
    ITokenCreator,
    ERC721BurnableUpgradeable,
    ERC2981Upgradeable
{
    using SafeMathUpgradeable for uint256;
    using StringsUpgradeable for uint256;
    using CountersUpgradeable for CountersUpgradeable.Counter;

    /////////////////////////////////////////////////////////////////////////////
    // Structs
    /////////////////////////////////////////////////////////////////////////////
    struct MintConfig {
        uint256 numberOfTokens;
        string baseURI;
        bool lockedMetadata;
    }

    /////////////////////////////////////////////////////////////////////////////
    // Storage
    /////////////////////////////////////////////////////////////////////////////
    //////////////////////////////////////////////
    // Public
    //////////////////////////////////////////////
    // Disabled flag
    bool public disabled;

    // Maximum number of tokens that can be minted
    uint256 public maxTokens;

    //////////////////////////////////////////////
    // Private
    //////////////////////////////////////////////
    // Mapping from token ID to approved address
    mapping(uint256 => address) private tokenApprovals;

    // Mapping from addresses that can mint outside of the owner
    mapping(address => bool) private minterAddresses;

    // Optional mapping for token URIs
    mapping(uint256 => string) private _tokenURIs;

    // Counter to keep track of the current token id.
    CountersUpgradeable.Counter private tokenIdCounter;

    // Mint batches for batch minting
    MintConfig private mintConfig;

    /////////////////////////////////////////////////////////////////////////////
    // Events
    /////////////////////////////////////////////////////////////////////////////
    // Emits when the contract is disabled.
    event ContractDisabled(address indexed user);

    // Emits when prepared for minting.
    event PrepareMint(uint256 indexed numberOfTokens, string baseURI);

    // Emits when metadata is locked.
    event MetadataLocked(string baseURI);

    // Emits when metadata is updated.
    event MetadataUpdated(string baseURI);

    // Emits when token URI is updated.
    event TokenURIUpdated(uint256 indexed tokenId, string metadataUri);

    /////////////////////////////////////////////////////////////////////////////
    // Init
    /////////////////////////////////////////////////////////////////////////////
    /**
     * @dev Contract initialization function.
     * @param _name The name of the NFT contract.
     * @param _symbol The symbol of the NFT contract.
     * @param _creator The address of the contract creator.
     * @param _maxTokens The maximum number of tokens that can be minted.
     */
    function init(
        string calldata _name,
        string calldata _symbol,
        address _creator,
        uint256 _maxTokens
    ) public initializer {
        require(_creator != address(0), "creator cannot be null address");
        _setDefaultRoyaltyPercentage(10);
        disabled = false;
        maxTokens = _maxTokens;

        __Ownable_init();
        __ERC721_init(_name, _symbol);
        __ERC165_init();
        __ERC2981__init();

        _setDefaultRoyaltyReceiver(_creator);

        super.transferOwnership(_creator);
    }

    /////////////////////////////////////////////////////////////////////////////
    // Modifiers
    /////////////////////////////////////////////////////////////////////////////
    /**
     * @dev Modifier to check if the contract is not disabled.
     */
    modifier ifNotDisabled() {
        require(!disabled, "Contract must not be disabled.");
        _;
    }

    /////////////////////////////////////////////////////////////////////////////
    // Write Functions
    /////////////////////////////////////////////////////////////////////////////

    /**
     * @dev Set a minter for the contract
     * @param _minter address of the minter.
     * @param _isMinter bool of whether the address is a minter.
     */
    function setMinterApproval(
        address _minter,
        bool _isMinter
    ) public onlyOwner ifNotDisabled {
        minterAddresses[_minter] = _isMinter;
    }

    /**
     * @dev Prepare a minting batch with a specified base URI and number of tokens.
     * @param _baseURI The base URI for token metadata.
     * @param _numberOfTokens The number of tokens to prepare for minting.
     */
    function prepareMint(
        string calldata _baseURI,
        uint256 _numberOfTokens
    ) public onlyOwner ifNotDisabled {
        _prepareMint(_baseURI, _numberOfTokens);
    }

    /**
     * @dev Prepare a minting batch with a specified base URI and number of tokens, and assign a minter address.
     * @param _baseURI The base URI for token metadata.
     * @param _numberOfTokens The number of tokens to prepare for minting.
     * @param _minter The address of the minter.
     */
    function prepareMintWithMinter(
        string calldata _baseURI,
        uint256 _numberOfTokens,
        address _minter
    ) public onlyOwner ifNotDisabled {
        _prepareMint(_baseURI, _numberOfTokens);
        minterAddresses[_minter] = true;
    }

    /**
     * @dev Mint a new token to the specified receiver.
     * @param _receiver The address of the token receiver.
     * @return uint256 Token Id of the new token.
     */
    function mintTo(
        address _receiver
    ) external ifNotDisabled returns (uint256) {
        require(
            msg.sender == owner() || minterAddresses[msg.sender],
            "lazyMint::only owner or approved minter can mint"
        );
        return
            _createToken(
                _receiver,
                getDefaultRoyaltyPercentage(),
                getDefaultRoyaltyReceiver()
            );
    }

    /**
     * @dev Delete a token with the given ID.
     * @param _tokenId The ID of the token to delete.
     */
    function deleteToken(uint256 _tokenId) public {
        require(
            ownerOf(_tokenId) == msg.sender,
            "Must be the owner of the token."
        );
        burn(_tokenId);
    }

    /**
     * @dev Disable the contract, preventing further minting.
     */
    function disableContract() public onlyOwner {
        disabled = true;
        emit ContractDisabled(msg.sender);
    }

    /**
     * @dev Set the default royalty receiver address.
     * @param _receiver The address of the default royalty receiver.
     */
    function setDefaultRoyaltyReceiver(address _receiver) external onlyOwner {
        _setDefaultRoyaltyReceiver(_receiver);
    }

    /**
     * @dev Set a specific royalty receiver address for a token.
     * @param _receiver The address of the royalty receiver.
     * @param _tokenId The ID of the token.
     */
    function setRoyaltyReceiverForToken(
        address _receiver,
        uint256 _tokenId
    ) external onlyOwner {
        royaltyReceivers[_tokenId] = _receiver;
    }

    /**
     * @dev Update the base URI.
     * @param _baseURI The new base URI.
     */
    function updateBaseURI(string calldata _baseURI) external onlyOwner {
        require(
            !mintConfig.lockedMetadata,
            "updateBaseURI::metadata is locked"
        );

        mintConfig.baseURI = _baseURI;
        emit MetadataUpdated(_baseURI);
    }

    /**
     * @dev Update the token metadata URI.
     * @param _metadataUri The new metadata URI.
     */
    function updateTokenURI(
        uint256 _tokenId,
        string calldata _metadataUri
    ) external onlyOwner {
        require(
            !mintConfig.lockedMetadata,
            "updateTokenURI::metadata is locked"
        );

        _tokenURIs[_tokenId] = _metadataUri;
        emit TokenURIUpdated(_tokenId, _metadataUri);
    }

    /**
     * @dev Lock the metadata to prevent  further updates.
     */
    function lockBaseURI() external onlyOwner {
        emit MetadataLocked(mintConfig.baseURI);
        mintConfig.lockedMetadata = true;
    }

    /////////////////////////////////////////////////////////////////////////////
    // Read Functions
    /////////////////////////////////////////////////////////////////////////////
    /**
     * @dev Checks if the supplied address is approved for minting
     * @param _address The address of the minter.
     * @return bool, whether the address is approved for minting.
     */
    function isApprovedMinter(address _address) public view returns (bool) {
        return minterAddresses[_address];
    }

    /**
     * @dev Get the address of the token creator for a given token ID.
     * @param _tokenId The ID of the token.
     * @return address of the token creator.
     */
    function tokenCreator(
        uint256 _tokenId
    ) public view override returns (address payable) {
        return payable(owner());
    }

    /**
     * @dev Get the current minting configuration.
     * @return mintConfig the mint config.
     */
    function getMintConfig() public view returns (MintConfig memory) {
        return mintConfig;
    }

    /**
     * @dev Get the token URI for a specific token. If a token has a set URI,
     * it will return that, otherwise it will return the token URI computed from
     * the base URI.
     * @param _tokenId The ID of the token.
     * @return The token's URI.
     */
    function tokenURI(
        uint256 _tokenId
    ) public view virtual override returns (string memory) {
        if (bytes(_tokenURIs[_tokenId]).length > 0) {
            return _tokenURIs[_tokenId];
        }
        return
            string(
                abi.encodePacked(
                    mintConfig.baseURI,
                    "/",
                    _tokenId.toString(),
                    ".json"
                )
            );
    }

    /**
     * @dev Get the total supply of tokens in existence.
     * @return The total supply of tokens.
     */
    function totalSupply() public view virtual returns (uint256) {
        return tokenIdCounter.current();
    }

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

    /////////////////////////////////////////////////////////////////////////////
    // Internal Functions
    /////////////////////////////////////////////////////////////////////////////
    /**
     * @dev Create a new token and assign it to the specified recipient.
     * @param _to The address of the token recipient.
     * @param _royaltyPercentage The royalty percentage for the token.
     * @param _royaltyReceiver The address of the royalty receiver for the token.
     * @return The ID of the newly created token.
     */
    function _createToken(
        address _to,
        uint256 _royaltyPercentage,
        address _royaltyReceiver
    ) internal returns (uint256) {
        tokenIdCounter.increment();
        uint256 tokenId = tokenIdCounter.current();
        require(tokenId <= maxTokens, "_createToken::exceeded maxTokens");
        _safeMint(_to, tokenId);
        _setRoyaltyPercentage(tokenId, _royaltyPercentage);
        _setRoyaltyReceiver(tokenId, _royaltyReceiver);
        return tokenId;
    }

    /**
     * @dev Prepare a minting batch with a specified base URI and number of tokens.
     * @param _baseURI The base URI for token metadata.
     * @param _numberOfTokens The number of tokens to prepare for minting.
     */
    function _prepareMint(
        string calldata _baseURI,
        uint256 _numberOfTokens
    ) internal {
        require(
            _numberOfTokens <= maxTokens,
            "_prepareMint::exceeded maxTokens"
        );
        require(
            tokenIdCounter.current() == 0,
            "_prepareMint::can only prepare mint with 0 tokens"
        );
        mintConfig = MintConfig(_numberOfTokens, _baseURI, false);
        emit PrepareMint(_numberOfTokens, _baseURI);
    }
}

File 5 of 31 : LazySovereignNFTRoyaltyGuard.sol
// contracts/token/ERC721/sovereign/SovereignNFT.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "royalty-guard/RoyaltyGuard.sol";

import "../LazySovereignNFT.sol";

contract LazySovereignNFTRoyaltyGuard is LazySovereignNFT, RoyaltyGuard {
    /*//////////////////////////////////////////////////////////////////////////
                              ERC165 LOGIC
  //////////////////////////////////////////////////////////////////////////*/

    /// @dev See {IERC165-supportsInterface}.
    function supportsInterface(bytes4 _interfaceId)
        public
        view
        virtual
        override(LazySovereignNFT, RoyaltyGuard)
        returns (bool)
    {
        return
            RoyaltyGuard.supportsInterface(_interfaceId) ||
            LazySovereignNFT.supportsInterface(_interfaceId);
    }

    /*//////////////////////////////////////////////////////////////////////////
                          RoyaltyGuard LOGIC
  //////////////////////////////////////////////////////////////////////////*/

    /// @inheritdoc RoyaltyGuard
    function hasAdminPermission(address _addr)
        public
        view
        virtual
        override
        returns (bool)
    {
        return _addr == owner();
    }

    /// @dev Guards {approve} based on the type of list and depending if {_spender} is on the list.
    function approve(address _spender, uint256 _id)
        public
        virtual
        override
        checkList(_spender)
    {
        super.approve(_spender, _id);
    }

    /// @dev Guards {setApprovalForAll} based on the type of list and depending if {_operator} is on the list.
    function setApprovalForAll(address _operator, bool _approved)
        public
        virtual
        override
        checkList(_operator)
    {
        super.setApprovalForAll(_operator, _approved);
    }
}

File 6 of 31 : LazySovereignNFTRoyaltyGuardDeadmanTrigger.sol
// contracts/token/ERC721/sovereign/SovereignNFT.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "royalty-guard/extensions/RoyaltyGuardDeadmanTrigger.sol";

import "../LazySovereignNFT.sol";

contract LazySovereignNFTRoyaltyGuardDeadmanTrigger is
    LazySovereignNFT,
    RoyaltyGuardDeadmanTrigger
{
    /*//////////////////////////////////////////////////////////////////////////
                              ERC165 LOGIC
  //////////////////////////////////////////////////////////////////////////*/

    /// @dev See {IERC165-supportsInterface}.
    function supportsInterface(bytes4 _interfaceId)
        public
        view
        virtual
        override(LazySovereignNFT, RoyaltyGuard)
        returns (bool)
    {
        return
            RoyaltyGuard.supportsInterface(_interfaceId) ||
            LazySovereignNFT.supportsInterface(_interfaceId);
    }

    /*//////////////////////////////////////////////////////////////////////////
                          RoyaltyGuard LOGIC
  //////////////////////////////////////////////////////////////////////////*/

    /// @inheritdoc RoyaltyGuard
    function hasAdminPermission(address _addr)
        public
        view
        virtual
        override(IRoyaltyGuard, RoyaltyGuard)
        returns (bool)
    {
        return _addr == owner();
    }

    /// @dev Guards {approve} based on the type of list and depending if {_spender} is on the list.
    function approve(address _spender, uint256 _id)
        public
        virtual
        override
        checkList(_spender)
    {
        super.approve(_spender, _id);
    }

    /// @dev Guards {setApprovalForAll} based on the type of list and depending if {_operator} is on the list.
    function setApprovalForAll(address _operator, bool _approved)
        public
        virtual
        override
        checkList(_operator)
    {
        super.setApprovalForAll(_operator, _approved);
    }
}

File 7 of 31 : Context.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)

pragma solidity ^0.8.0;

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

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

File 8 of 31 : ERC721Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (token/ERC721/ERC721.sol)

pragma solidity ^0.8.0;

import "./IERC721Upgradeable.sol";
import "./IERC721ReceiverUpgradeable.sol";
import "./extensions/IERC721MetadataUpgradeable.sol";
import "../../utils/AddressUpgradeable.sol";
import "../../utils/ContextUpgradeable.sol";
import "../../utils/StringsUpgradeable.sol";
import "../../utils/introspection/ERC165Upgradeable.sol";
import "../../proxy/utils/Initializable.sol";

/**
 * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
 * the Metadata extension, but not including the Enumerable extension, which is available separately as
 * {ERC721Enumerable}.
 */
contract ERC721Upgradeable is Initializable, ContextUpgradeable, ERC165Upgradeable, IERC721Upgradeable, IERC721MetadataUpgradeable {
    using AddressUpgradeable for address;
    using StringsUpgradeable for uint256;

    // Token name
    string private _name;

    // Token symbol
    string private _symbol;

    // Mapping from token ID to owner address
    mapping(uint256 => address) private _owners;

    // Mapping owner address to token count
    mapping(address => uint256) private _balances;

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

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

    /**
     * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
     */
    function __ERC721_init(string memory name_, string memory symbol_) internal onlyInitializing {
        __ERC721_init_unchained(name_, symbol_);
    }

    function __ERC721_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
        _name = name_;
        _symbol = symbol_;
    }

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

    /**
     * @dev See {IERC721-balanceOf}.
     */
    function balanceOf(address owner) public view virtual override returns (uint256) {
        require(owner != address(0), "ERC721: address zero is not a valid owner");
        return _balances[owner];
    }

    /**
     * @dev See {IERC721-ownerOf}.
     */
    function ownerOf(uint256 tokenId) public view virtual override returns (address) {
        address owner = _owners[tokenId];
        require(owner != address(0), "ERC721: owner query for nonexistent token");
        return owner;
    }

    /**
     * @dev See {IERC721Metadata-name}.
     */
    function name() public view virtual override returns (string memory) {
        return _name;
    }

    /**
     * @dev See {IERC721Metadata-symbol}.
     */
    function symbol() public view virtual override returns (string memory) {
        return _symbol;
    }

    /**
     * @dev See {IERC721Metadata-tokenURI}.
     */
    function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
        require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");

        string memory baseURI = _baseURI();
        return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
    }

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

    /**
     * @dev See {IERC721-approve}.
     */
    function approve(address to, uint256 tokenId) public virtual override {
        address owner = ERC721Upgradeable.ownerOf(tokenId);
        require(to != owner, "ERC721: approval to current owner");

        require(
            _msgSender() == owner || isApprovedForAll(owner, _msgSender()),
            "ERC721: approve caller is not owner nor approved for all"
        );

        _approve(to, tokenId);
    }

    /**
     * @dev See {IERC721-getApproved}.
     */
    function getApproved(uint256 tokenId) public view virtual override returns (address) {
        require(_exists(tokenId), "ERC721: approved query for nonexistent token");

        return _tokenApprovals[tokenId];
    }

    /**
     * @dev See {IERC721-setApprovalForAll}.
     */
    function setApprovalForAll(address operator, bool approved) public virtual override {
        _setApprovalForAll(_msgSender(), operator, approved);
    }

    /**
     * @dev See {IERC721-isApprovedForAll}.
     */
    function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
        return _operatorApprovals[owner][operator];
    }

    /**
     * @dev See {IERC721-transferFrom}.
     */
    function transferFrom(
        address from,
        address to,
        uint256 tokenId
    ) public virtual override {
        //solhint-disable-next-line max-line-length
        require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");

        _transfer(from, to, tokenId);
    }

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

        _beforeTokenTransfer(from, to, tokenId);

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

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

        emit Transfer(from, to, tokenId);

        _afterTokenTransfer(from, to, tokenId);
    }

    /**
     * @dev Approve `to` to operate on `tokenId`
     *
     * Emits a {Approval} event.
     */
    function _approve(address to, uint256 tokenId) internal virtual {
        _tokenApprovals[tokenId] = to;
        emit Approval(ERC721Upgradeable.ownerOf(tokenId), to, tokenId);
    }

    /**
     * @dev Approve `operator` to operate on all of `owner` tokens
     *
     * Emits a {ApprovalForAll} event.
     */
    function _setApprovalForAll(
        address owner,
        address operator,
        bool approved
    ) internal virtual {
        require(owner != operator, "ERC721: approve to caller");
        _operatorApprovals[owner][operator] = approved;
        emit ApprovalForAll(owner, operator, approved);
    }

    /**
     * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
     * The call is not executed if the target address is not a contract.
     *
     * @param from address representing the previous owner of the given token ID
     * @param to target address that will receive the tokens
     * @param tokenId uint256 ID of the token to be transferred
     * @param _data bytes optional data to send along with the call
     * @return bool whether the call correctly returned the expected magic value
     */
    function _checkOnERC721Received(
        address from,
        address to,
        uint256 tokenId,
        bytes memory _data
    ) private returns (bool) {
        if (to.isContract()) {
            try IERC721ReceiverUpgradeable(to).onERC721Received(_msgSender(), from, tokenId, _data) returns (bytes4 retval) {
                return retval == IERC721ReceiverUpgradeable.onERC721Received.selector;
            } catch (bytes memory reason) {
                if (reason.length == 0) {
                    revert("ERC721: transfer to non ERC721Receiver implementer");
                } else {
                    assembly {
                        revert(add(32, reason), mload(reason))
                    }
                }
            }
        } else {
            return true;
        }
    }

    /**
     * @dev Hook that is called before any token transfer. This includes minting
     * and burning.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
     * transferred to `to`.
     * - When `from` is zero, `tokenId` will be minted for `to`.
     * - When `to` is zero, ``from``'s `tokenId` will be burned.
     * - `from` and `to` are never both zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _beforeTokenTransfer(
        address from,
        address to,
        uint256 tokenId
    ) internal virtual {}

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

    /**
     * @dev This empty reserved space is put in place to allow future versions to add new
     * variables without shifting down storage in the inheritance chain.
     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
     */
    uint256[44] private __gap;
}

File 9 of 31 : ERC721BurnableUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/ERC721Burnable.sol)

pragma solidity ^0.8.0;

import "../ERC721Upgradeable.sol";
import "../../../utils/ContextUpgradeable.sol";
import "../../../proxy/utils/Initializable.sol";

/**
 * @title ERC721 Burnable Token
 * @dev ERC721 Token that can be irreversibly burned (destroyed).
 */
abstract contract ERC721BurnableUpgradeable is Initializable, ContextUpgradeable, ERC721Upgradeable {
    function __ERC721Burnable_init() internal onlyInitializing {
    }

    function __ERC721Burnable_init_unchained() internal onlyInitializing {
    }
    /**
     * @dev Burns `tokenId`. See {ERC721-_burn}.
     *
     * Requirements:
     *
     * - The caller must own `tokenId` or be an approved operator.
     */
    function burn(uint256 tokenId) public virtual {
        //solhint-disable-next-line max-line-length
        require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721Burnable: caller is not owner nor approved");
        _burn(tokenId);
    }

    /**
     * @dev This empty reserved space is put in place to allow future versions to add new
     * variables without shifting down storage in the inheritance chain.
     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
     */
    uint256[50] private __gap;
}

File 10 of 31 : ERC165Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)

pragma solidity ^0.8.0;

import "./IERC165Upgradeable.sol";
import "../../proxy/utils/Initializable.sol";

/**
 * @dev Implementation of the {IERC165} interface.
 *
 * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
 * for the additional interface id that will be supported. For example:
 *
 * ```solidity
 * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
 *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
 * }
 * ```
 *
 * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
 */
abstract contract ERC165Upgradeable is Initializable, IERC165Upgradeable {
    function __ERC165_init() internal onlyInitializing {
    }

    function __ERC165_init_unchained() internal onlyInitializing {
    }
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IERC165Upgradeable).interfaceId;
    }

    /**
     * @dev This empty reserved space is put in place to allow future versions to add new
     * variables without shifting down storage in the inheritance chain.
     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
     */
    uint256[50] private __gap;
}

File 11 of 31 : OwnableUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/Ownable.sol)

pragma solidity ^0.8.0;

import "../utils/ContextUpgradeable.sol";
import "../proxy/utils/Initializable.sol";

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

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

    /**
     * @dev Initializes the contract setting the deployer as the initial owner.
     */
    function __Ownable_init() internal onlyInitializing {
        __Ownable_init_unchained();
    }

    function __Ownable_init_unchained() internal onlyInitializing {
        _transferOwnership(_msgSender());
    }

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

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        require(owner() == _msgSender(), "Ownable: caller is not the owner");
        _;
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions anymore. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby removing any functionality that is only available to the owner.
     */
    function renounceOwnership() public virtual onlyOwner {
        _transferOwnership(address(0));
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual onlyOwner {
        require(newOwner != address(0), "Ownable: new owner is the zero address");
        _transferOwnership(newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual {
        address oldOwner = _owner;
        _owner = newOwner;
        emit OwnershipTransferred(oldOwner, newOwner);
    }

    /**
     * @dev This empty reserved space is put in place to allow future versions to add new
     * variables without shifting down storage in the inheritance chain.
     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
     */
    uint256[49] private __gap;
}

File 12 of 31 : CountersUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Counters.sol)

pragma solidity ^0.8.0;

/**
 * @title Counters
 * @author Matt Condon (@shrugs)
 * @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
 * of elements in a mapping, issuing ERC721 ids, or counting request ids.
 *
 * Include with `using Counters for Counters.Counter;`
 */
library CountersUpgradeable {
    struct Counter {
        // This variable should never be directly accessed by users of the library: interactions must be restricted to
        // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
        // this feature: see https://github.com/ethereum/solidity/issues/4637
        uint256 _value; // default: 0
    }

    function current(Counter storage counter) internal view returns (uint256) {
        return counter._value;
    }

    function increment(Counter storage counter) internal {
        unchecked {
            counter._value += 1;
        }
    }

    function decrement(Counter storage counter) internal {
        uint256 value = counter._value;
        require(value > 0, "Counter: decrement overflow");
        unchecked {
            counter._value = value - 1;
        }
    }

    function reset(Counter storage counter) internal {
        counter._value = 0;
    }
}

File 13 of 31 : SafeMathUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/math/SafeMath.sol)

pragma solidity ^0.8.0;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

File 14 of 31 : ITokenCreator.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

interface ITokenCreator {
    // bytes4(keccak256(tokenCreator(uint256))) == 0x40c1a064
    function tokenCreator(uint256 _tokenId)
        external
        view
        returns (address payable);
}

File 15 of 31 : ERC2981Upgradeable.sol
// contracts/royalty/ERC2981.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;

import "openzeppelin-contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol";
import "openzeppelin-contracts-upgradeable/utils/math/SafeMathUpgradeable.sol";
import "./IERC2981.sol";

abstract contract ERC2981Upgradeable is IERC2981, ERC165Upgradeable {
    using SafeMathUpgradeable for uint256;

    // bytes4(keccak256("royaltyInfo(uint256,uint256)")) == 0x2a55205a
    bytes4 private constant _INTERFACE_ID_ERC2981 = 0x2a55205a;

    address private defaultRoyaltyReceiver;

    uint256 private defaultRoyaltyPercentage;

    mapping(uint256 => address) royaltyReceivers;
    mapping(uint256 => uint256) royaltyPercentages;

    constructor() {}

    function __ERC2981__init() internal onlyInitializing {
        __ERC165_init();
    }

    function royaltyInfo(uint256 _tokenId, uint256 _salePrice)
        public
        view
        virtual
        override
        returns (address receiver, uint256 royaltyAmount)
    {
        receiver = royaltyReceivers[_tokenId] != address(0)
            ? royaltyReceivers[_tokenId]
            : defaultRoyaltyReceiver;
        royaltyAmount = _salePrice
            .mul(
                royaltyPercentages[_tokenId] != 0
                    ? royaltyPercentages[_tokenId]
                    : defaultRoyaltyPercentage
            )
            .div(100);
    }

    function _setDefaultRoyaltyReceiver(address _receiver) internal {
        defaultRoyaltyReceiver = _receiver;
    }

    function _setRoyaltyReceiver(uint256 _tokenId, address _newReceiver)
        internal
    {
        royaltyReceivers[_tokenId] = _newReceiver;
    }

    function _setRoyaltyPercentage(uint256 _tokenId, uint256 _percentage)
        internal
    {
        royaltyPercentages[_tokenId] = _percentage;
    }

    function supportsInterface(bytes4 interfaceId)
        public
        view
        virtual
        override
        returns (bool)
    {
        return
            interfaceId == type(IERC2981).interfaceId ||
            super.supportsInterface(interfaceId);
    }

    function _setDefaultRoyaltyPercentage(uint256 _percentage) internal {
        defaultRoyaltyPercentage = _percentage;
    }

    function getDefaultRoyaltyReceiver() public view returns (address) {
        return defaultRoyaltyReceiver;
    }

    function getDefaultRoyaltyPercentage() public view returns (uint256) {
        return defaultRoyaltyPercentage;
    }
}

File 16 of 31 : RoyaltyGuard.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.15;

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

import {EnumerableSet} from "openzeppelin-contracts/utils/structs/EnumerableSet.sol";
import {ERC165} from "openzeppelin-contracts/utils/introspection/ERC165.sol";

/// @title RoyaltyGuard
/// @author highland, koloz, van arman
/// @notice An abstract contract with the necessary functions, structures, modifiers to ensure royalties are paid.
/// @dev Inherriting this contract requires implementing {hasAdminPermission} and connecting the desired functions to the {checkList} modifier.
abstract contract RoyaltyGuard is IRoyaltyGuard, ERC165 {
  using EnumerableSet for EnumerableSet.AddressSet;

  /*//////////////////////////////////////////////////////////////////////////
                          Private Contract Storage
  //////////////////////////////////////////////////////////////////////////*/

  mapping(IRoyaltyGuard.ListType => EnumerableSet.AddressSet) private list;
  IRoyaltyGuard.ListType private listType;

  /*//////////////////////////////////////////////////////////////////////////
                                Modifiers
  //////////////////////////////////////////////////////////////////////////*/

  /// @notice Checks if an address is part the current, in-use list
  /// @dev depending on list type and if the address is on the list will throw {IRoyaltyGuard.Unauthorized}
  modifier checkList(address _addr) {
    if (listType == IRoyaltyGuard.ListType.ALLOW) {
      if (!list[IRoyaltyGuard.ListType.ALLOW].contains(_addr)) revert IRoyaltyGuard.Unauthorized();
    } else if (listType == IRoyaltyGuard.ListType.DENY) {
      if (list[IRoyaltyGuard.ListType.DENY].contains(_addr)) revert IRoyaltyGuard.Unauthorized();
    }
    _;
  }

  /// @notice Checks to see if the msg.sender has admin permissions.
  /// @dev {hasAdminPermissions} is an abstract function that the implementing contract will define.
  /// @dev if msg.sender doesnt have permission will throw {IRoyaltyGuard.MustBeAdmin}
  modifier onlyAdmin() {
    if (!hasAdminPermission(msg.sender)) revert IRoyaltyGuard.MustBeAdmin();
    _;
  }

  /*//////////////////////////////////////////////////////////////////////////
                            Admin Functions
  //////////////////////////////////////////////////////////////////////////*/

  /// @dev Only the contract owner can call this function.
  /// @inheritdoc IRoyaltyGuard
  function toggleListType(IRoyaltyGuard.ListType _newListType) external virtual onlyAdmin {
    _setListType(_newListType);
  }

  /// @dev Only the contract owner can call this function.
  /// @dev Cannot add to the OFF list
  /// @inheritdoc IRoyaltyGuard
  function batchAddAddressToRoyaltyList(IRoyaltyGuard.ListType _listType, address[] calldata _addrs) external virtual onlyAdmin {
    if (_listType == IRoyaltyGuard.ListType.OFF) revert IRoyaltyGuard.CantAddToOFFList();
    _batchUpdateList(_listType, _addrs, true);
  }

  /// @dev Only the contract owner can call this function.
  /// @inheritdoc IRoyaltyGuard
  function batchRemoveAddressToRoyaltyList(IRoyaltyGuard.ListType _listType, address[] calldata _addrs) external virtual onlyAdmin {
    _batchUpdateList(_listType, _addrs, false);
  }

  /// @dev Only the contract owner can call this function.
  /// @inheritdoc IRoyaltyGuard
  function clearList(IRoyaltyGuard.ListType _listType) external virtual onlyAdmin {
    delete list[_listType];
    emit ListCleared(msg.sender, _listType);
  }

  /*//////////////////////////////////////////////////////////////////////////
                          Public Read Functions
  //////////////////////////////////////////////////////////////////////////*/

  /// @inheritdoc IRoyaltyGuard
  function getList(IRoyaltyGuard.ListType _listType) external virtual view returns (address[] memory) {
    return list[_listType].values();
  }

  /// @inheritdoc IRoyaltyGuard
  function getInUseList() external virtual view returns (address[] memory) {
    return list[listType].values();
  }

  /// @inheritdoc IRoyaltyGuard
  function isOperatorInList(address _operator) external virtual view returns (bool) {
    return list[listType].contains(_operator);
  }

  /// @inheritdoc IRoyaltyGuard
  function getListType() external virtual view returns (IRoyaltyGuard.ListType) {
    return listType;
  }

  /// @dev used in the {onlyAdmin} modifier
  /// @inheritdoc IRoyaltyGuard
  function hasAdminPermission(address _addr) public virtual view returns (bool);

  /*//////////////////////////////////////////////////////////////////////////
                          ERC165 Overrides
  //////////////////////////////////////////////////////////////////////////*/

  /// @inheritdoc ERC165
  function supportsInterface(bytes4 _interfaceId) public virtual view override returns (bool) {
        return _interfaceId == type(IRoyaltyGuard).interfaceId || super.supportsInterface(_interfaceId);
    }

  /*//////////////////////////////////////////////////////////////////////////
                            Internal Functions
  //////////////////////////////////////////////////////////////////////////*/
  
  /// @dev Internal method to set list type. Main usage is constructor.
  function _setListType(IRoyaltyGuard.ListType _newListType) internal {
    emit ListTypeUpdated(msg.sender, listType, _newListType);
    listType = _newListType;
  }

  /// @dev Internal method to update a certain list. Main usage is constructor.
  function _batchUpdateList(IRoyaltyGuard.ListType _listType, address[] memory _addrs, bool _onList) internal {
    if (_listType != IRoyaltyGuard.ListType.OFF) {
      for (uint256 i = 0; i < _addrs.length; i++) {
        if (_onList) {
          list[_listType].add(_addrs[i]);
          emit AddressAddedToList(msg.sender, _addrs[i], _listType);
        } else {
          list[_listType].remove(_addrs[i]);
          emit AddressRemovedList(msg.sender, _addrs[i], _listType);
        }
      }
    }
  }
}

File 17 of 31 : RoyaltyGuardDeadmanTrigger.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.15;

import {IRoyaltyGuardDeadmanTrigger} from "../extensions/IRoyaltyGuardDeadmanTrigger.sol";
import {IRoyaltyGuard, RoyaltyGuard} from "../RoyaltyGuard.sol";

import {EnumerableSet} from "openzeppelin-contracts/utils/structs/EnumerableSet.sol";
import {ERC165} from "openzeppelin-contracts/utils/introspection/ERC165.sol";

/// @title RoyaltyGuard
/// @author highland, koloz, van arman
/// @notice An abstract contract with the necessary functions, structures, modifiers to ensure royalties are paid.
/// @dev Inherriting this contract requires implementing {hasAdminPermission} and connecting the desired functions to the {checkList} modifier.
abstract contract RoyaltyGuardDeadmanTrigger is IRoyaltyGuardDeadmanTrigger, RoyaltyGuard {

  /*//////////////////////////////////////////////////////////////////////////
                          Private Contract Storage
  //////////////////////////////////////////////////////////////////////////*/

  uint256 private deadmanListTriggerAfterDatetime;

  /*//////////////////////////////////////////////////////////////////////////
                            Admin Functions
  //////////////////////////////////////////////////////////////////////////*/

  /// @dev Only the contract owner can call this function.
  /// @inheritdoc IRoyaltyGuardDeadmanTrigger
  function setDeadmanListTriggerRenewalDuration(uint256 _numYears) external virtual onlyAdmin {
    _setDeadmanTriggerRenewalInYears(_numYears);
  }

  /*//////////////////////////////////////////////////////////////////////////
                          Public Write Functions
  //////////////////////////////////////////////////////////////////////////*/

  /// @dev Can only be called if deadmanListTriggerAfterDatetime is in the past.
  /// @inheritdoc IRoyaltyGuardDeadmanTrigger
  function activateDeadmanListTrigger() external virtual {
    if (deadmanListTriggerAfterDatetime > block.timestamp) revert IRoyaltyGuardDeadmanTrigger.DeadmanTriggerStillActive();
    _setListType(IRoyaltyGuard.ListType.OFF);
    emit DeadmanTriggerActivated(msg.sender);
  }

  /*//////////////////////////////////////////////////////////////////////////
                          Public Read Functions
  //////////////////////////////////////////////////////////////////////////*/

  /// @inheritdoc IRoyaltyGuardDeadmanTrigger
  function getDeadmanTriggerAvailableDatetime() external virtual view returns (uint256) {
    return deadmanListTriggerAfterDatetime;
  }

  /*//////////////////////////////////////////////////////////////////////////
                            Internal Functions
  //////////////////////////////////////////////////////////////////////////*/

  /// @dev Internal method to set deadman trigger datetime. Main usage is constructor.
  function _setDeadmanTriggerRenewalInYears(uint256 _numYears) internal {
    uint256 newDatetime = block.timestamp + _numYears * 365 days;
    emit DeadmanTriggerDatetimeUpdated(msg.sender, deadmanListTriggerAfterDatetime, newDatetime);
    deadmanListTriggerAfterDatetime = newDatetime;
  }
}

File 18 of 31 : IERC721Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721.sol)

pragma solidity ^0.8.0;

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

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

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

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

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

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

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

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

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

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

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

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

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

File 19 of 31 : IERC721ReceiverUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721Receiver.sol)

pragma solidity ^0.8.0;

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

File 20 of 31 : IERC721MetadataUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)

pragma solidity ^0.8.0;

import "../IERC721Upgradeable.sol";

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

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

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

File 21 of 31 : AddressUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (utils/Address.sol)

pragma solidity ^0.8.1;

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

        return account.code.length > 0;
    }

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

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

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

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

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

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

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

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

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

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

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

                assembly {
                    let returndata_size := mload(returndata)
                    revert(add(32, returndata), returndata_size)
                }
            } else {
                revert(errorMessage);
            }
        }
    }
}

File 22 of 31 : ContextUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)

pragma solidity ^0.8.0;
import "../proxy/utils/Initializable.sol";

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

    function __Context_init_unchained() internal onlyInitializing {
    }
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

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

    /**
     * @dev This empty reserved space is put in place to allow future versions to add new
     * variables without shifting down storage in the inheritance chain.
     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
     */
    uint256[50] private __gap;
}

File 23 of 31 : StringsUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Strings.sol)

pragma solidity ^0.8.0;

/**
 * @dev String operations.
 */
library StringsUpgradeable {
    bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";

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

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

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

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

File 24 of 31 : Initializable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (proxy/utils/Initializable.sol)

pragma solidity ^0.8.0;

import "../../utils/AddressUpgradeable.sol";

/**
 * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
 * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
 * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
 * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
 *
 * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
 * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
 * case an upgrade adds a module that needs to be initialized.
 *
 * For example:
 *
 * [.hljs-theme-light.nopadding]
 * ```
 * contract MyToken is ERC20Upgradeable {
 *     function initialize() initializer public {
 *         __ERC20_init("MyToken", "MTK");
 *     }
 * }
 * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
 *     function initializeV2() reinitializer(2) public {
 *         __ERC20Permit_init("MyToken");
 *     }
 * }
 * ```
 *
 * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
 * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
 *
 * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
 * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
 *
 * [CAUTION]
 * ====
 * Avoid leaving a contract uninitialized.
 *
 * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
 * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
 * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
 *
 * [.hljs-theme-light.nopadding]
 * ```
 * /// @custom:oz-upgrades-unsafe-allow constructor
 * constructor() {
 *     _disableInitializers();
 * }
 * ```
 * ====
 */
abstract contract Initializable {
    /**
     * @dev Indicates that the contract has been initialized.
     * @custom:oz-retyped-from bool
     */
    uint8 private _initialized;

    /**
     * @dev Indicates that the contract is in the process of being initialized.
     */
    bool private _initializing;

    /**
     * @dev Triggered when the contract has been initialized or reinitialized.
     */
    event Initialized(uint8 version);

    /**
     * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
     * `onlyInitializing` functions can be used to initialize parent contracts. Equivalent to `reinitializer(1)`.
     */
    modifier initializer() {
        bool isTopLevelCall = _setInitializedVersion(1);
        if (isTopLevelCall) {
            _initializing = true;
        }
        _;
        if (isTopLevelCall) {
            _initializing = false;
            emit Initialized(1);
        }
    }

    /**
     * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
     * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
     * used to initialize parent contracts.
     *
     * `initializer` is equivalent to `reinitializer(1)`, so a reinitializer may be used after the original
     * initialization step. This is essential to configure modules that are added through upgrades and that require
     * initialization.
     *
     * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
     * a contract, executing them in the right order is up to the developer or operator.
     */
    modifier reinitializer(uint8 version) {
        bool isTopLevelCall = _setInitializedVersion(version);
        if (isTopLevelCall) {
            _initializing = true;
        }
        _;
        if (isTopLevelCall) {
            _initializing = false;
            emit Initialized(version);
        }
    }

    /**
     * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
     * {initializer} and {reinitializer} modifiers, directly or indirectly.
     */
    modifier onlyInitializing() {
        require(_initializing, "Initializable: contract is not initializing");
        _;
    }

    /**
     * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
     * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
     * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
     * through proxies.
     */
    function _disableInitializers() internal virtual {
        _setInitializedVersion(type(uint8).max);
    }

    function _setInitializedVersion(uint8 version) private returns (bool) {
        // If the contract is initializing we ignore whether _initialized is set in order to support multiple
        // inheritance patterns, but we only do this in the context of a constructor, and for the lowest level
        // of initializers, because in other contexts the contract may have been reentered.
        if (_initializing) {
            require(
                version == 1 && !AddressUpgradeable.isContract(address(this)),
                "Initializable: contract is already initialized"
            );
            return false;
        } else {
            require(_initialized < version, "Initializable: contract is already initialized");
            _initialized = version;
            return true;
        }
    }
}

File 25 of 31 : IERC165Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC165 standard, as defined in the
 * https://eips.ethereum.org/EIPS/eip-165[EIP].
 *
 * Implementers can declare support of contract interfaces, which can then be
 * queried by others ({ERC165Checker}).
 *
 * For an implementation, see {ERC165}.
 */
interface IERC165Upgradeable {
    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30 000 gas.
     */
    function supportsInterface(bytes4 interfaceId) external view returns (bool);
}

File 26 of 31 : IERC2981.sol
// contracts/royalty/IERC2981.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

/// @dev Interface for the NFT Royalty Standard
interface IERC2981 {
    /// ERC165 bytes to add to interface array - set in parent contract
    /// implementing this standard
    ///
    /// bytes4(keccak256("royaltyInfo(uint256,uint256)")) == 0x2a55205a
    /// bytes4 private constant _INTERFACE_ID_ERC2981 = 0x2a55205a;
    /// _registerInterface(_INTERFACE_ID_ERC2981);

    /// @notice Called with the sale price to determine how much royalty
    //          is owed and to whom.
    /// @param _tokenId - the NFT asset queried for royalty information
    /// @param _salePrice - the sale price of the NFT asset specified by _tokenId
    /// @return receiver - address of who should be sent the royalty payment
    /// @return royaltyAmount - the royalty payment amount for _salePrice
    function royaltyInfo(uint256 _tokenId, uint256 _salePrice)
        external
        view
        returns (address receiver, uint256 royaltyAmount);
}

File 27 of 31 : IRoyaltyGuard.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.15;

/// @title IRoyaltyGuard
/// @author highland, koloz, van arman
/// @notice Interface for the royalty guard with all the fields, errors, functions, etc.
interface IRoyaltyGuard {

  /*//////////////////////////////////////////////////////////////////////////
                              Enums
  //////////////////////////////////////////////////////////////////////////*/

    /// @notice An enum denoting 3 types for a list: OFF (0), ALLOW (1), DENY (2)
    enum ListType {
      OFF,
      ALLOW,
      DENY
    }

  /*//////////////////////////////////////////////////////////////////////////
                            Events
  //////////////////////////////////////////////////////////////////////////*/

  /// @notice Emitted when the list type is updated.
  event ListTypeUpdated(address indexed _updater, ListType indexed _oldListType, ListType indexed _newListType);

  /// @notice Emitted when an address is added to a list.
  event AddressAddedToList(address indexed _updater, address indexed _addedAddr, ListType indexed _ListType);

  /// @notice Emitted when an address is removed from a list.
  event AddressRemovedList(address indexed _updater, address indexed _removedAddr, ListType indexed _ListType);

  /// @notice Emitted when a list is cleared.
  event ListCleared(address indexed _updater, ListType _listType);

  /*//////////////////////////////////////////////////////////////////////////
                          Custom Errors
  //////////////////////////////////////////////////////////////////////////*/

  /// @notice Emitted when an unauthorized party tries to call a specific function.
  error Unauthorized();

  /// @notice Emitted when trying to add an address to a list with type OFF.
  error CantAddToOFFList();

  /// @notice Emitted when an admin only function tries to be called by a non-admin.
  error MustBeAdmin();

  /*//////////////////////////////////////////////////////////////////////////
                          External Write Functions
  //////////////////////////////////////////////////////////////////////////*/

  /// @notice Toggles the list type between ALLOW, DENY, or OFF
  /// @param _newListType to be applied to the list. Options are 0 (OFF), 1 (ALLOW), 2 (DENY)
  function toggleListType(IRoyaltyGuard.ListType _newListType) external;

  /// @notice Adds a list of addresses to the specified list.
  /// @param _listType that addresses are being added to
  /// @param _addrs being added to the designated list
  function batchAddAddressToRoyaltyList(IRoyaltyGuard.ListType _listType, address[] calldata _addrs) external;

  /// @notice Removes a list of addresses to the specified list.
  /// @param _listType that addresses are being removed from
  /// @param _addrs being removed from the designated list
  function batchRemoveAddressToRoyaltyList(IRoyaltyGuard.ListType _listType, address[] calldata _addrs) external;

  /// @notice Clears an entire list.
  /// @param _listType of list being cleared.
  function clearList(IRoyaltyGuard.ListType _listType) external;

  /*//////////////////////////////////////////////////////////////////////////
                          External Read Functions
  //////////////////////////////////////////////////////////////////////////*/

  /// @notice Returns the set of addresses on a list.
  /// @param _listType of list being retrieved.
  /// @return list of addresses on a given list.
  function getList(IRoyaltyGuard.ListType _listType) external view returns (address[] memory);

  /// @notice Returns the set of addresses on a list.
  /// @return list of addresses on a given list.
  function getInUseList() external view returns (address[] memory);

  /// @notice Returns if the supplied operator address in part of the current in use list.
  /// @param _operator address being checked.
  /// @return bool relating to if the operator is on the list.
  function isOperatorInList(address _operator) external view returns (bool);
  

  /// @notice States whether or not an address has admin permission.
  /// @return bool denoting if _addr has admin permission.
  function hasAdminPermission(address _addr) external view returns (bool);

  /// @notice Returns the ListType currently being used;
  /// @return ListType of the list. Values are: 0 (OFF), 1 (ALLOW), 2 (DENY)
  function getListType() external view returns (ListType);
}

File 28 of 31 : EnumerableSet.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (utils/structs/EnumerableSet.sol)

pragma solidity ^0.8.0;

/**
 * @dev Library for managing
 * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
 * types.
 *
 * Sets have the following properties:
 *
 * - Elements are added, removed, and checked for existence in constant time
 * (O(1)).
 * - Elements are enumerated in O(n). No guarantees are made on the ordering.
 *
 * ```
 * contract Example {
 *     // Add the library methods
 *     using EnumerableSet for EnumerableSet.AddressSet;
 *
 *     // Declare a set state variable
 *     EnumerableSet.AddressSet private mySet;
 * }
 * ```
 *
 * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
 * and `uint256` (`UintSet`) are supported.
 */
library EnumerableSet {
    // To implement this library for multiple types with as little code
    // repetition as possible, we write it in terms of a generic Set type with
    // bytes32 values.
    // The Set implementation uses private functions, and user-facing
    // implementations (such as AddressSet) are just wrappers around the
    // underlying Set.
    // This means that we can only create new EnumerableSets for types that fit
    // in bytes32.

    struct Set {
        // Storage of set values
        bytes32[] _values;
        // Position of the value in the `values` array, plus 1 because index 0
        // means a value is not in the set.
        mapping(bytes32 => uint256) _indexes;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function _add(Set storage set, bytes32 value) private returns (bool) {
        if (!_contains(set, value)) {
            set._values.push(value);
            // The value is stored at length-1, but we add 1 to all indexes
            // and use 0 as a sentinel value
            set._indexes[value] = set._values.length;
            return true;
        } else {
            return false;
        }
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function _remove(Set storage set, bytes32 value) private returns (bool) {
        // We read and store the value's index to prevent multiple reads from the same storage slot
        uint256 valueIndex = set._indexes[value];

        if (valueIndex != 0) {
            // Equivalent to contains(set, value)
            // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
            // the array, and then remove the last element (sometimes called as 'swap and pop').
            // This modifies the order of the array, as noted in {at}.

            uint256 toDeleteIndex = valueIndex - 1;
            uint256 lastIndex = set._values.length - 1;

            if (lastIndex != toDeleteIndex) {
                bytes32 lastValue = set._values[lastIndex];

                // Move the last value to the index where the value to delete is
                set._values[toDeleteIndex] = lastValue;
                // Update the index for the moved value
                set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex
            }

            // Delete the slot where the moved value was stored
            set._values.pop();

            // Delete the index for the deleted slot
            delete set._indexes[value];

            return true;
        } else {
            return false;
        }
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function _contains(Set storage set, bytes32 value) private view returns (bool) {
        return set._indexes[value] != 0;
    }

    /**
     * @dev Returns the number of values on the set. O(1).
     */
    function _length(Set storage set) private view returns (uint256) {
        return set._values.length;
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function _at(Set storage set, uint256 index) private view returns (bytes32) {
        return set._values[index];
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function _values(Set storage set) private view returns (bytes32[] memory) {
        return set._values;
    }

    // Bytes32Set

    struct Bytes32Set {
        Set _inner;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
        return _add(set._inner, value);
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
        return _remove(set._inner, value);
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
        return _contains(set._inner, value);
    }

    /**
     * @dev Returns the number of values in the set. O(1).
     */
    function length(Bytes32Set storage set) internal view returns (uint256) {
        return _length(set._inner);
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
        return _at(set._inner, index);
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
        return _values(set._inner);
    }

    // AddressSet

    struct AddressSet {
        Set _inner;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function add(AddressSet storage set, address value) internal returns (bool) {
        return _add(set._inner, bytes32(uint256(uint160(value))));
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function remove(AddressSet storage set, address value) internal returns (bool) {
        return _remove(set._inner, bytes32(uint256(uint160(value))));
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function contains(AddressSet storage set, address value) internal view returns (bool) {
        return _contains(set._inner, bytes32(uint256(uint160(value))));
    }

    /**
     * @dev Returns the number of values in the set. O(1).
     */
    function length(AddressSet storage set) internal view returns (uint256) {
        return _length(set._inner);
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function at(AddressSet storage set, uint256 index) internal view returns (address) {
        return address(uint160(uint256(_at(set._inner, index))));
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function values(AddressSet storage set) internal view returns (address[] memory) {
        bytes32[] memory store = _values(set._inner);
        address[] memory result;

        assembly {
            result := store
        }

        return result;
    }

    // UintSet

    struct UintSet {
        Set _inner;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function add(UintSet storage set, uint256 value) internal returns (bool) {
        return _add(set._inner, bytes32(value));
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function remove(UintSet storage set, uint256 value) internal returns (bool) {
        return _remove(set._inner, bytes32(value));
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function contains(UintSet storage set, uint256 value) internal view returns (bool) {
        return _contains(set._inner, bytes32(value));
    }

    /**
     * @dev Returns the number of values on the set. O(1).
     */
    function length(UintSet storage set) internal view returns (uint256) {
        return _length(set._inner);
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function at(UintSet storage set, uint256 index) internal view returns (uint256) {
        return uint256(_at(set._inner, index));
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function values(UintSet storage set) internal view returns (uint256[] memory) {
        bytes32[] memory store = _values(set._inner);
        uint256[] memory result;

        assembly {
            result := store
        }

        return result;
    }
}

File 29 of 31 : ERC165.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)

pragma solidity ^0.8.0;

import "./IERC165.sol";

/**
 * @dev Implementation of the {IERC165} interface.
 *
 * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
 * for the additional interface id that will be supported. For example:
 *
 * ```solidity
 * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
 *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
 * }
 * ```
 *
 * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
 */
abstract contract ERC165 is IERC165 {
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IERC165).interfaceId;
    }
}

File 30 of 31 : IRoyaltyGuardDeadmanTrigger.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.15;

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

/// @title IRoyaltyGuard
/// @author highland, koloz, van arman
/// @notice Interface for a deadman trigger extension to IRoyaltyGuard
interface IRoyaltyGuardDeadmanTrigger is IRoyaltyGuard {
  /*//////////////////////////////////////////////////////////////////////////
                            Events
  //////////////////////////////////////////////////////////////////////////*/

  /// @notice Emitted when deadman trigger datetime has been updated.
  event DeadmanTriggerDatetimeUpdated(address indexed _updater, uint256 _oldDatetime, uint256 _newDatetime);

  /// @notice Emitted when the deadman switch is activated.
  event DeadmanTriggerActivated(address indexed _activator);

  /*//////////////////////////////////////////////////////////////////////////
                          Custom Errors
  //////////////////////////////////////////////////////////////////////////*/

  /// @notice Emitted when the deadman trigger datetime threshold hasnt passed but tries to get called.
  error DeadmanTriggerStillActive();

  /*//////////////////////////////////////////////////////////////////////////
                          External Write Functions
  //////////////////////////////////////////////////////////////////////////*/

  /// @notice Sets the deadman list trigger for the specified number of years from current block timestamp
  /// @param _numYears to renew the trigger for.
  function setDeadmanListTriggerRenewalDuration(uint256 _numYears) external;

  /// @notice Triggers the deadman switch for the list
  function activateDeadmanListTrigger() external;

  /// @notice The datetime threshold after which the deadman trigger can be called by anyone.
  /// @return uint256 denoting unix epoch time after which the deadman trigger can be activated.
  function getDeadmanTriggerAvailableDatetime() external view returns (uint256);
}

File 31 of 31 : IERC165.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC165 standard, as defined in the
 * https://eips.ethereum.org/EIPS/eip-165[EIP].
 *
 * Implementers can declare support of contract interfaces, which can then be
 * queried by others ({ERC165Checker}).
 *
 * For an implementation, see {ERC165}.
 */
interface IERC165 {
    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30 000 gas.
     */
    function supportsInterface(bytes4 interfaceId) external view returns (bool);
}

Settings
{
  "remappings": [
    "openzeppelin-contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/",
    "openzeppelin-contracts/=lib/openzeppelin-contracts/contracts/",
    "rareprotocol/aux/=lib/aux/src/",
    "royalty-guard/=lib/royalty-guard/src/royalty-guard/",
    "forge-std/=lib/forge-std/src/",
    "aux/=lib/aux/",
    "ds-test/=lib/ds-test/src/",
    "erc4626-tests/=lib/aux/lib/openzeppelin-contracts-upgradeable/lib/erc4626-tests/",
    "openzeppelin/=lib/aux/lib/openzeppelin-contracts-upgradeable/contracts/",
    "solmate/=lib/royalty-guard/lib/solmate/src/"
  ],
  "optimizer": {
    "enabled": true,
    "runs": 200
  },
  "metadata": {
    "useLiteralContent": false,
    "bytecodeHash": "ipfs"
  },
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  },
  "evmVersion": "london",
  "libraries": {}
}

Contract Security Audit

Contract ABI

[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"contractAddress","type":"address"},{"indexed":true,"internalType":"address","name":"owner","type":"address"}],"name":"SovereignNFTContractCreated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"contractAddress","type":"address"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"bytes32","name":"contractType","type":"bytes32"}],"name":"SovereignNFTContractCreated","type":"event"},{"inputs":[],"name":"LAZY_ROYALTY_GUARD","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"LAZY_ROYALTY_GUARD_DEADMAN","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"LAZY_SOVEREIGN_NFT","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"_name","type":"string"},{"internalType":"string","name":"_symbol","type":"string"},{"internalType":"uint256","name":"_maxTokens","type":"uint256"},{"internalType":"bytes32","name":"_contractType","type":"bytes32"}],"name":"createSovereignNFTContract","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"lazySovereignNFT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lazySovereignNFTRoyaltyGuard","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lazySovereignNFTRoyaltyGuardDeadmanTrigger","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_sovereignNFT","type":"address"},{"internalType":"bytes32","name":"_contractType","type":"bytes32"}],"name":"setSovereignNFT","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"}]

608060405234801561001057600080fd5b5061001a33610102565b600060405161002890610152565b604051809103906000f080158015610044573d6000803e3d6000fd5b50600180546001600160a01b0319166001600160a01b03831617905560405190915060009061007290610160565b604051809103906000f08015801561008e573d6000803e3d6000fd5b50600280546001600160a01b0319166001600160a01b0383161790556040519091506000906100bc9061016e565b604051809103906000f0801580156100d8573d6000803e3d6000fd5b50600380546001600160a01b0319166001600160a01b03929092169190911790555061017c915050565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b612d458062000c6883390190565b61386080620039ad83390190565b6139b2806200720d83390190565b610adc806200018c6000396000f3fe608060405234801561001057600080fd5b50600436106100a85760003560e01c8063877ebf5111610071578063877ebf511461016a5780638da5cb5b1461017d578063a55b1c251461018e578063c4dca7ab146101a1578063f2fde38b146101b4578063f5e0e6df146101c757600080fd5b8062e8ece6146100ad57806322d60fcb146100e7578063637944f514610112578063715018a614610139578063740adf3114610143575b600080fd5b6100d47f5d53444d40ee2f466d1c91f96d7c4d4b6bcb514ac7911b9a6c947234a2f957c581565b6040519081526020015b60405180910390f35b6002546100fa906001600160a01b031681565b6040516001600160a01b0390911681526020016100de565b6100d47f8eae45f58440dde5634b0645eea1e0aa7e9dfd92d41ded6de63fc6498057dd6881565b6101416101da565b005b6100d47f6c556facba1fb001f8d830adc0dcceae3a683a8890dc3299db292ca0c662517081565b6100fa61017836600461090b565b610219565b6000546001600160a01b03166100fa565b61014161019c366004610996565b610576565b6003546100fa906001600160a01b031681565b6101416101c23660046109c0565b6106e1565b6001546100fa906001600160a01b031681565b6000546001600160a01b0316331461020d5760405162461bcd60e51b8152600401610204906109e2565b60405180910390fd5b610217600061077c565b565b6000826000036102875760405162461bcd60e51b815260206004820152603360248201527f637265617465536f7665726569676e4e4654436f6e74726163743a3a5f6d6178604482015272546f6b656e732063616e74206265207a65726f60681b6064820152608401610204565b60007f8eae45f58440dde5634b0645eea1e0aa7e9dfd92d41ded6de63fc6498057dd68830361032d576001546102c5906001600160a01b03166107cc565b604051635edc7c1960e01b81529091506001600160a01b03821690635edc7c19906102fa908990899033908a90600401610a64565b600060405180830381600087803b15801561031457600080fd5b505af1158015610328573d6000803e3d6000fd5b505050505b7f5d53444d40ee2f466d1c91f96d7c4d4b6bcb514ac7911b9a6c947234a2f957c583036103d157600254610369906001600160a01b03166107cc565b604051635edc7c1960e01b81529091506001600160a01b03821690635edc7c199061039e908990899033908a90600401610a64565b600060405180830381600087803b1580156103b857600080fd5b505af11580156103cc573d6000803e3d6000fd5b505050505b7f6c556facba1fb001f8d830adc0dcceae3a683a8890dc3299db292ca0c662517083036104755760035461040d906001600160a01b03166107cc565b604051635edc7c1960e01b81529091506001600160a01b03821690635edc7c1990610442908990899033908a90600401610a64565b600060405180830381600087803b15801561045c57600080fd5b505af1158015610470573d6000803e3d6000fd5b505050505b6001600160a01b0381166104ff5760405162461bcd60e51b8152602060048201526044602482018190527f637265617465536f7665726569676e4e4654436f6e74726163743a3a5f636f6e908201527f74726163745479706520756e737570706f7274656420636f6e747261637420746064820152633cb8329760e11b608482015260a401610204565b60405133906001600160a01b038316907f46dd19b0bfeba14ab8b9e9c9e4179a2f8a3ba70420a845ea8da585dd8e59eeec90600090a3604051839033906001600160a01b038416907feec8a411955d10f84b6b0e3110b206d0888593b71381b8ca931e8f131f7eb36590600090a495945050505050565b6000546001600160a01b031633146105a05760405162461bcd60e51b8152600401610204906109e2565b6001600160a01b0382166105b357600080fd5b7f8eae45f58440dde5634b0645eea1e0aa7e9dfd92d41ded6de63fc6498057dd6881036105f957600180546001600160a01b0319166001600160a01b0384161790555050565b7f5d53444d40ee2f466d1c91f96d7c4d4b6bcb514ac7911b9a6c947234a2f957c5810361063f57600280546001600160a01b0319166001600160a01b0384161790555050565b7f6c556facba1fb001f8d830adc0dcceae3a683a8890dc3299db292ca0c6625170810361068557600380546001600160a01b0319166001600160a01b0384161790555050565b60405162461bcd60e51b815260206004820152602b60248201527f736574536f7665726569676e4e46543a3a556e737570706f72746564205f636f60448201526a373a3930b1ba2a3cb8329760a91b6064820152608401610204565b6000546001600160a01b0316331461070b5760405162461bcd60e51b8152600401610204906109e2565b6001600160a01b0381166107705760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610204565b6107798161077c565b50565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b600060405172602d8060093d393df3363d3d373d3d3d363d7360681b81528260601b60138201526e5af43d82803e903d91602b57fd5bf360881b60278201526036816000f09150506001600160a01b0381166108635760405162461bcd60e51b8152602060048201526016602482015275115490cc4c4d8dce8818dc99585d194819985a5b195960521b6044820152606401610204565b919050565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261088f57600080fd5b813567ffffffffffffffff808211156108aa576108aa610868565b604051601f8301601f19908116603f011681019082821181831017156108d2576108d2610868565b816040528381528660208588010111156108eb57600080fd5b836020870160208301376000602085830101528094505050505092915050565b6000806000806080858703121561092157600080fd5b843567ffffffffffffffff8082111561093957600080fd5b6109458883890161087e565b9550602087013591508082111561095b57600080fd5b506109688782880161087e565b949794965050505060408301359260600135919050565b80356001600160a01b038116811461086357600080fd5b600080604083850312156109a957600080fd5b6109b28361097f565b946020939093013593505050565b6000602082840312156109d257600080fd5b6109db8261097f565b9392505050565b6020808252818101527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604082015260600190565b6000815180845260005b81811015610a3d57602081850181015186830182015201610a21565b81811115610a4f576000602083870101525b50601f01601f19169290920160200192915050565b608081526000610a776080830187610a17565b8281036020840152610a898187610a17565b6001600160a01b039590951660408401525050606001529291505056fea264697066735822122074d3532c94662a16b4982bdabc1fa6d7f8983e80a84dd7dd93a61fdba6fea23164736f6c634300080f0033608060405234801561001057600080fd5b50612d25806100206000396000f3fe608060405234801561001057600080fd5b50600436106102325760003560e01c806370a0823111610130578063ab69607a116100b8578063e83157421161007c578063e8315742146104de578063e985e9c5146104e8578063ee07080514610524578063efc32cd414610530578063f2fde38b1461054357600080fd5b8063ab69607a1461048a578063b390ac2514610492578063b88d4fde146104a5578063b9fbd25c146104b8578063c87b56dd146104cb57600080fd5b80638da5cb5b116100ff5780638da5cb5b14610436578063931688cb146104475780639338bb5d1461045a57806395d89b411461046f578063a22cb4651461047757600080fd5b806370a0823114610400578063715018a614610413578063755edd171461041b578063894ba8331461042e57600080fd5b80633403c4e9116101be57806342966c681161018257806342966c68146103ac57806353df5c7c146103bf5780635edc7c19146103c75780636297c16c146103da5780636352211e146103ed57600080fd5b80633403c4e9146103355780633a3d146f146103465780633ebc82c51461037357806340c1a0641461038657806342842e0e1461039957600080fd5b80630de54ba0116102055780630de54ba0146102b457806318160ddd146102c757806318e97fd1146102dd57806323b872dd146102f05780632a55205a1461030357600080fd5b806301ffc9a71461023757806306fdde031461025f578063081812fc14610274578063095ea7b31461029f575b600080fd5b61024a6102453660046121b9565b610556565b60405190151581526020015b60405180910390f35b61026761059f565b604051610256919061222e565b610287610282366004612241565b610631565b6040516001600160a01b039091168152602001610256565b6102b26102ad366004612271565b6106cb565b005b6102b26102c236600461229b565b6107e0565b6102cf610858565b604051908152602001610256565b6102b26102eb366004612320565b610869565b6102b26102fe36600461236c565b61094c565b6103166103113660046123a8565b61097e565b604080516001600160a01b039093168352602083019190915201610256565b60fb546001600160a01b0316610287565b61024a6103543660046123ca565b6001600160a01b03166000908152610102602052604090205460ff1690565b6102b26103813660046123ca565b610a19565b610287610394366004612241565b610a4f565b6102b26103a736600461236c565b610a63565b6102b26103ba366004612241565b610a7e565b6102b2610af5565b6102b26103d53660046123e5565b610b69565b6102b26103e8366004612241565b610ce9565b6102876103fb366004612241565b610d52565b6102cf61040e3660046123ca565b610dc9565b6102b2610e4f565b6102cf6104293660046123ca565b610e85565b6102b2610f5b565b6033546001600160a01b0316610287565b6102b261045536600461246e565b610fbf565b610462611093565b60405161025691906124b0565b610267611177565b6102b261048536600461229b565b611186565b60fc546102cf565b6102b26104a03660046124ee565b611195565b6102b26104b3366004612550565b6111ec565b6102b26104c636600461262c565b611224565b6102676104d9366004612241565b6112a3565b6102cf6101005481565b61024a6104f6366004612689565b6001600160a01b039182166000908152609c6020908152604080832093909416825291909152205460ff1690565b60ff805461024a911681565b6102b261053e366004612271565b61139c565b6102b26105513660046123ca565b6113f4565b60006001600160e01b03198216631030681960e21b148061057b575061057b8261148c565b8061058a575061058a826114a2565b806105995750610599826114c3565b92915050565b6060609780546105ae906126b3565b80601f01602080910402602001604051908101604052809291908181526020018280546105da906126b3565b80156106275780601f106105fc57610100808354040283529160200191610627565b820191906000526020600020905b81548152906001019060200180831161060a57829003601f168201915b5050505050905090565b6000818152609960205260408120546001600160a01b03166106af5760405162461bcd60e51b815260206004820152602c60248201527f4552433732313a20617070726f76656420717565727920666f72206e6f6e657860448201526b34b9ba32b73a103a37b5b2b760a11b60648201526084015b60405180910390fd5b506000908152609b60205260409020546001600160a01b031690565b60006106d682610d52565b9050806001600160a01b0316836001600160a01b0316036107435760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b60648201526084016106a6565b336001600160a01b038216148061075f575061075f81336104f6565b6107d15760405162461bcd60e51b815260206004820152603860248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f74206f7760448201527f6e6572206e6f7220617070726f76656420666f7220616c6c000000000000000060648201526084016106a6565b6107db8383611503565b505050565b6033546001600160a01b0316331461080a5760405162461bcd60e51b81526004016106a6906126ed565b60ff8054161561082c5760405162461bcd60e51b81526004016106a690612722565b6001600160a01b0391909116600090815261010260205260409020805460ff1916911515919091179055565b60006108646101045490565b905090565b6033546001600160a01b031633146108935760405162461bcd60e51b81526004016106a6906126ed565b6101075460ff16156108f25760405162461bcd60e51b815260206004820152602260248201527f757064617465546f6b656e5552493a3a6d65746164617461206973206c6f636b604482015261195960f21b60648201526084016106a6565b60008381526101036020526040902061090c8284836127a7565b50827f931f495b9a8e5d8e61946ea5d61e021f636cfe213a801f97589c18c152e408bd838360405161093f929190612868565b60405180910390a2505050565b610957335b82611571565b6109735760405162461bcd60e51b81526004016106a690612897565b6107db838383611668565b600082815260fd602052604081205481906001600160a01b03166109ad5760fb546001600160a01b03166109c6565b600084815260fd60205260409020546001600160a01b03165b9150610a106064610a0a60fe6000888152602001908152602001600020546000036109f35760fc54610a03565b600087815260fe60205260409020545b8690611804565b90611817565b90509250929050565b6033546001600160a01b03163314610a435760405162461bcd60e51b81526004016106a6906126ed565b610a4c81611823565b50565b60006105996033546001600160a01b031690565b6107db838383604051806020016040528060008152506111ec565b610a8733610951565b610aec5760405162461bcd60e51b815260206004820152603060248201527f4552433732314275726e61626c653a2063616c6c6572206973206e6f74206f7760448201526f1b995c881b9bdc88185c1c1c9bdd995960821b60648201526084016106a6565b610a4c81611845565b6033546001600160a01b03163314610b1f5760405162461bcd60e51b81526004016106a6906126ed565b6040517fb634b0cb94234b05eabb1438717e0e645bfd84788ae1263682242327563cde5e90610b5190610106906128e8565b60405180910390a1610107805460ff19166001179055565b6000610b7560016118e0565b90508015610b8d576000805461ff0019166101001790555b6001600160a01b038316610be35760405162461bcd60e51b815260206004820152601e60248201527f63726561746f722063616e6e6f74206265206e756c6c2061646472657373000060448201526064016106a6565b610bed600a60fc55565b60ff805460ff19169055610100829055610c05611968565b610c7887878080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8b01819004810282018101909252898152925089915088908190840183828082843760009201919091525061199792505050565b610c806119c8565b610c886119ef565b610c9183611823565b610c9a836113f4565b8015610ce0576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050505050565b33610cf382610d52565b6001600160a01b031614610d495760405162461bcd60e51b815260206004820152601f60248201527f4d75737420626520746865206f776e6572206f662074686520746f6b656e2e0060448201526064016106a6565b610a4c81610a7e565b6000818152609960205260408120546001600160a01b0316806105995760405162461bcd60e51b815260206004820152602960248201527f4552433732313a206f776e657220717565727920666f72206e6f6e657869737460448201526832b73a103a37b5b2b760b91b60648201526084016106a6565b60006001600160a01b038216610e335760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b60648201526084016106a6565b506001600160a01b03166000908152609a602052604090205490565b6033546001600160a01b03163314610e795760405162461bcd60e51b81526004016106a6906126ed565b610e836000611a1e565b565b60ff80546000911615610eaa5760405162461bcd60e51b81526004016106a690612722565b6033546001600160a01b0316331480610ed35750336000908152610102602052604090205460ff165b610f385760405162461bcd60e51b815260206004820152603060248201527f6c617a794d696e743a3a6f6e6c79206f776e6572206f7220617070726f76656460448201526f081b5a5b9d195c8818d85b881b5a5b9d60821b60648201526084016106a6565b61059982610f4560fc5490565b60fb546001600160a01b0316611a70565b919050565b6033546001600160a01b03163314610f855760405162461bcd60e51b81526004016106a6906126ed565b60ff805460ff1916600117905560405133907f793bc6423dd0257d64f9d47db72fd4b2162f4541aa41740ba1c5fb5e2cd41bcd90600090a2565b6033546001600160a01b03163314610fe95760405162461bcd60e51b81526004016106a6906126ed565b6101075460ff16156110475760405162461bcd60e51b815260206004820152602160248201527f757064617465426173655552493a3a6d65746164617461206973206c6f636b656044820152601960fa1b60648201526084016106a6565b6101066110558284836127a7565b507f1c306e70c05992619e2128ad1ef88df75f36c9476282e59f51401b2abaa42e4e8282604051611087929190612868565b60405180910390a15050565b6110b9604051806060016040528060008152602001606081526020016000151581525090565b60408051606081019091526101058054825261010680546020840191906110df906126b3565b80601f016020809104026020016040519081016040528092919081815260200182805461110b906126b3565b80156111585780601f1061112d57610100808354040283529160200191611158565b820191906000526020600020905b81548152906001019060200180831161113b57829003601f168201915b50505091835250506002919091015460ff161515602090910152919050565b6060609880546105ae906126b3565b611191338383611b2c565b5050565b6033546001600160a01b031633146111bf5760405162461bcd60e51b81526004016106a6906126ed565b60ff805416156111e15760405162461bcd60e51b81526004016106a690612722565b6107db838383611bfa565b6111f63383611571565b6112125760405162461bcd60e51b81526004016106a690612897565b61121e84848484611d6f565b50505050565b6033546001600160a01b0316331461124e5760405162461bcd60e51b81526004016106a6906126ed565b60ff805416156112705760405162461bcd60e51b81526004016106a690612722565b61127b848484611bfa565b6001600160a01b0316600090815261010260205260409020805460ff19166001179055505050565b600081815261010360205260408120805460609291906112c2906126b3565b905011156113695760008281526101036020526040902080546112e4906126b3565b80601f0160208091040260200160405190810160405280929190818152602001828054611310906126b3565b801561135d5780601f106113325761010080835404028352916020019161135d565b820191906000526020600020905b81548152906001019060200180831161134057829003601f168201915b50505050509050919050565b61010661137583611da2565b604051602001611386929190612973565b6040516020818303038152906040529050919050565b6033546001600160a01b031633146113c65760405162461bcd60e51b81526004016106a6906126ed565b600090815260fd6020526040902080546001600160a01b0319166001600160a01b0392909216919091179055565b6033546001600160a01b0316331461141e5760405162461bcd60e51b81526004016106a6906126ed565b6001600160a01b0381166114835760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016106a6565b610a4c81611a1e565b6001600160e01b0319166301ffc9a760e01b1490565b60006001600160e01b0319821663152a902d60e11b14806105995750610599825b60006001600160e01b031982166380ac58cd60e01b14806114f457506001600160e01b03198216635b5e139f60e01b145b8061059957506105998261148c565b6000818152609b6020526040902080546001600160a01b0319166001600160a01b038416908117909155819061153882610d52565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b6000818152609960205260408120546001600160a01b03166115ea5760405162461bcd60e51b815260206004820152602c60248201527f4552433732313a206f70657261746f7220717565727920666f72206e6f6e657860448201526b34b9ba32b73a103a37b5b2b760a11b60648201526084016106a6565b60006115f583610d52565b9050806001600160a01b0316846001600160a01b0316148061163c57506001600160a01b038082166000908152609c602090815260408083209388168352929052205460ff165b806116605750836001600160a01b031661165584610631565b6001600160a01b0316145b949350505050565b826001600160a01b031661167b82610d52565b6001600160a01b0316146116df5760405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b60648201526084016106a6565b6001600160a01b0382166117415760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b60648201526084016106a6565b61174c600082611503565b6001600160a01b0383166000908152609a60205260408120805460019290611775908490612a2f565b90915550506001600160a01b0382166000908152609a602052604081208054600192906117a3908490612a46565b909155505060008181526099602052604080822080546001600160a01b0319166001600160a01b0386811691821790925591518493918716917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef91a4505050565b60006118108284612a5e565b9392505050565b60006118108284612a93565b60fb80546001600160a01b0319166001600160a01b0392909216919091179055565b600061185082610d52565b905061185d600083611503565b6001600160a01b0381166000908152609a60205260408120805460019290611886908490612a2f565b909155505060008281526099602052604080822080546001600160a01b0319169055518391906001600160a01b038416907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908390a45050565b60008054610100900460ff1615611927578160ff1660011480156119035750303b155b61191f5760405162461bcd60e51b81526004016106a690612aa7565b506000919050565b60005460ff80841691161061194e5760405162461bcd60e51b81526004016106a690612aa7565b506000805460ff191660ff92909216919091179055600190565b600054610100900460ff1661198f5760405162461bcd60e51b81526004016106a690612af5565b610e83611ea3565b600054610100900460ff166119be5760405162461bcd60e51b81526004016106a690612af5565b6111918282611ed3565b600054610100900460ff16610e835760405162461bcd60e51b81526004016106a690612af5565b600054610100900460ff16611a165760405162461bcd60e51b81526004016106a690612af5565b610e836119c8565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6000611a8161010480546001019055565b6000611a8d6101045490565b905061010054811115611ae25760405162461bcd60e51b815260206004820181905260248201527f5f637265617465546f6b656e3a3a6578636565646564206d6178546f6b656e7360448201526064016106a6565b611aec8582611f13565b600081815260fe60205260409020849055600081815260fd6020526040902080546001600160a01b0319166001600160a01b038516179055949350505050565b816001600160a01b0316836001600160a01b031603611b8d5760405162461bcd60e51b815260206004820152601960248201527f4552433732313a20617070726f766520746f2063616c6c65720000000000000060448201526064016106a6565b6001600160a01b038381166000818152609c6020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b61010054811115611c4d5760405162461bcd60e51b815260206004820181905260248201527f5f707265706172654d696e743a3a6578636565646564206d6178546f6b656e7360448201526064016106a6565b6101045415611cb85760405162461bcd60e51b815260206004820152603160248201527f5f707265706172654d696e743a3a63616e206f6e6c792070726570617265206d604482015270696e742077697468203020746f6b656e7360781b60648201526084016106a6565b604051806060016040528082815260200184848080601f016020809104026020016040519081016040528093929190818152602001838380828437600092018290525093855250505060209182015281516101059081559082015161010690611d219082612b40565b50604091820151600291909101805460ff19169115159190911790555181907f6f1d651e6e0c8f86bd32a20c22a644d1e34fabf72307ff95d51b9f5892ddba199061093f9086908690612868565b611d7a848484611668565b611d8684848484611f2d565b61121e5760405162461bcd60e51b81526004016106a690612c00565b606081600003611dc95750506040805180820190915260018152600360fc1b602082015290565b8160005b8115611df35780611ddd81612c52565b9150611dec9050600a83612a93565b9150611dcd565b60008167ffffffffffffffff811115611e0e57611e0e61253a565b6040519080825280601f01601f191660200182016040528015611e38576020820181803683370190505b5090505b841561166057611e4d600183612a2f565b9150611e5a600a86612c6b565b611e65906030612a46565b60f81b818381518110611e7a57611e7a612c7f565b60200101906001600160f81b031916908160001a905350611e9c600a86612a93565b9450611e3c565b600054610100900460ff16611eca5760405162461bcd60e51b81526004016106a690612af5565b610e8333611a1e565b600054610100900460ff16611efa5760405162461bcd60e51b81526004016106a690612af5565b6097611f068382612b40565b5060986107db8282612b40565b61119182826040518060200160405280600081525061202e565b60006001600160a01b0384163b1561202357604051630a85bd0160e11b81526001600160a01b0385169063150b7a0290611f71903390899088908890600401612c95565b6020604051808303816000875af1925050508015611fac575060408051601f3d908101601f19168201909252611fa991810190612cd2565b60015b612009573d808015611fda576040519150601f19603f3d011682016040523d82523d6000602084013e611fdf565b606091505b5080516000036120015760405162461bcd60e51b81526004016106a690612c00565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050611660565b506001949350505050565b6120388383612061565b6120456000848484611f2d565b6107db5760405162461bcd60e51b81526004016106a690612c00565b6001600160a01b0382166120b75760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f206164647265737360448201526064016106a6565b6000818152609960205260409020546001600160a01b03161561211c5760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e7465640000000060448201526064016106a6565b6001600160a01b0382166000908152609a60205260408120805460019290612145908490612a46565b909155505060008181526099602052604080822080546001600160a01b0319166001600160a01b03861690811790915590518392907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a45050565b6001600160e01b031981168114610a4c57600080fd5b6000602082840312156121cb57600080fd5b8135611810816121a3565b60005b838110156121f15781810151838201526020016121d9565b8381111561121e5750506000910152565b6000815180845261221a8160208601602086016121d6565b601f01601f19169290920160200192915050565b6020815260006118106020830184612202565b60006020828403121561225357600080fd5b5035919050565b80356001600160a01b0381168114610f5657600080fd5b6000806040838503121561228457600080fd5b61228d8361225a565b946020939093013593505050565b600080604083850312156122ae57600080fd5b6122b78361225a565b9150602083013580151581146122cc57600080fd5b809150509250929050565b60008083601f8401126122e957600080fd5b50813567ffffffffffffffff81111561230157600080fd5b60208301915083602082850101111561231957600080fd5b9250929050565b60008060006040848603121561233557600080fd5b83359250602084013567ffffffffffffffff81111561235357600080fd5b61235f868287016122d7565b9497909650939450505050565b60008060006060848603121561238157600080fd5b61238a8461225a565b92506123986020850161225a565b9150604084013590509250925092565b600080604083850312156123bb57600080fd5b50508035926020909101359150565b6000602082840312156123dc57600080fd5b6118108261225a565b600080600080600080608087890312156123fe57600080fd5b863567ffffffffffffffff8082111561241657600080fd5b6124228a838b016122d7565b9098509650602089013591508082111561243b57600080fd5b5061244889828a016122d7565b909550935061245b90506040880161225a565b9150606087013590509295509295509295565b6000806020838503121561248157600080fd5b823567ffffffffffffffff81111561249857600080fd5b6124a4858286016122d7565b90969095509350505050565b602081528151602082015260006020830151606060408401526124d66080840182612202565b90506040840151151560608401528091505092915050565b60008060006040848603121561250357600080fd5b833567ffffffffffffffff81111561251a57600080fd5b612526868287016122d7565b909790965060209590950135949350505050565b634e487b7160e01b600052604160045260246000fd5b6000806000806080858703121561256657600080fd5b61256f8561225a565b935061257d6020860161225a565b925060408501359150606085013567ffffffffffffffff808211156125a157600080fd5b818701915087601f8301126125b557600080fd5b8135818111156125c7576125c761253a565b604051601f8201601f19908116603f011681019083821181831017156125ef576125ef61253a565b816040528281528a602084870101111561260857600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b6000806000806060858703121561264257600080fd5b843567ffffffffffffffff81111561265957600080fd5b612665878288016122d7565b9095509350506020850135915061267e6040860161225a565b905092959194509250565b6000806040838503121561269c57600080fd5b6126a58361225a565b9150610a106020840161225a565b600181811c908216806126c757607f821691505b6020821081036126e757634e487b7160e01b600052602260045260246000fd5b50919050565b6020808252818101527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604082015260600190565b6020808252601e908201527f436f6e7472616374206d757374206e6f742062652064697361626c65642e0000604082015260600190565b601f8211156107db57600081815260208120601f850160051c810160208610156127805750805b601f850160051c820191505b8181101561279f5782815560010161278c565b505050505050565b67ffffffffffffffff8311156127bf576127bf61253a565b6127d3836127cd83546126b3565b83612759565b6000601f84116001811461280757600085156127ef5750838201355b600019600387901b1c1916600186901b178355612861565b600083815260209020601f19861690835b828110156128385786850135825560209485019460019092019101612818565b50868210156128555760001960f88860031b161c19848701351681555b505060018560011b0183555b5050505050565b60208152816020820152818360408301376000818301604090810191909152601f909201601f19160101919050565b60208082526031908201527f4552433732313a207472616e736665722063616c6c6572206973206e6f74206f6040820152701ddb995c881b9bdc88185c1c1c9bdd9959607a1b606082015260800190565b60006020808352600084546128fc816126b3565b8084870152604060018084166000811461291d576001811461293757612965565b60ff1985168984015283151560051b890183019550612965565b896000528660002060005b8581101561295d5781548b8201860152908301908801612942565b8a0184019650505b509398975050505050505050565b6000808454612981816126b3565b6001828116801561299957600181146129ae576129dd565b60ff19841687528215158302870194506129dd565b8860005260208060002060005b858110156129d45781548a8201529084019082016129bb565b50505082870194505b50602f60f81b8452865192506129f98382860160208a016121d6565b64173539b7b760d91b939092019182019290925260060195945050505050565b634e487b7160e01b600052601160045260246000fd5b600082821015612a4157612a41612a19565b500390565b60008219821115612a5957612a59612a19565b500190565b6000816000190483118215151615612a7857612a78612a19565b500290565b634e487b7160e01b600052601260045260246000fd5b600082612aa257612aa2612a7d565b500490565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b815167ffffffffffffffff811115612b5a57612b5a61253a565b612b6e81612b6884546126b3565b84612759565b602080601f831160018114612ba35760008415612b8b5750858301515b600019600386901b1c1916600185901b17855561279f565b600085815260208120601f198616915b82811015612bd257888601518255948401946001909101908401612bb3565b5085821015612bf05787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b600060018201612c6457612c64612a19565b5060010190565b600082612c7a57612c7a612a7d565b500690565b634e487b7160e01b600052603260045260246000fd5b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090612cc890830184612202565b9695505050505050565b600060208284031215612ce457600080fd5b8151611810816121a356fea26469706673582212203ad60c5acc0ff04f869f53b97ed097eb310c45126ed03b9e44d45229f8b29f2764736f6c634300080f0033608060405234801561001057600080fd5b50613840806100206000396000f3fe608060405234801561001057600080fd5b50600436106102955760003560e01c806370a0823111610167578063b390ac25116100ce578063e985e9c511610087578063e985e9c5146105d7578063eab85118146105ea578063ee070805146105fd578063efc32cd414610609578063f2fde38b1461061c578063ff6e8c8f1461062f57600080fd5b8063b390ac251461056e578063b88d4fde14610581578063b9fbd25c14610594578063bc719455146105a7578063c87b56dd146105ba578063e8315742146105cd57600080fd5b8063931688cb11610120578063931688cb146105105780639338bb5d1461052357806395d89b41146105385780639e860f2a14610540578063a22cb46514610553578063ab69607a1461056657600080fd5b806370a08231146104b5578063715018a6146104c8578063755edd17146104d057806387bc793f146104e3578063894ba833146104f75780638da5cb5b146104ff57600080fd5b80632ce878da1161020b57806342966c68116101c457806342966c681461044e578063472a66381461046157806353df5c7c146104745780635edc7c191461047c5780636297c16c1461048f5780636352211e146104a257600080fd5b80632ce878da146103cf5780633403c4e9146103d75780633a3d146f146103e85780633ebc82c51461041557806340c1a0641461042857806342842e0e1461043b57600080fd5b80630de54ba01161025d5780630de54ba01461033b57806318160ddd1461034e57806318e97fd114610364578063204274861461037757806323b872dd1461038a5780632a55205a1461039d57600080fd5b8063012cf1e81461029a57806301ffc9a7146102c357806306fdde03146102e6578063081812fc146102fb578063095ea7b314610326575b600080fd5b6102ad6102a8366004612b7c565b610642565b6040516102ba9190612b97565b60405180910390f35b6102d66102d1366004612bfa565b610688565b60405190151581526020016102ba565b6102ee6106a2565b6040516102ba9190612c6f565b61030e610309366004612c82565b610734565b6040516001600160a01b0390911681526020016102ba565b610339610334366004612cb2565b6107ce565b005b610339610349366004612cdc565b6108a3565b61035661091b565b6040519081526020016102ba565b610339610372366004612d61565b61092c565b6102d6610385366004612dad565b610a0f565b610339610398366004612dc8565b610a3e565b6103b06103ab366004612e04565b610a70565b604080516001600160a01b0390931683526020830191909152016102ba565b6102ad610b0b565b60fb546001600160a01b031661030e565b6102d66103f6366004612dad565b6001600160a01b03166000908152610102602052604090205460ff1690565b610339610423366004612dad565b610b31565b61030e610436366004612c82565b610b67565b610339610449366004612dc8565b610b7b565b61033961045c366004612c82565b610b96565b61033961046f366004612b7c565b610c0d565b610339610c3c565b61033961048a366004612e26565b610cb0565b61033961049d366004612c82565b610e30565b61030e6104b0366004612c82565b610e99565b6103566104c3366004612dad565b610f10565b610339610f96565b6103566104de366004612dad565b610fcc565b6101095460ff166040516102ba9190612ec5565b6103396110a2565b6033546001600160a01b031661030e565b61033961051e366004612eed565b611106565b61052b6111da565b6040516102ba9190612f2f565b6102ee6112be565b61033961054e366004612f6d565b6112cd565b610339610561366004612cdc565b611330565b60fc54610356565b61033961057c366004612ff3565b6113d7565b61033961058f366004613055565b61142e565b6103396105a2366004613131565b611466565b6103396105b5366004612b7c565b6114e5565b6102ee6105c8366004612c82565b61159a565b6103566101005481565b6102d66105e536600461318e565b611693565b6102d66105f8366004612dad565b6116c1565b60ff80546102d6911681565b610339610617366004612cb2565b6116e8565b61033961062a366004612dad565b611740565b61033961063d366004612f6d565b6117d8565b6060610682610108600084600281111561065e5761065e612eaf565b600281111561066f5761066f612eaf565b8152602001908152602001600020611870565b92915050565b600061069382611884565b806106825750610682826118a9565b6060609780546106b1906131b8565b80601f01602080910402602001604051908101604052809291908181526020018280546106dd906131b8565b801561072a5780601f106106ff5761010080835404028352916020019161072a565b820191906000526020600020905b81548152906001019060200180831161070d57829003601f168201915b5050505050905090565b6000818152609960205260408120546001600160a01b03166107b25760405162461bcd60e51b815260206004820152602c60248201527f4552433732313a20617070726f76656420717565727920666f72206e6f6e657860448201526b34b9ba32b73a103a37b5b2b760a11b60648201526084015b60405180910390fd5b506000908152609b60205260409020546001600160a01b031690565b8160016101095460ff1660028111156107e9576107e9612eaf565b036108485761082781610108600060015b600281111561080b5761080b612eaf565b81526020019081526020016000206118ec90919063ffffffff16565b610843576040516282b42960e81b815260040160405180910390fd5b610894565b60026101095460ff16600281111561086257610862612eaf565b036108945761087781610108600060026107fa565b15610894576040516282b42960e81b815260040160405180910390fd5b61089e838361190e565b505050565b6033546001600160a01b031633146108cd5760405162461bcd60e51b81526004016107a9906131f2565b60ff805416156108ef5760405162461bcd60e51b81526004016107a990613227565b6001600160a01b0391909116600090815261010260205260409020805460ff1916911515919091179055565b60006109276101045490565b905090565b6033546001600160a01b031633146109565760405162461bcd60e51b81526004016107a9906131f2565b6101075460ff16156109b55760405162461bcd60e51b815260206004820152602260248201527f757064617465546f6b656e5552493a3a6d65746164617461206973206c6f636b604482015261195960f21b60648201526084016107a9565b6000838152610103602052604090206109cf8284836132ac565b50827f931f495b9a8e5d8e61946ea5d61e021f636cfe213a801f97589c18c152e408bd8383604051610a0292919061336d565b60405180910390a2505050565b6000610a236033546001600160a01b031690565b6001600160a01b0316826001600160a01b0316149050919050565b610a49335b82611a1e565b610a655760405162461bcd60e51b81526004016107a99061339c565b61089e838383611af5565b600082815260fd602052604081205481906001600160a01b0316610a9f5760fb546001600160a01b0316610ab8565b600084815260fd60205260409020546001600160a01b03165b9150610b026064610afc60fe600088815260200190815260200160002054600003610ae55760fc54610af5565b600087815260fe60205260409020545b8690611c91565b90611c9d565b90509250929050565b61010954606090610927906101089060009060ff16600281111561065e5761065e612eaf565b6033546001600160a01b03163314610b5b5760405162461bcd60e51b81526004016107a9906131f2565b610b6481611ca9565b50565b60006106826033546001600160a01b031690565b61089e8383836040518060200160405280600081525061142e565b610b9f33610a43565b610c045760405162461bcd60e51b815260206004820152603060248201527f4552433732314275726e61626c653a2063616c6c6572206973206e6f74206f7760448201526f1b995c881b9bdc88185c1c1c9bdd995960821b60648201526084016107a9565b610b6481611ccb565b610c1633610a0f565b610c3357604051635c510c8360e11b815260040160405180910390fd5b610b6481611d67565b6033546001600160a01b03163314610c665760405162461bcd60e51b81526004016107a9906131f2565b6040517fb634b0cb94234b05eabb1438717e0e645bfd84788ae1263682242327563cde5e90610c9890610106906133ed565b60405180910390a1610107805460ff19166001179055565b6000610cbc6001611de4565b90508015610cd4576000805461ff0019166101001790555b6001600160a01b038316610d2a5760405162461bcd60e51b815260206004820152601e60248201527f63726561746f722063616e6e6f74206265206e756c6c2061646472657373000060448201526064016107a9565b610d34600a60fc55565b60ff805460ff19169055610100829055610d4c611e6c565b610dbf87878080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8b018190048102820181019092528981529250899150889081908401838280828437600092019190915250611e9b92505050565b610dc7611ecc565b610dcf611ef3565b610dd883611ca9565b610de183611740565b8015610e27576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050505050565b33610e3a82610e99565b6001600160a01b031614610e905760405162461bcd60e51b815260206004820152601f60248201527f4d75737420626520746865206f776e6572206f662074686520746f6b656e2e0060448201526064016107a9565b610b6481610b96565b6000818152609960205260408120546001600160a01b0316806106825760405162461bcd60e51b815260206004820152602960248201527f4552433732313a206f776e657220717565727920666f72206e6f6e657869737460448201526832b73a103a37b5b2b760b91b60648201526084016107a9565b60006001600160a01b038216610f7a5760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b60648201526084016107a9565b506001600160a01b03166000908152609a602052604090205490565b6033546001600160a01b03163314610fc05760405162461bcd60e51b81526004016107a9906131f2565b610fca6000611f22565b565b60ff80546000911615610ff15760405162461bcd60e51b81526004016107a990613227565b6033546001600160a01b031633148061101a5750336000908152610102602052604090205460ff165b61107f5760405162461bcd60e51b815260206004820152603060248201527f6c617a794d696e743a3a6f6e6c79206f776e6572206f7220617070726f76656460448201526f081b5a5b9d195c8818d85b881b5a5b9d60821b60648201526084016107a9565b6106828261108c60fc5490565b60fb546001600160a01b0316611f74565b919050565b6033546001600160a01b031633146110cc5760405162461bcd60e51b81526004016107a9906131f2565b60ff805460ff1916600117905560405133907f793bc6423dd0257d64f9d47db72fd4b2162f4541aa41740ba1c5fb5e2cd41bcd90600090a2565b6033546001600160a01b031633146111305760405162461bcd60e51b81526004016107a9906131f2565b6101075460ff161561118e5760405162461bcd60e51b815260206004820152602160248201527f757064617465426173655552493a3a6d65746164617461206973206c6f636b656044820152601960fa1b60648201526084016107a9565b61010661119c8284836132ac565b507f1c306e70c05992619e2128ad1ef88df75f36c9476282e59f51401b2abaa42e4e82826040516111ce92919061336d565b60405180910390a15050565b611200604051806060016040528060008152602001606081526020016000151581525090565b6040805160608101909152610105805482526101068054602084019190611226906131b8565b80601f0160208091040260200160405190810160405280929190818152602001828054611252906131b8565b801561129f5780601f106112745761010080835404028352916020019161129f565b820191906000526020600020905b81548152906001019060200180831161128257829003601f168201915b50505091835250506002919091015460ff161515602090910152919050565b6060609880546106b1906131b8565b6112d633610a0f565b6112f357604051635c510c8360e11b815260040160405180910390fd5b61089e8383838080602002602001604051908101604052809392919081815260200183836020028082843760009201829052509250612030915050565b8160016101095460ff16600281111561134b5761134b612eaf565b036113815761136081610108600060016107fa565b61137c576040516282b42960e81b815260040160405180910390fd5b6113cd565b60026101095460ff16600281111561139b5761139b612eaf565b036113cd576113b081610108600060026107fa565b156113cd576040516282b42960e81b815260040160405180910390fd5b61089e838361220d565b6033546001600160a01b031633146114015760405162461bcd60e51b81526004016107a9906131f2565b60ff805416156114235760405162461bcd60e51b81526004016107a990613227565b61089e838383612218565b6114383383611a1e565b6114545760405162461bcd60e51b81526004016107a99061339c565b6114608484848461238d565b50505050565b6033546001600160a01b031633146114905760405162461bcd60e51b81526004016107a9906131f2565b60ff805416156114b25760405162461bcd60e51b81526004016107a990613227565b6114bd848484612218565b6001600160a01b0316600090815261010260205260409020805460ff19166001179055505050565b6114ee33610a0f565b61150b57604051635c510c8360e11b815260040160405180910390fd5b610108600082600281111561152257611522612eaf565b600281111561153357611533612eaf565b8152602081019190915260400160009081209081816115528282612b3b565b50505050336001600160a01b03167f7efc19cf93d497a6a56103ea89a39d51c0cad74a817ed3cd0ecaff9823d4da248260405161158f9190612ec5565b60405180910390a250565b600081815261010360205260408120805460609291906115b9906131b8565b905011156116605760008281526101036020526040902080546115db906131b8565b80601f0160208091040260200160405190810160405280929190818152602001828054611607906131b8565b80156116545780601f1061162957610100808354040283529160200191611654565b820191906000526020600020905b81548152906001019060200180831161163757829003601f168201915b50505050509050919050565b61010661166c836123c0565b60405160200161167d929190613478565b6040516020818303038152906040529050919050565b6001600160a01b039182166000908152609c6020908152604080832093909416825291909152205460ff1690565b6101095460009061068290839061010890849060ff1660028111156107fa576107fa612eaf565b6033546001600160a01b031633146117125760405162461bcd60e51b81526004016107a9906131f2565b600090815260fd6020526040902080546001600160a01b0319166001600160a01b0392909216919091179055565b6033546001600160a01b0316331461176a5760405162461bcd60e51b81526004016107a9906131f2565b6001600160a01b0381166117cf5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016107a9565b610b6481611f22565b6117e133610a0f565b6117fe57604051635c510c8360e11b815260040160405180910390fd5b600083600281111561181257611812612eaf565b0361183057604051632de777a160e11b815260040160405180910390fd5b61089e8383838080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525060019250612030915050565b6060600061187d836124c1565b9392505050565b60006001600160e01b0319821663fa31a45b60e01b148061068257506106828261251c565b60006001600160e01b03198216631030681960e21b14806118ce57506118ce8261251c565b806118dd57506118dd82612532565b80610682575061068282612553565b6001600160a01b0381166000908152600183016020526040812054151561187d565b600061191982610e99565b9050806001600160a01b0316836001600160a01b0316036119865760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b60648201526084016107a9565b336001600160a01b03821614806119a257506119a28133611693565b611a145760405162461bcd60e51b815260206004820152603860248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f74206f7760448201527f6e6572206e6f7220617070726f76656420666f7220616c6c000000000000000060648201526084016107a9565b61089e8383612593565b6000818152609960205260408120546001600160a01b0316611a975760405162461bcd60e51b815260206004820152602c60248201527f4552433732313a206f70657261746f7220717565727920666f72206e6f6e657860448201526b34b9ba32b73a103a37b5b2b760a11b60648201526084016107a9565b6000611aa283610e99565b9050806001600160a01b0316846001600160a01b03161480611ac95750611ac98185611693565b80611aed5750836001600160a01b0316611ae284610734565b6001600160a01b0316145b949350505050565b826001600160a01b0316611b0882610e99565b6001600160a01b031614611b6c5760405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b60648201526084016107a9565b6001600160a01b038216611bce5760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b60648201526084016107a9565b611bd9600082612593565b6001600160a01b0383166000908152609a60205260408120805460019290611c02908490613534565b90915550506001600160a01b0382166000908152609a60205260408120805460019290611c3090849061354b565b909155505060008181526099602052604080822080546001600160a01b0319166001600160a01b0386811691821790925591518493918716917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef91a4505050565b600061187d8284613563565b600061187d8284613598565b60fb80546001600160a01b0319166001600160a01b0392909216919091179055565b6000611cd682610e99565b9050611ce3600083612593565b6001600160a01b0381166000908152609a60205260408120805460019290611d0c908490613534565b909155505060008281526099602052604080822080546001600160a01b0319169055518391906001600160a01b038416907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908390a45b5050565b806002811115611d7957611d79612eaf565b6101095460ff166002811115611d9157611d91612eaf565b60405133907f12282389323caf08dd4e02c490ef05bc7edb56967c085742687aad3cc81aa15f90600090a4610109805482919060ff19166001836002811115611ddc57611ddc612eaf565b021790555050565b60008054610100900460ff1615611e2b578160ff166001148015611e075750303b155b611e235760405162461bcd60e51b81526004016107a9906135ac565b506000919050565b60005460ff808416911610611e525760405162461bcd60e51b81526004016107a9906135ac565b506000805460ff191660ff92909216919091179055600190565b600054610100900460ff16611e935760405162461bcd60e51b81526004016107a9906135fa565b610fca612601565b600054610100900460ff16611ec25760405162461bcd60e51b81526004016107a9906135fa565b611d638282612631565b600054610100900460ff16610fca5760405162461bcd60e51b81526004016107a9906135fa565b600054610100900460ff16611f1a5760405162461bcd60e51b81526004016107a9906135fa565b610fca611ecc565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6000611f8561010480546001019055565b6000611f916101045490565b905061010054811115611fe65760405162461bcd60e51b815260206004820181905260248201527f5f637265617465546f6b656e3a3a6578636565646564206d6178546f6b656e7360448201526064016107a9565b611ff08582612671565b600081815260fe60205260409020849055600081815260fd6020526040902080546001600160a01b0319166001600160a01b038516179055949350505050565b600083600281111561204457612044612eaf565b1461089e5760005b825181101561146057811561212d576120bc83828151811061207057612070613645565b6020026020010151610108600087600281111561208f5761208f612eaf565b60028111156120a0576120a0612eaf565b815260200190815260200160002061268b90919063ffffffff16565b508360028111156120cf576120cf612eaf565b8382815181106120e1576120e1613645565b60200260200101516001600160a01b0316336001600160a01b03167f14155f749dc3f9cd2bf890d6d3a47069f77ae35befcee11c8b1a3ba41cba153660405160405180910390a46121fb565b61218e83828151811061214257612142613645565b6020026020010151610108600087600281111561216157612161612eaf565b600281111561217257612172612eaf565b81526020019081526020016000206126a090919063ffffffff16565b508360028111156121a1576121a1612eaf565b8382815181106121b3576121b3613645565b60200260200101516001600160a01b0316336001600160a01b03167fc72e29af1b34de3dec3a764b4ca4d85b9c380ab33b9b268d29b6e7008bd0ed9560405160405180910390a45b806122058161365b565b91505061204c565b611d633383836126b5565b6101005481111561226b5760405162461bcd60e51b815260206004820181905260248201527f5f707265706172654d696e743a3a6578636565646564206d6178546f6b656e7360448201526064016107a9565b61010454156122d65760405162461bcd60e51b815260206004820152603160248201527f5f707265706172654d696e743a3a63616e206f6e6c792070726570617265206d604482015270696e742077697468203020746f6b656e7360781b60648201526084016107a9565b604051806060016040528082815260200184848080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201829052509385525050506020918201528151610105908155908201516101069061233f9082613674565b50604091820151600291909101805460ff19169115159190911790555181907f6f1d651e6e0c8f86bd32a20c22a644d1e34fabf72307ff95d51b9f5892ddba1990610a02908690869061336d565b612398848484611af5565b6123a484848484612783565b6114605760405162461bcd60e51b81526004016107a990613734565b6060816000036123e75750506040805180820190915260018152600360fc1b602082015290565b8160005b811561241157806123fb8161365b565b915061240a9050600a83613598565b91506123eb565b60008167ffffffffffffffff81111561242c5761242c61303f565b6040519080825280601f01601f191660200182016040528015612456576020820181803683370190505b5090505b8415611aed5761246b600183613534565b9150612478600a86613786565b61248390603061354b565b60f81b81838151811061249857612498613645565b60200101906001600160f81b031916908160001a9053506124ba600a86613598565b945061245a565b60608160000180548060200260200160405190810160405280929190818152602001828054801561165457602002820191906000526020600020905b8154815260200190600101908083116124fd5750505050509050919050565b6001600160e01b0319166301ffc9a760e01b1490565b60006001600160e01b0319821663152a902d60e11b14806106825750610682825b60006001600160e01b031982166380ac58cd60e01b148061258457506001600160e01b03198216635b5e139f60e01b145b8061068257506106828261251c565b6000818152609b6020526040902080546001600160a01b0319166001600160a01b03841690811790915581906125c882610e99565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b600054610100900460ff166126285760405162461bcd60e51b81526004016107a9906135fa565b610fca33611f22565b600054610100900460ff166126585760405162461bcd60e51b81526004016107a9906135fa565b60976126648382613674565b50609861089e8282613674565b611d63828260405180602001604052806000815250612884565b600061187d836001600160a01b0384166128b7565b600061187d836001600160a01b038416612906565b816001600160a01b0316836001600160a01b0316036127165760405162461bcd60e51b815260206004820152601960248201527f4552433732313a20617070726f766520746f2063616c6c65720000000000000060448201526064016107a9565b6001600160a01b038381166000818152609c6020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b60006001600160a01b0384163b1561287957604051630a85bd0160e11b81526001600160a01b0385169063150b7a02906127c790339089908890889060040161379a565b6020604051808303816000875af1925050508015612802575060408051601f3d908101601f191682019092526127ff918101906137d7565b60015b61285f573d808015612830576040519150601f19603f3d011682016040523d82523d6000602084013e612835565b606091505b5080516000036128575760405162461bcd60e51b81526004016107a990613734565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050611aed565b506001949350505050565b61288e83836129f9565b61289b6000848484612783565b61089e5760405162461bcd60e51b81526004016107a990613734565b60008181526001830160205260408120546128fe57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610682565b506000610682565b600081815260018301602052604081205480156129ef57600061292a600183613534565b855490915060009061293e90600190613534565b90508181146129a357600086600001828154811061295e5761295e613645565b906000526020600020015490508087600001848154811061298157612981613645565b6000918252602080832090910192909255918252600188019052604090208390555b85548690806129b4576129b46137f4565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610682565b6000915050610682565b6001600160a01b038216612a4f5760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f206164647265737360448201526064016107a9565b6000818152609960205260409020546001600160a01b031615612ab45760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e7465640000000060448201526064016107a9565b6001600160a01b0382166000908152609a60205260408120805460019290612add90849061354b565b909155505060008181526099602052604080822080546001600160a01b0319166001600160a01b03861690811790915590518392907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a45050565b5080546000825590600052602060002090810190610b6491905b80821115612b695760008155600101612b55565b5090565b80356003811061109d57600080fd5b600060208284031215612b8e57600080fd5b61187d82612b6d565b6020808252825182820181905260009190848201906040850190845b81811015612bd85783516001600160a01b031683529284019291840191600101612bb3565b50909695505050505050565b6001600160e01b031981168114610b6457600080fd5b600060208284031215612c0c57600080fd5b813561187d81612be4565b60005b83811015612c32578181015183820152602001612c1a565b838111156114605750506000910152565b60008151808452612c5b816020860160208601612c17565b601f01601f19169290920160200192915050565b60208152600061187d6020830184612c43565b600060208284031215612c9457600080fd5b5035919050565b80356001600160a01b038116811461109d57600080fd5b60008060408385031215612cc557600080fd5b612cce83612c9b565b946020939093013593505050565b60008060408385031215612cef57600080fd5b612cf883612c9b565b915060208301358015158114612d0d57600080fd5b809150509250929050565b60008083601f840112612d2a57600080fd5b50813567ffffffffffffffff811115612d4257600080fd5b602083019150836020828501011115612d5a57600080fd5b9250929050565b600080600060408486031215612d7657600080fd5b83359250602084013567ffffffffffffffff811115612d9457600080fd5b612da086828701612d18565b9497909650939450505050565b600060208284031215612dbf57600080fd5b61187d82612c9b565b600080600060608486031215612ddd57600080fd5b612de684612c9b565b9250612df460208501612c9b565b9150604084013590509250925092565b60008060408385031215612e1757600080fd5b50508035926020909101359150565b60008060008060008060808789031215612e3f57600080fd5b863567ffffffffffffffff80821115612e5757600080fd5b612e638a838b01612d18565b90985096506020890135915080821115612e7c57600080fd5b50612e8989828a01612d18565b9095509350612e9c905060408801612c9b565b9150606087013590509295509295509295565b634e487b7160e01b600052602160045260246000fd5b6020810160038310612ee757634e487b7160e01b600052602160045260246000fd5b91905290565b60008060208385031215612f0057600080fd5b823567ffffffffffffffff811115612f1757600080fd5b612f2385828601612d18565b90969095509350505050565b60208152815160208201526000602083015160606040840152612f556080840182612c43565b90506040840151151560608401528091505092915050565b600080600060408486031215612f8257600080fd5b612f8b84612b6d565b9250602084013567ffffffffffffffff80821115612fa857600080fd5b818601915086601f830112612fbc57600080fd5b813581811115612fcb57600080fd5b8760208260051b8501011115612fe057600080fd5b6020830194508093505050509250925092565b60008060006040848603121561300857600080fd5b833567ffffffffffffffff81111561301f57600080fd5b61302b86828701612d18565b909790965060209590950135949350505050565b634e487b7160e01b600052604160045260246000fd5b6000806000806080858703121561306b57600080fd5b61307485612c9b565b935061308260208601612c9b565b925060408501359150606085013567ffffffffffffffff808211156130a657600080fd5b818701915087601f8301126130ba57600080fd5b8135818111156130cc576130cc61303f565b604051601f8201601f19908116603f011681019083821181831017156130f4576130f461303f565b816040528281528a602084870101111561310d57600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b6000806000806060858703121561314757600080fd5b843567ffffffffffffffff81111561315e57600080fd5b61316a87828801612d18565b9095509350506020850135915061318360408601612c9b565b905092959194509250565b600080604083850312156131a157600080fd5b6131aa83612c9b565b9150610b0260208401612c9b565b600181811c908216806131cc57607f821691505b6020821081036131ec57634e487b7160e01b600052602260045260246000fd5b50919050565b6020808252818101527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604082015260600190565b6020808252601e908201527f436f6e7472616374206d757374206e6f742062652064697361626c65642e0000604082015260600190565b601f82111561089e57600081815260208120601f850160051c810160208610156132855750805b601f850160051c820191505b818110156132a457828155600101613291565b505050505050565b67ffffffffffffffff8311156132c4576132c461303f565b6132d8836132d283546131b8565b8361325e565b6000601f84116001811461330c57600085156132f45750838201355b600019600387901b1c1916600186901b178355613366565b600083815260209020601f19861690835b8281101561333d578685013582556020948501946001909201910161331d565b508682101561335a5760001960f88860031b161c19848701351681555b505060018560011b0183555b5050505050565b60208152816020820152818360408301376000818301604090810191909152601f909201601f19160101919050565b60208082526031908201527f4552433732313a207472616e736665722063616c6c6572206973206e6f74206f6040820152701ddb995c881b9bdc88185c1c1c9bdd9959607a1b606082015260800190565b6000602080835260008454613401816131b8565b80848701526040600180841660008114613422576001811461343c5761346a565b60ff1985168984015283151560051b89018301955061346a565b896000528660002060005b858110156134625781548b8201860152908301908801613447565b8a0184019650505b509398975050505050505050565b6000808454613486816131b8565b6001828116801561349e57600181146134b3576134e2565b60ff19841687528215158302870194506134e2565b8860005260208060002060005b858110156134d95781548a8201529084019082016134c0565b50505082870194505b50602f60f81b8452865192506134fe8382860160208a01612c17565b64173539b7b760d91b939092019182019290925260060195945050505050565b634e487b7160e01b600052601160045260246000fd5b6000828210156135465761354661351e565b500390565b6000821982111561355e5761355e61351e565b500190565b600081600019048311821515161561357d5761357d61351e565b500290565b634e487b7160e01b600052601260045260246000fd5b6000826135a7576135a7613582565b500490565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b60006001820161366d5761366d61351e565b5060010190565b815167ffffffffffffffff81111561368e5761368e61303f565b6136a28161369c84546131b8565b8461325e565b602080601f8311600181146136d757600084156136bf5750858301515b600019600386901b1c1916600185901b1785556132a4565b600085815260208120601f198616915b82811015613706578886015182559484019460019091019084016136e7565b50858210156137245787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b60008261379557613795613582565b500690565b6001600160a01b03858116825284166020820152604081018390526080606082018190526000906137cd90830184612c43565b9695505050505050565b6000602082840312156137e957600080fd5b815161187d81612be4565b634e487b7160e01b600052603160045260246000fdfea26469706673582212205370b00cd33099bb7db34d5dcd47472641d39a154db4f6e3ad68922ff6aec39a64736f6c634300080f0033608060405234801561001057600080fd5b50613992806100206000396000f3fe608060405234801561001057600080fd5b50600436106102d65760003560e01c806370a0823111610182578063ab69607a116100e9578063e8315742116100a2578063ee0708051161007c578063ee07080514610662578063efc32cd41461066e578063f2fde38b14610681578063ff6e8c8f1461069457600080fd5b8063e831574214610632578063e985e9c51461063c578063eab851181461064f57600080fd5b8063ab69607a146105cb578063b390ac25146105d3578063b88d4fde146105e6578063b9fbd25c146105f9578063bc7194551461060c578063c87b56dd1461061f57600080fd5b80638da5cb5b1161013b5780638da5cb5b14610564578063931688cb146105755780639338bb5d1461058857806395d89b411461059d5780639e860f2a146105a5578063a22cb465146105b857600080fd5b806370a0823114610511578063715018a614610524578063717392ed1461052c578063755edd171461053557806387bc793f14610548578063894ba8331461055c57600080fd5b80632ce878da1161024157806342966c68116101fa5780635aec8d62116101d45780635aec8d62146104d05780635edc7c19146104d85780636297c16c146104eb5780636352211e146104fe57600080fd5b806342966c68146104a2578063472a6638146104b557806353df5c7c146104c857600080fd5b80632ce878da146104235780633403c4e91461042b5780633a3d146f1461043c5780633ebc82c51461046957806340c1a0641461047c57806342842e0e1461048f57600080fd5b806318160ddd1161029357806318160ddd1461038f57806318e97fd1146103a557806320427486146103b857806321c4a5d8146103cb57806323b872dd146103de5780632a55205a146103f157600080fd5b8063012cf1e8146102db57806301ffc9a71461030457806306fdde0314610327578063081812fc1461033c578063095ea7b3146103675780630de54ba01461037c575b600080fd5b6102ee6102e9366004612cce565b6106a7565b6040516102fb9190612ce9565b60405180910390f35b610317610312366004612d4c565b6106ed565b60405190151581526020016102fb565b61032f610707565b6040516102fb9190612dc1565b61034f61034a366004612dd4565b610799565b6040516001600160a01b0390911681526020016102fb565b61037a610375366004612e04565b610833565b005b61037a61038a366004612e2e565b610908565b610397610980565b6040519081526020016102fb565b61037a6103b3366004612eb3565b610991565b6103176103c6366004612eff565b610a74565b61037a6103d9366004612dd4565b610aa3565b61037a6103ec366004612f1a565b610ad5565b6104046103ff366004612f56565b610b07565b604080516001600160a01b0390931683526020830191909152016102fb565b6102ee610ba2565b60fb546001600160a01b031661034f565b61031761044a366004612eff565b6001600160a01b03166000908152610102602052604090205460ff1690565b61037a610477366004612eff565b610bc8565b61034f61048a366004612dd4565b610bfb565b61037a61049d366004612f1a565b610c0f565b61037a6104b0366004612dd4565b610c2a565b61037a6104c3366004612cce565b610ca1565b61037a610cd0565b61037a610d44565b61037a6104e6366004612f78565b610d9f565b61037a6104f9366004612dd4565b610f1f565b61034f61050c366004612dd4565b610f88565b61039761051f366004612eff565b610fff565b61037a611085565b61010a54610397565b610397610543366004612eff565b6110bb565b6101095460ff166040516102fb9190613017565b61037a611191565b6033546001600160a01b031661034f565b61037a61058336600461303f565b6111f5565b6105906112c9565b6040516102fb9190613081565b61032f6113ad565b61037a6105b33660046130bf565b6113bc565b61037a6105c6366004612e2e565b61141f565b60fc54610397565b61037a6105e1366004613145565b6114c6565b61037a6105f43660046131a7565b61151d565b61037a610607366004613283565b611555565b61037a61061a366004612cce565b6115d4565b61032f61062d366004612dd4565b611689565b6103976101005481565b61031761064a3660046132e0565b611782565b61031761065d366004612eff565b6117b0565b60ff8054610317911681565b61037a61067c366004612e04565b6117d7565b61037a61068f366004612eff565b61182f565b61037a6106a23660046130bf565b6118c7565b60606106e761010860008460028111156106c3576106c3613001565b60028111156106d4576106d4613001565b815260200190815260200160002061195f565b92915050565b60006106f882611973565b806106e757506106e782611998565b6060609780546107169061330a565b80601f01602080910402602001604051908101604052809291908181526020018280546107429061330a565b801561078f5780601f106107645761010080835404028352916020019161078f565b820191906000526020600020905b81548152906001019060200180831161077257829003601f168201915b5050505050905090565b6000818152609960205260408120546001600160a01b03166108175760405162461bcd60e51b815260206004820152602c60248201527f4552433732313a20617070726f76656420717565727920666f72206e6f6e657860448201526b34b9ba32b73a103a37b5b2b760a11b60648201526084015b60405180910390fd5b506000908152609b60205260409020546001600160a01b031690565b8160016101095460ff16600281111561084e5761084e613001565b036108ad5761088c81610108600060015b600281111561087057610870613001565b81526020019081526020016000206119db90919063ffffffff16565b6108a8576040516282b42960e81b815260040160405180910390fd5b6108f9565b60026101095460ff1660028111156108c7576108c7613001565b036108f9576108dc816101086000600261085f565b156108f9576040516282b42960e81b815260040160405180910390fd5b61090383836119fd565b505050565b6033546001600160a01b031633146109325760405162461bcd60e51b815260040161080e90613344565b60ff805416156109545760405162461bcd60e51b815260040161080e90613379565b6001600160a01b0391909116600090815261010260205260409020805460ff1916911515919091179055565b600061098c6101045490565b905090565b6033546001600160a01b031633146109bb5760405162461bcd60e51b815260040161080e90613344565b6101075460ff1615610a1a5760405162461bcd60e51b815260206004820152602260248201527f757064617465546f6b656e5552493a3a6d65746164617461206973206c6f636b604482015261195960f21b606482015260840161080e565b600083815261010360205260409020610a348284836133fe565b50827f931f495b9a8e5d8e61946ea5d61e021f636cfe213a801f97589c18c152e408bd8383604051610a679291906134bf565b60405180910390a2505050565b6000610a886033546001600160a01b031690565b6001600160a01b0316826001600160a01b0316149050919050565b610aac33610a74565b610ac957604051635c510c8360e11b815260040160405180910390fd5b610ad281611b0d565b50565b610ae0335b82611b70565b610afc5760405162461bcd60e51b815260040161080e906134ee565b610903838383611c47565b600082815260fd602052604081205481906001600160a01b0316610b365760fb546001600160a01b0316610b4f565b600084815260fd60205260409020546001600160a01b03165b9150610b996064610b9360fe600088815260200190815260200160002054600003610b7c5760fc54610b8c565b600087815260fe60205260409020545b8690611de3565b90611def565b90509250929050565b6101095460609061098c906101089060009060ff1660028111156106c3576106c3613001565b6033546001600160a01b03163314610bf25760405162461bcd60e51b815260040161080e90613344565b610ad281611dfb565b60006106e76033546001600160a01b031690565b6109038383836040518060200160405280600081525061151d565b610c3333610ada565b610c985760405162461bcd60e51b815260206004820152603060248201527f4552433732314275726e61626c653a2063616c6c6572206973206e6f74206f7760448201526f1b995c881b9bdc88185c1c1c9bdd995960821b606482015260840161080e565b610ad281611e1d565b610caa33610a74565b610cc757604051635c510c8360e11b815260040160405180910390fd5b610ad281611eb9565b6033546001600160a01b03163314610cfa5760405162461bcd60e51b815260040161080e90613344565b6040517fb634b0cb94234b05eabb1438717e0e645bfd84788ae1263682242327563cde5e90610d2c906101069061353f565b60405180910390a1610107805460ff19166001179055565b4261010a541115610d685760405163807a684760e01b815260040160405180910390fd5b610d726000611eb9565b60405133907f60faf76514baf225c418dfc1e3c75bed0bd280f0436999e12cb0a73acb0f9a4690600090a2565b6000610dab6001611f36565b90508015610dc3576000805461ff0019166101001790555b6001600160a01b038316610e195760405162461bcd60e51b815260206004820152601e60248201527f63726561746f722063616e6e6f74206265206e756c6c20616464726573730000604482015260640161080e565b610e23600a60fc55565b60ff805460ff19169055610100829055610e3b611fbe565b610eae87878080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8b018190048102820181019092528981529250899150889081908401838280828437600092019190915250611fed92505050565b610eb661201e565b610ebe612045565b610ec783611dfb565b610ed08361182f565b8015610f16576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050505050565b33610f2982610f88565b6001600160a01b031614610f7f5760405162461bcd60e51b815260206004820152601f60248201527f4d75737420626520746865206f776e6572206f662074686520746f6b656e2e00604482015260640161080e565b610ad281610c2a565b6000818152609960205260408120546001600160a01b0316806106e75760405162461bcd60e51b815260206004820152602960248201527f4552433732313a206f776e657220717565727920666f72206e6f6e657869737460448201526832b73a103a37b5b2b760b91b606482015260840161080e565b60006001600160a01b0382166110695760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b606482015260840161080e565b506001600160a01b03166000908152609a602052604090205490565b6033546001600160a01b031633146110af5760405162461bcd60e51b815260040161080e90613344565b6110b96000612074565b565b60ff805460009116156110e05760405162461bcd60e51b815260040161080e90613379565b6033546001600160a01b03163314806111095750336000908152610102602052604090205460ff165b61116e5760405162461bcd60e51b815260206004820152603060248201527f6c617a794d696e743a3a6f6e6c79206f776e6572206f7220617070726f76656460448201526f081b5a5b9d195c8818d85b881b5a5b9d60821b606482015260840161080e565b6106e78261117b60fc5490565b60fb546001600160a01b03166120c6565b919050565b6033546001600160a01b031633146111bb5760405162461bcd60e51b815260040161080e90613344565b60ff805460ff1916600117905560405133907f793bc6423dd0257d64f9d47db72fd4b2162f4541aa41740ba1c5fb5e2cd41bcd90600090a2565b6033546001600160a01b0316331461121f5760405162461bcd60e51b815260040161080e90613344565b6101075460ff161561127d5760405162461bcd60e51b815260206004820152602160248201527f757064617465426173655552493a3a6d65746164617461206973206c6f636b656044820152601960fa1b606482015260840161080e565b61010661128b8284836133fe565b507f1c306e70c05992619e2128ad1ef88df75f36c9476282e59f51401b2abaa42e4e82826040516112bd9291906134bf565b60405180910390a15050565b6112ef604051806060016040528060008152602001606081526020016000151581525090565b60408051606081019091526101058054825261010680546020840191906113159061330a565b80601f01602080910402602001604051908101604052809291908181526020018280546113419061330a565b801561138e5780601f106113635761010080835404028352916020019161138e565b820191906000526020600020905b81548152906001019060200180831161137157829003601f168201915b50505091835250506002919091015460ff161515602090910152919050565b6060609880546107169061330a565b6113c533610a74565b6113e257604051635c510c8360e11b815260040160405180910390fd5b6109038383838080602002602001604051908101604052809392919081815260200183836020028082843760009201829052509250612182915050565b8160016101095460ff16600281111561143a5761143a613001565b036114705761144f816101086000600161085f565b61146b576040516282b42960e81b815260040160405180910390fd5b6114bc565b60026101095460ff16600281111561148a5761148a613001565b036114bc5761149f816101086000600261085f565b156114bc576040516282b42960e81b815260040160405180910390fd5b610903838361235f565b6033546001600160a01b031633146114f05760405162461bcd60e51b815260040161080e90613344565b60ff805416156115125760405162461bcd60e51b815260040161080e90613379565b61090383838361236a565b6115273383611b70565b6115435760405162461bcd60e51b815260040161080e906134ee565b61154f848484846124df565b50505050565b6033546001600160a01b0316331461157f5760405162461bcd60e51b815260040161080e90613344565b60ff805416156115a15760405162461bcd60e51b815260040161080e90613379565b6115ac84848461236a565b6001600160a01b0316600090815261010260205260409020805460ff19166001179055505050565b6115dd33610a74565b6115fa57604051635c510c8360e11b815260040160405180910390fd5b610108600082600281111561161157611611613001565b600281111561162257611622613001565b8152602081019190915260400160009081209081816116418282612c8d565b50505050336001600160a01b03167f7efc19cf93d497a6a56103ea89a39d51c0cad74a817ed3cd0ecaff9823d4da248260405161167e9190613017565b60405180910390a250565b600081815261010360205260408120805460609291906116a89061330a565b9050111561174f5760008281526101036020526040902080546116ca9061330a565b80601f01602080910402602001604051908101604052809291908181526020018280546116f69061330a565b80156117435780601f1061171857610100808354040283529160200191611743565b820191906000526020600020905b81548152906001019060200180831161172657829003601f168201915b50505050509050919050565b61010661175b83612512565b60405160200161176c9291906135ca565b6040516020818303038152906040529050919050565b6001600160a01b039182166000908152609c6020908152604080832093909416825291909152205460ff1690565b610109546000906106e790839061010890849060ff16600281111561085f5761085f613001565b6033546001600160a01b031633146118015760405162461bcd60e51b815260040161080e90613344565b600090815260fd6020526040902080546001600160a01b0319166001600160a01b0392909216919091179055565b6033546001600160a01b031633146118595760405162461bcd60e51b815260040161080e90613344565b6001600160a01b0381166118be5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b606482015260840161080e565b610ad281612074565b6118d033610a74565b6118ed57604051635c510c8360e11b815260040160405180910390fd5b600083600281111561190157611901613001565b0361191f57604051632de777a160e11b815260040160405180910390fd5b6109038383838080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525060019250612182915050565b6060600061196c83612613565b9392505050565b60006001600160e01b0319821663fa31a45b60e01b14806106e757506106e78261266e565b60006001600160e01b03198216631030681960e21b14806119bd57506119bd8261266e565b806119cc57506119cc82612684565b806106e757506106e7826126a5565b6001600160a01b0381166000908152600183016020526040812054151561196c565b6000611a0882610f88565b9050806001600160a01b0316836001600160a01b031603611a755760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b606482015260840161080e565b336001600160a01b0382161480611a915750611a918133611782565b611b035760405162461bcd60e51b815260206004820152603860248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f74206f7760448201527f6e6572206e6f7220617070726f76656420666f7220616c6c0000000000000000606482015260840161080e565b61090383836126e5565b6000611b1d826301e13380613686565b611b2790426136a5565b61010a54604080519182526020820183905291925033917f6e948191a35d69000746799fef50c705bbdc93bd5a7577e9e9eb879c04bdebc9910160405180910390a261010a5550565b6000818152609960205260408120546001600160a01b0316611be95760405162461bcd60e51b815260206004820152602c60248201527f4552433732313a206f70657261746f7220717565727920666f72206e6f6e657860448201526b34b9ba32b73a103a37b5b2b760a11b606482015260840161080e565b6000611bf483610f88565b9050806001600160a01b0316846001600160a01b03161480611c1b5750611c1b8185611782565b80611c3f5750836001600160a01b0316611c3484610799565b6001600160a01b0316145b949350505050565b826001600160a01b0316611c5a82610f88565b6001600160a01b031614611cbe5760405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b606482015260840161080e565b6001600160a01b038216611d205760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b606482015260840161080e565b611d2b6000826126e5565b6001600160a01b0383166000908152609a60205260408120805460019290611d549084906136bd565b90915550506001600160a01b0382166000908152609a60205260408120805460019290611d829084906136a5565b909155505060008181526099602052604080822080546001600160a01b0319166001600160a01b0386811691821790925591518493918716917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef91a4505050565b600061196c8284613686565b600061196c82846136ea565b60fb80546001600160a01b0319166001600160a01b0392909216919091179055565b6000611e2882610f88565b9050611e356000836126e5565b6001600160a01b0381166000908152609a60205260408120805460019290611e5e9084906136bd565b909155505060008281526099602052604080822080546001600160a01b0319169055518391906001600160a01b038416907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908390a45b5050565b806002811115611ecb57611ecb613001565b6101095460ff166002811115611ee357611ee3613001565b60405133907f12282389323caf08dd4e02c490ef05bc7edb56967c085742687aad3cc81aa15f90600090a4610109805482919060ff19166001836002811115611f2e57611f2e613001565b021790555050565b60008054610100900460ff1615611f7d578160ff166001148015611f595750303b155b611f755760405162461bcd60e51b815260040161080e906136fe565b506000919050565b60005460ff808416911610611fa45760405162461bcd60e51b815260040161080e906136fe565b506000805460ff191660ff92909216919091179055600190565b600054610100900460ff16611fe55760405162461bcd60e51b815260040161080e9061374c565b6110b9612753565b600054610100900460ff166120145760405162461bcd60e51b815260040161080e9061374c565b611eb58282612783565b600054610100900460ff166110b95760405162461bcd60e51b815260040161080e9061374c565b600054610100900460ff1661206c5760405162461bcd60e51b815260040161080e9061374c565b6110b961201e565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60006120d761010480546001019055565b60006120e36101045490565b9050610100548111156121385760405162461bcd60e51b815260206004820181905260248201527f5f637265617465546f6b656e3a3a6578636565646564206d6178546f6b656e73604482015260640161080e565b61214285826127c3565b600081815260fe60205260409020849055600081815260fd6020526040902080546001600160a01b0319166001600160a01b038516179055949350505050565b600083600281111561219657612196613001565b146109035760005b825181101561154f57811561227f5761220e8382815181106121c2576121c2613797565b602002602001015161010860008760028111156121e1576121e1613001565b60028111156121f2576121f2613001565b81526020019081526020016000206127dd90919063ffffffff16565b5083600281111561222157612221613001565b83828151811061223357612233613797565b60200260200101516001600160a01b0316336001600160a01b03167f14155f749dc3f9cd2bf890d6d3a47069f77ae35befcee11c8b1a3ba41cba153660405160405180910390a461234d565b6122e083828151811061229457612294613797565b602002602001015161010860008760028111156122b3576122b3613001565b60028111156122c4576122c4613001565b81526020019081526020016000206127f290919063ffffffff16565b508360028111156122f3576122f3613001565b83828151811061230557612305613797565b60200260200101516001600160a01b0316336001600160a01b03167fc72e29af1b34de3dec3a764b4ca4d85b9c380ab33b9b268d29b6e7008bd0ed9560405160405180910390a45b80612357816137ad565b91505061219e565b611eb5338383612807565b610100548111156123bd5760405162461bcd60e51b815260206004820181905260248201527f5f707265706172654d696e743a3a6578636565646564206d6178546f6b656e73604482015260640161080e565b61010454156124285760405162461bcd60e51b815260206004820152603160248201527f5f707265706172654d696e743a3a63616e206f6e6c792070726570617265206d604482015270696e742077697468203020746f6b656e7360781b606482015260840161080e565b604051806060016040528082815260200184848080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201829052509385525050506020918201528151610105908155908201516101069061249190826137c6565b50604091820151600291909101805460ff19169115159190911790555181907f6f1d651e6e0c8f86bd32a20c22a644d1e34fabf72307ff95d51b9f5892ddba1990610a6790869086906134bf565b6124ea848484611c47565b6124f6848484846128d5565b61154f5760405162461bcd60e51b815260040161080e90613886565b6060816000036125395750506040805180820190915260018152600360fc1b602082015290565b8160005b8115612563578061254d816137ad565b915061255c9050600a836136ea565b915061253d565b60008167ffffffffffffffff81111561257e5761257e613191565b6040519080825280601f01601f1916602001820160405280156125a8576020820181803683370190505b5090505b8415611c3f576125bd6001836136bd565b91506125ca600a866138d8565b6125d59060306136a5565b60f81b8183815181106125ea576125ea613797565b60200101906001600160f81b031916908160001a90535061260c600a866136ea565b94506125ac565b60608160000180548060200260200160405190810160405280929190818152602001828054801561174357602002820191906000526020600020905b81548152602001906001019080831161264f5750505050509050919050565b6001600160e01b0319166301ffc9a760e01b1490565b60006001600160e01b0319821663152a902d60e11b14806106e757506106e7825b60006001600160e01b031982166380ac58cd60e01b14806126d657506001600160e01b03198216635b5e139f60e01b145b806106e757506106e78261266e565b6000818152609b6020526040902080546001600160a01b0319166001600160a01b038416908117909155819061271a82610f88565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b600054610100900460ff1661277a5760405162461bcd60e51b815260040161080e9061374c565b6110b933612074565b600054610100900460ff166127aa5760405162461bcd60e51b815260040161080e9061374c565b60976127b683826137c6565b50609861090382826137c6565b611eb58282604051806020016040528060008152506129d6565b600061196c836001600160a01b038416612a09565b600061196c836001600160a01b038416612a58565b816001600160a01b0316836001600160a01b0316036128685760405162461bcd60e51b815260206004820152601960248201527f4552433732313a20617070726f766520746f2063616c6c657200000000000000604482015260640161080e565b6001600160a01b038381166000818152609c6020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b60006001600160a01b0384163b156129cb57604051630a85bd0160e11b81526001600160a01b0385169063150b7a02906129199033908990889088906004016138ec565b6020604051808303816000875af1925050508015612954575060408051601f3d908101601f1916820190925261295191810190613929565b60015b6129b1573d808015612982576040519150601f19603f3d011682016040523d82523d6000602084013e612987565b606091505b5080516000036129a95760405162461bcd60e51b815260040161080e90613886565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050611c3f565b506001949350505050565b6129e08383612b4b565b6129ed60008484846128d5565b6109035760405162461bcd60e51b815260040161080e90613886565b6000818152600183016020526040812054612a50575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556106e7565b5060006106e7565b60008181526001830160205260408120548015612b41576000612a7c6001836136bd565b8554909150600090612a90906001906136bd565b9050818114612af5576000866000018281548110612ab057612ab0613797565b9060005260206000200154905080876000018481548110612ad357612ad3613797565b6000918252602080832090910192909255918252600188019052604090208390555b8554869080612b0657612b06613946565b6001900381819060005260206000200160009055905585600101600086815260200190815260200160002060009055600193505050506106e7565b60009150506106e7565b6001600160a01b038216612ba15760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f2061646472657373604482015260640161080e565b6000818152609960205260409020546001600160a01b031615612c065760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e74656400000000604482015260640161080e565b6001600160a01b0382166000908152609a60205260408120805460019290612c2f9084906136a5565b909155505060008181526099602052604080822080546001600160a01b0319166001600160a01b03861690811790915590518392907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a45050565b5080546000825590600052602060002090810190610ad291905b80821115612cbb5760008155600101612ca7565b5090565b80356003811061118c57600080fd5b600060208284031215612ce057600080fd5b61196c82612cbf565b6020808252825182820181905260009190848201906040850190845b81811015612d2a5783516001600160a01b031683529284019291840191600101612d05565b50909695505050505050565b6001600160e01b031981168114610ad257600080fd5b600060208284031215612d5e57600080fd5b813561196c81612d36565b60005b83811015612d84578181015183820152602001612d6c565b8381111561154f5750506000910152565b60008151808452612dad816020860160208601612d69565b601f01601f19169290920160200192915050565b60208152600061196c6020830184612d95565b600060208284031215612de657600080fd5b5035919050565b80356001600160a01b038116811461118c57600080fd5b60008060408385031215612e1757600080fd5b612e2083612ded565b946020939093013593505050565b60008060408385031215612e4157600080fd5b612e4a83612ded565b915060208301358015158114612e5f57600080fd5b809150509250929050565b60008083601f840112612e7c57600080fd5b50813567ffffffffffffffff811115612e9457600080fd5b602083019150836020828501011115612eac57600080fd5b9250929050565b600080600060408486031215612ec857600080fd5b83359250602084013567ffffffffffffffff811115612ee657600080fd5b612ef286828701612e6a565b9497909650939450505050565b600060208284031215612f1157600080fd5b61196c82612ded565b600080600060608486031215612f2f57600080fd5b612f3884612ded565b9250612f4660208501612ded565b9150604084013590509250925092565b60008060408385031215612f6957600080fd5b50508035926020909101359150565b60008060008060008060808789031215612f9157600080fd5b863567ffffffffffffffff80821115612fa957600080fd5b612fb58a838b01612e6a565b90985096506020890135915080821115612fce57600080fd5b50612fdb89828a01612e6a565b9095509350612fee905060408801612ded565b9150606087013590509295509295509295565b634e487b7160e01b600052602160045260246000fd5b602081016003831061303957634e487b7160e01b600052602160045260246000fd5b91905290565b6000806020838503121561305257600080fd5b823567ffffffffffffffff81111561306957600080fd5b61307585828601612e6a565b90969095509350505050565b602081528151602082015260006020830151606060408401526130a76080840182612d95565b90506040840151151560608401528091505092915050565b6000806000604084860312156130d457600080fd5b6130dd84612cbf565b9250602084013567ffffffffffffffff808211156130fa57600080fd5b818601915086601f83011261310e57600080fd5b81358181111561311d57600080fd5b8760208260051b850101111561313257600080fd5b6020830194508093505050509250925092565b60008060006040848603121561315a57600080fd5b833567ffffffffffffffff81111561317157600080fd5b61317d86828701612e6a565b909790965060209590950135949350505050565b634e487b7160e01b600052604160045260246000fd5b600080600080608085870312156131bd57600080fd5b6131c685612ded565b93506131d460208601612ded565b925060408501359150606085013567ffffffffffffffff808211156131f857600080fd5b818701915087601f83011261320c57600080fd5b81358181111561321e5761321e613191565b604051601f8201601f19908116603f0116810190838211818310171561324657613246613191565b816040528281528a602084870101111561325f57600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b6000806000806060858703121561329957600080fd5b843567ffffffffffffffff8111156132b057600080fd5b6132bc87828801612e6a565b909550935050602085013591506132d560408601612ded565b905092959194509250565b600080604083850312156132f357600080fd5b6132fc83612ded565b9150610b9960208401612ded565b600181811c9082168061331e57607f821691505b60208210810361333e57634e487b7160e01b600052602260045260246000fd5b50919050565b6020808252818101527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604082015260600190565b6020808252601e908201527f436f6e7472616374206d757374206e6f742062652064697361626c65642e0000604082015260600190565b601f82111561090357600081815260208120601f850160051c810160208610156133d75750805b601f850160051c820191505b818110156133f6578281556001016133e3565b505050505050565b67ffffffffffffffff83111561341657613416613191565b61342a83613424835461330a565b836133b0565b6000601f84116001811461345e57600085156134465750838201355b600019600387901b1c1916600186901b1783556134b8565b600083815260209020601f19861690835b8281101561348f578685013582556020948501946001909201910161346f565b50868210156134ac5760001960f88860031b161c19848701351681555b505060018560011b0183555b5050505050565b60208152816020820152818360408301376000818301604090810191909152601f909201601f19160101919050565b60208082526031908201527f4552433732313a207472616e736665722063616c6c6572206973206e6f74206f6040820152701ddb995c881b9bdc88185c1c1c9bdd9959607a1b606082015260800190565b60006020808352600084546135538161330a565b80848701526040600180841660008114613574576001811461358e576135bc565b60ff1985168984015283151560051b8901830195506135bc565b896000528660002060005b858110156135b45781548b8201860152908301908801613599565b8a0184019650505b509398975050505050505050565b60008084546135d88161330a565b600182811680156135f0576001811461360557613634565b60ff1984168752821515830287019450613634565b8860005260208060002060005b8581101561362b5781548a820152908401908201613612565b50505082870194505b50602f60f81b8452865192506136508382860160208a01612d69565b64173539b7b760d91b939092019182019290925260060195945050505050565b634e487b7160e01b600052601160045260246000fd5b60008160001904831182151516156136a0576136a0613670565b500290565b600082198211156136b8576136b8613670565b500190565b6000828210156136cf576136cf613670565b500390565b634e487b7160e01b600052601260045260246000fd5b6000826136f9576136f96136d4565b500490565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b6000600182016137bf576137bf613670565b5060010190565b815167ffffffffffffffff8111156137e0576137e0613191565b6137f4816137ee845461330a565b846133b0565b602080601f83116001811461382957600084156138115750858301515b600019600386901b1c1916600185901b1785556133f6565b600085815260208120601f198616915b8281101561385857888601518255948401946001909101908401613839565b50858210156138765787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b6000826138e7576138e76136d4565b500690565b6001600160a01b038581168252841660208201526040810183905260806060820181905260009061391f90830184612d95565b9695505050505050565b60006020828403121561393b57600080fd5b815161196c81612d36565b634e487b7160e01b600052603160045260246000fdfea2646970667358221220c56957add7ec3c873454c61a75d3f36270da88804e2d016bdde99de6ebabd10f64736f6c634300080f0033

Deployed Bytecode

0x608060405234801561001057600080fd5b50600436106100a85760003560e01c8063877ebf5111610071578063877ebf511461016a5780638da5cb5b1461017d578063a55b1c251461018e578063c4dca7ab146101a1578063f2fde38b146101b4578063f5e0e6df146101c757600080fd5b8062e8ece6146100ad57806322d60fcb146100e7578063637944f514610112578063715018a614610139578063740adf3114610143575b600080fd5b6100d47f5d53444d40ee2f466d1c91f96d7c4d4b6bcb514ac7911b9a6c947234a2f957c581565b6040519081526020015b60405180910390f35b6002546100fa906001600160a01b031681565b6040516001600160a01b0390911681526020016100de565b6100d47f8eae45f58440dde5634b0645eea1e0aa7e9dfd92d41ded6de63fc6498057dd6881565b6101416101da565b005b6100d47f6c556facba1fb001f8d830adc0dcceae3a683a8890dc3299db292ca0c662517081565b6100fa61017836600461090b565b610219565b6000546001600160a01b03166100fa565b61014161019c366004610996565b610576565b6003546100fa906001600160a01b031681565b6101416101c23660046109c0565b6106e1565b6001546100fa906001600160a01b031681565b6000546001600160a01b0316331461020d5760405162461bcd60e51b8152600401610204906109e2565b60405180910390fd5b610217600061077c565b565b6000826000036102875760405162461bcd60e51b815260206004820152603360248201527f637265617465536f7665726569676e4e4654436f6e74726163743a3a5f6d6178604482015272546f6b656e732063616e74206265207a65726f60681b6064820152608401610204565b60007f8eae45f58440dde5634b0645eea1e0aa7e9dfd92d41ded6de63fc6498057dd68830361032d576001546102c5906001600160a01b03166107cc565b604051635edc7c1960e01b81529091506001600160a01b03821690635edc7c19906102fa908990899033908a90600401610a64565b600060405180830381600087803b15801561031457600080fd5b505af1158015610328573d6000803e3d6000fd5b505050505b7f5d53444d40ee2f466d1c91f96d7c4d4b6bcb514ac7911b9a6c947234a2f957c583036103d157600254610369906001600160a01b03166107cc565b604051635edc7c1960e01b81529091506001600160a01b03821690635edc7c199061039e908990899033908a90600401610a64565b600060405180830381600087803b1580156103b857600080fd5b505af11580156103cc573d6000803e3d6000fd5b505050505b7f6c556facba1fb001f8d830adc0dcceae3a683a8890dc3299db292ca0c662517083036104755760035461040d906001600160a01b03166107cc565b604051635edc7c1960e01b81529091506001600160a01b03821690635edc7c1990610442908990899033908a90600401610a64565b600060405180830381600087803b15801561045c57600080fd5b505af1158015610470573d6000803e3d6000fd5b505050505b6001600160a01b0381166104ff5760405162461bcd60e51b8152602060048201526044602482018190527f637265617465536f7665726569676e4e4654436f6e74726163743a3a5f636f6e908201527f74726163745479706520756e737570706f7274656420636f6e747261637420746064820152633cb8329760e11b608482015260a401610204565b60405133906001600160a01b038316907f46dd19b0bfeba14ab8b9e9c9e4179a2f8a3ba70420a845ea8da585dd8e59eeec90600090a3604051839033906001600160a01b038416907feec8a411955d10f84b6b0e3110b206d0888593b71381b8ca931e8f131f7eb36590600090a495945050505050565b6000546001600160a01b031633146105a05760405162461bcd60e51b8152600401610204906109e2565b6001600160a01b0382166105b357600080fd5b7f8eae45f58440dde5634b0645eea1e0aa7e9dfd92d41ded6de63fc6498057dd6881036105f957600180546001600160a01b0319166001600160a01b0384161790555050565b7f5d53444d40ee2f466d1c91f96d7c4d4b6bcb514ac7911b9a6c947234a2f957c5810361063f57600280546001600160a01b0319166001600160a01b0384161790555050565b7f6c556facba1fb001f8d830adc0dcceae3a683a8890dc3299db292ca0c6625170810361068557600380546001600160a01b0319166001600160a01b0384161790555050565b60405162461bcd60e51b815260206004820152602b60248201527f736574536f7665726569676e4e46543a3a556e737570706f72746564205f636f60448201526a373a3930b1ba2a3cb8329760a91b6064820152608401610204565b6000546001600160a01b0316331461070b5760405162461bcd60e51b8152600401610204906109e2565b6001600160a01b0381166107705760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610204565b6107798161077c565b50565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b600060405172602d8060093d393df3363d3d373d3d3d363d7360681b81528260601b60138201526e5af43d82803e903d91602b57fd5bf360881b60278201526036816000f09150506001600160a01b0381166108635760405162461bcd60e51b8152602060048201526016602482015275115490cc4c4d8dce8818dc99585d194819985a5b195960521b6044820152606401610204565b919050565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261088f57600080fd5b813567ffffffffffffffff808211156108aa576108aa610868565b604051601f8301601f19908116603f011681019082821181831017156108d2576108d2610868565b816040528381528660208588010111156108eb57600080fd5b836020870160208301376000602085830101528094505050505092915050565b6000806000806080858703121561092157600080fd5b843567ffffffffffffffff8082111561093957600080fd5b6109458883890161087e565b9550602087013591508082111561095b57600080fd5b506109688782880161087e565b949794965050505060408301359260600135919050565b80356001600160a01b038116811461086357600080fd5b600080604083850312156109a957600080fd5b6109b28361097f565b946020939093013593505050565b6000602082840312156109d257600080fd5b6109db8261097f565b9392505050565b6020808252818101527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604082015260600190565b6000815180845260005b81811015610a3d57602081850181015186830182015201610a21565b81811115610a4f576000602083870101525b50601f01601f19169290920160200192915050565b608081526000610a776080830187610a17565b8281036020840152610a898187610a17565b6001600160a01b039590951660408401525050606001529291505056fea264697066735822122074d3532c94662a16b4982bdabc1fa6d7f8983e80a84dd7dd93a61fdba6fea23164736f6c634300080f0033

Block Transaction Difficulty Gas Used Reward
View All Blocks Produced

Block Uncle Number Difficulty Gas Used Reward
View All Uncles
Loading...
Loading
Loading...
Loading

Validator Index Block Amount
View All Withdrawals

Transaction Hash Block Value Eth2 PubKey Valid
View All Deposits
Loading...
Loading
[ Download: CSV Export  ]
[ Download: CSV Export  ]

A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.