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.20;

import {SolvBTCV2_1} from "./SolvBTCV2_1.sol";
import {BlacklistableUpgradeable} from "./access/BlacklistableUpgradeable.sol";

/**
 * @title Implementation for SolvBTC V3, which is inherited from SolvBTC V2.1 and expanded with 
 * blacklist functionality.
 * @custom:security-contact [email protected]
 */
contract SolvBTCV3 is SolvBTCV2_1, BlacklistableUpgradeable {

    /**
     * @dev Account is not blacklisted.
     */
    error SolvBTCNotBlacklisted(address account);

    /// @notice Emitted when black funds are destroyed.
    event DestroyBlackFunds(address indexed account, uint256 amount);

    /// @notice Destroys black funds from the specified blacklist account.
    function destroyBlackFunds(address account, uint256 amount) external virtual onlyOwner {
        if (!isBlacklisted(account)) {
            revert SolvBTCNotBlacklisted(account);
        }
        super._update(account, address(0), amount);
        emit DestroyBlackFunds(account, amount);
    }

    function _approve(address owner, address spender, uint256 value, bool emitEvent)
        internal
        virtual
        override
        notBlacklisted(spender)
        notBlacklisted(owner)
    {
        super._approve(owner, spender, value, emitEvent);
    }

    function _update(address from, address to, uint256 value)
        internal
        virtual
        override
        notBlacklisted(from)
        notBlacklisted(to)
        notBlacklisted(msg.sender)
    {
        super._update(from, to, value);
    }
}

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

pragma solidity ^0.8.20;

import {IAccessControl} from "@openzeppelin/contracts/access/IAccessControl.sol";
import {ContextUpgradeable} from "../utils/ContextUpgradeable.sol";
import {ERC165Upgradeable} from "../utils/introspection/ERC165Upgradeable.sol";
import {Initializable} from "../proxy/utils/Initializable.sol";

/**
 * @dev Contract module that allows children to implement role-based access
 * control mechanisms. This is a lightweight version that doesn't allow enumerating role
 * members except through off-chain means by accessing the contract event logs. Some
 * applications may benefit from on-chain enumerability, for those cases see
 * {AccessControlEnumerable}.
 *
 * Roles are referred to by their `bytes32` identifier. These should be exposed
 * in the external API and be unique. The best way to achieve this is by
 * using `public constant` hash digests:
 *
 * ```solidity
 * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
 * ```
 *
 * Roles can be used to represent a set of permissions. To restrict access to a
 * function call, use {hasRole}:
 *
 * ```solidity
 * function foo() public {
 *     require(hasRole(MY_ROLE, msg.sender));
 *     ...
 * }
 * ```
 *
 * Roles can be granted and revoked dynamically via the {grantRole} and
 * {revokeRole} functions. Each role has an associated admin role, and only
 * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
 *
 * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
 * that only accounts with this role will be able to grant or revoke other
 * roles. More complex role relationships can be created by using
 * {_setRoleAdmin}.
 *
 * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
 * grant and revoke this role. Extra precautions should be taken to secure
 * accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules}
 * to enforce additional security measures for this role.
 */
abstract contract AccessControlUpgradeable is Initializable, ContextUpgradeable, IAccessControl, ERC165Upgradeable {
    struct RoleData {
        mapping(address account => bool) hasRole;
        bytes32 adminRole;
    }

    bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;


    /// @custom:storage-location erc7201:openzeppelin.storage.AccessControl
    struct AccessControlStorage {
        mapping(bytes32 role => RoleData) _roles;
    }

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.AccessControl")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant AccessControlStorageLocation = 0x02dd7bc7dec4dceedda775e58dd541e08a116c6c53815c0bd028192f7b626800;

    function _getAccessControlStorage() private pure returns (AccessControlStorage storage $) {
        assembly {
            $.slot := AccessControlStorageLocation
        }
    }

    /**
     * @dev Modifier that checks that an account has a specific role. Reverts
     * with an {AccessControlUnauthorizedAccount} error including the required role.
     */
    modifier onlyRole(bytes32 role) {
        _checkRole(role);
        _;
    }

    function __AccessControl_init() internal onlyInitializing {
    }

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

    /**
     * @dev Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) public view virtual returns (bool) {
        AccessControlStorage storage $ = _getAccessControlStorage();
        return $._roles[role].hasRole[account];
    }

    /**
     * @dev Reverts with an {AccessControlUnauthorizedAccount} error if `_msgSender()`
     * is missing `role`. Overriding this function changes the behavior of the {onlyRole} modifier.
     */
    function _checkRole(bytes32 role) internal view virtual {
        _checkRole(role, _msgSender());
    }

    /**
     * @dev Reverts with an {AccessControlUnauthorizedAccount} error if `account`
     * is missing `role`.
     */
    function _checkRole(bytes32 role, address account) internal view virtual {
        if (!hasRole(role, account)) {
            revert AccessControlUnauthorizedAccount(account, role);
        }
    }

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) public view virtual returns (bytes32) {
        AccessControlStorage storage $ = _getAccessControlStorage();
        return $._roles[role].adminRole;
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     *
     * May emit a {RoleGranted} event.
     */
    function grantRole(bytes32 role, address account) public virtual onlyRole(getRoleAdmin(role)) {
        _grantRole(role, account);
    }

    /**
     * @dev Revokes `role` from `account`.
     *
     * If `account` had been granted `role`, emits a {RoleRevoked} event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     *
     * May emit a {RoleRevoked} event.
     */
    function revokeRole(bytes32 role, address account) public virtual onlyRole(getRoleAdmin(role)) {
        _revokeRole(role, account);
    }

    /**
     * @dev Revokes `role` from the calling account.
     *
     * Roles are often managed via {grantRole} and {revokeRole}: this function's
     * purpose is to provide a mechanism for accounts to lose their privileges
     * if they are compromised (such as when a trusted device is misplaced).
     *
     * If the calling account had been revoked `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `callerConfirmation`.
     *
     * May emit a {RoleRevoked} event.
     */
    function renounceRole(bytes32 role, address callerConfirmation) public virtual {
        if (callerConfirmation != _msgSender()) {
            revert AccessControlBadConfirmation();
        }

        _revokeRole(role, callerConfirmation);
    }

    /**
     * @dev Sets `adminRole` as ``role``'s admin role.
     *
     * Emits a {RoleAdminChanged} event.
     */
    function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
        AccessControlStorage storage $ = _getAccessControlStorage();
        bytes32 previousAdminRole = getRoleAdmin(role);
        $._roles[role].adminRole = adminRole;
        emit RoleAdminChanged(role, previousAdminRole, adminRole);
    }

    /**
     * @dev Attempts to grant `role` to `account` and returns a boolean indicating if `role` was granted.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleGranted} event.
     */
    function _grantRole(bytes32 role, address account) internal virtual returns (bool) {
        AccessControlStorage storage $ = _getAccessControlStorage();
        if (!hasRole(role, account)) {
            $._roles[role].hasRole[account] = true;
            emit RoleGranted(role, account, _msgSender());
            return true;
        } else {
            return false;
        }
    }

    /**
     * @dev Attempts to revoke `role` to `account` and returns a boolean indicating if `role` was revoked.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleRevoked} event.
     */
    function _revokeRole(bytes32 role, address account) internal virtual returns (bool) {
        AccessControlStorage storage $ = _getAccessControlStorage();
        if (hasRole(role, account)) {
            $._roles[role].hasRole[account] = false;
            emit RoleRevoked(role, account, _msgSender());
            return true;
        } else {
            return false;
        }
    }
}

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

pragma solidity ^0.8.20;

import {OwnableUpgradeable} from "./OwnableUpgradeable.sol";
import {Initializable} from "../proxy/utils/Initializable.sol";

/**
 * @dev Contract module which provides access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * The initial owner is specified at deployment time in the constructor for `Ownable`. This
 * can later be changed with {transferOwnership} and {acceptOwnership}.
 *
 * This module is used through inheritance. It will make available all functions
 * from parent (Ownable).
 */
abstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {
    /// @custom:storage-location erc7201:openzeppelin.storage.Ownable2Step
    struct Ownable2StepStorage {
        address _pendingOwner;
    }

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Ownable2Step")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant Ownable2StepStorageLocation = 0x237e158222e3e6968b72b9db0d8043aacf074ad9f650f0d1606b4d82ee432c00;

    function _getOwnable2StepStorage() private pure returns (Ownable2StepStorage storage $) {
        assembly {
            $.slot := Ownable2StepStorageLocation
        }
    }

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

    function __Ownable2Step_init() internal onlyInitializing {
    }

    function __Ownable2Step_init_unchained() internal onlyInitializing {
    }
    /**
     * @dev Returns the address of the pending owner.
     */
    function pendingOwner() public view virtual returns (address) {
        Ownable2StepStorage storage $ = _getOwnable2StepStorage();
        return $._pendingOwner;
    }

    /**
     * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual override onlyOwner {
        Ownable2StepStorage storage $ = _getOwnable2StepStorage();
        $._pendingOwner = newOwner;
        emit OwnershipTransferStarted(owner(), newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual override {
        Ownable2StepStorage storage $ = _getOwnable2StepStorage();
        delete $._pendingOwner;
        super._transferOwnership(newOwner);
    }

    /**
     * @dev The new owner accepts the ownership transfer.
     */
    function acceptOwnership() public virtual {
        address sender = _msgSender();
        if (pendingOwner() != sender) {
            revert OwnableUnauthorizedAccount(sender);
        }
        _transferOwnership(sender);
    }
}

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

pragma solidity ^0.8.20;

import {ContextUpgradeable} from "../utils/ContextUpgradeable.sol";
import {Initializable} from "../proxy/utils/Initializable.sol";

/**
 * @dev Contract module which provides a basic access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * 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 OwnableUpgradeable is Initializable, ContextUpgradeable {
    /// @custom:storage-location erc7201:openzeppelin.storage.Ownable
    struct OwnableStorage {
        address _owner;
    }

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Ownable")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant OwnableStorageLocation = 0x9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300;

    function _getOwnableStorage() private pure returns (OwnableStorage storage $) {
        assembly {
            $.slot := OwnableStorageLocation
        }
    }

    /**
     * @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.
     */
    function __Ownable_init(address initialOwner) internal onlyInitializing {
        __Ownable_init_unchained(initialOwner);
    }

    function __Ownable_init_unchained(address initialOwner) internal onlyInitializing {
        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) {
        OwnableStorage storage $ = _getOwnableStorage();
        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 {
        OwnableStorage storage $ = _getOwnableStorage();
        address oldOwner = $._owner;
        $._owner = newOwner;
        emit OwnershipTransferred(oldOwner, newOwner);
    }
}

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

pragma solidity ^0.8.20;

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

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Initializable")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant INITIALIZABLE_STORAGE = 0xf0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00;

    /**
     * @dev The contract is already initialized.
     */
    error InvalidInitialization();

    /**
     * @dev The contract is not initializing.
     */
    error NotInitializing();

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

    /**
     * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
     * `onlyInitializing` functions can be used to initialize parent contracts.
     *
     * Similar to `reinitializer(1)`, except that in the context of a constructor an `initializer` may be invoked any
     * number of times. This behavior in the constructor can be useful during testing and is not expected to be used in
     * production.
     *
     * Emits an {Initialized} event.
     */
    modifier initializer() {
        // solhint-disable-next-line var-name-mixedcase
        InitializableStorage storage $ = _getInitializableStorage();

        // Cache values to avoid duplicated sloads
        bool isTopLevelCall = !$._initializing;
        uint64 initialized = $._initialized;

        // Allowed calls:
        // - initialSetup: the contract is not in the initializing state and no previous version was
        //                 initialized
        // - construction: the contract is initialized at version 1 (no reininitialization) and the
        //                 current contract is just being deployed
        bool initialSetup = initialized == 0 && isTopLevelCall;
        bool construction = initialized == 1 && address(this).code.length == 0;

        if (!initialSetup && !construction) {
            revert InvalidInitialization();
        }
        $._initialized = 1;
        if (isTopLevelCall) {
            $._initializing = true;
        }
        _;
        if (isTopLevelCall) {
            $._initializing = false;
            emit Initialized(1);
        }
    }

    /**
     * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
     * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
     * used to initialize parent contracts.
     *
     * A reinitializer may be used after the original initialization step. This is essential to configure modules that
     * are added through upgrades and that require initialization.
     *
     * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
     * cannot be nested. If one is invoked in the context of another, execution will revert.
     *
     * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
     * a contract, executing them in the right order is up to the developer or operator.
     *
     * WARNING: Setting the version to 2**64 - 1 will prevent any future reinitialization.
     *
     * Emits an {Initialized} event.
     */
    modifier reinitializer(uint64 version) {
        // solhint-disable-next-line var-name-mixedcase
        InitializableStorage storage $ = _getInitializableStorage();

        if ($._initializing || $._initialized >= version) {
            revert InvalidInitialization();
        }
        $._initialized = version;
        $._initializing = true;
        _;
        $._initializing = false;
        emit Initialized(version);
    }

    /**
     * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
     * {initializer} and {reinitializer} modifiers, directly or indirectly.
     */
    modifier onlyInitializing() {
        _checkInitializing();
        _;
    }

    /**
     * @dev Reverts if the contract is not in an initializing state. See {onlyInitializing}.
     */
    function _checkInitializing() internal view virtual {
        if (!_isInitializing()) {
            revert NotInitializing();
        }
    }

    /**
     * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
     * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
     * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
     * through proxies.
     *
     * Emits an {Initialized} event the first time it is successfully executed.
     */
    function _disableInitializers() internal virtual {
        // solhint-disable-next-line var-name-mixedcase
        InitializableStorage storage $ = _getInitializableStorage();

        if ($._initializing) {
            revert InvalidInitialization();
        }
        if ($._initialized != type(uint64).max) {
            $._initialized = type(uint64).max;
            emit Initialized(type(uint64).max);
        }
    }

    /**
     * @dev Returns the highest version that has been initialized. See {reinitializer}.
     */
    function _getInitializedVersion() internal view returns (uint64) {
        return _getInitializableStorage()._initialized;
    }

    /**
     * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
     */
    function _isInitializing() internal view returns (bool) {
        return _getInitializableStorage()._initializing;
    }

    /**
     * @dev Returns a pointer to the storage namespace.
     */
    // solhint-disable-next-line var-name-mixedcase
    function _getInitializableStorage() private pure returns (InitializableStorage storage $) {
        assembly {
            $.slot := INITIALIZABLE_STORAGE
        }
    }
}

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

pragma solidity ^0.8.20;

import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol";
import {ContextUpgradeable} from "../../utils/ContextUpgradeable.sol";
import {IERC20Errors} from "@openzeppelin/contracts/interfaces/draft-IERC6093.sol";
import {Initializable} from "../../proxy/utils/Initializable.sol";

/**
 * @dev Implementation of the {IERC20} interface.
 *
 * This implementation is agnostic to the way tokens are created. This means
 * that a supply mechanism has to be added in a derived contract using {_mint}.
 *
 * TIP: For a detailed writeup see our guide
 * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How
 * to implement supply mechanisms].
 *
 * The default value of {decimals} is 18. To change this, you should override
 * this function so it returns a different value.
 *
 * We have followed general OpenZeppelin Contracts guidelines: functions revert
 * instead returning `false` on failure. This behavior is nonetheless
 * conventional and does not conflict with the expectations of ERC20
 * applications.
 *
 * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
 * This allows applications to reconstruct the allowance for all accounts just
 * by listening to said events. Other implementations of the EIP may not emit
 * these events, as it isn't required by the specification.
 */
abstract contract ERC20Upgradeable is Initializable, ContextUpgradeable, IERC20, IERC20Metadata, IERC20Errors {
    /// @custom:storage-location erc7201:openzeppelin.storage.ERC20
    struct ERC20Storage {
        mapping(address account => uint256) _balances;

        mapping(address account => mapping(address spender => uint256)) _allowances;

        uint256 _totalSupply;

        string _name;
        string _symbol;
    }

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ERC20")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant ERC20StorageLocation = 0x52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace00;

    function _getERC20Storage() private pure returns (ERC20Storage storage $) {
        assembly {
            $.slot := ERC20StorageLocation
        }
    }

    /**
     * @dev Sets the values for {name} and {symbol}.
     *
     * All two of these values are immutable: they can only be set once during
     * construction.
     */
    function __ERC20_init(string memory name_, string memory symbol_) internal onlyInitializing {
        __ERC20_init_unchained(name_, symbol_);
    }

    function __ERC20_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
        ERC20Storage storage $ = _getERC20Storage();
        $._name = name_;
        $._symbol = symbol_;
    }

    /**
     * @dev Returns the name of the token.
     */
    function name() public view virtual returns (string memory) {
        ERC20Storage storage $ = _getERC20Storage();
        return $._name;
    }

    /**
     * @dev Returns the symbol of the token, usually a shorter version of the
     * name.
     */
    function symbol() public view virtual returns (string memory) {
        ERC20Storage storage $ = _getERC20Storage();
        return $._symbol;
    }

    /**
     * @dev Returns the number of decimals used to get its user representation.
     * For example, if `decimals` equals `2`, a balance of `505` tokens should
     * be displayed to a user as `5.05` (`505 / 10 ** 2`).
     *
     * Tokens usually opt for a value of 18, imitating the relationship between
     * Ether and Wei. This is the default value returned by this function, unless
     * it's overridden.
     *
     * NOTE: This information is only used for _display_ purposes: it in
     * no way affects any of the arithmetic of the contract, including
     * {IERC20-balanceOf} and {IERC20-transfer}.
     */
    function decimals() public view virtual returns (uint8) {
        return 18;
    }

    /**
     * @dev See {IERC20-totalSupply}.
     */
    function totalSupply() public view virtual returns (uint256) {
        ERC20Storage storage $ = _getERC20Storage();
        return $._totalSupply;
    }

    /**
     * @dev See {IERC20-balanceOf}.
     */
    function balanceOf(address account) public view virtual returns (uint256) {
        ERC20Storage storage $ = _getERC20Storage();
        return $._balances[account];
    }

    /**
     * @dev See {IERC20-transfer}.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - the caller must have a balance of at least `value`.
     */
    function transfer(address to, uint256 value) public virtual returns (bool) {
        address owner = _msgSender();
        _transfer(owner, to, value);
        return true;
    }

    /**
     * @dev See {IERC20-allowance}.
     */
    function allowance(address owner, address spender) public view virtual returns (uint256) {
        ERC20Storage storage $ = _getERC20Storage();
        return $._allowances[owner][spender];
    }

    /**
     * @dev See {IERC20-approve}.
     *
     * NOTE: If `value` is the maximum `uint256`, the allowance is not updated on
     * `transferFrom`. This is semantically equivalent to an infinite approval.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     */
    function approve(address spender, uint256 value) public virtual returns (bool) {
        address owner = _msgSender();
        _approve(owner, spender, value);
        return true;
    }

    /**
     * @dev See {IERC20-transferFrom}.
     *
     * Emits an {Approval} event indicating the updated allowance. This is not
     * required by the EIP. See the note at the beginning of {ERC20}.
     *
     * NOTE: Does not update the allowance if the current allowance
     * is the maximum `uint256`.
     *
     * Requirements:
     *
     * - `from` and `to` cannot be the zero address.
     * - `from` must have a balance of at least `value`.
     * - the caller must have allowance for ``from``'s tokens of at least
     * `value`.
     */
    function transferFrom(address from, address to, uint256 value) public virtual returns (bool) {
        address spender = _msgSender();
        _spendAllowance(from, spender, value);
        _transfer(from, to, value);
        return true;
    }

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to`.
     *
     * This internal function is equivalent to {transfer}, and can be used to
     * e.g. implement automatic token fees, slashing mechanisms, etc.
     *
     * Emits a {Transfer} event.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead.
     */
    function _transfer(address from, address to, uint256 value) internal {
        if (from == address(0)) {
            revert ERC20InvalidSender(address(0));
        }
        if (to == address(0)) {
            revert ERC20InvalidReceiver(address(0));
        }
        _update(from, to, value);
    }

    /**
     * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from`
     * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding
     * this function.
     *
     * Emits a {Transfer} event.
     */
    function _update(address from, address to, uint256 value) internal virtual {
        ERC20Storage storage $ = _getERC20Storage();
        if (from == address(0)) {
            // Overflow check required: The rest of the code assumes that totalSupply never overflows
            $._totalSupply += value;
        } else {
            uint256 fromBalance = $._balances[from];
            if (fromBalance < value) {
                revert ERC20InsufficientBalance(from, fromBalance, value);
            }
            unchecked {
                // Overflow not possible: value <= fromBalance <= totalSupply.
                $._balances[from] = fromBalance - value;
            }
        }

        if (to == address(0)) {
            unchecked {
                // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply.
                $._totalSupply -= value;
            }
        } else {
            unchecked {
                // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256.
                $._balances[to] += value;
            }
        }

        emit Transfer(from, to, value);
    }

    /**
     * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0).
     * Relies on the `_update` mechanism
     *
     * Emits a {Transfer} event with `from` set to the zero address.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead.
     */
    function _mint(address account, uint256 value) internal {
        if (account == address(0)) {
            revert ERC20InvalidReceiver(address(0));
        }
        _update(address(0), account, value);
    }

    /**
     * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply.
     * Relies on the `_update` mechanism.
     *
     * Emits a {Transfer} event with `to` set to the zero address.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead
     */
    function _burn(address account, uint256 value) internal {
        if (account == address(0)) {
            revert ERC20InvalidSender(address(0));
        }
        _update(account, address(0), value);
    }

    /**
     * @dev Sets `value` as the allowance of `spender` over the `owner` s tokens.
     *
     * This internal function is equivalent to `approve`, and can be used to
     * e.g. set automatic allowances for certain subsystems, etc.
     *
     * Emits an {Approval} event.
     *
     * Requirements:
     *
     * - `owner` cannot be the zero address.
     * - `spender` cannot be the zero address.
     *
     * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument.
     */
    function _approve(address owner, address spender, uint256 value) internal {
        _approve(owner, spender, value, true);
    }

    /**
     * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event.
     *
     * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by
     * `_spendAllowance` during the `transferFrom` operation set the flag to false. This saves gas by not emitting any
     * `Approval` event during `transferFrom` operations.
     *
     * Anyone who wishes to continue emitting `Approval` events on the`transferFrom` operation can force the flag to
     * true using the following override:
     * ```
     * function _approve(address owner, address spender, uint256 value, bool) internal virtual override {
     *     super._approve(owner, spender, value, true);
     * }
     * ```
     *
     * Requirements are the same as {_approve}.
     */
    function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual {
        ERC20Storage storage $ = _getERC20Storage();
        if (owner == address(0)) {
            revert ERC20InvalidApprover(address(0));
        }
        if (spender == address(0)) {
            revert ERC20InvalidSpender(address(0));
        }
        $._allowances[owner][spender] = value;
        if (emitEvent) {
            emit Approval(owner, spender, value);
        }
    }

    /**
     * @dev Updates `owner` s allowance for `spender` based on spent `value`.
     *
     * Does not update the allowance value in case of infinite allowance.
     * Revert if not enough allowance is available.
     *
     * Does not emit an {Approval} event.
     */
    function _spendAllowance(address owner, address spender, uint256 value) internal virtual {
        uint256 currentAllowance = allowance(owner, spender);
        if (currentAllowance != type(uint256).max) {
            if (currentAllowance < value) {
                revert ERC20InsufficientAllowance(spender, currentAllowance, value);
            }
            unchecked {
                _approve(owner, spender, currentAllowance - value, false);
            }
        }
    }
}

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

pragma solidity ^0.8.20;
import {Initializable} from "../proxy/utils/Initializable.sol";

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

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

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

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

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

pragma solidity ^0.8.20;
import {Initializable} from "../proxy/utils/Initializable.sol";

/**
 * @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 ReentrancyGuardUpgradeable is Initializable {
    // 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;

    /// @custom:storage-location erc7201:openzeppelin.storage.ReentrancyGuard
    struct ReentrancyGuardStorage {
        uint256 _status;
    }

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ReentrancyGuard")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant ReentrancyGuardStorageLocation = 0x9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f00;

    function _getReentrancyGuardStorage() private pure returns (ReentrancyGuardStorage storage $) {
        assembly {
            $.slot := ReentrancyGuardStorageLocation
        }
    }

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

    function __ReentrancyGuard_init() internal onlyInitializing {
        __ReentrancyGuard_init_unchained();
    }

    function __ReentrancyGuard_init_unchained() internal onlyInitializing {
        ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage();
        $._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 {
        ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage();
        // 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 {
        ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage();
        // 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) {
        ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage();
        return $._status == ENTERED;
    }
}

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

pragma solidity ^0.8.20;

import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
import {Initializable} from "../../proxy/utils/Initializable.sol";

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

    function __ERC165_init_unchained() internal onlyInitializing {
    }
    /**
     * @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) (access/IAccessControl.sol)

pragma solidity ^0.8.20;

/**
 * @dev External interface of AccessControl declared to support ERC165 detection.
 */
interface IAccessControl {
    /**
     * @dev The `account` is missing a role.
     */
    error AccessControlUnauthorizedAccount(address account, bytes32 neededRole);

    /**
     * @dev The caller of a function is not the expected one.
     *
     * NOTE: Don't confuse with {AccessControlUnauthorizedAccount}.
     */
    error AccessControlBadConfirmation();

    /**
     * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
     *
     * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
     * {RoleAdminChanged} not being emitted signaling this.
     */
    event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);

    /**
     * @dev Emitted when `account` is granted `role`.
     *
     * `sender` is the account that originated the contract call, an admin role
     * bearer except when using {AccessControl-_setupRole}.
     */
    event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Emitted when `account` is revoked `role`.
     *
     * `sender` is the account that originated the contract call:
     *   - if using `revokeRole`, it is the admin role bearer
     *   - if using `renounceRole`, it is the role bearer (i.e. `account`)
     */
    event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) external view returns (bool);

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {AccessControl-_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) external view returns (bytes32);

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function grantRole(bytes32 role, address account) external;

    /**
     * @dev Revokes `role` from `account`.
     *
     * If `account` had been granted `role`, emits a {RoleRevoked} event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function revokeRole(bytes32 role, address account) external;

    /**
     * @dev Revokes `role` from the calling account.
     *
     * Roles are often managed via {grantRole} and {revokeRole}: this function's
     * purpose is to provide a mechanism for accounts to lose their privileges
     * if they are compromised (such as when a trusted device is misplaced).
     *
     * If the calling account had been granted `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `callerConfirmation`.
     */
    function renounceRole(bytes32 role, address callerConfirmation) external;
}

// 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) (token/ERC20/IERC20.sol)

pragma solidity ^0.8.20;

/**
 * @dev Interface of the ERC20 standard as defined in the EIP.
 */
interface IERC20 {
    /**
     * @dev Emitted when `value` tokens are moved from one account (`from`) to
     * another (`to`).
     *
     * Note that `value` may be zero.
     */
    event Transfer(address indexed from, address indexed to, uint256 value);

    /**
     * @dev Emitted when the allowance of a `spender` for an `owner` is set by
     * a call to {approve}. `value` is the new allowance.
     */
    event Approval(address indexed owner, address indexed spender, uint256 value);

    /**
     * @dev Returns the value of tokens in existence.
     */
    function totalSupply() external view returns (uint256);

    /**
     * @dev Returns the value of tokens owned by `account`.
     */
    function balanceOf(address account) external view returns (uint256);

    /**
     * @dev Moves a `value` amount of tokens from the caller's account to `to`.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transfer(address to, uint256 value) external returns (bool);

    /**
     * @dev Returns the remaining number of tokens that `spender` will be
     * allowed to spend on behalf of `owner` through {transferFrom}. This is
     * zero by default.
     *
     * This value changes when {approve} or {transferFrom} are called.
     */
    function allowance(address owner, address spender) external view returns (uint256);

    /**
     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
     * caller's tokens.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * IMPORTANT: Beware that changing an allowance with this method brings the risk
     * that someone may use both the old and the new allowance by unfortunate
     * transaction ordering. One possible solution to mitigate this race
     * condition is to first reduce the spender's allowance to 0 and set the
     * desired value afterwards:
     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
     *
     * Emits an {Approval} event.
     */
    function approve(address spender, uint256 value) external returns (bool);

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to` using the
     * allowance mechanism. `value` is then deducted from the caller's
     * allowance.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transferFrom(address from, address to, uint256 value) external returns (bool);
}

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

pragma solidity ^0.8.20;

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

/**
 * @dev Interface for the optional metadata functions from the ERC20 standard.
 */
interface IERC20Metadata is IERC20 {
    /**
     * @dev Returns the name of the token.
     */
    function name() external view returns (string memory);

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

    /**
     * @dev Returns the decimals places of the token.
     */
    function decimals() external view returns (uint8);
}

// 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

pragma solidity 0.8.20;

import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
import {IERC721Receiver} from "./external/IERC721Receiver.sol";
import {IERC3525Receiver} from "./external/IERC3525Receiver.sol";

/**
 * @title Interface for SolvBTC.
 * @custom:security-contact [email protected]
 */
interface ISolvBTC is IERC20, IERC721Receiver, IERC3525Receiver, IERC165 {

    error ERC721NotReceivable(address token);
    error ERC3525NotReceivable(address token);

    function mint(address account_, uint256 value_) external;
    function burn(address account_, uint256 value_) external;
    function burn(uint256 value_) external;
}

// SPDX-License-Identifier: MIT

pragma solidity 0.8.20;

import {ERC20Upgradeable} from "@openzeppelin/contracts-upgradeable/token/ERC20/ERC20Upgradeable.sol";
import {ReentrancyGuardUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/ReentrancyGuardUpgradeable.sol";
import {Ownable2StepUpgradeable} from "@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol";
import {AccessControlUpgradeable} from "@openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol";
import {ISolvBTC, IERC721Receiver, IERC3525Receiver, IERC165} from "./ISolvBTC.sol";

/**
 * @title Implementation for SolvBTC V2.1, which is inherited from SolvBTC V2.
 * @dev This version is upgraded from SolvBTC V2 with the removal of deprecated variables and functions. 
 * @custom:security-contact [email protected]
 */
contract SolvBTCV2_1 is ISolvBTC, ERC20Upgradeable, ReentrancyGuardUpgradeable, Ownable2StepUpgradeable, AccessControlUpgradeable {

    /// @custom:storage-location erc7201:solv.storage.SolvBTC
    // struct SolvBTCStorage {
    //     address _solvBTCMultiAssetPool;
    // }

    /**
     * @dev Deprecated variables inherited from SolvBTC V1, the values of which have been cleared in V2.
     * Thus the declaration of these variables would be removed from V2.1.
     */
    // address public wrappedSftAddress;
    // uint256 public wrappedSftSlot;
    // address public navOracle;
    // uint256 public holdingValueSftId;
    // uint256[] internal _holdingEmptySftIds;

    // keccak256(abi.encode(uint256(keccak256("solv.storage.SolvBTC")) - 1)) & ~bytes32(uint256(0xff))
    // bytes32 private constant SolvBTCStorageLocation = 0x25351088c72db31d4a47cbdabb12f8d9c124b300211236164ae2941317058400;

    /// @notice `SOLVBTC_MINTER` role is allowed to mint SolvBTC tokens, as well as to burn SolvBTC tokens held by itself.
    bytes32 public constant SOLVBTC_MINTER_ROLE = keccak256(abi.encodePacked("SOLVBTC_MINTER"));

    /// @notice `SOLVBTC_POOL_BURNER` role is allowed to burn SolvBTC tokens from other accounts only when necessary.
    bytes32 public constant SOLVBTC_POOL_BURNER_ROLE = keccak256(abi.encodePacked("SOLVBTC_POOL_BURNER"));

    // event SetSolvBTCMultiAssetPool(address indexed solvBTCMultiAssetPool);

    /**
     * @dev Mint or burn zero value is not allowed.
     */
    error SolvBTCZeroValueNotAllowed();

    /// @custom:oz-upgrades-unsafe-allow constructor
    constructor() {
        _disableInitializers();
    }

    function initialize(string memory name_, string memory symbol_, address owner_) external virtual initializer {
        ERC20Upgradeable.__ERC20_init(name_, symbol_);
        ReentrancyGuardUpgradeable.__ReentrancyGuard_init();

        _transferOwnership(owner_);
        _grantRole(DEFAULT_ADMIN_ROLE, owner_);
    }

    /**
     * @dev Deprecated function inherited from SolvBTC V2, since the values of deprecated variables have been
     * cleared, this function would be deleted from V2.1.
     */
    // function initializeV2(address solvBTCMultiAssetPool_) external virtual reinitializer(2) {
    //     require(msg.sender == 0x55C09707Fd7aFD670e82A62FaeE312903940013E, "SolvBTC: only owner");
    //     _transferOwnership(msg.sender);
    //     _grantRole(DEFAULT_ADMIN_ROLE, msg.sender);

    //     _setSolvBTCMultiAssetPool(solvBTCMultiAssetPool_);

    //     if (holdingValueSftId != 0) {
    //         ERC3525TransferHelper.doTransferOut(wrappedSftAddress, solvBTCMultiAssetPool(), holdingValueSftId);
    //     }
    //     wrappedSftAddress = address(0);
    //     wrappedSftSlot = 0;
    //     navOracle = address(0);
    //     holdingValueSftId = 0;
    // }

    function onERC3525Received(
        address, /* operator_ */
        uint256 /* fromSftId_ */,
        uint256 /* sftId_ */,
        uint256 /* value_ */,
        bytes calldata /* data_ */
    ) external virtual override returns (bytes4) {
        revert ERC3525NotReceivable(msg.sender);
    }

    function onERC721Received(
        address /* operator_ */, 
        address /* from_ */, 
        uint256 /* sftId_ */, 
        bytes calldata /* data_ */ 
    ) external virtual override returns (bytes4) {
        revert ERC721NotReceivable(msg.sender);
    }

    function mint(address account_, uint256 value_) external virtual nonReentrant onlyRole(SOLVBTC_MINTER_ROLE) {
        if (value_ == 0) {
            revert SolvBTCZeroValueNotAllowed();
        }
        _mint(account_, value_);
    }

    function burn(uint256 value_) external virtual nonReentrant onlyRole(SOLVBTC_MINTER_ROLE) {
        if (value_ == 0) {
            revert SolvBTCZeroValueNotAllowed();
        }
        _burn(msg.sender, value_);
    }

    function burn(address account_, uint256 value_) external virtual nonReentrant onlyRole(SOLVBTC_POOL_BURNER_ROLE) {
        if (value_ == 0) {
            revert SolvBTCZeroValueNotAllowed();
        }
        _burn(account_, value_);
    }

    function supportsInterface(bytes4 interfaceId) public view virtual override(AccessControlUpgradeable, IERC165) returns (bool) {
        return 
            interfaceId == type(IERC3525Receiver).interfaceId || 
            interfaceId == type(IERC721Receiver).interfaceId || 
            super.supportsInterface(interfaceId);
    }

    /**
     * @dev Deprecated function inherited from SolvBTC V2, since the empty sft ids would be removed 
     * before upgrading to V2.1.
     */
    // function sweepEmptySftIds(address sft_, uint256 sweepAmount_) external virtual {
    //     uint256 length = _holdingEmptySftIds.length;
    //     for (uint256 i = 0; i < length && i < sweepAmount_; i++) {
    //         uint256 lastSftId = _holdingEmptySftIds[_holdingEmptySftIds.length - 1];
    //         ERC3525TransferHelper.doTransferOut(sft_, 0x000000000000000000000000000000000000dEaD, lastSftId);
    //         _holdingEmptySftIds.pop();
    //     }
    //     if (_holdingEmptySftIds.length == 0) {
    //         delete _holdingEmptySftIds;
    //     }
    // }

    /**
     * @dev The following functions are deprecated in SolvBTC V2.1, since the value of `solvBTCMultiAssetPool`
     * will not be used in V2.1.
     */
    // function _getSolvBTCStorage() private pure returns (SolvBTCStorage storage $) {
    //     assembly {
    //         $.slot := SolvBTCStorageLocation
    //     }
    // }
    // function solvBTCMultiAssetPool() public view virtual returns (address) {
    //     SolvBTCStorage storage $ = _getSolvBTCStorage();
    //     return $._solvBTCMultiAssetPool;
    // }
    // function setSolvBTCMultiAssetPool(address solvBTCMultiAssetPool_) external virtual onlyOwner {
    //     _setSolvBTCMultiAssetPool(solvBTCMultiAssetPool_);
    // }
    // function _setSolvBTCMultiAssetPool(address solvBTCMultiAssetPool_) internal virtual {
    //     SolvBTCStorage storage $ = _getSolvBTCStorage();
    //     $._solvBTCMultiAssetPool = solvBTCMultiAssetPool_;
    //     emit SetSolvBTCMultiAssetPool(solvBTCMultiAssetPool_);
    // }

    /** @dev Use EIP-7201 for storage management instead. */
    // uint256[45] private __gap;
}

// SPDX-License-Identifier: MIT

pragma solidity 0.8.20;

import {Ownable2StepUpgradeable} from "@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol";

/**
 * @title Blacklistable
 * @dev Allows accounts to be blacklisted by a "blacklist manager" role
 * @custom:security-contact [email protected]
 */
abstract contract BlacklistableUpgradeable is Ownable2StepUpgradeable {

    /// @custom:storage-location erc7201:solv.storage.Blacklistable
    struct BlacklistableStorage {
        mapping(address => bool) _blacklisted;
        address _blacklistManager;
    }

    // keccak256(abi.encode(uint256(keccak256("solv.storage.Blacklistable")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant SolvBTCStorageLocation = 0x37055a6a5ad221b3685065a6f80bdaf8b5de26b2f60e82c3fbc16e3374b00c00;

    /**
     * @dev Operates by non blacklist manager.
     */
    error BlacklistableNotManager(address account);

    /**
     * @dev Account is blacklisted.
     */
    error BlacklistableBlacklistedAccount(address account);

    /**
     * @dev Zero address is not allowed.
     */
    error BlacklistableZeroAddressNotAllowed();

    event BlacklistAdded(address indexed account_);
    event BlacklistRemoved(address indexed account_);
    event BlacklistManagerChanged(address indexed newBlacklistManager);

    /**
     * @dev Throws if called by any account other than the blacklist manager.
     */
    modifier onlyBlacklistManager() {
        if (msg.sender != blacklistManager()) {
            revert BlacklistableNotManager(msg.sender);
        }
        _;
    }

    /**
     * @dev Throws if argument account is blacklisted.
     * @param account_ The address to check.
     */
    modifier notBlacklisted(address account_) {
        if (isBlacklisted(account_)) {
            revert BlacklistableBlacklistedAccount(account_);
        }
        _;
    }

    /**
     * @notice Adds account to blacklist.
     * @param account_ The address to blacklist.
     */
    function addBlacklist(address account_) external onlyBlacklistManager {
        _addBlacklist(account_);
    }

    /**
     * @notice Adds multiple accounts to the blacklist.
     * @param accounts_ The addresses to blacklist.
     */
    function addBlacklistBatch(address[] calldata accounts_) external onlyBlacklistManager {
        for (uint256 i; i < accounts_.length; ) {
            _addBlacklist(accounts_[i]);
            unchecked { ++i; }
        }
    }

    /**
     * @notice Removes account from blacklist.
     * @param account_ The address to remove from the blacklist.
     */
    function removeBlacklist(address account_) external onlyBlacklistManager {
        _removeBlacklist(account_);
    }

    /**
     * @notice Removes multiple accounts from the blacklist.
     * @param accounts_ The addresses to remove from the blacklist.
     */
    function removeBlacklistBatch(address[] calldata accounts_) external onlyBlacklistManager {
        for (uint256 i; i < accounts_.length; ) {
            _removeBlacklist(accounts_[i]);
            unchecked { ++i; }
        }
    }

    /**
     * @notice Updates the blacklist manager address.
     * @param newBlacklistManager_ The address of the new blacklist manager.
     */
    function updateBlacklistManager(address newBlacklistManager_) external onlyOwner {
        if (newBlacklistManager_ == address(0)) {
            revert BlacklistableZeroAddressNotAllowed();
        }
        BlacklistableStorage storage $ = _getBlacklistableStorage();
        $._blacklistManager = newBlacklistManager_;
        emit BlacklistManagerChanged(newBlacklistManager_);
    }

    /**
     * @notice Checks if account is blacklisted.
     * @param account_ The address to check.
     * @return True if the account is blacklisted, false if the account is not blacklisted.
     */
    function isBlacklisted(address account_) public view returns (bool) {
        BlacklistableStorage storage $ = _getBlacklistableStorage();
        return $._blacklisted[account_];
    }

    /**
     * @notice Get the address of the blacklist manager.
     */
    function blacklistManager() public view returns (address) {
        BlacklistableStorage storage $ = _getBlacklistableStorage();
        return $._blacklistManager;
    }

    function _getBlacklistableStorage() private pure returns (BlacklistableStorage storage $) {
        assembly {
            $.slot := SolvBTCStorageLocation
        }
    }

    /**
     * @dev Helper method that blacklists an account.
     * @param account_ The address to blacklist.
     */
    function _addBlacklist(address account_) private {
        if (account_ == address(0)) {
            revert BlacklistableZeroAddressNotAllowed();
        }
        BlacklistableStorage storage $ = _getBlacklistableStorage();
        $._blacklisted[account_] = true;
        emit BlacklistAdded(account_);
    }

    /**
     * @dev Helper method that unblacklists an account.
     * @param account_ The address to unblacklist.
     */
    function _removeBlacklist(address account_) private {
        BlacklistableStorage storage $ = _getBlacklistableStorage();
        $._blacklisted[account_] = false;
        emit BlacklistRemoved(account_);
    }
}

// SPDX-License-Identifier: MIT

pragma solidity 0.8.20;

interface IERC3525Receiver {
    function onERC3525Received(address operator, uint256 fromTokenId, uint256 toTokenId, uint256 value, bytes calldata data) external returns (bytes4);
}

// SPDX-License-Identifier: MIT

pragma solidity 0.8.20;

interface IERC721Receiver {
    function onERC721Received(address operator, address from, uint256 tokenId, bytes calldata data) external returns (bytes4);
}

{
  "evmVersion": "paris",
  "libraries": {},
  "metadata": {
    "bytecodeHash": "ipfs",
    "useLiteralContent": true
  },
  "optimizer": {
    "enabled": true,
    "runs": 1
  },
  "remappings": [],
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[],"name":"AccessControlBadConfirmation","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"bytes32","name":"neededRole","type":"bytes32"}],"name":"AccessControlUnauthorizedAccount","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"BlacklistableBlacklistedAccount","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"BlacklistableNotManager","type":"error"},{"inputs":[],"name":"BlacklistableZeroAddressNotAllowed","type":"error"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"allowance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientAllowance","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint256","name":"balance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientBalance","type":"error"},{"inputs":[{"internalType":"address","name":"approver","type":"address"}],"name":"ERC20InvalidApprover","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC20InvalidReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"ERC20InvalidSender","type":"error"},{"inputs":[{"internalType":"address","name":"spender","type":"address"}],"name":"ERC20InvalidSpender","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"ERC3525NotReceivable","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"ERC721NotReceivable","type":"error"},{"inputs":[],"name":"InvalidInitialization","type":"error"},{"inputs":[],"name":"NotInitializing","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"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"SolvBTCNotBlacklisted","type":"error"},{"inputs":[],"name":"SolvBTCZeroValueNotAllowed","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account_","type":"address"}],"name":"BlacklistAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"newBlacklistManager","type":"address"}],"name":"BlacklistManagerChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account_","type":"address"}],"name":"BlacklistRemoved","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"DestroyBlackFunds","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"version","type":"uint64"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SOLVBTC_MINTER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SOLVBTC_POOL_BURNER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account_","type":"address"}],"name":"addBlacklist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts_","type":"address[]"}],"name":"addBlacklistBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"blacklistManager","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"value_","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account_","type":"address"},{"internalType":"uint256","name":"value_","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"destroyBlackFunds","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"},{"internalType":"address","name":"owner_","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account_","type":"address"}],"name":"isBlacklisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account_","type":"address"},{"internalType":"uint256","name":"value_","type":"uint256"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC3525Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC721Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account_","type":"address"}],"name":"removeBlacklist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts_","type":"address[]"}],"name":"removeBlacklistBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"callerConfirmation","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newBlacklistManager_","type":"address"}],"name":"updateBlacklistManager","outputs":[],"stateMutability":"nonpayable","type":"function"}]

608060405234801561001057600080fd5b5061001961001e565b6100d0565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00805468010000000000000000900460ff161561006e5760405163f92ee8a960e01b815260040160405180910390fd5b80546001600160401b03908116146100cd5780546001600160401b0319166001600160401b0390811782556040519081527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b50565b611ce9806100df6000396000f3fe608060405234801561001057600080fd5b50600436106101b65760003560e01c80629ce20b146101bb57806301ffc9a7146101ec57806306fdde031461020f578063077f224a14610224578063095ea7b314610239578063150b7a021461024c57806318160ddd1461025f57806323b872dd14610275578063248a9ca3146102885780632f2ff15d1461029b578063313ce567146102ae57806336568abe146102bd57806338b20518146102d057806340c10f19146102e357806342966c68146102f657806353d51e641461030957806370a082311461031c578063715018a61461032f57806379ba5097146103375780638da5cb5b1461033f57806391d148541461035457806395d89b411461036757806396c495971461036f5780639999416f146103775780639cfe42da1461038a5780639dc29fac1461039d578063a217fddf146103b0578063a49630b2146103b8578063a9059cbb146103c0578063d547741f146103d3578063d9dbf657146103e6578063dd62ed3e146103ee578063e30c397814610401578063eb91e65114610409578063ef2af9221461041c578063f2fde38b1461042f578063fe575a8714610442575b600080fd5b6101ce6101c93660046116f9565b610455565b6040516001600160e01b031990911681526020015b60405180910390f35b6101ff6101fa366004611769565b61047b565b60405190151581526020016101e3565b6102176104c0565b6040516101e3919061179a565b61023761023236600461188a565b610561565b005b6101ff6102473660046118fd565b61067a565b6101ce61025a366004611927565b610692565b6102676106af565b6040519081526020016101e3565b6101ff610283366004611995565b6106c4565b6102676102963660046119d1565b6106e8565b6102376102a93660046119ea565b610708565b604051601281526020016101e3565b6102376102cb3660046119ea565b61072a565b6102376102de366004611a16565b610762565b6102376102f13660046118fd565b6107ec565b6102376103043660046119d1565b61085a565b6102376103173660046118fd565b6108c7565b61026761032a366004611a16565b61094a565b610237610975565b610237610989565b6103476109c5565b6040516101e39190611a31565b6101ff6103623660046119ea565b6109e0565b610217610a16565b610267610a33565b610237610385366004611a45565b610a5b565b610237610398366004611a16565b610ad7565b6102376103ab3660046118fd565b610b1a565b610267600081565b610267610b7b565b6101ff6103ce3660046118fd565b610b8a565b6102376103e13660046119ea565b610b98565b610347610bb4565b6102676103fc366004611ab9565b610bd2565b610347610c0e565b610237610417366004611a16565b610c19565b61023761042a366004611a45565b610c5c565b61023761043d366004611a16565b610cd8565b6101ff610450366004611a16565b610d49565b60003360405163578f385f60e11b81526004016104729190611a31565b60405180910390fd5b60006001600160e01b03198216629ce20b60e01b14806104ab57506001600160e01b03198216630a85bd0160e11b145b806104ba57506104ba82610d77565b92915050565b606060006104cc610dac565b90508060030180546104dd90611ae3565b80601f016020809104026020016040519081016040528092919081815260200182805461050990611ae3565b80156105565780601f1061052b57610100808354040283529160200191610556565b820191906000526020600020905b81548152906001019060200180831161053957829003601f168201915b505050505091505090565b600061056b610dd0565b805490915060ff600160401b82041615906001600160401b03166000811580156105925750825b90506000826001600160401b031660011480156105ae5750303b155b9050811580156105bc575080155b156105da5760405163f92ee8a960e01b815260040160405180910390fd5b84546001600160401b0319166001178555831561060357845460ff60401b1916600160401b1785555b61060d8888610df4565b610615610e06565b61061e86610e16565b610629600087610e39565b50831561067057845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050505050565b600033610688818585610eda565b5060019392505050565b600033604051637992d8e360e11b81526004016104729190611a31565b6000806106ba610dac565b6002015492915050565b6000336106d2858285610ee7565b6106dd858585610f34565b506001949350505050565b6000806106f3610f93565b60009384526020525050604090206001015490565b610711826106e8565b61071a81610fb7565b6107248383610e39565b50505050565b6001600160a01b03811633146107535760405163334bd91960e11b815260040160405180910390fd5b61075d8282610fc1565b505050565b61076a611039565b6001600160a01b038116610791576040516349fe757360e01b815260040160405180910390fd5b600061079b61106b565b6001810180546001600160a01b0319166001600160a01b038516908117909155604051919250907f5baec8c712a7efe1ef755579f2a5b46fe2ffb57d5d216b746e7130605ee9e97690600090a25050565b6107f461108f565b60405160200161080390611b1d565b6040516020818303038152906040528051906020012061082281610fb7565b816000036108435760405163015a4ac960e51b815260040160405180910390fd5b61084d83836110c5565b506108566110fb565b5050565b61086261108f565b60405160200161087190611b1d565b6040516020818303038152906040528051906020012061089081610fb7565b816000036108b15760405163015a4ac960e51b815260040160405180910390fd5b6108bb338361110c565b506108c46110fb565b50565b6108cf611039565b6108d882610d49565b6108f7578160405163451aa33d60e01b81526004016104729190611a31565b61090382600083611142565b816001600160a01b03167f11d33c4bdbad6892d3d8fe9b29fca9d1701c823ddea540b942b102366a4a47e28260405161093e91815260200190565b60405180910390a25050565b600080610955610dac565b6001600160a01b0390931660009081526020939093525050604090205490565b61097d611039565b6109876000610e16565b565b3380610993610c0e565b6001600160a01b0316146109bc578060405163118cdaa760e01b81526004016104729190611a31565b6108c481610e16565b6000806109d061126a565b546001600160a01b031692915050565b6000806109eb610f93565b6000948552602090815260408086206001600160a01b03959095168652939052505090205460ff1690565b60606000610a22610dac565b90508060040180546104dd90611ae3565b604051602001610a4290611b1d565b6040516020818303038152906040528051906020012081565b610a63610bb4565b6001600160a01b0316336001600160a01b031614610a955733604051626c2eb760e01b81526004016104729190611a31565b60005b8181101561075d57610acf838383818110610ab557610ab5611b37565b9050602002016020810190610aca9190611a16565b61128e565b600101610a98565b610adf610bb4565b6001600160a01b0316336001600160a01b031614610b115733604051626c2eb760e01b81526004016104729190611a31565b6108c48161128e565b610b2261108f565b604051602001610b3190611b4d565b60405160208183030381529060405280519060200120610b5081610fb7565b81600003610b715760405163015a4ac960e51b815260040160405180910390fd5b61084d838361110c565b604051602001610a4290611b4d565b600033610688818585610f34565b610ba1826106e8565b610baa81610fb7565b6107248383610fc1565b600080610bbf61106b565b600101546001600160a01b031692915050565b600080610bdd610dac565b6001600160a01b03948516600090815260019190910160209081526040808320959096168252939093525050205490565b6000806109d0611311565b610c21610bb4565b6001600160a01b0316336001600160a01b031614610c535733604051626c2eb760e01b81526004016104729190611a31565b6108c481611335565b610c64610bb4565b6001600160a01b0316336001600160a01b031614610c965733604051626c2eb760e01b81526004016104729190611a31565b60005b8181101561075d57610cd0838383818110610cb657610cb6611b37565b9050602002016020810190610ccb9190611a16565b611335565b600101610c99565b610ce0611039565b6000610cea611311565b80546001600160a01b0319166001600160a01b0384169081178255909150610d106109c5565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a35050565b600080610d5461106b565b6001600160a01b0390931660009081526020939093525050604090205460ff1690565b60006001600160e01b03198216637965db0b60e01b14806104ba57506301ffc9a760e01b6001600160e01b03198316146104ba565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0090565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0090565b610dfc61138e565b61085682826113b3565b610e0e61138e565b6109876113e4565b6000610e20611311565b80546001600160a01b03191681559050610856826113ec565b600080610e44610f93565b9050610e5084846109e0565b610ed0576000848152602082815260408083206001600160a01b03871684529091529020805460ff19166001179055610e863390565b6001600160a01b0316836001600160a01b0316857f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a460019150506104ba565b60009150506104ba565b61075d8383836001611448565b6000610ef38484610bd2565b905060001981146107245781811015610f2557828183604051637dc7a0d960e11b815260040161047293929190611b6c565b61072484848484036000611448565b6001600160a01b038316610f5e576000604051634b637e8f60e11b81526004016104729190611a31565b6001600160a01b038216610f8857600060405163ec442f0560e01b81526004016104729190611a31565b61075d8383836114b0565b7f02dd7bc7dec4dceedda775e58dd541e08a116c6c53815c0bd028192f7b62680090565b6108c48133611539565b600080610fcc610f93565b9050610fd884846109e0565b15610ed0576000848152602082815260408083206001600160a01b0387168085529252808320805460ff1916905551339287917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a460019150506104ba565b336110426109c5565b6001600160a01b031614610987573360405163118cdaa760e01b81526004016104729190611a31565b7f37055a6a5ad221b3685065a6f80bdaf8b5de26b2f60e82c3fbc16e3374b00c0090565b6000611099611572565b8054909150600119016110bf57604051633ee5aeb560e01b815260040160405180910390fd5b60029055565b6001600160a01b0382166110ef57600060405163ec442f0560e01b81526004016104729190611a31565b610856600083836114b0565b6000611105611572565b6001905550565b6001600160a01b038216611136576000604051634b637e8f60e11b81526004016104729190611a31565b610856826000836114b0565b600061114c610dac565b90506001600160a01b03841661117b57818160020160008282546111709190611b8d565b909155506111da9050565b6001600160a01b038416600090815260208290526040902054828110156111bb5784818460405163391434e360e21b815260040161047293929190611b6c565b6001600160a01b03851660009081526020839052604090209083900390555b6001600160a01b0383166111f8576002810180548390039055611217565b6001600160a01b03831660009081526020829052604090208054830190555b826001600160a01b0316846001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8460405161125c91815260200190565b60405180910390a350505050565b7f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c19930090565b6001600160a01b0381166112b5576040516349fe757360e01b815260040160405180910390fd5b60006112bf61106b565b6001600160a01b038316600081815260208390526040808220805460ff191660011790555192935090917f44d5fe68b00f68950fb9c1ff0a61ef7f747b1a36359a7e3a7f3324db4b8789679190a25050565b7f237e158222e3e6968b72b9db0d8043aacf074ad9f650f0d1606b4d82ee432c0090565b600061133f61106b565b6001600160a01b038316600081815260208390526040808220805460ff191690555192935090917f1747ca720b1a174a464b6513ace29b1d3190b5f632b9f34147017c81425bfde89190a25050565b611396611596565b61098757604051631afcd79f60e31b815260040160405180910390fd5b6113bb61138e565b60006113c5610dac565b9050600381016113d58482611bf4565b50600481016107248382611bf4565b6110fb61138e565b60006113f661126a565b80546001600160a01b038481166001600160a01b031983168117845560405193945091169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a3505050565b8261145281610d49565b15611472578060405163bb70159d60e01b81526004016104729190611a31565b8461147c81610d49565b1561149c578060405163bb70159d60e01b81526004016104729190611a31565b6114a8868686866115b0565b505050505050565b826114ba81610d49565b156114da578060405163bb70159d60e01b81526004016104729190611a31565b826114e481610d49565b15611504578060405163bb70159d60e01b81526004016104729190611a31565b3361150e81610d49565b1561152e578060405163bb70159d60e01b81526004016104729190611a31565b6114a8868686611142565b61154382826109e0565b6108565760405163e2517d3f60e01b81526001600160a01b038216600482015260248101839052604401610472565b7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f0090565b60006115a0610dd0565b54600160401b900460ff16919050565b60006115ba610dac565b90506001600160a01b0385166115e657600060405163e602df0560e01b81526004016104729190611a31565b6001600160a01b038416611610576000604051634a1406b160e11b81526004016104729190611a31565b6001600160a01b0380861660009081526001830160209081526040808320938816835292905220839055811561168e57836001600160a01b0316856001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b9258560405161168591815260200190565b60405180910390a35b5050505050565b80356001600160a01b03811681146116ac57600080fd5b919050565b60008083601f8401126116c357600080fd5b5081356001600160401b038111156116da57600080fd5b6020830191508360208285010111156116f257600080fd5b9250929050565b60008060008060008060a0878903121561171257600080fd5b61171b87611695565b955060208701359450604087013593506060870135925060808701356001600160401b0381111561174b57600080fd5b61175789828a016116b1565b979a9699509497509295939492505050565b60006020828403121561177b57600080fd5b81356001600160e01b03198116811461179357600080fd5b9392505050565b600060208083528351808285015260005b818110156117c7578581018301518582016040015282016117ab565b506000604082860101526040601f19601f8301168501019250505092915050565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261180f57600080fd5b81356001600160401b0380821115611829576118296117e8565b604051601f8301601f19908116603f01168101908282118183101715611851576118516117e8565b8160405283815286602085880101111561186a57600080fd5b836020870160208301376000602085830101528094505050505092915050565b60008060006060848603121561189f57600080fd5b83356001600160401b03808211156118b657600080fd5b6118c2878388016117fe565b945060208601359150808211156118d857600080fd5b506118e5868287016117fe565b9250506118f460408501611695565b90509250925092565b6000806040838503121561191057600080fd5b61191983611695565b946020939093013593505050565b60008060008060006080868803121561193f57600080fd5b61194886611695565b945061195660208701611695565b93506040860135925060608601356001600160401b0381111561197857600080fd5b611984888289016116b1565b969995985093965092949392505050565b6000806000606084860312156119aa57600080fd5b6119b384611695565b92506119c160208501611695565b9150604084013590509250925092565b6000602082840312156119e357600080fd5b5035919050565b600080604083850312156119fd57600080fd5b82359150611a0d60208401611695565b90509250929050565b600060208284031215611a2857600080fd5b61179382611695565b6001600160a01b0391909116815260200190565b60008060208385031215611a5857600080fd5b82356001600160401b0380821115611a6f57600080fd5b818501915085601f830112611a8357600080fd5b813581811115611a9257600080fd5b8660208260051b8501011115611aa757600080fd5b60209290920196919550909350505050565b60008060408385031215611acc57600080fd5b611ad583611695565b9150611a0d60208401611695565b600181811c90821680611af757607f821691505b602082108103611b1757634e487b7160e01b600052602260045260246000fd5b50919050565b6d29a7a62b212a21afa6a4a72a22a960911b8152600e0190565b634e487b7160e01b600052603260045260246000fd5b7229a7a62b212a21afa827a7a62fa12aa92722a960691b815260130190565b6001600160a01b039390931683526020830191909152604082015260600190565b808201808211156104ba57634e487b7160e01b600052601160045260246000fd5b601f82111561075d57600081815260208120601f850160051c81016020861015611bd55750805b601f850160051c820191505b818110156114a857828155600101611be1565b81516001600160401b03811115611c0d57611c0d6117e8565b611c2181611c1b8454611ae3565b84611bae565b602080601f831160018114611c565760008415611c3e5750858301515b600019600386901b1c1916600185901b1785556114a8565b600085815260208120601f198616915b82811015611c8557888601518255948401946001909101908401611c66565b5085821015611ca35787850151600019600388901b60f8161c191681555b5050505050600190811b0190555056fea26469706673582212206adf7147577cf47061b7da4331db08a8892ceb141654f55e615df76fcd55d5a564736f6c63430008140033

0x608060405234801561001057600080fd5b50600436106101b65760003560e01c80629ce20b146101bb57806301ffc9a7146101ec57806306fdde031461020f578063077f224a14610224578063095ea7b314610239578063150b7a021461024c57806318160ddd1461025f57806323b872dd14610275578063248a9ca3146102885780632f2ff15d1461029b578063313ce567146102ae57806336568abe146102bd57806338b20518146102d057806340c10f19146102e357806342966c68146102f657806353d51e641461030957806370a082311461031c578063715018a61461032f57806379ba5097146103375780638da5cb5b1461033f57806391d148541461035457806395d89b411461036757806396c495971461036f5780639999416f146103775780639cfe42da1461038a5780639dc29fac1461039d578063a217fddf146103b0578063a49630b2146103b8578063a9059cbb146103c0578063d547741f146103d3578063d9dbf657146103e6578063dd62ed3e146103ee578063e30c397814610401578063eb91e65114610409578063ef2af9221461041c578063f2fde38b1461042f578063fe575a8714610442575b600080fd5b6101ce6101c93660046116f9565b610455565b6040516001600160e01b031990911681526020015b60405180910390f35b6101ff6101fa366004611769565b61047b565b60405190151581526020016101e3565b6102176104c0565b6040516101e3919061179a565b61023761023236600461188a565b610561565b005b6101ff6102473660046118fd565b61067a565b6101ce61025a366004611927565b610692565b6102676106af565b6040519081526020016101e3565b6101ff610283366004611995565b6106c4565b6102676102963660046119d1565b6106e8565b6102376102a93660046119ea565b610708565b604051601281526020016101e3565b6102376102cb3660046119ea565b61072a565b6102376102de366004611a16565b610762565b6102376102f13660046118fd565b6107ec565b6102376103043660046119d1565b61085a565b6102376103173660046118fd565b6108c7565b61026761032a366004611a16565b61094a565b610237610975565b610237610989565b6103476109c5565b6040516101e39190611a31565b6101ff6103623660046119ea565b6109e0565b610217610a16565b610267610a33565b610237610385366004611a45565b610a5b565b610237610398366004611a16565b610ad7565b6102376103ab3660046118fd565b610b1a565b610267600081565b610267610b7b565b6101ff6103ce3660046118fd565b610b8a565b6102376103e13660046119ea565b610b98565b610347610bb4565b6102676103fc366004611ab9565b610bd2565b610347610c0e565b610237610417366004611a16565b610c19565b61023761042a366004611a45565b610c5c565b61023761043d366004611a16565b610cd8565b6101ff610450366004611a16565b610d49565b60003360405163578f385f60e11b81526004016104729190611a31565b60405180910390fd5b60006001600160e01b03198216629ce20b60e01b14806104ab57506001600160e01b03198216630a85bd0160e11b145b806104ba57506104ba82610d77565b92915050565b606060006104cc610dac565b90508060030180546104dd90611ae3565b80601f016020809104026020016040519081016040528092919081815260200182805461050990611ae3565b80156105565780601f1061052b57610100808354040283529160200191610556565b820191906000526020600020905b81548152906001019060200180831161053957829003601f168201915b505050505091505090565b600061056b610dd0565b805490915060ff600160401b82041615906001600160401b03166000811580156105925750825b90506000826001600160401b031660011480156105ae5750303b155b9050811580156105bc575080155b156105da5760405163f92ee8a960e01b815260040160405180910390fd5b84546001600160401b0319166001178555831561060357845460ff60401b1916600160401b1785555b61060d8888610df4565b610615610e06565b61061e86610e16565b610629600087610e39565b50831561067057845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050505050565b600033610688818585610eda565b5060019392505050565b600033604051637992d8e360e11b81526004016104729190611a31565b6000806106ba610dac565b6002015492915050565b6000336106d2858285610ee7565b6106dd858585610f34565b506001949350505050565b6000806106f3610f93565b60009384526020525050604090206001015490565b610711826106e8565b61071a81610fb7565b6107248383610e39565b50505050565b6001600160a01b03811633146107535760405163334bd91960e11b815260040160405180910390fd5b61075d8282610fc1565b505050565b61076a611039565b6001600160a01b038116610791576040516349fe757360e01b815260040160405180910390fd5b600061079b61106b565b6001810180546001600160a01b0319166001600160a01b038516908117909155604051919250907f5baec8c712a7efe1ef755579f2a5b46fe2ffb57d5d216b746e7130605ee9e97690600090a25050565b6107f461108f565b60405160200161080390611b1d565b6040516020818303038152906040528051906020012061082281610fb7565b816000036108435760405163015a4ac960e51b815260040160405180910390fd5b61084d83836110c5565b506108566110fb565b5050565b61086261108f565b60405160200161087190611b1d565b6040516020818303038152906040528051906020012061089081610fb7565b816000036108b15760405163015a4ac960e51b815260040160405180910390fd5b6108bb338361110c565b506108c46110fb565b50565b6108cf611039565b6108d882610d49565b6108f7578160405163451aa33d60e01b81526004016104729190611a31565b61090382600083611142565b816001600160a01b03167f11d33c4bdbad6892d3d8fe9b29fca9d1701c823ddea540b942b102366a4a47e28260405161093e91815260200190565b60405180910390a25050565b600080610955610dac565b6001600160a01b0390931660009081526020939093525050604090205490565b61097d611039565b6109876000610e16565b565b3380610993610c0e565b6001600160a01b0316146109bc578060405163118cdaa760e01b81526004016104729190611a31565b6108c481610e16565b6000806109d061126a565b546001600160a01b031692915050565b6000806109eb610f93565b6000948552602090815260408086206001600160a01b03959095168652939052505090205460ff1690565b60606000610a22610dac565b90508060040180546104dd90611ae3565b604051602001610a4290611b1d565b6040516020818303038152906040528051906020012081565b610a63610bb4565b6001600160a01b0316336001600160a01b031614610a955733604051626c2eb760e01b81526004016104729190611a31565b60005b8181101561075d57610acf838383818110610ab557610ab5611b37565b9050602002016020810190610aca9190611a16565b61128e565b600101610a98565b610adf610bb4565b6001600160a01b0316336001600160a01b031614610b115733604051626c2eb760e01b81526004016104729190611a31565b6108c48161128e565b610b2261108f565b604051602001610b3190611b4d565b60405160208183030381529060405280519060200120610b5081610fb7565b81600003610b715760405163015a4ac960e51b815260040160405180910390fd5b61084d838361110c565b604051602001610a4290611b4d565b600033610688818585610f34565b610ba1826106e8565b610baa81610fb7565b6107248383610fc1565b600080610bbf61106b565b600101546001600160a01b031692915050565b600080610bdd610dac565b6001600160a01b03948516600090815260019190910160209081526040808320959096168252939093525050205490565b6000806109d0611311565b610c21610bb4565b6001600160a01b0316336001600160a01b031614610c535733604051626c2eb760e01b81526004016104729190611a31565b6108c481611335565b610c64610bb4565b6001600160a01b0316336001600160a01b031614610c965733604051626c2eb760e01b81526004016104729190611a31565b60005b8181101561075d57610cd0838383818110610cb657610cb6611b37565b9050602002016020810190610ccb9190611a16565b611335565b600101610c99565b610ce0611039565b6000610cea611311565b80546001600160a01b0319166001600160a01b0384169081178255909150610d106109c5565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a35050565b600080610d5461106b565b6001600160a01b0390931660009081526020939093525050604090205460ff1690565b60006001600160e01b03198216637965db0b60e01b14806104ba57506301ffc9a760e01b6001600160e01b03198316146104ba565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0090565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0090565b610dfc61138e565b61085682826113b3565b610e0e61138e565b6109876113e4565b6000610e20611311565b80546001600160a01b03191681559050610856826113ec565b600080610e44610f93565b9050610e5084846109e0565b610ed0576000848152602082815260408083206001600160a01b03871684529091529020805460ff19166001179055610e863390565b6001600160a01b0316836001600160a01b0316857f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a460019150506104ba565b60009150506104ba565b61075d8383836001611448565b6000610ef38484610bd2565b905060001981146107245781811015610f2557828183604051637dc7a0d960e11b815260040161047293929190611b6c565b61072484848484036000611448565b6001600160a01b038316610f5e576000604051634b637e8f60e11b81526004016104729190611a31565b6001600160a01b038216610f8857600060405163ec442f0560e01b81526004016104729190611a31565b61075d8383836114b0565b7f02dd7bc7dec4dceedda775e58dd541e08a116c6c53815c0bd028192f7b62680090565b6108c48133611539565b600080610fcc610f93565b9050610fd884846109e0565b15610ed0576000848152602082815260408083206001600160a01b0387168085529252808320805460ff1916905551339287917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a460019150506104ba565b336110426109c5565b6001600160a01b031614610987573360405163118cdaa760e01b81526004016104729190611a31565b7f37055a6a5ad221b3685065a6f80bdaf8b5de26b2f60e82c3fbc16e3374b00c0090565b6000611099611572565b8054909150600119016110bf57604051633ee5aeb560e01b815260040160405180910390fd5b60029055565b6001600160a01b0382166110ef57600060405163ec442f0560e01b81526004016104729190611a31565b610856600083836114b0565b6000611105611572565b6001905550565b6001600160a01b038216611136576000604051634b637e8f60e11b81526004016104729190611a31565b610856826000836114b0565b600061114c610dac565b90506001600160a01b03841661117b57818160020160008282546111709190611b8d565b909155506111da9050565b6001600160a01b038416600090815260208290526040902054828110156111bb5784818460405163391434e360e21b815260040161047293929190611b6c565b6001600160a01b03851660009081526020839052604090209083900390555b6001600160a01b0383166111f8576002810180548390039055611217565b6001600160a01b03831660009081526020829052604090208054830190555b826001600160a01b0316846001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8460405161125c91815260200190565b60405180910390a350505050565b7f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c19930090565b6001600160a01b0381166112b5576040516349fe757360e01b815260040160405180910390fd5b60006112bf61106b565b6001600160a01b038316600081815260208390526040808220805460ff191660011790555192935090917f44d5fe68b00f68950fb9c1ff0a61ef7f747b1a36359a7e3a7f3324db4b8789679190a25050565b7f237e158222e3e6968b72b9db0d8043aacf074ad9f650f0d1606b4d82ee432c0090565b600061133f61106b565b6001600160a01b038316600081815260208390526040808220805460ff191690555192935090917f1747ca720b1a174a464b6513ace29b1d3190b5f632b9f34147017c81425bfde89190a25050565b611396611596565b61098757604051631afcd79f60e31b815260040160405180910390fd5b6113bb61138e565b60006113c5610dac565b9050600381016113d58482611bf4565b50600481016107248382611bf4565b6110fb61138e565b60006113f661126a565b80546001600160a01b038481166001600160a01b031983168117845560405193945091169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a3505050565b8261145281610d49565b15611472578060405163bb70159d60e01b81526004016104729190611a31565b8461147c81610d49565b1561149c578060405163bb70159d60e01b81526004016104729190611a31565b6114a8868686866115b0565b505050505050565b826114ba81610d49565b156114da578060405163bb70159d60e01b81526004016104729190611a31565b826114e481610d49565b15611504578060405163bb70159d60e01b81526004016104729190611a31565b3361150e81610d49565b1561152e578060405163bb70159d60e01b81526004016104729190611a31565b6114a8868686611142565b61154382826109e0565b6108565760405163e2517d3f60e01b81526001600160a01b038216600482015260248101839052604401610472565b7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f0090565b60006115a0610dd0565b54600160401b900460ff16919050565b60006115ba610dac565b90506001600160a01b0385166115e657600060405163e602df0560e01b81526004016104729190611a31565b6001600160a01b038416611610576000604051634a1406b160e11b81526004016104729190611a31565b6001600160a01b0380861660009081526001830160209081526040808320938816835292905220839055811561168e57836001600160a01b0316856001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b9258560405161168591815260200190565b60405180910390a35b5050505050565b80356001600160a01b03811681146116ac57600080fd5b919050565b60008083601f8401126116c357600080fd5b5081356001600160401b038111156116da57600080fd5b6020830191508360208285010111156116f257600080fd5b9250929050565b60008060008060008060a0878903121561171257600080fd5b61171b87611695565b955060208701359450604087013593506060870135925060808701356001600160401b0381111561174b57600080fd5b61175789828a016116b1565b979a9699509497509295939492505050565b60006020828403121561177b57600080fd5b81356001600160e01b03198116811461179357600080fd5b9392505050565b600060208083528351808285015260005b818110156117c7578581018301518582016040015282016117ab565b506000604082860101526040601f19601f8301168501019250505092915050565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261180f57600080fd5b81356001600160401b0380821115611829576118296117e8565b604051601f8301601f19908116603f01168101908282118183101715611851576118516117e8565b8160405283815286602085880101111561186a57600080fd5b836020870160208301376000602085830101528094505050505092915050565b60008060006060848603121561189f57600080fd5b83356001600160401b03808211156118b657600080fd5b6118c2878388016117fe565b945060208601359150808211156118d857600080fd5b506118e5868287016117fe565b9250506118f460408501611695565b90509250925092565b6000806040838503121561191057600080fd5b61191983611695565b946020939093013593505050565b60008060008060006080868803121561193f57600080fd5b61194886611695565b945061195660208701611695565b93506040860135925060608601356001600160401b0381111561197857600080fd5b611984888289016116b1565b969995985093965092949392505050565b6000806000606084860312156119aa57600080fd5b6119b384611695565b92506119c160208501611695565b9150604084013590509250925092565b6000602082840312156119e357600080fd5b5035919050565b600080604083850312156119fd57600080fd5b82359150611a0d60208401611695565b90509250929050565b600060208284031215611a2857600080fd5b61179382611695565b6001600160a01b0391909116815260200190565b60008060208385031215611a5857600080fd5b82356001600160401b0380821115611a6f57600080fd5b818501915085601f830112611a8357600080fd5b813581811115611a9257600080fd5b8660208260051b8501011115611aa757600080fd5b60209290920196919550909350505050565b60008060408385031215611acc57600080fd5b611ad583611695565b9150611a0d60208401611695565b600181811c90821680611af757607f821691505b602082108103611b1757634e487b7160e01b600052602260045260246000fd5b50919050565b6d29a7a62b212a21afa6a4a72a22a960911b8152600e0190565b634e487b7160e01b600052603260045260246000fd5b7229a7a62b212a21afa827a7a62fa12aa92722a960691b815260130190565b6001600160a01b039390931683526020830191909152604082015260600190565b808201808211156104ba57634e487b7160e01b600052601160045260246000fd5b601f82111561075d57600081815260208120601f850160051c81016020861015611bd55750805b601f850160051c820191505b818110156114a857828155600101611be1565b81516001600160401b03811115611c0d57611c0d6117e8565b611c2181611c1b8454611ae3565b84611bae565b602080601f831160018114611c565760008415611c3e5750858301515b600019600386901b1c1916600185901b1785556114a8565b600085815260208120601f198616915b82811015611c8557888601518255948401946001909101908401611c66565b5085821015611ca35787850151600019600388901b60f8161c191681555b5050505050600190811b0190555056fea26469706673582212206adf7147577cf47061b7da4331db08a8892ceb141654f55e615df76fcd55d5a564736f6c63430008140033