Token

Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

// SPDX-License-Identifier: MIT

pragma solidity >=0.8.19 <0.9.0;

import {ERC1155} from "@openzeppelin/contracts/token/ERC1155/ERC1155.sol";
import {Pausable} from "@openzeppelin/contracts/utils/Pausable.sol";
import {Ownable} from "@openzeppelin/contracts/access/Ownable.sol";
import {MerkleProof} from "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol";
import {ReentrancyGuard} from "@openzeppelin/contracts/utils/ReentrancyGuard.sol";

error MaxSupplyReached();
error InsufficientFunds();

contract FoundationBook is ERC1155, Ownable, ReentrancyGuard, Pausable {
    string public name = "Foundation for Art and Blockchain - Monograph";
    address public adminAddress = 0x6b4583E2CF92b973eB0ed0C01aecd0F0f242cC41;

    //Contract Variables Definition and Initialization
    uint256 public cost = 0;
    uint256 public maxSupply = 2000;
    uint256 public totalSupply = 0;
    bytes32 public merkleRoot;
    bool public allowlistMintEnabled = false;

    mapping(address => bool) public allowlistClaimed;

    //Royalty Information
    address public defaultRoyaltyReceiver = 0xaC0762C5B7500a9C60cCE8BDFB4036c0152E5a1b; //Artist address
    mapping(uint256 => address) royaltyReceivers;
    uint256 public defaultRoyaltyPercentage = 500; // BPS
    mapping(uint256 => uint256) royaltyPercentages;

    constructor() ERC1155("") Ownable(msg.sender) {
        _pause();
    }

    modifier requireAdminOrOwner() {
        require(adminAddress == msg.sender || owner() == msg.sender, "Requires admin or owner privileges");
        _;
    }

    function unpause() external requireAdminOrOwner {
        _unpause();
    }

    function pause() external requireAdminOrOwner {
        _pause();
    }

    function setCost(uint256 _cost) public requireAdminOrOwner {
        cost = _cost;
    }

    function setAdminAddress(address _adminAddress) public requireAdminOrOwner {
        adminAddress = _adminAddress;
    }

    function removeAdmin() public requireAdminOrOwner {
        adminAddress = address(0);
    }

    function setMerkleRoot(bytes32 _merkleRoot) public requireAdminOrOwner {
        merkleRoot = _merkleRoot;
    }

    function setAllowlistMintEnabled(bool _state) public requireAdminOrOwner {
        allowlistMintEnabled = _state;
    }

    function setURI(string memory newuri) public requireAdminOrOwner {
        _setURI(newuri);
    }

    function mintForAddress(address _receiver) public requireAdminOrOwner {
        //Verify Contract Requirements
        if (totalSupply >= maxSupply) revert MaxSupplyReached();

        _mint(_receiver, 0, 1, "");
        totalSupply++;
    }

    function allowlistMint(bytes32[] calldata _merkleProof) public payable nonReentrant {
        //Verify Contract Requirements
        if (totalSupply >= maxSupply) revert MaxSupplyReached();
        if (msg.value < cost) revert InsufficientFunds();
        // Verify allowlist requirements
        require(allowlistMintEnabled, "The allowlist sale is not enabled!");
        require(!allowlistClaimed[_msgSender()], "Address already claimed!");
        bytes32 leaf = keccak256(abi.encodePacked(_msgSender()));
        require(MerkleProof.verify(_merkleProof, merkleRoot, leaf), "Invalid proof!");

        allowlistClaimed[_msgSender()] = true;
        _mint(msg.sender, 0, 1, "");
        totalSupply++;
    }

    function mint() public payable whenNotPaused(){
        //Verify Contract Requirements
        if (totalSupply >= maxSupply) revert MaxSupplyReached();
        if (msg.value < cost) revert InsufficientFunds();
        _mint(msg.sender, 0, 1, "");
        totalSupply++;
    }

    function withdraw() public requireAdminOrOwner nonReentrant {
        (bool os,) = payable(owner()).call{value: address(this).balance}("");
        require(os);
    }

    function _update(address from, address to, uint256[] memory ids, uint256[] memory values)
        internal
        override(ERC1155)
    {
        super._update(from, to, ids, values);
    }

    /*//////////////////////////////////////////////////////////////////////////
                        ERC2981 Functions START
    //////////////////////////////////////////////////////////////////////////*/

    function royaltyInfo(uint256 _tokenId, uint256 _salePrice)
        public
        view
        virtual
        returns (address receiver, uint256 royaltyAmount)
    {
        receiver = royaltyReceivers[_tokenId] != address(0) ? royaltyReceivers[_tokenId] : defaultRoyaltyReceiver;
        royaltyAmount = royaltyPercentages[_tokenId] != 0
            ? (_salePrice * royaltyPercentages[_tokenId]) / 10000
            : (_salePrice * defaultRoyaltyPercentage) / 10000;
    }

    function setDefaultRoyaltyReceiver(address _receiver) external requireAdminOrOwner {
        defaultRoyaltyReceiver = _receiver;
    }

    function setRoyaltyReceiver(uint256 _tokenId, address _newReceiver) external requireAdminOrOwner {
        royaltyReceivers[_tokenId] = _newReceiver;
    }

    function setRoyaltyPercentage(uint256 _tokenId, uint256 _percentage) external requireAdminOrOwner {
        royaltyPercentages[_tokenId] = _percentage;
    }

    /*//////////////////////////////////////////////////////////////////////////
                        ERC2981 Functions END
    //////////////////////////////////////////////////////////////////////////*/
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/ReentrancyGuard.sol)

pragma solidity ^0.8.20;

/**
 * @dev Contract module that helps prevent reentrant calls to a function.
 *
 * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
 * available, which can be applied to functions to make sure there are no nested
 * (reentrant) calls to them.
 *
 * Note that because there is a single `nonReentrant` guard, functions marked as
 * `nonReentrant` may not call one another. This can be worked around by making
 * those functions `private`, and then adding `external` `nonReentrant` entry
 * points to them.
 *
 * TIP: If you would like to learn more about reentrancy and alternative ways
 * to protect against it, check out our blog post
 * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
 */
abstract contract ReentrancyGuard {
    // Booleans are more expensive than uint256 or any type that takes up a full
    // word because each write operation emits an extra SLOAD to first read the
    // slot's contents, replace the bits taken up by the boolean, and then write
    // back. This is the compiler's defense against contract upgrades and
    // pointer aliasing, and it cannot be disabled.

    // The values being non-zero value makes deployment a bit more expensive,
    // but in exchange the refund on every call to nonReentrant will be lower in
    // amount. Since refunds are capped to a percentage of the total
    // transaction's gas, it is best to keep them low in cases like this one, to
    // increase the likelihood of the full refund coming into effect.
    uint256 private constant NOT_ENTERED = 1;
    uint256 private constant ENTERED = 2;

    uint256 private _status;

    /**
     * @dev Unauthorized reentrant call.
     */
    error ReentrancyGuardReentrantCall();

    constructor() {
        _status = NOT_ENTERED;
    }

    /**
     * @dev Prevents a contract from calling itself, directly or indirectly.
     * Calling a `nonReentrant` function from another `nonReentrant`
     * function is not supported. It is possible to prevent this from happening
     * by making the `nonReentrant` function external, and making it call a
     * `private` function that does the actual work.
     */
    modifier nonReentrant() {
        _nonReentrantBefore();
        _;
        _nonReentrantAfter();
    }

    function _nonReentrantBefore() private {
        // On the first call to nonReentrant, _status will be NOT_ENTERED
        if (_status == ENTERED) {
            revert ReentrancyGuardReentrantCall();
        }

        // Any calls to nonReentrant after this point will fail
        _status = ENTERED;
    }

    function _nonReentrantAfter() private {
        // By storing the original value once again, a refund is triggered (see
        // https://eips.ethereum.org/EIPS/eip-2200)
        _status = NOT_ENTERED;
    }

    /**
     * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
     * `nonReentrant` function in the call stack.
     */
    function _reentrancyGuardEntered() internal view returns (bool) {
        return _status == ENTERED;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/cryptography/MerkleProof.sol)

pragma solidity ^0.8.20;

/**
 * @dev These functions deal with verification of Merkle Tree proofs.
 *
 * The tree and the proofs can be generated using our
 * https://github.com/OpenZeppelin/merkle-tree[JavaScript library].
 * You will find a quickstart guide in the readme.
 *
 * WARNING: You should avoid using leaf values that are 64 bytes long prior to
 * hashing, or use a hash function other than keccak256 for hashing leaves.
 * This is because the concatenation of a sorted pair of internal nodes in
 * the Merkle tree could be reinterpreted as a leaf value.
 * OpenZeppelin's JavaScript library generates Merkle trees that are safe
 * against this attack out of the box.
 */
library MerkleProof {
    /**
     *@dev The multiproof provided is not valid.
     */
    error MerkleProofInvalidMultiproof();

    /**
     * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
     * defined by `root`. For this, a `proof` must be provided, containing
     * sibling hashes on the branch from the leaf to the root of the tree. Each
     * pair of leaves and each pair of pre-images are assumed to be sorted.
     */
    function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
        return processProof(proof, leaf) == root;
    }

    /**
     * @dev Calldata version of {verify}
     */
    function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
        return processProofCalldata(proof, leaf) == root;
    }

    /**
     * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
     * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
     * hash matches the root of the tree. When processing the proof, the pairs
     * of leafs & pre-images are assumed to be sorted.
     */
    function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {
        bytes32 computedHash = leaf;
        for (uint256 i = 0; i < proof.length; i++) {
            computedHash = _hashPair(computedHash, proof[i]);
        }
        return computedHash;
    }

    /**
     * @dev Calldata version of {processProof}
     */
    function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) {
        bytes32 computedHash = leaf;
        for (uint256 i = 0; i < proof.length; i++) {
            computedHash = _hashPair(computedHash, proof[i]);
        }
        return computedHash;
    }

    /**
     * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a Merkle tree defined by
     * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
     *
     * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
     */
    function multiProofVerify(
        bytes32[] memory proof,
        bool[] memory proofFlags,
        bytes32 root,
        bytes32[] memory leaves
    ) internal pure returns (bool) {
        return processMultiProof(proof, proofFlags, leaves) == root;
    }

    /**
     * @dev Calldata version of {multiProofVerify}
     *
     * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
     */
    function multiProofVerifyCalldata(
        bytes32[] calldata proof,
        bool[] calldata proofFlags,
        bytes32 root,
        bytes32[] memory leaves
    ) internal pure returns (bool) {
        return processMultiProofCalldata(proof, proofFlags, leaves) == root;
    }

    /**
     * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
     * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
     * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
     * respectively.
     *
     * CAUTION: Not all Merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
     * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
     * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
     */
    function processMultiProof(
        bytes32[] memory proof,
        bool[] memory proofFlags,
        bytes32[] memory leaves
    ) internal pure returns (bytes32 merkleRoot) {
        // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
        // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
        // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
        // the Merkle tree.
        uint256 leavesLen = leaves.length;
        uint256 proofLen = proof.length;
        uint256 totalHashes = proofFlags.length;

        // Check proof validity.
        if (leavesLen + proofLen != totalHashes + 1) {
            revert MerkleProofInvalidMultiproof();
        }

        // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
        // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
        bytes32[] memory hashes = new bytes32[](totalHashes);
        uint256 leafPos = 0;
        uint256 hashPos = 0;
        uint256 proofPos = 0;
        // At each step, we compute the next hash using two values:
        // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
        //   get the next hash.
        // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
        //   `proof` array.
        for (uint256 i = 0; i < totalHashes; i++) {
            bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
            bytes32 b = proofFlags[i]
                ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
                : proof[proofPos++];
            hashes[i] = _hashPair(a, b);
        }

        if (totalHashes > 0) {
            if (proofPos != proofLen) {
                revert MerkleProofInvalidMultiproof();
            }
            unchecked {
                return hashes[totalHashes - 1];
            }
        } else if (leavesLen > 0) {
            return leaves[0];
        } else {
            return proof[0];
        }
    }

    /**
     * @dev Calldata version of {processMultiProof}.
     *
     * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
     */
    function processMultiProofCalldata(
        bytes32[] calldata proof,
        bool[] calldata proofFlags,
        bytes32[] memory leaves
    ) internal pure returns (bytes32 merkleRoot) {
        // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
        // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
        // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
        // the Merkle tree.
        uint256 leavesLen = leaves.length;
        uint256 proofLen = proof.length;
        uint256 totalHashes = proofFlags.length;

        // Check proof validity.
        if (leavesLen + proofLen != totalHashes + 1) {
            revert MerkleProofInvalidMultiproof();
        }

        // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
        // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
        bytes32[] memory hashes = new bytes32[](totalHashes);
        uint256 leafPos = 0;
        uint256 hashPos = 0;
        uint256 proofPos = 0;
        // At each step, we compute the next hash using two values:
        // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
        //   get the next hash.
        // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
        //   `proof` array.
        for (uint256 i = 0; i < totalHashes; i++) {
            bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
            bytes32 b = proofFlags[i]
                ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
                : proof[proofPos++];
            hashes[i] = _hashPair(a, b);
        }

        if (totalHashes > 0) {
            if (proofPos != proofLen) {
                revert MerkleProofInvalidMultiproof();
            }
            unchecked {
                return hashes[totalHashes - 1];
            }
        } else if (leavesLen > 0) {
            return leaves[0];
        } else {
            return proof[0];
        }
    }

    /**
     * @dev Sorts the pair (a, b) and hashes the result.
     */
    function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) {
        return a < b ? _efficientHash(a, b) : _efficientHash(b, a);
    }

    /**
     * @dev Implementation of keccak256(abi.encode(a, b)) that doesn't allocate or expand memory.
     */
    function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, a)
            mstore(0x20, b)
            value := keccak256(0x00, 0x40)
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)

pragma solidity ^0.8.20;

import {Context} from "../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.
 *
 * The initial owner is set to the address provided by the deployer. 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;

    /**
     * @dev The caller account is not authorized to perform an operation.
     */
    error OwnableUnauthorizedAccount(address account);

    /**
     * @dev The owner is not a valid owner account. (eg. `address(0)`)
     */
    error OwnableInvalidOwner(address owner);

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

    /**
     * @dev Initializes the contract setting the address provided by the deployer as the initial owner.
     */
    constructor(address initialOwner) {
        if (initialOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(initialOwner);
    }

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        _checkOwner();
        _;
    }

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

    /**
     * @dev Throws if the sender is not the owner.
     */
    function _checkOwner() internal view virtual {
        if (owner() != _msgSender()) {
            revert OwnableUnauthorizedAccount(_msgSender());
        }
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby disabling 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 {
        if (newOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(newOwner);
    }

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/Pausable.sol)

pragma solidity ^0.8.20;

import {Context} from "../utils/Context.sol";

/**
 * @dev Contract module which allows children to implement an emergency stop
 * mechanism that can be triggered by an authorized account.
 *
 * This module is used through inheritance. It will make available the
 * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
 * the functions of your contract. Note that they will not be pausable by
 * simply including this module, only once the modifiers are put in place.
 */
abstract contract Pausable is Context {
    bool private _paused;

    /**
     * @dev Emitted when the pause is triggered by `account`.
     */
    event Paused(address account);

    /**
     * @dev Emitted when the pause is lifted by `account`.
     */
    event Unpaused(address account);

    /**
     * @dev The operation failed because the contract is paused.
     */
    error EnforcedPause();

    /**
     * @dev The operation failed because the contract is not paused.
     */
    error ExpectedPause();

    /**
     * @dev Initializes the contract in unpaused state.
     */
    constructor() {
        _paused = false;
    }

    /**
     * @dev Modifier to make a function callable only when the contract is not paused.
     *
     * Requirements:
     *
     * - The contract must not be paused.
     */
    modifier whenNotPaused() {
        _requireNotPaused();
        _;
    }

    /**
     * @dev Modifier to make a function callable only when the contract is paused.
     *
     * Requirements:
     *
     * - The contract must be paused.
     */
    modifier whenPaused() {
        _requirePaused();
        _;
    }

    /**
     * @dev Returns true if the contract is paused, and false otherwise.
     */
    function paused() public view virtual returns (bool) {
        return _paused;
    }

    /**
     * @dev Throws if the contract is paused.
     */
    function _requireNotPaused() internal view virtual {
        if (paused()) {
            revert EnforcedPause();
        }
    }

    /**
     * @dev Throws if the contract is not paused.
     */
    function _requirePaused() internal view virtual {
        if (!paused()) {
            revert ExpectedPause();
        }
    }

    /**
     * @dev Triggers stopped state.
     *
     * Requirements:
     *
     * - The contract must not be paused.
     */
    function _pause() internal virtual whenNotPaused {
        _paused = true;
        emit Paused(_msgSender());
    }

    /**
     * @dev Returns to normal state.
     *
     * Requirements:
     *
     * - The contract must be paused.
     */
    function _unpause() internal virtual whenPaused {
        _paused = false;
        emit Unpaused(_msgSender());
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/ERC1155.sol)

pragma solidity ^0.8.20;

import {IERC1155} from "./IERC1155.sol";
import {IERC1155Receiver} from "./IERC1155Receiver.sol";
import {IERC1155MetadataURI} from "./extensions/IERC1155MetadataURI.sol";
import {Context} from "../../utils/Context.sol";
import {IERC165, ERC165} from "../../utils/introspection/ERC165.sol";
import {Arrays} from "../../utils/Arrays.sol";
import {IERC1155Errors} from "../../interfaces/draft-IERC6093.sol";

/**
 * @dev Implementation of the basic standard multi-token.
 * See https://eips.ethereum.org/EIPS/eip-1155
 * Originally based on code by Enjin: https://github.com/enjin/erc-1155
 */
abstract contract ERC1155 is Context, ERC165, IERC1155, IERC1155MetadataURI, IERC1155Errors {
    using Arrays for uint256[];
    using Arrays for address[];

    mapping(uint256 id => mapping(address account => uint256)) private _balances;

    mapping(address account => mapping(address operator => bool)) private _operatorApprovals;

    // Used as the URI for all token types by relying on ID substitution, e.g. https://token-cdn-domain/{id}.json
    string private _uri;

    /**
     * @dev See {_setURI}.
     */
    constructor(string memory uri_) {
        _setURI(uri_);
    }

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

    /**
     * @dev See {IERC1155MetadataURI-uri}.
     *
     * This implementation returns the same URI for *all* token types. It relies
     * on the token type ID substitution mechanism
     * https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP].
     *
     * Clients calling this function must replace the `\{id\}` substring with the
     * actual token type ID.
     */
    function uri(uint256 /* id */) public view virtual returns (string memory) {
        return _uri;
    }

    /**
     * @dev See {IERC1155-balanceOf}.
     */
    function balanceOf(address account, uint256 id) public view virtual returns (uint256) {
        return _balances[id][account];
    }

    /**
     * @dev See {IERC1155-balanceOfBatch}.
     *
     * Requirements:
     *
     * - `accounts` and `ids` must have the same length.
     */
    function balanceOfBatch(
        address[] memory accounts,
        uint256[] memory ids
    ) public view virtual returns (uint256[] memory) {
        if (accounts.length != ids.length) {
            revert ERC1155InvalidArrayLength(ids.length, accounts.length);
        }

        uint256[] memory batchBalances = new uint256[](accounts.length);

        for (uint256 i = 0; i < accounts.length; ++i) {
            batchBalances[i] = balanceOf(accounts.unsafeMemoryAccess(i), ids.unsafeMemoryAccess(i));
        }

        return batchBalances;
    }

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

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

    /**
     * @dev See {IERC1155-safeTransferFrom}.
     */
    function safeTransferFrom(address from, address to, uint256 id, uint256 value, bytes memory data) public virtual {
        address sender = _msgSender();
        if (from != sender && !isApprovedForAll(from, sender)) {
            revert ERC1155MissingApprovalForAll(sender, from);
        }
        _safeTransferFrom(from, to, id, value, data);
    }

    /**
     * @dev See {IERC1155-safeBatchTransferFrom}.
     */
    function safeBatchTransferFrom(
        address from,
        address to,
        uint256[] memory ids,
        uint256[] memory values,
        bytes memory data
    ) public virtual {
        address sender = _msgSender();
        if (from != sender && !isApprovedForAll(from, sender)) {
            revert ERC1155MissingApprovalForAll(sender, from);
        }
        _safeBatchTransferFrom(from, to, ids, values, data);
    }

    /**
     * @dev Transfers a `value` amount of tokens of type `id` from `from` to `to`. Will mint (or burn) if `from`
     * (or `to`) is the zero address.
     *
     * Emits a {TransferSingle} event if the arrays contain one element, and {TransferBatch} otherwise.
     *
     * Requirements:
     *
     * - If `to` refers to a smart contract, it must implement either {IERC1155Receiver-onERC1155Received}
     *   or {IERC1155Receiver-onERC1155BatchReceived} and return the acceptance magic value.
     * - `ids` and `values` must have the same length.
     *
     * NOTE: The ERC-1155 acceptance check is not performed in this function. See {_updateWithAcceptanceCheck} instead.
     */
    function _update(address from, address to, uint256[] memory ids, uint256[] memory values) internal virtual {
        if (ids.length != values.length) {
            revert ERC1155InvalidArrayLength(ids.length, values.length);
        }

        address operator = _msgSender();

        for (uint256 i = 0; i < ids.length; ++i) {
            uint256 id = ids.unsafeMemoryAccess(i);
            uint256 value = values.unsafeMemoryAccess(i);

            if (from != address(0)) {
                uint256 fromBalance = _balances[id][from];
                if (fromBalance < value) {
                    revert ERC1155InsufficientBalance(from, fromBalance, value, id);
                }
                unchecked {
                    // Overflow not possible: value <= fromBalance
                    _balances[id][from] = fromBalance - value;
                }
            }

            if (to != address(0)) {
                _balances[id][to] += value;
            }
        }

        if (ids.length == 1) {
            uint256 id = ids.unsafeMemoryAccess(0);
            uint256 value = values.unsafeMemoryAccess(0);
            emit TransferSingle(operator, from, to, id, value);
        } else {
            emit TransferBatch(operator, from, to, ids, values);
        }
    }

    /**
     * @dev Version of {_update} that performs the token acceptance check by calling
     * {IERC1155Receiver-onERC1155Received} or {IERC1155Receiver-onERC1155BatchReceived} on the receiver address if it
     * contains code (eg. is a smart contract at the moment of execution).
     *
     * IMPORTANT: Overriding this function is discouraged because it poses a reentrancy risk from the receiver. So any
     * update to the contract state after this function would break the check-effect-interaction pattern. Consider
     * overriding {_update} instead.
     */
    function _updateWithAcceptanceCheck(
        address from,
        address to,
        uint256[] memory ids,
        uint256[] memory values,
        bytes memory data
    ) internal virtual {
        _update(from, to, ids, values);
        if (to != address(0)) {
            address operator = _msgSender();
            if (ids.length == 1) {
                uint256 id = ids.unsafeMemoryAccess(0);
                uint256 value = values.unsafeMemoryAccess(0);
                _doSafeTransferAcceptanceCheck(operator, from, to, id, value, data);
            } else {
                _doSafeBatchTransferAcceptanceCheck(operator, from, to, ids, values, data);
            }
        }
    }

    /**
     * @dev Transfers a `value` tokens of token type `id` from `from` to `to`.
     *
     * Emits a {TransferSingle} event.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - `from` must have a balance of tokens of type `id` of at least `value` amount.
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
     * acceptance magic value.
     */
    function _safeTransferFrom(address from, address to, uint256 id, uint256 value, bytes memory data) internal {
        if (to == address(0)) {
            revert ERC1155InvalidReceiver(address(0));
        }
        if (from == address(0)) {
            revert ERC1155InvalidSender(address(0));
        }
        (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value);
        _updateWithAcceptanceCheck(from, to, ids, values, data);
    }

    /**
     * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_safeTransferFrom}.
     *
     * Emits a {TransferBatch} event.
     *
     * Requirements:
     *
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
     * acceptance magic value.
     * - `ids` and `values` must have the same length.
     */
    function _safeBatchTransferFrom(
        address from,
        address to,
        uint256[] memory ids,
        uint256[] memory values,
        bytes memory data
    ) internal {
        if (to == address(0)) {
            revert ERC1155InvalidReceiver(address(0));
        }
        if (from == address(0)) {
            revert ERC1155InvalidSender(address(0));
        }
        _updateWithAcceptanceCheck(from, to, ids, values, data);
    }

    /**
     * @dev Sets a new URI for all token types, by relying on the token type ID
     * substitution mechanism
     * https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP].
     *
     * By this mechanism, any occurrence of the `\{id\}` substring in either the
     * URI or any of the values in the JSON file at said URI will be replaced by
     * clients with the token type ID.
     *
     * For example, the `https://token-cdn-domain/\{id\}.json` URI would be
     * interpreted by clients as
     * `https://token-cdn-domain/000000000000000000000000000000000000000000000000000000000004cce0.json`
     * for token type ID 0x4cce0.
     *
     * See {uri}.
     *
     * Because these URIs cannot be meaningfully represented by the {URI} event,
     * this function emits no events.
     */
    function _setURI(string memory newuri) internal virtual {
        _uri = newuri;
    }

    /**
     * @dev Creates a `value` amount of tokens of type `id`, and assigns them to `to`.
     *
     * Emits a {TransferSingle} event.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
     * acceptance magic value.
     */
    function _mint(address to, uint256 id, uint256 value, bytes memory data) internal {
        if (to == address(0)) {
            revert ERC1155InvalidReceiver(address(0));
        }
        (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value);
        _updateWithAcceptanceCheck(address(0), to, ids, values, data);
    }

    /**
     * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_mint}.
     *
     * Emits a {TransferBatch} event.
     *
     * Requirements:
     *
     * - `ids` and `values` must have the same length.
     * - `to` cannot be the zero address.
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
     * acceptance magic value.
     */
    function _mintBatch(address to, uint256[] memory ids, uint256[] memory values, bytes memory data) internal {
        if (to == address(0)) {
            revert ERC1155InvalidReceiver(address(0));
        }
        _updateWithAcceptanceCheck(address(0), to, ids, values, data);
    }

    /**
     * @dev Destroys a `value` amount of tokens of type `id` from `from`
     *
     * Emits a {TransferSingle} event.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `from` must have at least `value` amount of tokens of type `id`.
     */
    function _burn(address from, uint256 id, uint256 value) internal {
        if (from == address(0)) {
            revert ERC1155InvalidSender(address(0));
        }
        (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value);
        _updateWithAcceptanceCheck(from, address(0), ids, values, "");
    }

    /**
     * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_burn}.
     *
     * Emits a {TransferBatch} event.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `from` must have at least `value` amount of tokens of type `id`.
     * - `ids` and `values` must have the same length.
     */
    function _burnBatch(address from, uint256[] memory ids, uint256[] memory values) internal {
        if (from == address(0)) {
            revert ERC1155InvalidSender(address(0));
        }
        _updateWithAcceptanceCheck(from, address(0), ids, values, "");
    }

    /**
     * @dev Approve `operator` to operate on all of `owner` tokens
     *
     * Emits an {ApprovalForAll} event.
     *
     * Requirements:
     *
     * - `operator` cannot be the zero address.
     */
    function _setApprovalForAll(address owner, address operator, bool approved) internal virtual {
        if (operator == address(0)) {
            revert ERC1155InvalidOperator(address(0));
        }
        _operatorApprovals[owner][operator] = approved;
        emit ApprovalForAll(owner, operator, approved);
    }

    /**
     * @dev Performs an acceptance check by calling {IERC1155-onERC1155Received} on the `to` address
     * if it contains code at the moment of execution.
     */
    function _doSafeTransferAcceptanceCheck(
        address operator,
        address from,
        address to,
        uint256 id,
        uint256 value,
        bytes memory data
    ) private {
        if (to.code.length > 0) {
            try IERC1155Receiver(to).onERC1155Received(operator, from, id, value, data) returns (bytes4 response) {
                if (response != IERC1155Receiver.onERC1155Received.selector) {
                    // Tokens rejected
                    revert ERC1155InvalidReceiver(to);
                }
            } catch (bytes memory reason) {
                if (reason.length == 0) {
                    // non-ERC1155Receiver implementer
                    revert ERC1155InvalidReceiver(to);
                } else {
                    /// @solidity memory-safe-assembly
                    assembly {
                        revert(add(32, reason), mload(reason))
                    }
                }
            }
        }
    }

    /**
     * @dev Performs a batch acceptance check by calling {IERC1155-onERC1155BatchReceived} on the `to` address
     * if it contains code at the moment of execution.
     */
    function _doSafeBatchTransferAcceptanceCheck(
        address operator,
        address from,
        address to,
        uint256[] memory ids,
        uint256[] memory values,
        bytes memory data
    ) private {
        if (to.code.length > 0) {
            try IERC1155Receiver(to).onERC1155BatchReceived(operator, from, ids, values, data) returns (
                bytes4 response
            ) {
                if (response != IERC1155Receiver.onERC1155BatchReceived.selector) {
                    // Tokens rejected
                    revert ERC1155InvalidReceiver(to);
                }
            } catch (bytes memory reason) {
                if (reason.length == 0) {
                    // non-ERC1155Receiver implementer
                    revert ERC1155InvalidReceiver(to);
                } else {
                    /// @solidity memory-safe-assembly
                    assembly {
                        revert(add(32, reason), mload(reason))
                    }
                }
            }
        }
    }

    /**
     * @dev Creates an array in memory with only one value for each of the elements provided.
     */
    function _asSingletonArrays(
        uint256 element1,
        uint256 element2
    ) private pure returns (uint256[] memory array1, uint256[] memory array2) {
        /// @solidity memory-safe-assembly
        assembly {
            // Load the free memory pointer
            array1 := mload(0x40)
            // Set array length to 1
            mstore(array1, 1)
            // Store the single element at the next word after the length (where content starts)
            mstore(add(array1, 0x20), element1)

            // Repeat for next array locating it right after the first array
            array2 := add(array1, 0x40)
            mstore(array2, 1)
            mstore(add(array2, 0x20), element2)

            // Update the free memory pointer by pointing after the second array
            mstore(0x40, add(array2, 0x40))
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)

pragma solidity ^0.8.20;

/**
 * @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;
    }

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol)
pragma solidity ^0.8.20;

/**
 * @dev Standard ERC20 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens.
 */
interface IERC20Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC20InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC20InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     * @param allowance Amount of tokens a `spender` is allowed to operate with.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC20InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `spender` to be approved. Used in approvals.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC20InvalidSpender(address spender);
}

/**
 * @dev Standard ERC721 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens.
 */
interface IERC721Errors {
    /**
     * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20.
     * Used in balance queries.
     * @param owner Address of the current owner of a token.
     */
    error ERC721InvalidOwner(address owner);

    /**
     * @dev Indicates a `tokenId` whose `owner` is the zero address.
     * @param tokenId Identifier number of a token.
     */
    error ERC721NonexistentToken(uint256 tokenId);

    /**
     * @dev Indicates an error related to the ownership over a particular token. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param tokenId Identifier number of a token.
     * @param owner Address of the current owner of a token.
     */
    error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC721InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC721InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param tokenId Identifier number of a token.
     */
    error ERC721InsufficientApproval(address operator, uint256 tokenId);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC721InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC721InvalidOperator(address operator);
}

/**
 * @dev Standard ERC1155 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens.
 */
interface IERC1155Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     * @param tokenId Identifier number of a token.
     */
    error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC1155InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC1155InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param owner Address of the current owner of a token.
     */
    error ERC1155MissingApprovalForAll(address operator, address owner);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC1155InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC1155InvalidOperator(address operator);

    /**
     * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation.
     * Used in batch transfers.
     * @param idsLength Length of the array of token identifiers
     * @param valuesLength Length of the array of token amounts
     */
    error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/Arrays.sol)

pragma solidity ^0.8.20;

import {StorageSlot} from "./StorageSlot.sol";
import {Math} from "./math/Math.sol";

/**
 * @dev Collection of functions related to array types.
 */
library Arrays {
    using StorageSlot for bytes32;

    /**
     * @dev Searches a sorted `array` and returns the first index that contains
     * a value greater or equal to `element`. If no such index exists (i.e. all
     * values in the array are strictly less than `element`), the array length is
     * returned. Time complexity O(log n).
     *
     * `array` is expected to be sorted in ascending order, and to contain no
     * repeated elements.
     */
    function findUpperBound(uint256[] storage array, uint256 element) internal view returns (uint256) {
        uint256 low = 0;
        uint256 high = array.length;

        if (high == 0) {
            return 0;
        }

        while (low < high) {
            uint256 mid = Math.average(low, high);

            // Note that mid will always be strictly less than high (i.e. it will be a valid array index)
            // because Math.average rounds towards zero (it does integer division with truncation).
            if (unsafeAccess(array, mid).value > element) {
                high = mid;
            } else {
                low = mid + 1;
            }
        }

        // At this point `low` is the exclusive upper bound. We will return the inclusive upper bound.
        if (low > 0 && unsafeAccess(array, low - 1).value == element) {
            return low - 1;
        } else {
            return low;
        }
    }

    /**
     * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check.
     *
     * WARNING: Only use if you are certain `pos` is lower than the array length.
     */
    function unsafeAccess(address[] storage arr, uint256 pos) internal pure returns (StorageSlot.AddressSlot storage) {
        bytes32 slot;
        // We use assembly to calculate the storage slot of the element at index `pos` of the dynamic array `arr`
        // following https://docs.soliditylang.org/en/v0.8.20/internals/layout_in_storage.html#mappings-and-dynamic-arrays.

        /// @solidity memory-safe-assembly
        assembly {
            mstore(0, arr.slot)
            slot := add(keccak256(0, 0x20), pos)
        }
        return slot.getAddressSlot();
    }

    /**
     * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check.
     *
     * WARNING: Only use if you are certain `pos` is lower than the array length.
     */
    function unsafeAccess(bytes32[] storage arr, uint256 pos) internal pure returns (StorageSlot.Bytes32Slot storage) {
        bytes32 slot;
        // We use assembly to calculate the storage slot of the element at index `pos` of the dynamic array `arr`
        // following https://docs.soliditylang.org/en/v0.8.20/internals/layout_in_storage.html#mappings-and-dynamic-arrays.

        /// @solidity memory-safe-assembly
        assembly {
            mstore(0, arr.slot)
            slot := add(keccak256(0, 0x20), pos)
        }
        return slot.getBytes32Slot();
    }

    /**
     * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check.
     *
     * WARNING: Only use if you are certain `pos` is lower than the array length.
     */
    function unsafeAccess(uint256[] storage arr, uint256 pos) internal pure returns (StorageSlot.Uint256Slot storage) {
        bytes32 slot;
        // We use assembly to calculate the storage slot of the element at index `pos` of the dynamic array `arr`
        // following https://docs.soliditylang.org/en/v0.8.20/internals/layout_in_storage.html#mappings-and-dynamic-arrays.

        /// @solidity memory-safe-assembly
        assembly {
            mstore(0, arr.slot)
            slot := add(keccak256(0, 0x20), pos)
        }
        return slot.getUint256Slot();
    }

    /**
     * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check.
     *
     * WARNING: Only use if you are certain `pos` is lower than the array length.
     */
    function unsafeMemoryAccess(uint256[] memory arr, uint256 pos) internal pure returns (uint256 res) {
        assembly {
            res := mload(add(add(arr, 0x20), mul(pos, 0x20)))
        }
    }

    /**
     * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check.
     *
     * WARNING: Only use if you are certain `pos` is lower than the array length.
     */
    function unsafeMemoryAccess(address[] memory arr, uint256 pos) internal pure returns (address res) {
        assembly {
            res := mload(add(add(arr, 0x20), mul(pos, 0x20)))
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/ERC165.sol)

pragma solidity ^0.8.20;

import {IERC165} from "./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);
 * }
 * ```
 */
abstract contract ERC165 is IERC165 {
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
        return interfaceId == type(IERC165).interfaceId;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/extensions/IERC1155MetadataURI.sol)

pragma solidity ^0.8.20;

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

/**
 * @dev Interface of the optional ERC1155MetadataExtension interface, as defined
 * in the https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[EIP].
 */
interface IERC1155MetadataURI is IERC1155 {
    /**
     * @dev Returns the URI for token type `id`.
     *
     * If the `\{id\}` substring is present in the URI, it must be replaced by
     * clients with the actual token type ID.
     */
    function uri(uint256 id) external view returns (string memory);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/IERC1155Receiver.sol)

pragma solidity ^0.8.20;

import {IERC165} from "../../utils/introspection/IERC165.sol";

/**
 * @dev Interface that must be implemented by smart contracts in order to receive
 * ERC-1155 token transfers.
 */
interface IERC1155Receiver is IERC165 {
    /**
     * @dev Handles the receipt of a single ERC1155 token type. This function is
     * called at the end of a `safeTransferFrom` after the balance has been updated.
     *
     * NOTE: To accept the transfer, this must return
     * `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
     * (i.e. 0xf23a6e61, or its own function selector).
     *
     * @param operator The address which initiated the transfer (i.e. msg.sender)
     * @param from The address which previously owned the token
     * @param id The ID of the token being transferred
     * @param value The amount of tokens being transferred
     * @param data Additional data with no specified format
     * @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
     */
    function onERC1155Received(
        address operator,
        address from,
        uint256 id,
        uint256 value,
        bytes calldata data
    ) external returns (bytes4);

    /**
     * @dev Handles the receipt of a multiple ERC1155 token types. This function
     * is called at the end of a `safeBatchTransferFrom` after the balances have
     * been updated.
     *
     * NOTE: To accept the transfer(s), this must return
     * `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
     * (i.e. 0xbc197c81, or its own function selector).
     *
     * @param operator The address which initiated the batch transfer (i.e. msg.sender)
     * @param from The address which previously owned the token
     * @param ids An array containing ids of each token being transferred (order and length must match values array)
     * @param values An array containing amounts of each token being transferred (order and length must match ids array)
     * @param data Additional data with no specified format
     * @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
     */
    function onERC1155BatchReceived(
        address operator,
        address from,
        uint256[] calldata ids,
        uint256[] calldata values,
        bytes calldata data
    ) external returns (bytes4);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.1) (token/ERC1155/IERC1155.sol)

pragma solidity ^0.8.20;

import {IERC165} from "../../utils/introspection/IERC165.sol";

/**
 * @dev Required interface of an ERC1155 compliant contract, as defined in the
 * https://eips.ethereum.org/EIPS/eip-1155[EIP].
 */
interface IERC1155 is IERC165 {
    /**
     * @dev Emitted when `value` amount of tokens of type `id` are transferred from `from` to `to` by `operator`.
     */
    event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);

    /**
     * @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
     * transfers.
     */
    event TransferBatch(
        address indexed operator,
        address indexed from,
        address indexed to,
        uint256[] ids,
        uint256[] values
    );

    /**
     * @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
     * `approved`.
     */
    event ApprovalForAll(address indexed account, address indexed operator, bool approved);

    /**
     * @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
     *
     * If an {URI} event was emitted for `id`, the standard
     * https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
     * returned by {IERC1155MetadataURI-uri}.
     */
    event URI(string value, uint256 indexed id);

    /**
     * @dev Returns the value of tokens of token type `id` owned by `account`.
     *
     * Requirements:
     *
     * - `account` cannot be the zero address.
     */
    function balanceOf(address account, uint256 id) external view returns (uint256);

    /**
     * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
     *
     * Requirements:
     *
     * - `accounts` and `ids` must have the same length.
     */
    function balanceOfBatch(
        address[] calldata accounts,
        uint256[] calldata ids
    ) external view returns (uint256[] memory);

    /**
     * @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
     *
     * Emits an {ApprovalForAll} event.
     *
     * Requirements:
     *
     * - `operator` cannot be the caller.
     */
    function setApprovalForAll(address operator, bool approved) external;

    /**
     * @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
     *
     * See {setApprovalForAll}.
     */
    function isApprovedForAll(address account, address operator) external view returns (bool);

    /**
     * @dev Transfers a `value` amount of tokens of type `id` from `from` to `to`.
     *
     * WARNING: This function can potentially allow a reentrancy attack when transferring tokens
     * to an untrusted contract, when invoking {onERC1155Received} on the receiver.
     * Ensure to follow the checks-effects-interactions pattern and consider employing
     * reentrancy guards when interacting with untrusted contracts.
     *
     * Emits a {TransferSingle} event.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}.
     * - `from` must have a balance of tokens of type `id` of at least `value` amount.
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
     * acceptance magic value.
     */
    function safeTransferFrom(address from, address to, uint256 id, uint256 value, bytes calldata data) external;

    /**
     * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
     *
     * WARNING: This function can potentially allow a reentrancy attack when transferring tokens
     * to an untrusted contract, when invoking {onERC1155BatchReceived} on the receiver.
     * Ensure to follow the checks-effects-interactions pattern and consider employing
     * reentrancy guards when interacting with untrusted contracts.
     *
     * Emits either a {TransferSingle} or a {TransferBatch} event, depending on the length of the array arguments.
     *
     * Requirements:
     *
     * - `ids` and `values` must have the same length.
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
     * acceptance magic value.
     */
    function safeBatchTransferFrom(
        address from,
        address to,
        uint256[] calldata ids,
        uint256[] calldata values,
        bytes calldata data
    ) external;
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/IERC165.sol)

pragma solidity ^0.8.20;

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/math/Math.sol)

pragma solidity ^0.8.20;

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library Math {
    /**
     * @dev Muldiv operation overflow.
     */
    error MathOverflowedMulDiv();

    enum Rounding {
        Floor, // Toward negative infinity
        Ceil, // Toward positive infinity
        Trunc, // Toward zero
        Expand // Away from zero
    }

    /**
     * @dev Returns the addition of two unsigned integers, with an overflow flag.
     */
    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.
     */
    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.
     */
    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.
     */
    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.
     */
    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 largest of two numbers.
     */
    function max(uint256 a, uint256 b) internal pure returns (uint256) {
        return a > b ? a : b;
    }

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

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

    /**
     * @dev Returns the ceiling of the division of two numbers.
     *
     * This differs from standard division with `/` in that it rounds towards infinity instead
     * of rounding towards zero.
     */
    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
        if (b == 0) {
            // Guarantee the same behavior as in a regular Solidity division.
            return a / b;
        }

        // (a + b - 1) / b can overflow on addition, so we distribute.
        return a == 0 ? 0 : (a - 1) / b + 1;
    }

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

            // Handle non-overflow cases, 256 by 256 division.
            if (prod1 == 0) {
                // Solidity will revert if denominator == 0, unlike the div opcode on its own.
                // The surrounding unchecked block does not change this fact.
                // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
                return prod0 / denominator;
            }

            // Make sure the result is less than 2^256. Also prevents denominator == 0.
            if (denominator <= prod1) {
                revert MathOverflowedMulDiv();
            }

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

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

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

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

            uint256 twos = denominator & (0 - denominator);
            assembly {
                // Divide denominator by twos.
                denominator := div(denominator, twos)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    /**
     * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.
     */
    function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {
        return uint8(rounding) % 2 == 1;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/StorageSlot.sol)
// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.

pragma solidity ^0.8.20;

/**
 * @dev Library for reading and writing primitive types to specific storage slots.
 *
 * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
 * This library helps with reading and writing to such slots without the need for inline assembly.
 *
 * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
 *
 * Example usage to set ERC1967 implementation slot:
 * ```solidity
 * contract ERC1967 {
 *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
 *
 *     function _getImplementation() internal view returns (address) {
 *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
 *     }
 *
 *     function _setImplementation(address newImplementation) internal {
 *         require(newImplementation.code.length > 0);
 *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
 *     }
 * }
 * ```
 */
library StorageSlot {
    struct AddressSlot {
        address value;
    }

    struct BooleanSlot {
        bool value;
    }

    struct Bytes32Slot {
        bytes32 value;
    }

    struct Uint256Slot {
        uint256 value;
    }

    struct StringSlot {
        string value;
    }

    struct BytesSlot {
        bytes value;
    }

    /**
     * @dev Returns an `AddressSlot` with member `value` located at `slot`.
     */
    function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
     */
    function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
     */
    function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
     */
    function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `StringSlot` with member `value` located at `slot`.
     */
    function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
     */
    function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := store.slot
        }
    }

    /**
     * @dev Returns an `BytesSlot` with member `value` located at `slot`.
     */
    function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
     */
    function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := store.slot
        }
    }
}

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

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint256","name":"balance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ERC1155InsufficientBalance","type":"error"},{"inputs":[{"internalType":"address","name":"approver","type":"address"}],"name":"ERC1155InvalidApprover","type":"error"},{"inputs":[{"internalType":"uint256","name":"idsLength","type":"uint256"},{"internalType":"uint256","name":"valuesLength","type":"uint256"}],"name":"ERC1155InvalidArrayLength","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"ERC1155InvalidOperator","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC1155InvalidReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"ERC1155InvalidSender","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"address","name":"owner","type":"address"}],"name":"ERC1155MissingApprovalForAll","type":"error"},{"inputs":[],"name":"EnforcedPause","type":"error"},{"inputs":[],"name":"ExpectedPause","type":"error"},{"inputs":[],"name":"InsufficientFunds","type":"error"},{"inputs":[],"name":"MaxSupplyReached","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"inputs":[],"name":"ReentrancyGuardReentrantCall","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"values","type":"uint256[]"}],"name":"TransferBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"TransferSingle","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"value","type":"string"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"}],"name":"URI","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"inputs":[],"name":"adminAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"allowlistClaimed","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32[]","name":"_merkleProof","type":"bytes32[]"}],"name":"allowlistMint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"allowlistMintEnabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"}],"name":"balanceOfBatch","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"cost","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"defaultRoyaltyPercentage","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"defaultRoyaltyReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"merkleRoot","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"mint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"_receiver","type":"address"}],"name":"mintForAddress","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"removeAdmin","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint256","name":"_salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"royaltyAmount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"values","type":"uint256[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeBatchTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_adminAddress","type":"address"}],"name":"setAdminAddress","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_state","type":"bool"}],"name":"setAllowlistMintEnabled","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_cost","type":"uint256"}],"name":"setCost","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_receiver","type":"address"}],"name":"setDefaultRoyaltyReceiver","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"_merkleRoot","type":"bytes32"}],"name":"setMerkleRoot","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint256","name":"_percentage","type":"uint256"}],"name":"setRoyaltyPercentage","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"address","name":"_newReceiver","type":"address"}],"name":"setRoyaltyReceiver","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"newuri","type":"string"}],"name":"setURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"uri","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"}]

60e0604052602d608081815290620027d560a03960069062000022908262000291565b50600780546001600160a01b0319908116736b4583e2cf92b973eb0ed0c01aecd0f0f242cc41179091555f60088190556107d0600955600a55600c805460ff19169055600e805490911673ac0762c5b7500a9c60cce8bdfb4036c0152e5a1b1790556101f460105534801562000096575f80fd5b5060408051602081019091525f81523390620000b2816200010c565b506001600160a01b038116620000e157604051631e4fbdf760e01b81525f600482015260240160405180910390fd5b620000ec816200011e565b5060016004556005805460ff19169055620001066200016f565b6200035d565b60026200011a828262000291565b5050565b600380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b62000179620001cc565b6005805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258620001af3390565b6040516001600160a01b03909116815260200160405180910390a1565b60055460ff1615620001f15760405163d93c066560e01b815260040160405180910390fd5b565b634e487b7160e01b5f52604160045260245ffd5b600181811c908216806200021c57607f821691505b6020821081036200023b57634e487b7160e01b5f52602260045260245ffd5b50919050565b601f8211156200028c57805f5260205f20601f840160051c81016020851015620002685750805b601f840160051c820191505b8181101562000289575f815560010162000274565b50505b505050565b81516001600160401b03811115620002ad57620002ad620001f3565b620002c581620002be845462000207565b8462000241565b602080601f831160018114620002fb575f8415620002e35750858301515b5f19600386901b1c1916600185901b17855562000355565b5f85815260208120601f198616915b828110156200032b578886015182559484019460019091019084016200030a565b50858210156200034957878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b61246a806200036b5f395ff3fe60806040526004361061021c575f3560e01c80634e1273f41161011e5780638da5cb5b116100a8578063e5cff4871161006d578063e5cff487146105f9578063e985e9c514610618578063f242432a14610637578063f2fde38b14610656578063fc6f946814610675575f80fd5b80638da5cb5b146105615780639a202d4714610592578063a22cb465146105a6578063d5abeb01146105c5578063e461aa23146105da575f80fd5b8063715018a6116100ee578063715018a6146104e257806371a94340146104f657806379de186a146105155780637cb647591461052e5780638456cb591461054d575f80fd5b80634e1273f41461046d5780634f2b937914610499578063537924ef146104b85780635c975abb146104cb575f80fd5b80632a55205a116101aa5780633ccfd60b1161016f5780633ccfd60b146103e85780633ebc82c5146103fc5780633f4ba83a1461041b57806341d6f9c21461042f57806344a0d68a1461044e575f80fd5b80632a55205a146103295780632c1e816d146103675780632eb2c2d6146103865780632eb4a7ab146103a557806330b42ec2146103ba575f80fd5b80630e89341c116101f05780630e89341c146102c35780631249c58b146102e2578063139d8325146102ea57806313faede6146102ff57806318160ddd14610314575f80fd5b8062fdd58e1461022057806301ffc9a71461025257806302fe53051461028157806306fdde03146102a2575b5f80fd5b34801561022b575f80fd5b5061023f61023a366004611ba1565b610694565b6040519081526020015b60405180910390f35b34801561025d575f80fd5b5061027161026c366004611bde565b6106bb565b6040519015158152602001610249565b34801561028c575f80fd5b506102a061029b366004611c93565b61070a565b005b3480156102ad575f80fd5b506102b661076d565b6040516102499190611d23565b3480156102ce575f80fd5b506102b66102dd366004611d35565b6107f9565b6102a061088b565b3480156102f5575f80fd5b5061023f60105481565b34801561030a575f80fd5b5061023f60085481565b34801561031f575f80fd5b5061023f600a5481565b348015610334575f80fd5b50610348610343366004611d4c565b61090b565b604080516001600160a01b039093168352602083019190915201610249565b348015610372575f80fd5b506102a0610381366004611d6c565b6109b6565b348015610391575f80fd5b506102a06103a0366004611e32565b610a26565b3480156103b0575f80fd5b5061023f600b5481565b3480156103c5575f80fd5b506102716103d4366004611d6c565b600d6020525f908152604090205460ff1681565b3480156103f3575f80fd5b506102a0610a8d565b348015610407575f80fd5b506102a0610416366004611d6c565b610b5c565b348015610426575f80fd5b506102a0610bcc565b34801561043a575f80fd5b506102a0610449366004611d4c565b610c22565b348015610459575f80fd5b506102a0610468366004611d35565b610c81565b348015610478575f80fd5b5061048c610487366004611ed5565b610cd4565b6040516102499190611fc9565b3480156104a4575f80fd5b506102a06104b3366004611d6c565b610d9f565b6102a06104c6366004611fdb565b610e43565b3480156104d6575f80fd5b5060055460ff16610271565b3480156104ed575f80fd5b506102a061105b565b348015610501575f80fd5b506102a0610510366004612059565b61106c565b348015610520575f80fd5b50600c546102719060ff1681565b348015610539575f80fd5b506102a0610548366004611d35565b6110cd565b348015610558575f80fd5b506102a0611120565b34801561056c575f80fd5b506003546001600160a01b03165b6040516001600160a01b039091168152602001610249565b34801561059d575f80fd5b506102a0611176565b3480156105b1575f80fd5b506102a06105c0366004612072565b6111d6565b3480156105d0575f80fd5b5061023f60095481565b3480156105e5575f80fd5b50600e5461057a906001600160a01b031681565b348015610604575f80fd5b506102a061061336600461209a565b6111e1565b348015610623575f80fd5b506102716106323660046120bb565b61125c565b348015610642575f80fd5b506102a06106513660046120e3565b611289565b348015610661575f80fd5b506102a0610670366004611d6c565b6112e8565b348015610680575f80fd5b5060075461057a906001600160a01b031681565b5f818152602081815260408083206001600160a01b03861684529091529020545b92915050565b5f6001600160e01b03198216636cdb3d1360e11b14806106eb57506001600160e01b031982166303a24d0760e21b145b806106b557506301ffc9a760e01b6001600160e01b03198316146106b5565b6007546001600160a01b031633148061073c5750336107316003546001600160a01b031690565b6001600160a01b0316145b6107615760405162461bcd60e51b815260040161075890612143565b60405180910390fd5b61076a81611322565b50565b6006805461077a90612185565b80601f01602080910402602001604051908101604052809291908181526020018280546107a690612185565b80156107f15780601f106107c8576101008083540402835291602001916107f1565b820191905f5260205f20905b8154815290600101906020018083116107d457829003601f168201915b505050505081565b60606002805461080890612185565b80601f016020809104026020016040519081016040528092919081815260200182805461083490612185565b801561087f5780601f106108565761010080835404028352916020019161087f565b820191905f5260205f20905b81548152906001019060200180831161086257829003601f168201915b50505050509050919050565b61089361132e565b600954600a54106108b75760405163d05cb60960e01b815260040160405180910390fd5b6008543410156108da5760405163356680b760e01b815260040160405180910390fd5b6108f5335f600160405180602001604052805f815250611352565b600a8054905f610904836121d1565b9190505550565b5f828152600f602052604081205481906001600160a01b031661093957600e546001600160a01b0316610951565b5f848152600f60205260409020546001600160a01b03165b5f8581526011602052604081205491935003610987576127106010548461097891906121e9565b6109829190612200565b6109ad565b5f84815260116020526040902054612710906109a390856121e9565b6109ad9190612200565b90509250929050565b6007546001600160a01b03163314806109e85750336109dd6003546001600160a01b031690565b6001600160a01b0316145b610a045760405162461bcd60e51b815260040161075890612143565b600780546001600160a01b0319166001600160a01b0392909216919091179055565b336001600160a01b0386168114801590610a475750610a45868261125c565b155b15610a785760405163711bec9160e11b81526001600160a01b03808316600483015287166024820152604401610758565b610a8586868686866113ad565b505050505050565b6007546001600160a01b0316331480610abf575033610ab46003546001600160a01b031690565b6001600160a01b0316145b610adb5760405162461bcd60e51b815260040161075890612143565b610ae3611412565b5f610af66003546001600160a01b031690565b6001600160a01b0316476040515f6040518083038185875af1925050503d805f8114610b3d576040519150601f19603f3d011682016040523d82523d5f602084013e610b42565b606091505b5050905080610b4f575f80fd5b50610b5a6001600455565b565b6007546001600160a01b0316331480610b8e575033610b836003546001600160a01b031690565b6001600160a01b0316145b610baa5760405162461bcd60e51b815260040161075890612143565b600e80546001600160a01b0319166001600160a01b0392909216919091179055565b6007546001600160a01b0316331480610bfe575033610bf36003546001600160a01b031690565b6001600160a01b0316145b610c1a5760405162461bcd60e51b815260040161075890612143565b610b5a61143c565b6007546001600160a01b0316331480610c54575033610c496003546001600160a01b031690565b6001600160a01b0316145b610c705760405162461bcd60e51b815260040161075890612143565b5f9182526011602052604090912055565b6007546001600160a01b0316331480610cb3575033610ca86003546001600160a01b031690565b6001600160a01b0316145b610ccf5760405162461bcd60e51b815260040161075890612143565b600855565b60608151835114610d055781518351604051635b05999160e01b815260048101929092526024820152604401610758565b5f835167ffffffffffffffff811115610d2057610d20611bf9565b604051908082528060200260200182016040528015610d49578160200160208202803683370190505b5090505f5b8451811015610d9757602080820286010151610d7290602080840287010151610694565b828281518110610d8457610d8461221f565b6020908102919091010152600101610d4e565b509392505050565b6007546001600160a01b0316331480610dd1575033610dc66003546001600160a01b031690565b6001600160a01b0316145b610ded5760405162461bcd60e51b815260040161075890612143565b600954600a5410610e115760405163d05cb60960e01b815260040160405180910390fd5b610e2c815f600160405180602001604052805f815250611352565b600a8054905f610e3b836121d1565b919050555050565b610e4b611412565b600954600a5410610e6f5760405163d05cb60960e01b815260040160405180910390fd5b600854341015610e925760405163356680b760e01b815260040160405180910390fd5b600c5460ff16610eef5760405162461bcd60e51b815260206004820152602260248201527f54686520616c6c6f776c6973742073616c65206973206e6f7420656e61626c65604482015261642160f01b6064820152608401610758565b335f908152600d602052604090205460ff1615610f4e5760405162461bcd60e51b815260206004820152601860248201527f4164647265737320616c726561647920636c61696d65642100000000000000006044820152606401610758565b6040516bffffffffffffffffffffffff193360601b1660208201525f90603401604051602081830303815290604052805190602001209050610fc68383808060200260200160405190810160405280939291908181526020018383602002808284375f9201919091525050600b54915084905061148e565b6110035760405162461bcd60e51b815260206004820152600e60248201526d496e76616c69642070726f6f662160901b6044820152606401610758565b335f818152600d60209081526040808320805460ff191660019081179091558151928301909152828252611038939291611352565b600a8054905f611047836121d1565b9190505550506110576001600455565b5050565b6110636114a3565b610b5a5f6114d0565b6007546001600160a01b031633148061109e5750336110936003546001600160a01b031690565b6001600160a01b0316145b6110ba5760405162461bcd60e51b815260040161075890612143565b600c805460ff1916911515919091179055565b6007546001600160a01b03163314806110ff5750336110f46003546001600160a01b031690565b6001600160a01b0316145b61111b5760405162461bcd60e51b815260040161075890612143565b600b55565b6007546001600160a01b03163314806111525750336111476003546001600160a01b031690565b6001600160a01b0316145b61116e5760405162461bcd60e51b815260040161075890612143565b610b5a611521565b6007546001600160a01b03163314806111a857503361119d6003546001600160a01b031690565b6001600160a01b0316145b6111c45760405162461bcd60e51b815260040161075890612143565b600780546001600160a01b0319169055565b61105733838361155e565b6007546001600160a01b03163314806112135750336112086003546001600160a01b031690565b6001600160a01b0316145b61122f5760405162461bcd60e51b815260040161075890612143565b5f918252600f602052604090912080546001600160a01b0319166001600160a01b03909216919091179055565b6001600160a01b039182165f90815260016020908152604080832093909416825291909152205460ff1690565b336001600160a01b03861681148015906112aa57506112a8868261125c565b155b156112db5760405163711bec9160e11b81526001600160a01b03808316600483015287166024820152604401610758565b610a8586868686866115f2565b6112f06114a3565b6001600160a01b03811661131957604051631e4fbdf760e01b81525f6004820152602401610758565b61076a816114d0565b6002611057828261227c565b60055460ff1615610b5a5760405163d93c066560e01b815260040160405180910390fd5b6001600160a01b03841661137b57604051632bfa23e760e11b81525f6004820152602401610758565b60408051600180825260208201869052818301908152606082018590526080820190925290610a855f8784848761167e565b6001600160a01b0384166113d657604051632bfa23e760e11b81525f6004820152602401610758565b6001600160a01b0385166113fe57604051626a0d4560e21b81525f6004820152602401610758565b61140b858585858561167e565b5050505050565b60026004540361143557604051633ee5aeb560e01b815260040160405180910390fd5b6002600455565b6114446116d1565b6005805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b5f8261149a85846116f4565b14949350505050565b6003546001600160a01b03163314610b5a5760405163118cdaa760e01b8152336004820152602401610758565b600380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b61152961132e565b6005805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586114713390565b6001600160a01b0382166115865760405162ced3e160e81b81525f6004820152602401610758565b6001600160a01b038381165f81815260016020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6001600160a01b03841661161b57604051632bfa23e760e11b81525f6004820152602401610758565b6001600160a01b03851661164357604051626a0d4560e21b81525f6004820152602401610758565b60408051600180825260208201869052818301908152606082018590526080820190925290611675878784848761167e565b50505050505050565b61168a8585858561172e565b6001600160a01b0384161561140b57825133906001036116c357602084810151908401516116bc838989858589611740565b5050610a85565b610a85818787878787611861565b60055460ff16610b5a57604051638dfc202b60e01b815260040160405180910390fd5b5f81815b8451811015610d9757611724828683815181106117175761171761221f565b6020026020010151611948565b91506001016116f8565b61173a84848484611977565b50505050565b6001600160a01b0384163b15610a855760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e61906117849089908990889088908890600401612338565b6020604051808303815f875af19250505080156117be575060408051601f3d908101601f191682019092526117bb9181019061237c565b60015b611825573d8080156117eb576040519150601f19603f3d011682016040523d82523d5f602084013e6117f0565b606091505b5080515f0361181d57604051632bfa23e760e11b81526001600160a01b0386166004820152602401610758565b805181602001fd5b6001600160e01b0319811663f23a6e6160e01b1461167557604051632bfa23e760e11b81526001600160a01b0386166004820152602401610758565b6001600160a01b0384163b15610a855760405163bc197c8160e01b81526001600160a01b0385169063bc197c81906118a59089908990889088908890600401612397565b6020604051808303815f875af19250505080156118df575060408051601f3d908101601f191682019092526118dc9181019061237c565b60015b61190c573d8080156117eb576040519150601f19603f3d011682016040523d82523d5f602084013e6117f0565b6001600160e01b0319811663bc197c8160e01b1461167557604051632bfa23e760e11b81526001600160a01b0386166004820152602401610758565b5f818310611962575f828152602084905260409020611970565b5f8381526020839052604090205b9392505050565b80518251146119a65781518151604051635b05999160e01b815260048101929092526024820152604401610758565b335f5b8351811015611aa8576020818102858101820151908501909101516001600160a01b03881615611a5a575f828152602081815260408083206001600160a01b038c16845290915290205481811015611a34576040516303dee4c560e01b81526001600160a01b038a166004820152602481018290526044810183905260648101849052608401610758565b5f838152602081815260408083206001600160a01b038d16845290915290209082900390555b6001600160a01b03871615611a9e575f828152602081815260408083206001600160a01b038b16845290915281208054839290611a989084906123f4565b90915550505b50506001016119a9565b508251600103611b285760208301515f906020840151909150856001600160a01b0316876001600160a01b0316846001600160a01b03167fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f628585604051611b19929190918252602082015260400190565b60405180910390a4505061140b565b836001600160a01b0316856001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb8686604051611b77929190612407565b60405180910390a45050505050565b80356001600160a01b0381168114611b9c575f80fd5b919050565b5f8060408385031215611bb2575f80fd5b611bbb83611b86565b946020939093013593505050565b6001600160e01b03198116811461076a575f80fd5b5f60208284031215611bee575f80fd5b813561197081611bc9565b634e487b7160e01b5f52604160045260245ffd5b604051601f8201601f1916810167ffffffffffffffff81118282101715611c3657611c36611bf9565b604052919050565b5f67ffffffffffffffff831115611c5757611c57611bf9565b611c6a601f8401601f1916602001611c0d565b9050828152838383011115611c7d575f80fd5b828260208301375f602084830101529392505050565b5f60208284031215611ca3575f80fd5b813567ffffffffffffffff811115611cb9575f80fd5b8201601f81018413611cc9575f80fd5b611cd884823560208401611c3e565b949350505050565b5f81518084525f5b81811015611d0457602081850181015186830182015201611ce8565b505f602082860101526020601f19601f83011685010191505092915050565b602081525f6119706020830184611ce0565b5f60208284031215611d45575f80fd5b5035919050565b5f8060408385031215611d5d575f80fd5b50508035926020909101359150565b5f60208284031215611d7c575f80fd5b61197082611b86565b5f67ffffffffffffffff821115611d9e57611d9e611bf9565b5060051b60200190565b5f82601f830112611db7575f80fd5b81356020611dcc611dc783611d85565b611c0d565b8083825260208201915060208460051b870101935086841115611ded575f80fd5b602086015b84811015611e095780358352918301918301611df2565b509695505050505050565b5f82601f830112611e23575f80fd5b61197083833560208501611c3e565b5f805f805f60a08688031215611e46575f80fd5b611e4f86611b86565b9450611e5d60208701611b86565b9350604086013567ffffffffffffffff80821115611e79575f80fd5b611e8589838a01611da8565b94506060880135915080821115611e9a575f80fd5b611ea689838a01611da8565b93506080880135915080821115611ebb575f80fd5b50611ec888828901611e14565b9150509295509295909350565b5f8060408385031215611ee6575f80fd5b823567ffffffffffffffff80821115611efd575f80fd5b818501915085601f830112611f10575f80fd5b81356020611f20611dc783611d85565b82815260059290921b84018101918181019089841115611f3e575f80fd5b948201945b83861015611f6357611f5486611b86565b82529482019490820190611f43565b96505086013592505080821115611f78575f80fd5b50611f8585828601611da8565b9150509250929050565b5f815180845260208085019450602084015f5b83811015611fbe57815187529582019590820190600101611fa2565b509495945050505050565b602081525f6119706020830184611f8f565b5f8060208385031215611fec575f80fd5b823567ffffffffffffffff80821115612003575f80fd5b818501915085601f830112612016575f80fd5b813581811115612024575f80fd5b8660208260051b8501011115612038575f80fd5b60209290920196919550909350505050565b80358015158114611b9c575f80fd5b5f60208284031215612069575f80fd5b6119708261204a565b5f8060408385031215612083575f80fd5b61208c83611b86565b91506109ad6020840161204a565b5f80604083850312156120ab575f80fd5b823591506109ad60208401611b86565b5f80604083850312156120cc575f80fd5b6120d583611b86565b91506109ad60208401611b86565b5f805f805f60a086880312156120f7575f80fd5b61210086611b86565b945061210e60208701611b86565b93506040860135925060608601359150608086013567ffffffffffffffff811115612137575f80fd5b611ec888828901611e14565b60208082526022908201527f52657175697265732061646d696e206f72206f776e65722070726976696c6567604082015261657360f01b606082015260800190565b600181811c9082168061219957607f821691505b6020821081036121b757634e487b7160e01b5f52602260045260245ffd5b50919050565b634e487b7160e01b5f52601160045260245ffd5b5f600182016121e2576121e26121bd565b5060010190565b80820281158282048414176106b5576106b56121bd565b5f8261221a57634e487b7160e01b5f52601260045260245ffd5b500490565b634e487b7160e01b5f52603260045260245ffd5b601f82111561227757805f5260205f20601f840160051c810160208510156122585750805b601f840160051c820191505b8181101561140b575f8155600101612264565b505050565b815167ffffffffffffffff81111561229657612296611bf9565b6122aa816122a48454612185565b84612233565b602080601f8311600181146122dd575f84156122c65750858301515b5f19600386901b1c1916600185901b178555610a85565b5f85815260208120601f198616915b8281101561230b578886015182559484019460019091019084016122ec565b508582101561232857878501515f19600388901b60f8161c191681555b5050505050600190811b01905550565b6001600160a01b03868116825285166020820152604081018490526060810183905260a0608082018190525f9061237190830184611ce0565b979650505050505050565b5f6020828403121561238c575f80fd5b815161197081611bc9565b6001600160a01b0386811682528516602082015260a0604082018190525f906123c290830186611f8f565b82810360608401526123d48186611f8f565b905082810360808401526123e88185611ce0565b98975050505050505050565b808201808211156106b5576106b56121bd565b604081525f6124196040830185611f8f565b828103602084015261242b8185611f8f565b9594505050505056fea2646970667358221220592e3949f285337895c68fa5fa5227caef12f5e1d27246e48ec4208659d9de4d64736f6c63430008180033466f756e646174696f6e20666f722041727420616e6420426c6f636b636861696e202d204d6f6e6f6772617068

0x60806040526004361061021c575f3560e01c80634e1273f41161011e5780638da5cb5b116100a8578063e5cff4871161006d578063e5cff487146105f9578063e985e9c514610618578063f242432a14610637578063f2fde38b14610656578063fc6f946814610675575f80fd5b80638da5cb5b146105615780639a202d4714610592578063a22cb465146105a6578063d5abeb01146105c5578063e461aa23146105da575f80fd5b8063715018a6116100ee578063715018a6146104e257806371a94340146104f657806379de186a146105155780637cb647591461052e5780638456cb591461054d575f80fd5b80634e1273f41461046d5780634f2b937914610499578063537924ef146104b85780635c975abb146104cb575f80fd5b80632a55205a116101aa5780633ccfd60b1161016f5780633ccfd60b146103e85780633ebc82c5146103fc5780633f4ba83a1461041b57806341d6f9c21461042f57806344a0d68a1461044e575f80fd5b80632a55205a146103295780632c1e816d146103675780632eb2c2d6146103865780632eb4a7ab146103a557806330b42ec2146103ba575f80fd5b80630e89341c116101f05780630e89341c146102c35780631249c58b146102e2578063139d8325146102ea57806313faede6146102ff57806318160ddd14610314575f80fd5b8062fdd58e1461022057806301ffc9a71461025257806302fe53051461028157806306fdde03146102a2575b5f80fd5b34801561022b575f80fd5b5061023f61023a366004611ba1565b610694565b6040519081526020015b60405180910390f35b34801561025d575f80fd5b5061027161026c366004611bde565b6106bb565b6040519015158152602001610249565b34801561028c575f80fd5b506102a061029b366004611c93565b61070a565b005b3480156102ad575f80fd5b506102b661076d565b6040516102499190611d23565b3480156102ce575f80fd5b506102b66102dd366004611d35565b6107f9565b6102a061088b565b3480156102f5575f80fd5b5061023f60105481565b34801561030a575f80fd5b5061023f60085481565b34801561031f575f80fd5b5061023f600a5481565b348015610334575f80fd5b50610348610343366004611d4c565b61090b565b604080516001600160a01b039093168352602083019190915201610249565b348015610372575f80fd5b506102a0610381366004611d6c565b6109b6565b348015610391575f80fd5b506102a06103a0366004611e32565b610a26565b3480156103b0575f80fd5b5061023f600b5481565b3480156103c5575f80fd5b506102716103d4366004611d6c565b600d6020525f908152604090205460ff1681565b3480156103f3575f80fd5b506102a0610a8d565b348015610407575f80fd5b506102a0610416366004611d6c565b610b5c565b348015610426575f80fd5b506102a0610bcc565b34801561043a575f80fd5b506102a0610449366004611d4c565b610c22565b348015610459575f80fd5b506102a0610468366004611d35565b610c81565b348015610478575f80fd5b5061048c610487366004611ed5565b610cd4565b6040516102499190611fc9565b3480156104a4575f80fd5b506102a06104b3366004611d6c565b610d9f565b6102a06104c6366004611fdb565b610e43565b3480156104d6575f80fd5b5060055460ff16610271565b3480156104ed575f80fd5b506102a061105b565b348015610501575f80fd5b506102a0610510366004612059565b61106c565b348015610520575f80fd5b50600c546102719060ff1681565b348015610539575f80fd5b506102a0610548366004611d35565b6110cd565b348015610558575f80fd5b506102a0611120565b34801561056c575f80fd5b506003546001600160a01b03165b6040516001600160a01b039091168152602001610249565b34801561059d575f80fd5b506102a0611176565b3480156105b1575f80fd5b506102a06105c0366004612072565b6111d6565b3480156105d0575f80fd5b5061023f60095481565b3480156105e5575f80fd5b50600e5461057a906001600160a01b031681565b348015610604575f80fd5b506102a061061336600461209a565b6111e1565b348015610623575f80fd5b506102716106323660046120bb565b61125c565b348015610642575f80fd5b506102a06106513660046120e3565b611289565b348015610661575f80fd5b506102a0610670366004611d6c565b6112e8565b348015610680575f80fd5b5060075461057a906001600160a01b031681565b5f818152602081815260408083206001600160a01b03861684529091529020545b92915050565b5f6001600160e01b03198216636cdb3d1360e11b14806106eb57506001600160e01b031982166303a24d0760e21b145b806106b557506301ffc9a760e01b6001600160e01b03198316146106b5565b6007546001600160a01b031633148061073c5750336107316003546001600160a01b031690565b6001600160a01b0316145b6107615760405162461bcd60e51b815260040161075890612143565b60405180910390fd5b61076a81611322565b50565b6006805461077a90612185565b80601f01602080910402602001604051908101604052809291908181526020018280546107a690612185565b80156107f15780601f106107c8576101008083540402835291602001916107f1565b820191905f5260205f20905b8154815290600101906020018083116107d457829003601f168201915b505050505081565b60606002805461080890612185565b80601f016020809104026020016040519081016040528092919081815260200182805461083490612185565b801561087f5780601f106108565761010080835404028352916020019161087f565b820191905f5260205f20905b81548152906001019060200180831161086257829003601f168201915b50505050509050919050565b61089361132e565b600954600a54106108b75760405163d05cb60960e01b815260040160405180910390fd5b6008543410156108da5760405163356680b760e01b815260040160405180910390fd5b6108f5335f600160405180602001604052805f815250611352565b600a8054905f610904836121d1565b9190505550565b5f828152600f602052604081205481906001600160a01b031661093957600e546001600160a01b0316610951565b5f848152600f60205260409020546001600160a01b03165b5f8581526011602052604081205491935003610987576127106010548461097891906121e9565b6109829190612200565b6109ad565b5f84815260116020526040902054612710906109a390856121e9565b6109ad9190612200565b90509250929050565b6007546001600160a01b03163314806109e85750336109dd6003546001600160a01b031690565b6001600160a01b0316145b610a045760405162461bcd60e51b815260040161075890612143565b600780546001600160a01b0319166001600160a01b0392909216919091179055565b336001600160a01b0386168114801590610a475750610a45868261125c565b155b15610a785760405163711bec9160e11b81526001600160a01b03808316600483015287166024820152604401610758565b610a8586868686866113ad565b505050505050565b6007546001600160a01b0316331480610abf575033610ab46003546001600160a01b031690565b6001600160a01b0316145b610adb5760405162461bcd60e51b815260040161075890612143565b610ae3611412565b5f610af66003546001600160a01b031690565b6001600160a01b0316476040515f6040518083038185875af1925050503d805f8114610b3d576040519150601f19603f3d011682016040523d82523d5f602084013e610b42565b606091505b5050905080610b4f575f80fd5b50610b5a6001600455565b565b6007546001600160a01b0316331480610b8e575033610b836003546001600160a01b031690565b6001600160a01b0316145b610baa5760405162461bcd60e51b815260040161075890612143565b600e80546001600160a01b0319166001600160a01b0392909216919091179055565b6007546001600160a01b0316331480610bfe575033610bf36003546001600160a01b031690565b6001600160a01b0316145b610c1a5760405162461bcd60e51b815260040161075890612143565b610b5a61143c565b6007546001600160a01b0316331480610c54575033610c496003546001600160a01b031690565b6001600160a01b0316145b610c705760405162461bcd60e51b815260040161075890612143565b5f9182526011602052604090912055565b6007546001600160a01b0316331480610cb3575033610ca86003546001600160a01b031690565b6001600160a01b0316145b610ccf5760405162461bcd60e51b815260040161075890612143565b600855565b60608151835114610d055781518351604051635b05999160e01b815260048101929092526024820152604401610758565b5f835167ffffffffffffffff811115610d2057610d20611bf9565b604051908082528060200260200182016040528015610d49578160200160208202803683370190505b5090505f5b8451811015610d9757602080820286010151610d7290602080840287010151610694565b828281518110610d8457610d8461221f565b6020908102919091010152600101610d4e565b509392505050565b6007546001600160a01b0316331480610dd1575033610dc66003546001600160a01b031690565b6001600160a01b0316145b610ded5760405162461bcd60e51b815260040161075890612143565b600954600a5410610e115760405163d05cb60960e01b815260040160405180910390fd5b610e2c815f600160405180602001604052805f815250611352565b600a8054905f610e3b836121d1565b919050555050565b610e4b611412565b600954600a5410610e6f5760405163d05cb60960e01b815260040160405180910390fd5b600854341015610e925760405163356680b760e01b815260040160405180910390fd5b600c5460ff16610eef5760405162461bcd60e51b815260206004820152602260248201527f54686520616c6c6f776c6973742073616c65206973206e6f7420656e61626c65604482015261642160f01b6064820152608401610758565b335f908152600d602052604090205460ff1615610f4e5760405162461bcd60e51b815260206004820152601860248201527f4164647265737320616c726561647920636c61696d65642100000000000000006044820152606401610758565b6040516bffffffffffffffffffffffff193360601b1660208201525f90603401604051602081830303815290604052805190602001209050610fc68383808060200260200160405190810160405280939291908181526020018383602002808284375f9201919091525050600b54915084905061148e565b6110035760405162461bcd60e51b815260206004820152600e60248201526d496e76616c69642070726f6f662160901b6044820152606401610758565b335f818152600d60209081526040808320805460ff191660019081179091558151928301909152828252611038939291611352565b600a8054905f611047836121d1565b9190505550506110576001600455565b5050565b6110636114a3565b610b5a5f6114d0565b6007546001600160a01b031633148061109e5750336110936003546001600160a01b031690565b6001600160a01b0316145b6110ba5760405162461bcd60e51b815260040161075890612143565b600c805460ff1916911515919091179055565b6007546001600160a01b03163314806110ff5750336110f46003546001600160a01b031690565b6001600160a01b0316145b61111b5760405162461bcd60e51b815260040161075890612143565b600b55565b6007546001600160a01b03163314806111525750336111476003546001600160a01b031690565b6001600160a01b0316145b61116e5760405162461bcd60e51b815260040161075890612143565b610b5a611521565b6007546001600160a01b03163314806111a857503361119d6003546001600160a01b031690565b6001600160a01b0316145b6111c45760405162461bcd60e51b815260040161075890612143565b600780546001600160a01b0319169055565b61105733838361155e565b6007546001600160a01b03163314806112135750336112086003546001600160a01b031690565b6001600160a01b0316145b61122f5760405162461bcd60e51b815260040161075890612143565b5f918252600f602052604090912080546001600160a01b0319166001600160a01b03909216919091179055565b6001600160a01b039182165f90815260016020908152604080832093909416825291909152205460ff1690565b336001600160a01b03861681148015906112aa57506112a8868261125c565b155b156112db5760405163711bec9160e11b81526001600160a01b03808316600483015287166024820152604401610758565b610a8586868686866115f2565b6112f06114a3565b6001600160a01b03811661131957604051631e4fbdf760e01b81525f6004820152602401610758565b61076a816114d0565b6002611057828261227c565b60055460ff1615610b5a5760405163d93c066560e01b815260040160405180910390fd5b6001600160a01b03841661137b57604051632bfa23e760e11b81525f6004820152602401610758565b60408051600180825260208201869052818301908152606082018590526080820190925290610a855f8784848761167e565b6001600160a01b0384166113d657604051632bfa23e760e11b81525f6004820152602401610758565b6001600160a01b0385166113fe57604051626a0d4560e21b81525f6004820152602401610758565b61140b858585858561167e565b5050505050565b60026004540361143557604051633ee5aeb560e01b815260040160405180910390fd5b6002600455565b6114446116d1565b6005805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b5f8261149a85846116f4565b14949350505050565b6003546001600160a01b03163314610b5a5760405163118cdaa760e01b8152336004820152602401610758565b600380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b61152961132e565b6005805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586114713390565b6001600160a01b0382166115865760405162ced3e160e81b81525f6004820152602401610758565b6001600160a01b038381165f81815260016020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6001600160a01b03841661161b57604051632bfa23e760e11b81525f6004820152602401610758565b6001600160a01b03851661164357604051626a0d4560e21b81525f6004820152602401610758565b60408051600180825260208201869052818301908152606082018590526080820190925290611675878784848761167e565b50505050505050565b61168a8585858561172e565b6001600160a01b0384161561140b57825133906001036116c357602084810151908401516116bc838989858589611740565b5050610a85565b610a85818787878787611861565b60055460ff16610b5a57604051638dfc202b60e01b815260040160405180910390fd5b5f81815b8451811015610d9757611724828683815181106117175761171761221f565b6020026020010151611948565b91506001016116f8565b61173a84848484611977565b50505050565b6001600160a01b0384163b15610a855760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e61906117849089908990889088908890600401612338565b6020604051808303815f875af19250505080156117be575060408051601f3d908101601f191682019092526117bb9181019061237c565b60015b611825573d8080156117eb576040519150601f19603f3d011682016040523d82523d5f602084013e6117f0565b606091505b5080515f0361181d57604051632bfa23e760e11b81526001600160a01b0386166004820152602401610758565b805181602001fd5b6001600160e01b0319811663f23a6e6160e01b1461167557604051632bfa23e760e11b81526001600160a01b0386166004820152602401610758565b6001600160a01b0384163b15610a855760405163bc197c8160e01b81526001600160a01b0385169063bc197c81906118a59089908990889088908890600401612397565b6020604051808303815f875af19250505080156118df575060408051601f3d908101601f191682019092526118dc9181019061237c565b60015b61190c573d8080156117eb576040519150601f19603f3d011682016040523d82523d5f602084013e6117f0565b6001600160e01b0319811663bc197c8160e01b1461167557604051632bfa23e760e11b81526001600160a01b0386166004820152602401610758565b5f818310611962575f828152602084905260409020611970565b5f8381526020839052604090205b9392505050565b80518251146119a65781518151604051635b05999160e01b815260048101929092526024820152604401610758565b335f5b8351811015611aa8576020818102858101820151908501909101516001600160a01b03881615611a5a575f828152602081815260408083206001600160a01b038c16845290915290205481811015611a34576040516303dee4c560e01b81526001600160a01b038a166004820152602481018290526044810183905260648101849052608401610758565b5f838152602081815260408083206001600160a01b038d16845290915290209082900390555b6001600160a01b03871615611a9e575f828152602081815260408083206001600160a01b038b16845290915281208054839290611a989084906123f4565b90915550505b50506001016119a9565b508251600103611b285760208301515f906020840151909150856001600160a01b0316876001600160a01b0316846001600160a01b03167fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f628585604051611b19929190918252602082015260400190565b60405180910390a4505061140b565b836001600160a01b0316856001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb8686604051611b77929190612407565b60405180910390a45050505050565b80356001600160a01b0381168114611b9c575f80fd5b919050565b5f8060408385031215611bb2575f80fd5b611bbb83611b86565b946020939093013593505050565b6001600160e01b03198116811461076a575f80fd5b5f60208284031215611bee575f80fd5b813561197081611bc9565b634e487b7160e01b5f52604160045260245ffd5b604051601f8201601f1916810167ffffffffffffffff81118282101715611c3657611c36611bf9565b604052919050565b5f67ffffffffffffffff831115611c5757611c57611bf9565b611c6a601f8401601f1916602001611c0d565b9050828152838383011115611c7d575f80fd5b828260208301375f602084830101529392505050565b5f60208284031215611ca3575f80fd5b813567ffffffffffffffff811115611cb9575f80fd5b8201601f81018413611cc9575f80fd5b611cd884823560208401611c3e565b949350505050565b5f81518084525f5b81811015611d0457602081850181015186830182015201611ce8565b505f602082860101526020601f19601f83011685010191505092915050565b602081525f6119706020830184611ce0565b5f60208284031215611d45575f80fd5b5035919050565b5f8060408385031215611d5d575f80fd5b50508035926020909101359150565b5f60208284031215611d7c575f80fd5b61197082611b86565b5f67ffffffffffffffff821115611d9e57611d9e611bf9565b5060051b60200190565b5f82601f830112611db7575f80fd5b81356020611dcc611dc783611d85565b611c0d565b8083825260208201915060208460051b870101935086841115611ded575f80fd5b602086015b84811015611e095780358352918301918301611df2565b509695505050505050565b5f82601f830112611e23575f80fd5b61197083833560208501611c3e565b5f805f805f60a08688031215611e46575f80fd5b611e4f86611b86565b9450611e5d60208701611b86565b9350604086013567ffffffffffffffff80821115611e79575f80fd5b611e8589838a01611da8565b94506060880135915080821115611e9a575f80fd5b611ea689838a01611da8565b93506080880135915080821115611ebb575f80fd5b50611ec888828901611e14565b9150509295509295909350565b5f8060408385031215611ee6575f80fd5b823567ffffffffffffffff80821115611efd575f80fd5b818501915085601f830112611f10575f80fd5b81356020611f20611dc783611d85565b82815260059290921b84018101918181019089841115611f3e575f80fd5b948201945b83861015611f6357611f5486611b86565b82529482019490820190611f43565b96505086013592505080821115611f78575f80fd5b50611f8585828601611da8565b9150509250929050565b5f815180845260208085019450602084015f5b83811015611fbe57815187529582019590820190600101611fa2565b509495945050505050565b602081525f6119706020830184611f8f565b5f8060208385031215611fec575f80fd5b823567ffffffffffffffff80821115612003575f80fd5b818501915085601f830112612016575f80fd5b813581811115612024575f80fd5b8660208260051b8501011115612038575f80fd5b60209290920196919550909350505050565b80358015158114611b9c575f80fd5b5f60208284031215612069575f80fd5b6119708261204a565b5f8060408385031215612083575f80fd5b61208c83611b86565b91506109ad6020840161204a565b5f80604083850312156120ab575f80fd5b823591506109ad60208401611b86565b5f80604083850312156120cc575f80fd5b6120d583611b86565b91506109ad60208401611b86565b5f805f805f60a086880312156120f7575f80fd5b61210086611b86565b945061210e60208701611b86565b93506040860135925060608601359150608086013567ffffffffffffffff811115612137575f80fd5b611ec888828901611e14565b60208082526022908201527f52657175697265732061646d696e206f72206f776e65722070726976696c6567604082015261657360f01b606082015260800190565b600181811c9082168061219957607f821691505b6020821081036121b757634e487b7160e01b5f52602260045260245ffd5b50919050565b634e487b7160e01b5f52601160045260245ffd5b5f600182016121e2576121e26121bd565b5060010190565b80820281158282048414176106b5576106b56121bd565b5f8261221a57634e487b7160e01b5f52601260045260245ffd5b500490565b634e487b7160e01b5f52603260045260245ffd5b601f82111561227757805f5260205f20601f840160051c810160208510156122585750805b601f840160051c820191505b8181101561140b575f8155600101612264565b505050565b815167ffffffffffffffff81111561229657612296611bf9565b6122aa816122a48454612185565b84612233565b602080601f8311600181146122dd575f84156122c65750858301515b5f19600386901b1c1916600185901b178555610a85565b5f85815260208120601f198616915b8281101561230b578886015182559484019460019091019084016122ec565b508582101561232857878501515f19600388901b60f8161c191681555b5050505050600190811b01905550565b6001600160a01b03868116825285166020820152604081018490526060810183905260a0608082018190525f9061237190830184611ce0565b979650505050505050565b5f6020828403121561238c575f80fd5b815161197081611bc9565b6001600160a01b0386811682528516602082015260a0604082018190525f906123c290830186611f8f565b82810360608401526123d48186611f8f565b905082810360808401526123e88185611ce0565b98975050505050505050565b808201808211156106b5576106b56121bd565b604081525f6124196040830185611f8f565b828103602084015261242b8185611f8f565b9594505050505056fea2646970667358221220592e3949f285337895c68fa5fa5227caef12f5e1d27246e48ec4208659d9de4d64736f6c63430008180033