Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta

More Options

• Is this a proxy?
• Similar
• Submit Audit
• Compare

pragma solidity 0.8.20;

// SPDX-License-Identifier: MIT



import {ERC20PermitUpgradeable} from "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/draft-ERC20PermitUpgradeable.sol";
import {UpgradeableBeacon} from "@openzeppelin/contracts/proxy/beacon/UpgradeableBeacon.sol";
import {ERC1967Upgrade} from "@openzeppelin/contracts/proxy/ERC1967/ERC1967Upgrade.sol";

import {IL2StandardToken} from "./interfaces/IL2StandardToken.sol";

/// @author Matter Labs
/// @custom:security-contact [email protected]
/// @notice The ERC20 token implementation, that is used in the "default" ERC20 bridge. Note, that it does not
/// support any custom token logic, i.e. rebase tokens' functionality is not supported.
contract L2StandardERC20 is ERC20PermitUpgradeable, IL2StandardToken, ERC1967Upgrade {
    /// @dev Describes whether there is a specific getter in the token.
    /// @notice Used to explicitly separate which getters the token has and which it does not.
    /// @notice Different tokens in L1 can implement or not implement getter function as `name`/`symbol`/`decimals`,
    /// @notice Our goal is to store all the getters that L1 token implements, and for others, we keep it as an unimplemented method.
    struct ERC20Getters {
        bool ignoreName;
        bool ignoreSymbol;
        bool ignoreDecimals;
    }

    ERC20Getters private availableGetters;

    /// @dev The decimals of the token, that are used as a value for `decimals` getter function.
    /// @notice A private variable is used only for decimals, but not for `name` and `symbol`, because standard
    /// @notice OpenZeppelin token represents `name` and `symbol` as storage variables and `decimals` as constant.
    uint8 private decimals_;

    /// @dev Address of the L2 bridge that is used as trustee who can mint/burn tokens
    address public override l2Bridge;

    /// @dev Address of the L1 token that can be deposited to mint this L2 token
    address public override l1Address;

    /// @dev Contract is expected to be used as proxy implementation.
    constructor() {
        // Disable initialization to prevent Parity hack.
        _disableInitializers();
    }

    /// @notice Initializes a contract token for later use. Expected to be used in the proxy.
    /// @dev Stores the L1 address of the bridge and set `name`/`symbol`/`decimals` getters that L1 token has.
    /// @param _l1Address Address of the L1 token that can be deposited to mint this L2 token
    /// @param _data The additional data that the L1 bridge provide for initialization.
    /// In this case, it is packed `name`/`symbol`/`decimals` of the L1 token.
    function bridgeInitialize(address _l1Address, bytes memory _data) external initializer {
        require(_l1Address != address(0), "in6"); // Should be non-zero address
        l1Address = _l1Address;

        l2Bridge = msg.sender;

        // We parse the data exactly as they were created on the L1 bridge
        (bytes memory nameBytes, bytes memory symbolBytes, bytes memory decimalsBytes) = abi.decode(
            _data,
            (bytes, bytes, bytes)
        );

        ERC20Getters memory getters;
        string memory decodedName;
        string memory decodedSymbol;

        // L1 bridge didn't check if the L1 token return values with proper types for `name`/`symbol`/`decimals`
        // That's why we need to try to decode them, and if it works out, set the values as getters.

        // NOTE: Solidity doesn't have a convenient way to try to decode a value:
        // - Decode them manually, i.e. write a function that will validate that data in the correct format
        // and return decoded value and a boolean value - whether it was possible to decode.
        // - Use the standard abi.decode method, but wrap it into an external call in which error can be handled.
        // We use the second option here.

        try this.decodeString(nameBytes) returns (string memory nameString) {
            decodedName = nameString;
        } catch {
            getters.ignoreName = true;
        }

        try this.decodeString(symbolBytes) returns (string memory symbolString) {
            decodedSymbol = symbolString;
        } catch {
            getters.ignoreSymbol = true;
        }

        // Set decoded values for name and symbol.
        __ERC20_init_unchained(decodedName, decodedSymbol);

        // Set the name for EIP-712 signature.
        __ERC20Permit_init(decodedName);

        try this.decodeUint8(decimalsBytes) returns (uint8 decimalsUint8) {
            // Set decoded value for decimals.
            decimals_ = decimalsUint8;
        } catch {
            getters.ignoreDecimals = true;
        }

        availableGetters = getters;
        emit BridgeInitialize(_l1Address, decodedName, decodedSymbol, decimals_);
    }

    /// @notice A method to be called by the governor to update the token's metadata.
    /// @param _availableGetters The getters that the token has.
    /// @param _newName The new name of the token.
    /// @param _newSymbol The new symbol of the token.
    /// @param _version The version of the token that will be initialized.
    /// @dev The _version must be exactly the version higher by 1 than the current version. This is needed
    /// to ensure that the governor can not accidentally disable future reinitialization of the token.
    function reinitializeToken(
        ERC20Getters calldata _availableGetters,
        string memory _newName,
        string memory _newSymbol,
        uint8 _version
    ) external onlyNextVersion(_version) reinitializer(_version) {
        // It is expected that this token is deployed as a beacon proxy, so we'll
        // allow the governor of the beacon to reinitialize the token.
        address beaconAddress = _getBeacon();
        require(msg.sender == UpgradeableBeacon(beaconAddress).owner(), "tt");

        __ERC20_init_unchained(_newName, _newSymbol);
        __ERC20Permit_init(_newName);
        availableGetters = _availableGetters;

        emit BridgeInitialize(l1Address, _newName, _newSymbol, decimals_);
    }

    modifier onlyBridge() {
        require(msg.sender == l2Bridge, "xnt"); // Only L2 bridge can call this method
        _;
    }

    modifier onlyNextVersion(uint8 _version) {
        // The version should be incremented by 1. Otherwise, the governor risks disabling
        // future reinitialization of the token by providing too large a version.
        require(_version == _getInitializedVersion() + 1, "v");
        _;
    }

    /// @dev Mint tokens to a given account.
    /// @param _to The account that will receive the created tokens.
    /// @param _amount The amount that will be created.
    /// @notice Should be called by bridge after depositing tokens from L1.
    function bridgeMint(address _to, uint256 _amount) external override onlyBridge {
        _mint(_to, _amount);
        emit BridgeMint(_to, _amount);
    }

    /// @dev Burn tokens from a given account.
    /// @param _from The account from which tokens will be burned.
    /// @param _amount The amount that will be burned.
    /// @notice Should be called by bridge before withdrawing tokens to L1.
    function bridgeBurn(address _from, uint256 _amount) external override onlyBridge {
        _burn(_from, _amount);
        emit BridgeBurn(_from, _amount);
    }

    function name() public view override returns (string memory) {
        // If method is not available, behave like a token that does not implement this method - revert on call.
        if (availableGetters.ignoreName) revert();
        return super.name();
    }

    function symbol() public view override returns (string memory) {
        // If method is not available, behave like a token that does not implement this method - revert on call.
        if (availableGetters.ignoreSymbol) revert();
        return super.symbol();
    }

    function decimals() public view override returns (uint8) {
        // If method is not available, behave like a token that does not implement this method - revert on call.
        if (availableGetters.ignoreDecimals) revert();
        return decimals_;
    }

    /// @dev External function to decode a string from bytes.
    function decodeString(bytes memory _input) external pure returns (string memory result) {
        (result) = abi.decode(_input, (string));
    }

    /// @dev External function to decode a uint8 from bytes.
    function decodeUint8(bytes memory _input) external pure returns (uint8 result) {
        (result) = abi.decode(_input, (uint8));
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC5267.sol)

pragma solidity ^0.8.0;

interface IERC5267Upgradeable {
    /**
     * @dev MAY be emitted to signal that the domain could have changed.
     */
    event EIP712DomainChanged();

    /**
     * @dev returns the fields and values that describe the domain separator used by this contract for EIP-712
     * signature.
     */
    function eip712Domain()
        external
        view
        returns (
            bytes1 fields,
            string memory name,
            string memory version,
            uint256 chainId,
            address verifyingContract,
            bytes32 salt,
            uint256[] memory extensions
        );
}

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

pragma solidity ^0.8.2;

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

/**
 * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
 * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
 * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
 * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
 *
 * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
 * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
 * case an upgrade adds a module that needs to be initialized.
 *
 * For example:
 *
 * [.hljs-theme-light.nopadding]
 * ```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 Indicates that the contract has been initialized.
     * @custom:oz-retyped-from bool
     */
    uint8 private _initialized;

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

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

    /**
     * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
     * `onlyInitializing` functions can be used to initialize parent contracts.
     *
     * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
     * constructor.
     *
     * Emits an {Initialized} event.
     */
    modifier initializer() {
        bool isTopLevelCall = !_initializing;
        require(
            (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
            "Initializable: contract is already initialized"
        );
        _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 255 will prevent any future reinitialization.
     *
     * Emits an {Initialized} event.
     */
    modifier reinitializer(uint8 version) {
        require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
        _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() {
        require(_initializing, "Initializable: contract is not initializing");
        _;
    }

    /**
     * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
     * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
     * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
     * through proxies.
     *
     * Emits an {Initialized} event the first time it is successfully executed.
     */
    function _disableInitializers() internal virtual {
        require(!_initializing, "Initializable: contract is initializing");
        if (_initialized != type(uint8).max) {
            _initialized = type(uint8).max;
            emit Initialized(type(uint8).max);
        }
    }

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

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

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

pragma solidity ^0.8.0;

import "./IERC20Upgradeable.sol";
import "./extensions/IERC20MetadataUpgradeable.sol";
import "../../utils/ContextUpgradeable.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}.
 * For a generic mechanism see {ERC20PresetMinterPauser}.
 *
 * 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.
 *
 * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
 * functions have been added to mitigate the well-known issues around setting
 * allowances. See {IERC20-approve}.
 */
contract ERC20Upgradeable is Initializable, ContextUpgradeable, IERC20Upgradeable, IERC20MetadataUpgradeable {
    mapping(address => uint256) private _balances;

    mapping(address => mapping(address => uint256)) private _allowances;

    uint256 private _totalSupply;

    string private _name;
    string private _symbol;

    /**
     * @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 {
        _name = name_;
        _symbol = symbol_;
    }

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

    /**
     * @dev Returns the symbol of the token, usually a shorter version of the
     * name.
     */
    function symbol() public view virtual override returns (string memory) {
        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 override returns (uint8) {
        return 18;
    }

    /**
     * @dev See {IERC20-totalSupply}.
     */
    function totalSupply() public view virtual override returns (uint256) {
        return _totalSupply;
    }

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

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

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

    /**
     * @dev See {IERC20-approve}.
     *
     * NOTE: If `amount` 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 amount) public virtual override returns (bool) {
        address owner = _msgSender();
        _approve(owner, spender, amount);
        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 `amount`.
     * - the caller must have allowance for ``from``'s tokens of at least
     * `amount`.
     */
    function transferFrom(address from, address to, uint256 amount) public virtual override returns (bool) {
        address spender = _msgSender();
        _spendAllowance(from, spender, amount);
        _transfer(from, to, amount);
        return true;
    }

    /**
     * @dev Atomically increases the allowance granted to `spender` by the caller.
     *
     * This is an alternative to {approve} that can be used as a mitigation for
     * problems described in {IERC20-approve}.
     *
     * Emits an {Approval} event indicating the updated allowance.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     */
    function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
        address owner = _msgSender();
        _approve(owner, spender, allowance(owner, spender) + addedValue);
        return true;
    }

    /**
     * @dev Atomically decreases the allowance granted to `spender` by the caller.
     *
     * This is an alternative to {approve} that can be used as a mitigation for
     * problems described in {IERC20-approve}.
     *
     * Emits an {Approval} event indicating the updated allowance.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     * - `spender` must have allowance for the caller of at least
     * `subtractedValue`.
     */
    function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
        address owner = _msgSender();
        uint256 currentAllowance = allowance(owner, spender);
        require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
        unchecked {
            _approve(owner, spender, currentAllowance - subtractedValue);
        }

        return true;
    }

    /**
     * @dev Moves `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.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `from` must have a balance of at least `amount`.
     */
    function _transfer(address from, address to, uint256 amount) internal virtual {
        require(from != address(0), "ERC20: transfer from the zero address");
        require(to != address(0), "ERC20: transfer to the zero address");

        _beforeTokenTransfer(from, to, amount);

        uint256 fromBalance = _balances[from];
        require(fromBalance >= amount, "ERC20: transfer amount exceeds balance");
        unchecked {
            _balances[from] = fromBalance - amount;
            // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by
            // decrementing then incrementing.
            _balances[to] += amount;
        }

        emit Transfer(from, to, amount);

        _afterTokenTransfer(from, to, amount);
    }

    /** @dev Creates `amount` tokens and assigns them to `account`, increasing
     * the total supply.
     *
     * Emits a {Transfer} event with `from` set to the zero address.
     *
     * Requirements:
     *
     * - `account` cannot be the zero address.
     */
    function _mint(address account, uint256 amount) internal virtual {
        require(account != address(0), "ERC20: mint to the zero address");

        _beforeTokenTransfer(address(0), account, amount);

        _totalSupply += amount;
        unchecked {
            // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.
            _balances[account] += amount;
        }
        emit Transfer(address(0), account, amount);

        _afterTokenTransfer(address(0), account, amount);
    }

    /**
     * @dev Destroys `amount` tokens from `account`, reducing the
     * total supply.
     *
     * Emits a {Transfer} event with `to` set to the zero address.
     *
     * Requirements:
     *
     * - `account` cannot be the zero address.
     * - `account` must have at least `amount` tokens.
     */
    function _burn(address account, uint256 amount) internal virtual {
        require(account != address(0), "ERC20: burn from the zero address");

        _beforeTokenTransfer(account, address(0), amount);

        uint256 accountBalance = _balances[account];
        require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
        unchecked {
            _balances[account] = accountBalance - amount;
            // Overflow not possible: amount <= accountBalance <= totalSupply.
            _totalSupply -= amount;
        }

        emit Transfer(account, address(0), amount);

        _afterTokenTransfer(account, address(0), amount);
    }

    /**
     * @dev Sets `amount` 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.
     */
    function _approve(address owner, address spender, uint256 amount) internal virtual {
        require(owner != address(0), "ERC20: approve from the zero address");
        require(spender != address(0), "ERC20: approve to the zero address");

        _allowances[owner][spender] = amount;
        emit Approval(owner, spender, amount);
    }

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC20 standard as defined in the EIP.
 */
interface IERC20Upgradeable {
    /**
     * @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 amount of tokens in existence.
     */
    function totalSupply() external view returns (uint256);

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

    /**
     * @dev Moves `amount` 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 amount) 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 `amount` 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 amount) external returns (bool);

    /**
     * @dev Moves `amount` tokens from `from` to `to` using the
     * allowance mechanism. `amount` 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 amount) external returns (bool);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/ERC20Permit.sol)

pragma solidity ^0.8.0;

import "./IERC20PermitUpgradeable.sol";
import "../ERC20Upgradeable.sol";
import "../../../utils/cryptography/ECDSAUpgradeable.sol";
import "../../../utils/cryptography/EIP712Upgradeable.sol";
import "../../../utils/CountersUpgradeable.sol";
import {Initializable} from "../../../proxy/utils/Initializable.sol";

/**
 * @dev Implementation of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
 * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
 *
 * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
 * presenting a message signed by the account. By not relying on `{IERC20-approve}`, the token holder account doesn't
 * need to send a transaction, and thus is not required to hold Ether at all.
 *
 * _Available since v3.4._
 *
 * @custom:storage-size 51
 */
abstract contract ERC20PermitUpgradeable is Initializable, ERC20Upgradeable, IERC20PermitUpgradeable, EIP712Upgradeable {
    using CountersUpgradeable for CountersUpgradeable.Counter;

    mapping(address => CountersUpgradeable.Counter) private _nonces;

    // solhint-disable-next-line var-name-mixedcase
    bytes32 private constant _PERMIT_TYPEHASH =
        keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)");
    /**
     * @dev In previous versions `_PERMIT_TYPEHASH` was declared as `immutable`.
     * However, to ensure consistency with the upgradeable transpiler, we will continue
     * to reserve a slot.
     * @custom:oz-renamed-from _PERMIT_TYPEHASH
     */
    // solhint-disable-next-line var-name-mixedcase
    bytes32 private _PERMIT_TYPEHASH_DEPRECATED_SLOT;

    /**
     * @dev Initializes the {EIP712} domain separator using the `name` parameter, and setting `version` to `"1"`.
     *
     * It's a good idea to use the same `name` that is defined as the ERC20 token name.
     */
    function __ERC20Permit_init(string memory name) internal onlyInitializing {
        __EIP712_init_unchained(name, "1");
    }

    function __ERC20Permit_init_unchained(string memory) internal onlyInitializing {}

    /**
     * @inheritdoc IERC20PermitUpgradeable
     */
    function permit(
        address owner,
        address spender,
        uint256 value,
        uint256 deadline,
        uint8 v,
        bytes32 r,
        bytes32 s
    ) public virtual override {
        require(block.timestamp <= deadline, "ERC20Permit: expired deadline");

        bytes32 structHash = keccak256(abi.encode(_PERMIT_TYPEHASH, owner, spender, value, _useNonce(owner), deadline));

        bytes32 hash = _hashTypedDataV4(structHash);

        address signer = ECDSAUpgradeable.recover(hash, v, r, s);
        require(signer == owner, "ERC20Permit: invalid signature");

        _approve(owner, spender, value);
    }

    /**
     * @inheritdoc IERC20PermitUpgradeable
     */
    function nonces(address owner) public view virtual override returns (uint256) {
        return _nonces[owner].current();
    }

    /**
     * @inheritdoc IERC20PermitUpgradeable
     */
    // solhint-disable-next-line func-name-mixedcase
    function DOMAIN_SEPARATOR() external view override returns (bytes32) {
        return _domainSeparatorV4();
    }

    /**
     * @dev "Consume a nonce": return the current value and increment.
     *
     * _Available since v4.1._
     */
    function _useNonce(address owner) internal virtual returns (uint256 current) {
        CountersUpgradeable.Counter storage nonce = _nonces[owner];
        current = nonce.current();
        nonce.increment();
    }

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)

pragma solidity ^0.8.0;

import "../IERC20Upgradeable.sol";

/**
 * @dev Interface for the optional metadata functions from the ERC20 standard.
 *
 * _Available since v4.1._
 */
interface IERC20MetadataUpgradeable is IERC20Upgradeable {
    /**
     * @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 v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
 * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
 *
 * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
 * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
 * need to send a transaction, and thus is not required to hold Ether at all.
 *
 * ==== Security Considerations
 *
 * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature
 * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be
 * considered as an intention to spend the allowance in any specific way. The second is that because permits have
 * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should
 * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be
 * generally recommended is:
 *
 * ```solidity
 * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {
 *     try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}
 *     doThing(..., value);
 * }
 *
 * function doThing(..., uint256 value) public {
 *     token.safeTransferFrom(msg.sender, address(this), value);
 *     ...
 * }
 * ```
 *
 * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of
 * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also
 * {SafeERC20-safeTransferFrom}).
 *
 * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so
 * contracts should have entry points that don't rely on permit.
 */
interface IERC20PermitUpgradeable {
    /**
     * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
     * given ``owner``'s signed approval.
     *
     * IMPORTANT: The same issues {IERC20-approve} has related to transaction
     * ordering also apply here.
     *
     * Emits an {Approval} event.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     * - `deadline` must be a timestamp in the future.
     * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
     * over the EIP712-formatted function arguments.
     * - the signature must use ``owner``'s current nonce (see {nonces}).
     *
     * For more information on the signature format, see the
     * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
     * section].
     *
     * CAUTION: See Security Considerations above.
     */
    function permit(
        address owner,
        address spender,
        uint256 value,
        uint256 deadline,
        uint8 v,
        bytes32 r,
        bytes32 s
    ) external;

    /**
     * @dev Returns the current nonce for `owner`. This value must be
     * included whenever a signature is generated for {permit}.
     *
     * Every successful call to {permit} increases ``owner``'s nonce by one. This
     * prevents a signature from being used multiple times.
     */
    function nonces(address owner) external view returns (uint256);

    /**
     * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
     */
    // solhint-disable-next-line func-name-mixedcase
    function DOMAIN_SEPARATOR() external view returns (bytes32);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/extensions/draft-ERC20Permit.sol)

pragma solidity ^0.8.0;

// EIP-2612 is Final as of 2022-11-01. This file is deprecated.

import "./ERC20PermitUpgradeable.sol";

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)

pragma solidity ^0.8.1;

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

        return account.code.length > 0;
    }

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

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

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

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

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

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

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

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        (bool success, bytes memory returndata) = target.staticcall(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

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

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a delegate call.
     *
     * _Available since v3.4._
     */
    function functionDelegateCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        (bool success, bytes memory returndata) = target.delegatecall(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
     * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
     *
     * _Available since v4.8._
     */
    function verifyCallResultFromTarget(
        address target,
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        if (success) {
            if (returndata.length == 0) {
                // only check isContract if the call was successful and the return data is empty
                // otherwise we already know that it was a contract
                require(isContract(target), "Address: call to non-contract");
            }
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    /**
     * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
     * revert reason or using the provided one.
     *
     * _Available since v4.3._
     */
    function verifyCallResult(
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal pure returns (bytes memory) {
        if (success) {
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    function _revert(bytes memory returndata, string memory errorMessage) private pure {
        // Look for revert reason and bubble it up if present
        if (returndata.length > 0) {
            // The easiest way to bubble the revert reason is using memory via assembly
            /// @solidity memory-safe-assembly
            assembly {
                let returndata_size := mload(returndata)
                revert(add(32, returndata), returndata_size)
            }
        } else {
            revert(errorMessage);
        }
    }
}

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

pragma solidity ^0.8.0;
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;
    }

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Counters.sol)

pragma solidity ^0.8.0;

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

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)

pragma solidity ^0.8.0;

import "./math/MathUpgradeable.sol";
import "./math/SignedMathUpgradeable.sol";

/**
 * @dev String operations.
 */
library StringsUpgradeable {
    bytes16 private constant _SYMBOLS = "0123456789abcdef";
    uint8 private constant _ADDRESS_LENGTH = 20;

    /**
     * @dev Converts a `uint256` to its ASCII `string` decimal representation.
     */
    function toString(uint256 value) internal pure returns (string memory) {
        unchecked {
            uint256 length = MathUpgradeable.log10(value) + 1;
            string memory buffer = new string(length);
            uint256 ptr;
            /// @solidity memory-safe-assembly
            assembly {
                ptr := add(buffer, add(32, length))
            }
            while (true) {
                ptr--;
                /// @solidity memory-safe-assembly
                assembly {
                    mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
                }
                value /= 10;
                if (value == 0) break;
            }
            return buffer;
        }
    }

    /**
     * @dev Converts a `int256` to its ASCII `string` decimal representation.
     */
    function toString(int256 value) internal pure returns (string memory) {
        return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMathUpgradeable.abs(value))));
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
     */
    function toHexString(uint256 value) internal pure returns (string memory) {
        unchecked {
            return toHexString(value, MathUpgradeable.log256(value) + 1);
        }
    }

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

    /**
     * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
     */
    function toHexString(address addr) internal pure returns (string memory) {
        return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
    }

    /**
     * @dev Returns true if the two strings are equal.
     */
    function equal(string memory a, string memory b) internal pure returns (bool) {
        return keccak256(bytes(a)) == keccak256(bytes(b));
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)

pragma solidity ^0.8.0;

import "../StringsUpgradeable.sol";

/**
 * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
 *
 * These functions can be used to verify that a message was signed by the holder
 * of the private keys of a given address.
 */
library ECDSAUpgradeable {
    enum RecoverError {
        NoError,
        InvalidSignature,
        InvalidSignatureLength,
        InvalidSignatureS,
        InvalidSignatureV // Deprecated in v4.8
    }

    function _throwError(RecoverError error) private pure {
        if (error == RecoverError.NoError) {
            return; // no error: do nothing
        } else if (error == RecoverError.InvalidSignature) {
            revert("ECDSA: invalid signature");
        } else if (error == RecoverError.InvalidSignatureLength) {
            revert("ECDSA: invalid signature length");
        } else if (error == RecoverError.InvalidSignatureS) {
            revert("ECDSA: invalid signature 's' value");
        }
    }

    /**
     * @dev Returns the address that signed a hashed message (`hash`) with
     * `signature` or error string. This address can then be used for verification purposes.
     *
     * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
     * this function rejects them by requiring the `s` value to be in the lower
     * half order, and the `v` value to be either 27 or 28.
     *
     * IMPORTANT: `hash` _must_ be the result of a hash operation for the
     * verification to be secure: it is possible to craft signatures that
     * recover to arbitrary addresses for non-hashed data. A safe way to ensure
     * this is by receiving a hash of the original message (which may otherwise
     * be too long), and then calling {toEthSignedMessageHash} on it.
     *
     * Documentation for signature generation:
     * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
     * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
     *
     * _Available since v4.3._
     */
    function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
        if (signature.length == 65) {
            bytes32 r;
            bytes32 s;
            uint8 v;
            // ecrecover takes the signature parameters, and the only way to get them
            // currently is to use assembly.
            /// @solidity memory-safe-assembly
            assembly {
                r := mload(add(signature, 0x20))
                s := mload(add(signature, 0x40))
                v := byte(0, mload(add(signature, 0x60)))
            }
            return tryRecover(hash, v, r, s);
        } else {
            return (address(0), RecoverError.InvalidSignatureLength);
        }
    }

    /**
     * @dev Returns the address that signed a hashed message (`hash`) with
     * `signature`. This address can then be used for verification purposes.
     *
     * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
     * this function rejects them by requiring the `s` value to be in the lower
     * half order, and the `v` value to be either 27 or 28.
     *
     * IMPORTANT: `hash` _must_ be the result of a hash operation for the
     * verification to be secure: it is possible to craft signatures that
     * recover to arbitrary addresses for non-hashed data. A safe way to ensure
     * this is by receiving a hash of the original message (which may otherwise
     * be too long), and then calling {toEthSignedMessageHash} on it.
     */
    function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
        (address recovered, RecoverError error) = tryRecover(hash, signature);
        _throwError(error);
        return recovered;
    }

    /**
     * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
     *
     * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
     *
     * _Available since v4.3._
     */
    function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {
        bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);
        uint8 v = uint8((uint256(vs) >> 255) + 27);
        return tryRecover(hash, v, r, s);
    }

    /**
     * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
     *
     * _Available since v4.2._
     */
    function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {
        (address recovered, RecoverError error) = tryRecover(hash, r, vs);
        _throwError(error);
        return recovered;
    }

    /**
     * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
     * `r` and `s` signature fields separately.
     *
     * _Available since v4.3._
     */
    function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {
        // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
        // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
        // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
        // signatures from current libraries generate a unique signature with an s-value in the lower half order.
        //
        // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
        // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
        // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
        // these malleable signatures as well.
        if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
            return (address(0), RecoverError.InvalidSignatureS);
        }

        // If the signature is valid (and not malleable), return the signer address
        address signer = ecrecover(hash, v, r, s);
        if (signer == address(0)) {
            return (address(0), RecoverError.InvalidSignature);
        }

        return (signer, RecoverError.NoError);
    }

    /**
     * @dev Overload of {ECDSA-recover} that receives the `v`,
     * `r` and `s` signature fields separately.
     */
    function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {
        (address recovered, RecoverError error) = tryRecover(hash, v, r, s);
        _throwError(error);
        return recovered;
    }

    /**
     * @dev Returns an Ethereum Signed Message, created from a `hash`. This
     * produces hash corresponding to the one signed with the
     * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
     * JSON-RPC method as part of EIP-191.
     *
     * See {recover}.
     */
    function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {
        // 32 is the length in bytes of hash,
        // enforced by the type signature above
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, "\x19Ethereum Signed Message:\n32")
            mstore(0x1c, hash)
            message := keccak256(0x00, 0x3c)
        }
    }

    /**
     * @dev Returns an Ethereum Signed Message, created from `s`. This
     * produces hash corresponding to the one signed with the
     * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
     * JSON-RPC method as part of EIP-191.
     *
     * See {recover}.
     */
    function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
        return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", StringsUpgradeable.toString(s.length), s));
    }

    /**
     * @dev Returns an Ethereum Signed Typed Data, created from a
     * `domainSeparator` and a `structHash`. This produces hash corresponding
     * to the one signed with the
     * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
     * JSON-RPC method as part of EIP-712.
     *
     * See {recover}.
     */
    function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {
        /// @solidity memory-safe-assembly
        assembly {
            let ptr := mload(0x40)
            mstore(ptr, "\x19\x01")
            mstore(add(ptr, 0x02), domainSeparator)
            mstore(add(ptr, 0x22), structHash)
            data := keccak256(ptr, 0x42)
        }
    }

    /**
     * @dev Returns an Ethereum Signed Data with intended validator, created from a
     * `validator` and `data` according to the version 0 of EIP-191.
     *
     * See {recover}.
     */
    function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {
        return keccak256(abi.encodePacked("\x19\x00", validator, data));
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/EIP712.sol)

pragma solidity ^0.8.8;

import "./ECDSAUpgradeable.sol";
import "../../interfaces/IERC5267Upgradeable.sol";
import {Initializable} from "../../proxy/utils/Initializable.sol";

/**
 * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.
 *
 * The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible,
 * thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding
 * they need in their contracts using a combination of `abi.encode` and `keccak256`.
 *
 * This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding
 * scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA
 * ({_hashTypedDataV4}).
 *
 * The implementation of the domain separator was designed to be as efficient as possible while still properly updating
 * the chain id to protect against replay attacks on an eventual fork of the chain.
 *
 * NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method
 * https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].
 *
 * NOTE: In the upgradeable version of this contract, the cached values will correspond to the address, and the domain
 * separator of the implementation contract. This will cause the `_domainSeparatorV4` function to always rebuild the
 * separator from the immutable values, which is cheaper than accessing a cached version in cold storage.
 *
 * _Available since v3.4._
 *
 * @custom:storage-size 52
 */
abstract contract EIP712Upgradeable is Initializable, IERC5267Upgradeable {
    bytes32 private constant _TYPE_HASH =
        keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");

    /// @custom:oz-renamed-from _HASHED_NAME
    bytes32 private _hashedName;
    /// @custom:oz-renamed-from _HASHED_VERSION
    bytes32 private _hashedVersion;

    string private _name;
    string private _version;

    /**
     * @dev Initializes the domain separator and parameter caches.
     *
     * The meaning of `name` and `version` is specified in
     * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:
     *
     * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.
     * - `version`: the current major version of the signing domain.
     *
     * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart
     * contract upgrade].
     */
    function __EIP712_init(string memory name, string memory version) internal onlyInitializing {
        __EIP712_init_unchained(name, version);
    }

    function __EIP712_init_unchained(string memory name, string memory version) internal onlyInitializing {
        _name = name;
        _version = version;

        // Reset prior values in storage if upgrading
        _hashedName = 0;
        _hashedVersion = 0;
    }

    /**
     * @dev Returns the domain separator for the current chain.
     */
    function _domainSeparatorV4() internal view returns (bytes32) {
        return _buildDomainSeparator();
    }

    function _buildDomainSeparator() private view returns (bytes32) {
        return keccak256(abi.encode(_TYPE_HASH, _EIP712NameHash(), _EIP712VersionHash(), block.chainid, address(this)));
    }

    /**
     * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this
     * function returns the hash of the fully encoded EIP712 message for this domain.
     *
     * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:
     *
     * ```solidity
     * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(
     *     keccak256("Mail(address to,string contents)"),
     *     mailTo,
     *     keccak256(bytes(mailContents))
     * )));
     * address signer = ECDSA.recover(digest, signature);
     * ```
     */
    function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) {
        return ECDSAUpgradeable.toTypedDataHash(_domainSeparatorV4(), structHash);
    }

    /**
     * @dev See {EIP-5267}.
     *
     * _Available since v4.9._
     */
    function eip712Domain()
        public
        view
        virtual
        override
        returns (
            bytes1 fields,
            string memory name,
            string memory version,
            uint256 chainId,
            address verifyingContract,
            bytes32 salt,
            uint256[] memory extensions
        )
    {
        // If the hashed name and version in storage are non-zero, the contract hasn't been properly initialized
        // and the EIP712 domain is not reliable, as it will be missing name and version.
        require(_hashedName == 0 && _hashedVersion == 0, "EIP712: Uninitialized");

        return (
            hex"0f", // 01111
            _EIP712Name(),
            _EIP712Version(),
            block.chainid,
            address(this),
            bytes32(0),
            new uint256[](0)
        );
    }

    /**
     * @dev The name parameter for the EIP712 domain.
     *
     * NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs
     * are a concern.
     */
    function _EIP712Name() internal virtual view returns (string memory) {
        return _name;
    }

    /**
     * @dev The version parameter for the EIP712 domain.
     *
     * NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs
     * are a concern.
     */
    function _EIP712Version() internal virtual view returns (string memory) {
        return _version;
    }

    /**
     * @dev The hash of the name parameter for the EIP712 domain.
     *
     * NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Name` instead.
     */
    function _EIP712NameHash() internal view returns (bytes32) {
        string memory name = _EIP712Name();
        if (bytes(name).length > 0) {
            return keccak256(bytes(name));
        } else {
            // If the name is empty, the contract may have been upgraded without initializing the new storage.
            // We return the name hash in storage if non-zero, otherwise we assume the name is empty by design.
            bytes32 hashedName = _hashedName;
            if (hashedName != 0) {
                return hashedName;
            } else {
                return keccak256("");
            }
        }
    }

    /**
     * @dev The hash of the version parameter for the EIP712 domain.
     *
     * NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Version` instead.
     */
    function _EIP712VersionHash() internal view returns (bytes32) {
        string memory version = _EIP712Version();
        if (bytes(version).length > 0) {
            return keccak256(bytes(version));
        } else {
            // If the version is empty, the contract may have been upgraded without initializing the new storage.
            // We return the version hash in storage if non-zero, otherwise we assume the version is empty by design.
            bytes32 hashedVersion = _hashedVersion;
            if (hashedVersion != 0) {
                return hashedVersion;
            } else {
                return keccak256("");
            }
        }
    }

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

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

pragma solidity ^0.8.0;

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library MathUpgradeable {
    enum Rounding {
        Down, // Toward negative infinity
        Up, // Toward infinity
        Zero // Toward zero
    }

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

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

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

    /**
     * @dev Returns the ceiling of the division of two numbers.
     *
     * This differs from standard division with `/` in that it rounds up instead
     * of rounding down.
     */
    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b - 1) / b can overflow on addition, so we distribute.
        return a == 0 ? 0 : (a - 1) / b + 1;
    }

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

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

            // Make sure the result is less than 2^256. Also prevents denominator == 0.
            require(denominator > prod1, "Math: mulDiv overflow");

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

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

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

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

            // Does not overflow because the denominator cannot be zero at this stage in the function.
            uint256 twos = denominator & (~denominator + 1);
            assembly {
                // Divide denominator by twos.
                denominator := div(denominator, twos)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)

pragma solidity ^0.8.0;

/**
 * @dev Standard signed math utilities missing in the Solidity language.
 */
library SignedMathUpgradeable {
    /**
     * @dev Returns the largest of two signed numbers.
     */
    function max(int256 a, int256 b) internal pure returns (int256) {
        return a > b ? a : b;
    }

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

    /**
     * @dev Returns the average of two signed numbers without overflow.
     * The result is rounded towards zero.
     */
    function average(int256 a, int256 b) internal pure returns (int256) {
        // Formula from the book "Hacker's Delight"
        int256 x = (a & b) + ((a ^ b) >> 1);
        return x + (int256(uint256(x) >> 255) & (a ^ b));
    }

    /**
     * @dev Returns the absolute unsigned value of a signed value.
     */
    function abs(int256 n) internal pure returns (uint256) {
        unchecked {
            // must be unchecked in order to support `n = type(int256).min`
            return uint256(n >= 0 ? n : -n);
        }
    }
}

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

pragma solidity ^0.8.0;

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

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

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

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

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

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

    /**
     * @dev Throws if the sender is not the owner.
     */
    function _checkOwner() internal view virtual {
        require(owner() == _msgSender(), "Ownable: caller is not the owner");
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions. 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 {
        require(newOwner != address(0), "Ownable: new owner is the zero address");
        _transferOwnership(newOwner);
    }

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)

pragma solidity ^0.8.0;

/**
 * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.
 *
 * _Available since v4.8.3._
 */
interface IERC1967 {
    /**
     * @dev Emitted when the implementation is upgraded.
     */
    event Upgraded(address indexed implementation);

    /**
     * @dev Emitted when the admin account has changed.
     */
    event AdminChanged(address previousAdmin, address newAdmin);

    /**
     * @dev Emitted when the beacon is changed.
     */
    event BeaconUpgraded(address indexed beacon);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)

pragma solidity ^0.8.0;

/**
 * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
 * proxy whose upgrades are fully controlled by the current implementation.
 */
interface IERC1822Proxiable {
    /**
     * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
     * address.
     *
     * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
     * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
     * function revert if invoked through a proxy.
     */
    function proxiableUUID() external view returns (bytes32);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)

pragma solidity ^0.8.2;

import "../beacon/IBeacon.sol";
import "../../interfaces/IERC1967.sol";
import "../../interfaces/draft-IERC1822.sol";
import "../../utils/Address.sol";
import "../../utils/StorageSlot.sol";

/**
 * @dev This abstract contract provides getters and event emitting update functions for
 * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
 *
 * _Available since v4.1._
 */
abstract contract ERC1967Upgrade is IERC1967 {
    // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
    bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;

    /**
     * @dev Storage slot with the address of the current implementation.
     * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
     * validated in the constructor.
     */
    bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;

    /**
     * @dev Returns the current implementation address.
     */
    function _getImplementation() internal view returns (address) {
        return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
    }

    /**
     * @dev Stores a new address in the EIP1967 implementation slot.
     */
    function _setImplementation(address newImplementation) private {
        require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
        StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
    }

    /**
     * @dev Perform implementation upgrade
     *
     * Emits an {Upgraded} event.
     */
    function _upgradeTo(address newImplementation) internal {
        _setImplementation(newImplementation);
        emit Upgraded(newImplementation);
    }

    /**
     * @dev Perform implementation upgrade with additional setup call.
     *
     * Emits an {Upgraded} event.
     */
    function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
        _upgradeTo(newImplementation);
        if (data.length > 0 || forceCall) {
            Address.functionDelegateCall(newImplementation, data);
        }
    }

    /**
     * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
     *
     * Emits an {Upgraded} event.
     */
    function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {
        // Upgrades from old implementations will perform a rollback test. This test requires the new
        // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
        // this special case will break upgrade paths from old UUPS implementation to new ones.
        if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {
            _setImplementation(newImplementation);
        } else {
            try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
                require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
            } catch {
                revert("ERC1967Upgrade: new implementation is not UUPS");
            }
            _upgradeToAndCall(newImplementation, data, forceCall);
        }
    }

    /**
     * @dev Storage slot with the admin of the contract.
     * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
     * validated in the constructor.
     */
    bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;

    /**
     * @dev Returns the current admin.
     */
    function _getAdmin() internal view returns (address) {
        return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
    }

    /**
     * @dev Stores a new address in the EIP1967 admin slot.
     */
    function _setAdmin(address newAdmin) private {
        require(newAdmin != address(0), "ERC1967: new admin is the zero address");
        StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
    }

    /**
     * @dev Changes the admin of the proxy.
     *
     * Emits an {AdminChanged} event.
     */
    function _changeAdmin(address newAdmin) internal {
        emit AdminChanged(_getAdmin(), newAdmin);
        _setAdmin(newAdmin);
    }

    /**
     * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
     * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
     */
    bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;

    /**
     * @dev Returns the current beacon.
     */
    function _getBeacon() internal view returns (address) {
        return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
    }

    /**
     * @dev Stores a new beacon in the EIP1967 beacon slot.
     */
    function _setBeacon(address newBeacon) private {
        require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract");
        require(
            Address.isContract(IBeacon(newBeacon).implementation()),
            "ERC1967: beacon implementation is not a contract"
        );
        StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
    }

    /**
     * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
     * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
     *
     * Emits a {BeaconUpgraded} event.
     */
    function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
        _setBeacon(newBeacon);
        emit BeaconUpgraded(newBeacon);
        if (data.length > 0 || forceCall) {
            Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)

pragma solidity ^0.8.0;

/**
 * @dev This is the interface that {BeaconProxy} expects of its beacon.
 */
interface IBeacon {
    /**
     * @dev Must return an address that can be used as a delegate call target.
     *
     * {BeaconProxy} will check that this address is a contract.
     */
    function implementation() external view returns (address);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (proxy/beacon/UpgradeableBeacon.sol)

pragma solidity ^0.8.0;

import "./IBeacon.sol";
import "../../access/Ownable.sol";
import "../../utils/Address.sol";

/**
 * @dev This contract is used in conjunction with one or more instances of {BeaconProxy} to determine their
 * implementation contract, which is where they will delegate all function calls.
 *
 * An owner is able to change the implementation the beacon points to, thus upgrading the proxies that use this beacon.
 */
contract UpgradeableBeacon is IBeacon, Ownable {
    address private _implementation;

    /**
     * @dev Emitted when the implementation returned by the beacon is changed.
     */
    event Upgraded(address indexed implementation);

    /**
     * @dev Sets the address of the initial implementation, and the deployer account as the owner who can upgrade the
     * beacon.
     */
    constructor(address implementation_) {
        _setImplementation(implementation_);
    }

    /**
     * @dev Returns the current implementation address.
     */
    function implementation() public view virtual override returns (address) {
        return _implementation;
    }

    /**
     * @dev Upgrades the beacon to a new implementation.
     *
     * Emits an {Upgraded} event.
     *
     * Requirements:
     *
     * - msg.sender must be the owner of the contract.
     * - `newImplementation` must be a contract.
     */
    function upgradeTo(address newImplementation) public virtual onlyOwner {
        _setImplementation(newImplementation);
        emit Upgraded(newImplementation);
    }

    /**
     * @dev Sets the implementation contract address for this beacon
     *
     * Requirements:
     *
     * - `newImplementation` must be a contract.
     */
    function _setImplementation(address newImplementation) private {
        require(Address.isContract(newImplementation), "UpgradeableBeacon: implementation is not a contract");
        _implementation = newImplementation;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)

pragma solidity ^0.8.1;

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

        return account.code.length > 0;
    }

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

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

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

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

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

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

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

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        (bool success, bytes memory returndata) = target.staticcall(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

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

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a delegate call.
     *
     * _Available since v3.4._
     */
    function functionDelegateCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        (bool success, bytes memory returndata) = target.delegatecall(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
     * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
     *
     * _Available since v4.8._
     */
    function verifyCallResultFromTarget(
        address target,
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        if (success) {
            if (returndata.length == 0) {
                // only check isContract if the call was successful and the return data is empty
                // otherwise we already know that it was a contract
                require(isContract(target), "Address: call to non-contract");
            }
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    /**
     * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
     * revert reason or using the provided one.
     *
     * _Available since v4.3._
     */
    function verifyCallResult(
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal pure returns (bytes memory) {
        if (success) {
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    function _revert(bytes memory returndata, string memory errorMessage) private pure {
        // Look for revert reason and bubble it up if present
        if (returndata.length > 0) {
            // The easiest way to bubble the revert reason is using memory via assembly
            /// @solidity memory-safe-assembly
            assembly {
                let returndata_size := mload(returndata)
                revert(add(32, returndata), returndata_size)
            }
        } else {
            revert(errorMessage);
        }
    }
}

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

pragma solidity ^0.8.0;

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

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

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

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

pragma solidity ^0.8.0;

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

    struct BooleanSlot {
        bool value;
    }

    struct Bytes32Slot {
        bytes32 value;
    }

    struct Uint256Slot {
        uint256 value;
    }

    struct StringSlot {
        string value;
    }

    struct BytesSlot {
        bytes value;
    }

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

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

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

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

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

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

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

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

pragma solidity 0.8.20;

// SPDX-License-Identifier: MIT



interface IL2StandardToken {
    event BridgeInitialize(address indexed l1Token, string name, string symbol, uint8 decimals);

    event BridgeMint(address indexed _account, uint256 _amount);

    event BridgeBurn(address indexed _account, uint256 _amount);

    function bridgeMint(address _account, uint256 _amount) external;

    function bridgeBurn(address _account, uint256 _amount) external;

    function l1Address() external view returns (address);

    function l2Bridge() external view returns (address);
}

{
  "compilerPath": "",
  "experimental": {},
  "isSystem": true,
  "optimizer": {
    "enabled": true,
    "mode": "3"
  },
  "outputSelection": {
    "*": {
      "*": [
        "abi"
      ]
    }
  }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"previousAdmin","type":"address"},{"indexed":false,"internalType":"address","name":"newAdmin","type":"address"}],"name":"AdminChanged","type":"event"},{"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":"beacon","type":"address"}],"name":"BeaconUpgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"_account","type":"address"},{"indexed":false,"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"BridgeBurn","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"l1Token","type":"address"},{"indexed":false,"internalType":"string","name":"name","type":"string"},{"indexed":false,"internalType":"string","name":"symbol","type":"string"},{"indexed":false,"internalType":"uint8","name":"decimals","type":"uint8"}],"name":"BridgeInitialize","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"_account","type":"address"},{"indexed":false,"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"BridgeMint","type":"event"},{"anonymous":false,"inputs":[],"name":"EIP712DomainChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","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"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"inputs":[],"name":"DOMAIN_SEPARATOR","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_from","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"bridgeBurn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_l1Address","type":"address"},{"internalType":"bytes","name":"_data","type":"bytes"}],"name":"bridgeInitialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_to","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"bridgeMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes","name":"_input","type":"bytes"}],"name":"decodeString","outputs":[{"internalType":"string","name":"result","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"bytes","name":"_input","type":"bytes"}],"name":"decodeUint8","outputs":[{"internalType":"uint8","name":"result","type":"uint8"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"subtractedValue","type":"uint256"}],"name":"decreaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"eip712Domain","outputs":[{"internalType":"bytes1","name":"fields","type":"bytes1"},{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"version","type":"string"},{"internalType":"uint256","name":"chainId","type":"uint256"},{"internalType":"address","name":"verifyingContract","type":"address"},{"internalType":"bytes32","name":"salt","type":"bytes32"},{"internalType":"uint256[]","name":"extensions","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"addedValue","type":"uint256"}],"name":"increaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l1Address","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"l2Bridge","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"nonces","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256","name":"deadline","type":"uint256"},{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"}],"name":"permit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"bool","name":"ignoreName","type":"bool"},{"internalType":"bool","name":"ignoreSymbol","type":"bool"},{"internalType":"bool","name":"ignoreDecimals","type":"bool"}],"internalType":"struct L2StandardERC20.ERC20Getters","name":"_availableGetters","type":"tuple"},{"internalType":"string","name":"_newName","type":"string"},{"internalType":"string","name":"_newSymbol","type":"string"},{"internalType":"uint8","name":"_version","type":"uint8"}],"name":"reinitializeToken","outputs":[],"stateMutability":"nonpayable","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":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"}]

3cda3351000000000000000000000000000000000000000000000000000000000000000001000475f606ed80ceeb7c73dbd1fe09e9195511d68e5c8df6b905d60bac67e000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000

0x000300000000000200160000000000020000000003020019000000000901034f00000000010900190000006001100270000003f302100197000200000029035500010000000903550000008008000039000000400080043f0000000101300190000000330000c13d000000040120008c000003a90000413d000000000109043b000000e001100270000003fb0310009c0000005d0000a13d000003fc0310009c000000740000213d000004040310009c000001440000213d000004080310009c000002f40000613d000004090310009c000002100000613d0000040a0110009c000003a90000c13d0000000001000416000000000101004b000003a90000c13d000000040120008a000000200110008c000003a90000413d0000000401900370000000000101043b0000042c0310009c000003a90000213d00000004011000390fc80d480000040f000000001201043400000000022100190fc80f4e0000040f0000002002000039000000400300043d000e00000003001d00000000022304360fc80d220000040f0000000e04000029000003fe0000013d0000000001000416000000000101004b000003a90000c13d000000000100041a0000ff0002100190000000510000c13d000000ff0210018f000000ff0220008c0000004c0000613d000000ff011001bf000000000010041b000000ff01000039000000800010043f000003f3010000410000000002000414000003f30320009c0000000002018019000000c001200210000003f8011001c70000800d020000390000000103000039000003f9040000410fc80fbe0000040f0000000101200190000003a90000613d000000200100003900000100001004430000012000000443000003fa0100004100000fc90001042e000003f401000041000000800010043f0000002001000039000000840010043f0000002701000039000000a40010043f000003f501000041000000c40010043f000003f601000041000000e40010043f000003f70100004100000fca000104300000040b0310009c000001310000a13d0000040c0310009c000001a50000213d000004100310009c000003920000613d000004110310009c0000034c0000613d000004120110009c000003a90000c13d0000000001000416000000000101004b000003a90000c13d000000040120008a000000200110008c000003a90000413d0000000401900370000000000101043b000004190210009c000003a90000213d00000000001004350000003301000039000001b70000013d000003fd0310009c000001830000213d000004010310009c0000031c0000613d000004020310009c0000022e0000613d000004030110009c000003a90000c13d0000000001000416000000000101004b000003a90000c13d000000040120008a000000c00110008c000003a90000413d0000006401900370000000000301043b0000042c0130009c000003a90000213d00000023013000390000042d04000041000000000521004b000000000500001900000000050480190000042d01100197000000000601004b00000000040080190000042d0110009c000000000405c019000000000104004b000003a90000c13d0000000404300039000000000149034f000000000101043b0000042c0510009c0000043a0000213d000000bf05100039000000200700008a000000000575016f0000042c0650009c0000043a0000213d000e00000007001d000000400050043f000000800010043f00000000031300190000002403300039000000000323004b000003a90000213d0000002003400039000000000339034f0000001f0410018f0000000505100272000000b10000613d00000000060000190000000507600210000000000873034f000000000808043b000000a00770003900000000008704350000000106600039000000000756004b000000a90000413d000000000604004b000000c00000613d0000000505500210000000000353034f0000000304400210000000a005500039000000000605043300000000064601cf000000000646022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000363019f0000000000350435000000a00110003900000000000104350000008401900370000000000301043b0000042c0130009c000003a90000213d00000023013000390000042d04000041000000000521004b000000000500001900000000050480190000042d01100197000000000601004b00000000040080190000042d0110009c000000000405c019000000000104004b000003a90000c13d0000000404300039000000000149034f000000000101043b0000042c0510009c0000000e060000290000043a0000213d0000003f05100039000000000565016f000000400600043d0000000005560019000d00000006001d000000000665004b000000000600001900000001060040390000042c0750009c0000043a0000213d00000001066001900000043a0000c13d000000400050043f0000000d050000290000000005150436000c00000005001d00000000031300190000002403300039000000000223004b000003a90000213d0000002002400039000000000809034f000000000329034f0000001f0210018f00000005041002720000000c09000029000000fc0000613d000000000500001900000005065002100000000007690019000000000663034f000000000606043b00000000006704350000000105500039000000000645004b000000f40000413d000000000502004b0000010b0000613d0000000504400210000000000343034f0000000c044000290000000302200210000000000504043300000000052501cf000000000525022f000000000303043b0000010002200089000000000323022f00000000022301cf000000000252019f00000000002404350000000c011000290000000000010435000000a401800370000000000101043b000b00000001001d000000ff0110008c000003a90000213d000000000100041a000000ff0210018f000000ff0320008c0000040d0000613d00000001031000390000000b0330014f000000ff03300190000007630000c13d0000ff0003100190000005fd0000c13d0000000b0220006c000005fd0000813d0000042f011001970000000b011001af00000100011001bf000000000010041b0000043001000041000000000201041a000000400300043d0000043101000041000a00000003001d000000000013043500000000010004140000041902200197000000040320008c000007790000c13d0000000003000031000000200130008c00000000040300190000002004008039000007aa0000013d000004130310009c000001bc0000a13d000004140310009c0000020a0000613d000004150310009c000001cf0000613d000004160110009c000003a90000c13d0000000001000416000000000101004b000003a90000c13d000000cc01000039000000000101041a0000046301100198000003a90000c13d000000cd01000039000000000101041a000000ff0110018f000003490000013d000004050310009c0000032c0000613d000004060310009c000002350000613d000004070110009c000003a90000c13d0000000001000416000000000101004b000003a90000c13d000000040120008a000000400110008c000003a90000413d0000000401900370000000000101043b000e00000001001d000004190110009c000003a90000213d0000002401900370000000000101043b000d00000001001d0000000001000411000c00000001001d00000000001004350000003401000039000000200010043f000003f3030000410000000001000414000003f30210009c0000000001038019000000c0011002100000041d011001c700008010020000390fc80fc30000040f0000000102200190000003a90000613d000000000101043b0000000e020000290000000000200435000000200010043f0000000001000414000003f30210009c000003f301008041000000c0011002100000041d011001c700008010020000390fc80fc30000040f0000000102200190000003a90000613d000000000101043b000000000101041a0000000d03000029000000000231004b000004980000813d000000400100043d00000064021000390000044303000041000000000032043500000044021000390000044403000041000000000032043500000024021000390000002503000039000006060000013d000003fe0310009c000003430000613d000003ff0310009c000002920000613d000004000110009c000003a90000c13d0000000001000416000000000101004b000003a90000c13d000000040120008a000000400110008c000003a90000413d0000000401900370000000000101043b000004190210009c000003a90000213d0000002402900370000000000202043b000e00000002001d000004190220009c000003a90000213d00000000001004350000003401000039000000200010043f0000004002000039000d00000002001d00000000010000190fc80fa80000040f0000000e020000290000000000200435000000200010043f00000000010000190000000d02000029000001ba0000013d0000040d0310009c0000039e0000613d0000040e0310009c000003810000613d0000040f0110009c000003a90000c13d0000000001000416000000000101004b000003a90000c13d000000040120008a000000200110008c000003a90000413d0000000401900370000000000101043b000004190210009c000003a90000213d00000000001004350000009901000039000000200010043f000000400200003900000000010000190fc80fa80000040f0000020e0000013d000004170310009c000002ce0000613d000004180110009c000003a90000c13d0000000001000416000000000101004b000003a90000c13d000000040120008a000000400110008c000003a90000413d0000000401900370000000000201043b000004190120009c000003a90000213d0000002401900370000000000301043b00000000010004110fc80e110000040f0000032a0000013d0000000001000416000000000101004b000003a90000c13d000000040120008a000000600110008c000003a90000413d0000000401900370000000000101043b000e00000001001d000004190110009c000003a90000213d0000002401900370000000000101043b000d00000001001d000004190110009c000003a90000213d0000004401900370000000000101043b000c00000001001d0000000e0100002900000000001004350000003401000039000000200010043f000003f3030000410000000001000414000003f30210009c0000000001038019000000c0011002100000041d011001c700008010020000390fc80fc30000040f0000000102200190000003a90000613d000000000101043b0000000002000411000b00000002001d0000000000200435000000200010043f0000000001000414000003f30210009c000003f301008041000000c0011002100000041d011001c700008010020000390fc80fc30000040f0000000102200190000003a90000613d000000000101043b000000000101041a000000010200008a000000000221004b000005c60000613d0000000c03000029000000000231004b000005c20000813d000000400100043d00000044021000390000046403000041000002bf0000013d0000000001000416000000000101004b000003a90000c13d0000003501000039000000000101041a000003490000013d0000000001000416000000000101004b000003a90000c13d000000040120008a000000400110008c000003a90000413d0000000401900370000000000101043b000e00000001001d000004190110009c000003a90000213d0000002401900370000000000301043b000000cd01000039000000000101041a000000080110027000000419011001970000000002000411000000000112004b000003c90000c13d0000000e0100006b000004080000c13d000003f401000041000000800010043f0000002001000039000000840010043f0000001f01000039000000a40010043f0000045301000041000003d00000013d0000000001000416000000000101004b000003a90000c13d000000cd01000039000000000101041a0000000801100270000003480000013d0000000001000416000000000101004b000003a90000c13d000000040120008a000000400110008c000003a90000413d0000000401900370000000000101043b000e00000001001d000004190110009c000003a90000213d0000002401900370000000000301043b0000042c0130009c000003a90000213d00000023013000390000042d04000041000000000521004b000000000500001900000000050480190000042d01100197000000000601004b00000000040080190000042d0110009c000000000405c019000000000104004b000003a90000c13d0000000404300039000000000149034f000000000101043b0000042c0510009c0000043a0000213d000000bf05100039000000200700008a000000000575016f0000042c0650009c0000043a0000213d000d00000007001d000000400050043f000000800010043f00000000031300190000002403300039000000000223004b000003a90000213d0000002002400039000000000229034f0000001f0310018f00000005041002720000026f0000613d00000000050000190000000506500210000000000762034f000000000707043b000000a00660003900000000007604350000000105500039000000000645004b000002670000413d000000000503004b0000027e0000613d0000000504400210000000000242034f0000000303300210000000a004400039000000000504043300000000053501cf000000000535022f000000000202043b0000010003300089000000000232022f00000000023201cf000000000252019f0000000000240435000000a0011000390000000000010435000000000200041a000aff0000200194000900000008001d000c00000002001d000005ca0000c13d000000ff0120019000000000020000190000000102006039001500000002001d0000000002000415000000150220008a000b0020002000cd000000000101004b000005ce0000c13d0000000c010000290000042f0110019700000101011001bf000005ef0000013d0000000001000416000000000101004b000003a90000c13d000000040120008a000000e00110008c000003a90000413d0000000401900370000000000101043b000e00000001001d000004190110009c000003a90000213d0000002401900370000000000101043b000d00000001001d000004190110009c000003a90000213d0000006401900370000000000101043b000c00000001001d0000004401900370000000000101043b000b00000001001d0000008401900370000000000101043b000a00000001001d000000ff0110008c000003a90000213d0000041b010000410000000000100439000003f3010000410000000002000414000003f30320009c0000000002018019000000c0012002100000041c011001c70000800b020000390fc80fc30000040f0000000102200190000005f90000613d000000000101043b0000000c0110006c0000049c0000a13d000000400100043d00000044021000390000042b03000041000000000032043500000024021000390000001d030000390000000000320435000003f4020000410000000000210435000000040210003900000020030000390000000000320435000003f302000041000003f30310009c0000000001028019000000400110021000000426011001c700000fca000104300000000001000416000000000101004b000003a90000c13d000000cc01000039000000000101041a000000ff01100190000003a90000c13d0000003603000039000000000203041a000000010420019000000001052002700000007f0150018f000000000105c0190000001f0510008c00000000050000190000000105002039000000010550018f000000000554004b0000033f0000c13d000000800010043f000000000404004b000003e60000613d0000000000300435000000a002000039000000000301004b000003f30000613d000004340200004100000000040000190000000003040019000000000402041a000000a005300039000000000045043500000001022000390000002004300039000000000514004b000002ea0000413d000000c002300039000003f30000013d0000000001000416000000000101004b000003a90000c13d0000006501000039000000000101041a000000000101004b000003ab0000c13d0000006601000039000000000101041a000000000101004b000003ab0000c13d0000006703000039000000000103041a000000010410019000000001051002700000007f0250018f000000000205c0190000001f0520008c00000000050000190000000105002039000000000551013f00000001055001900000033f0000c13d000000800020043f000000000404004b0000042e0000613d0000000000300435000000a001000039000000000302004b000004400000613d00000438030000410000000001000019000000000403041a000000a005100039000000000045043500000001033000390000002001100039000000000421004b000003140000413d000004340000013d0000000001000416000000000101004b000003a90000c13d000000040120008a000000400110008c000003a90000413d0000000401900370000000000201043b000004190120009c000003a90000213d0000002401900370000000000301043b00000000010004110fc80d950000040f0000000101000039000003960000013d0000000001000416000000000101004b000003a90000c13d000000cc01000039000000000101041a0000ff0001100190000003a90000c13d0000003703000039000000000203041a000000010420019000000001052002700000007f0150018f000000000105c0190000001f0510008c00000000050000190000000105002039000000000552013f0000000105500190000003d30000613d0000045b01000041000000000010043500000022010000390000043d0000013d0000000001000416000000000101004b000003a90000c13d000000ce01000039000000000101041a0000041901100197000000800010043f0000041a0100004100000fc90001042e0000000001000416000000000101004b000003a90000c13d000000040120008a000000400110008c000003a90000413d0000000401900370000000000101043b000e00000001001d000004190110009c000003a90000213d0000000001000411000c00000001001d00000000001004350000003401000039000000200010043f000003f3030000410000000001000414000003f30210009c0000000001038019000000c0011002100000041d011001c70000801002000039000d0000000903530fc80fc30000040f0000000d0300035f0000000102200190000003a90000613d000000000101043b0000000e020000290000000000200435000000200010043f0000002401300370000000000101043b000d00000001001d0000000001000414000003f30210009c000003f301008041000000c0011002100000041d011001c700008010020000390fc80fc30000040f0000000102200190000003a90000613d000000000101043b000000000101041a0000000d03100029000000000113004b000000000100001900000001010040390000000101100190000004990000613d0000040d0000013d0000000001000416000000000101004b000003a90000c13d000000040120008a000000200110008c000003a90000413d0000000401900370000000000101043b0000042c0310009c000003a90000213d00000004011000390fc80d480000040f000000001201043400000000022100190fc80f950000040f000000ff0110018f000003960000013d0000000001000416000000000101004b000003a90000c13d0fc80e6b0000040f000000400200043d0000000000120435000003f301000041000003f30320009c0000000002018019000000400120021000000442011001c700000fc90001042e0000000001000416000000000101004b000003a90000c13d000000040120008a000000400110008c000003a90000413d0000000401900370000000000101043b000e00000001001d000004190110009c000003b30000a13d000000000100001900000fca00010430000003f401000041000000800010043f0000002001000039000000840010043f0000001501000039000000a40010043f0000045501000041000003d00000013d0000002401900370000000000301043b000000cd01000039000000000101041a000000080110027000000419011001970000000002000411000000000112004b000003c90000c13d0000000e02000029000000000102004b000004110000c13d000003f401000041000000800010043f0000002001000039000000840010043f0000002101000039000000a40010043f0000046101000041000000c40010043f00000462010000410000005a0000013d000003f401000041000000800010043f0000002001000039000000840010043f0000000301000039000000a40010043f0000045d01000041000000c40010043f000004540100004100000fca00010430000000800010043f000000000404004b000003ed0000613d0000000000300435000000a002000039000000000301004b000003f30000613d000004350200004100000000040000190000000003040019000000000402041a000000a005300039000000000045043500000001022000390000002004300039000000000514004b000003dc0000413d000000c002300039000003f30000013d000001000300008a000000000232016f000000a00020043f000000000101004b000000c002000039000000a002006039000003f30000013d000001000300008a000000000232016f000000a00020043f000000000101004b000000c002000039000000a002006039000000800220008a0000008001000039000e00000001001d0fc80d350000040f0000002001000039000000400200043d000d00000002001d00000000021204360000000e010000290fc80d220000040f0000000d040000290000000001410049000003f302000041000003f30310009c0000000001028019000003f30340009c000000000402801900000040024002100000006001100210000000000121019f00000fc90001042e0000003501000039000000000201041a000000000232001a0000040d0000413d0000045e0000013d0000045b01000041000000000010043500000011010000390000043d0000013d000d00000003001d00000000002004350000003301000039000c00000001001d000000200010043f000003f3010000410000000002000414000003f30320009c0000000002018019000000c0012002100000041d011001c700008010020000390fc80fc30000040f0000000102200190000003a90000613d000000000101043b000000000201041a0000000d0120006c000005100000813d000000400100043d00000064021000390000045f03000041000000000032043500000044021000390000046003000041000000000032043500000024021000390000002203000039000006060000013d000001000300008a000000000131016f000000a00010043f000000000102004b00000020010000390000000001006019000000bf01100039000000200200008a000000000121016f0000045602100041000004570220009c000004400000213d0000045b0100004100000000001004350000004101000039000000040010043f0000045c0100004100000fca00010430000000400010043f0000006805000039000000000405041a000000010640019000000001034002700000007f0230018f000000000203c0190000001f0320008c00000000030000190000000103002039000000000334013f00000001033001900000033f0000c13d0000000003210436000000000606004b000005510000613d0000000000500435000000000402004b0000000004000019000005570000613d000004390500004100000000040000190000000006430019000000000705041a000000000076043500000001055000390000002004400039000000000624004b000004560000413d000005570000013d000d00000003001d000000000021041b0000000e0100002900000000001004350000003301000039000000200010043f000003f3030000410000000001000414000003f30210009c0000000001038019000000c0011002100000041d011001c700008010020000390fc80fc30000040f0000000102200190000003a90000613d000000000101043b000000000201041a0000000d030000290000000002320019000000000021041b000000400100043d00000000003104350000000002000414000003f30320009c000003f3040000410000000002048019000003f30310009c00000000010480190000004001100210000000c002200210000000000112019f0000043f011001c70000800d020000390000000303000039000004510400004100000000050000190000000e060000290fc80fbe0000040f0000000101200190000003a90000613d000000400100043d0000000d020000290000000000210435000003f3020000410000000003000414000003f30430009c0000000003028019000003f30410009c00000000010280190000004001100210000000c002300210000000000112019f0000043f011001c70000800d02000039000000020300003900000452040000410000054b0000013d00000000033100490000000c010000290000000e02000029000001cd0000013d0000000e0100002900000000001004350000009901000039000000200010043f000003f3010000410000000002000414000003f30320009c0000000002018019000000c0012002100000041d011001c700008010020000390fc80fc30000040f0000000102200190000003a90000613d000000000101043b000000000201041a0000000103200039000000000031041b000000400100043d000000c0031000390000000c040000290000000000430435000000a003100039000000000023043500000080021000390000000b03000029000000000032043500000060021000390000000d03000029000000000032043500000040021000390000000e030000290000000000320435000000c00200003900000000022104360000041e0300004100000000003204350000041f0310009c0000043a0000213d000000e003100039000000400030043f000003f304000041000003f30320009c000000000204801900000040022002100000000001010433000003f30310009c00000000010480190000006001100210000000000121019f0000000002000414000003f30320009c0000000002048019000000c002200210000000000112019f00000420011001c700008010020000390fc80fc30000040f0000000102200190000003a90000613d000000000101043b000c00000001001d0fc80e6b0000040f0000042102000041000000400300043d00000000002304350000000202300039000000000012043500000022013000390000000c0200002900000000002104350000000101000367000000c402100370000000000202043b000c00000002001d000000a401100370000000000101043b000900000001001d0000000001000414000003f30210009c000003f3040000410000000001048019000003f30230009c00000000030480190000004002300210000000c001100210000000000112019f00000422011001c700008010020000390fc80fc30000040f0000000102200190000003a90000613d000000400200043d0000000c03000029000004230330009c000006fb0000a13d000000640120003900000428030000410000000000310435000000440120003900000429030000410000000000310435000000240120003900000022030000390000000000310435000003f4010000410000000000120435000000040120003900000020030000390000000000310435000003f301000041000003f30320009c000000000201801900000040012002100000042a011001c700000fca00010430000b00000002001d0000000e0100002900000000001004350000000c01000029000000200010043f000003f3030000410000000001000414000003f30210009c0000000001038019000000c0011002100000041d011001c700008010020000390fc80fc30000040f0000000102200190000003a90000613d0000000d030000290000000b02300069000000000101043b000000000021041b0000003501000039000000000201041a0000000002320049000000000021041b000000400100043d00000000003104350000000002000414000003f30320009c000003f3040000410000000002048019000003f30310009c00000000010480190000004001100210000000c002200210000000000112019f0000043f011001c70000800d02000039000000030300003900000451040000410000000e0500002900000000060000190fc80fbe0000040f0000000101200190000003a90000613d000000400100043d0000000d020000290000000000210435000003f3020000410000000003000414000003f30430009c0000000003028019000003f30410009c00000000010280190000004001100210000000c002300210000000000112019f0000043f011001c70000800d0200003900000002030000390000045e040000410000000e050000290fc80fbe0000040f0000000101200190000003a90000613d000000000100001900000fc90001042e000001000500008a000000000454016f0000000000430435000000000202004b000000200400003900000000040060190000003f02400039000000200500008a000000000252016f0000000004120019000000000224004b000000000200001900000001020040390000042c0340009c0000043a0000213d00000001022001900000043a0000c13d000000400040043f000004580240009c0000043a0000213d000d00000005001d0000002002400039000c00000002001d000000400020043f000b00000004001d0000000000040435000000400400043d0000002002400039000000e003000039000000000032043500000459020000410000000000240435000000e003400039000000800200043d0000000000230435000e00000004001d0000010003400039000000000402004b000005800000613d00000000040000190000000005340019000000a006400039000000000606043300000000006504350000002004400039000000000524004b000005790000413d000000000432001900000000000404350000001f022000390000000d0220017f00000000023200190000000e0400002900000000034200490000004004400039000000000034043500000000060104330000000005620436000000000206004b000005950000613d000000000200001900000000035200190000002002200039000000000412001900000000040404330000000000430435000000000362004b0000058e0000413d000a00000005001d000900000006001d000000000156001900000000000104350000045a010000410000000000100439000003f3010000410000000002000414000003f30320009c0000000002018019000000c0012002100000041c011001c70000800b020000390fc80fc30000040f0000000102200190000005f90000613d000000000101043b0000000e040000290000008002400039000000000300041000000000003204350000006002400039000000000012043500000009010000290000001f011000390000000d0110017f0000000a011000290000000002410049000000c0034000390000000000230435000000a00240003900000000000204350000000b0200002900000000020204330000000001210436000000000302004b0000000c05000029000000310000613d0000000003000019000000005405043400000000014104360000000103300039000000000423004b000005bc0000413d000000310000013d00000000033100490000000e010000290000000b020000290fc80e110000040f0000000e010000290000000d020000290000000c03000029000003290000013d0000000001000415000000160110008a000b0020001000cd001600000000001d0000044501000041000000000010043900000000010004100000000400100443000003f3010000410000000002000414000003f30320009c0000000002018019000000c00120021000000446011001c700008002020000390fc80fc30000040f0000000102200190000005f90000613d000000000101043b000000000101004b000005fa0000c13d0000000c01000029000000ff0110018f000000010110008c000000000100001900000001010060390000000b020000290000000502200270000000000201001f000005fd0000c13d000001000100008a0000000c0110017f00000001011001bf0000000a0200006b0000000c010060290000042f0110619700000101011061bf000000000010041b0000000e0100006b000006120000c13d000000400100043d00000044021000390000045003000041000000000032043500000024021000390000000303000039000002c20000013d000000000001042f0000000b010000290000000501100270000000000100001f000000400100043d00000064021000390000044703000041000000000032043500000044021000390000044803000041000000000032043500000024021000390000002e030000390000000000320435000003f4020000410000000000210435000000040210003900000020030000390000000000320435000003f302000041000003f30310009c000000000102801900000040011002100000042a011001c700000fca00010430000000ce01000039000000000201041a00000449022001970000000e022001af000000000021041b000000000100041100000008011002100000044a01100197000000cd03000039000000000203041a0000044b02200197000000000121019f000c00000003001d000000000013041b0000042d02000041000000800100043d000000600310008c000000000300001900000000030240190000042d04100197000000000504004b000000000200a0190000042d0440009c000000000203c019000000000202004b000003a90000c13d000000a00400043d0000042c0240009c000003a90000213d000000a002100039000000bf014000390000042d03000041000000000521004b000000000500001900000000050380190000042d062001970000042d01100197000000000761004b0000000003008019000000000161013f0000042d0110009c000000000305c019000000000103004b000003a90000c13d000000a00140003900000000030104330000042c0130009c0000000d050000290000043a0000213d0000003f01300039000000000551016f000000400100043d0000000005510019000000000615004b000000000600001900000001060040390000042c0750009c0000043a0000213d00000001066001900000043a0000c13d000000c004400039000000400050043f00000000053104360000000006430019000000000626004b000003a90000213d000000000603004b0000065e0000613d000000000600001900000000075600190000000008460019000000000808043300000000008704350000002006600039000000000736004b000006570000413d00000000033500190000000000030435000000c00400043d0000042c0340009c000003a90000213d000000bf034000390000042d05000041000000000623004b000000000600001900000000060580190000042d072001970000042d03300197000000000873004b0000000005008019000000000373013f0000042d0330009c000000000506c019000000000305004b000003a90000c13d000000a00340003900000000030304330000042c0530009c0000000d060000290000043a0000213d0000003f05300039000000000565016f000000400600043d0000000005560019000800000006001d000000000665004b000000000600001900000001060040390000042c0750009c0000043a0000213d00000001066001900000043a0000c13d000000c004400039000000400050043f000000080500002900000000053504360000000006430019000000000626004b000003a90000213d000000000603004b000006930000613d000000000600001900000000075600190000000008460019000000000808043300000000008704350000002006600039000000000736004b0000068c0000413d00000000033500190000000000030435000000e00400043d0000042c0340009c000003a90000213d000000bf034000390000042d05000041000000000623004b000000000600001900000000060580190000042d072001970000042d03300197000000000873004b0000000005008019000000000373013f0000042d0330009c000000000506c019000000000305004b000003a90000c13d000000a00340003900000000030304330000042c0530009c0000000d060000290000043a0000213d0000003f05300039000000000565016f000000400600043d0000000005560019000700000006001d000000000665004b000000000600001900000001060040390000042c0750009c0000043a0000213d00000001066001900000043a0000c13d000000c004400039000000400050043f000000070500002900000000053504360000000006430019000000000226004b000003a90000213d000000000203004b000006c80000613d000000000200001900000000065200190000000007420019000000000707043300000000007604350000002002200039000000000632004b000006c10000413d00000000023500190000000000020435000000400200043d000500000002001d0000044c0220009c0000043a0000213d00000005030000290000006002300039000000400020043f0000004002300039000100000002001d00000000000204350000000002030436000200000002001d00000000000204350000044d02000041000000400400043d000000000024043500000004024000390000002003000039000300000003001d0000000000320435000000000201043300000024034000390000000000230435000600000004001d0000004403400039000000000402004b000006ed0000613d000000000400001900000000053400190000002004400039000000000614001900000000060604330000000000650435000000000524004b000006e60000413d0000000001320019000000000001043500000000010004140000000003000410000400000003001d000000040330008c000008d30000c13d0000000004000415000000140440008a00000020044000c900000002010003670000000003000031001400000000001d000008f10000013d000000000101043b00000060032000390000000c04000029000000000043043500000040032000390000000904000029000000000043043500000020032000390000000a04000029000000000043043500000000001204350000000000000435000003f3010000410000000003000414000003f30430009c0000000003018019000003f30420009c00000000020180190000004001200210000000c002300210000000000112019f00000424011001c700000001020000390fc80fc30000040f00000000030100190000006003300270000003f303300197000000200430008c000000000403001900000020040080390000001f0540018f0000000504400272000007240000613d00000000060000190000000507600210000000000871034f000000000808043b00000000008704350000000106600039000000000746004b0000071d0000413d000000000605004b000007320000613d00000003055002100000000504400210000000000604043300000000065601cf000000000656022f000000000741034f000000000707043b0000010005500089000000000757022f00000000055701cf000000000565019f0000000000540435000000000003001f00020000000103550000000102200190000007400000613d000000000100043300000419011001980000076a0000c13d000000400100043d00000044021000390000042703000041000000000032043500000024021000390000001803000039000002c20000013d000000400200043d0000001f0430018f00000005053002720000074d0000613d000000000600001900000005076002100000000008720019000000000771034f000000000707043b00000000007804350000000106600039000000000756004b000007450000413d000000000604004b0000075c0000613d0000000505500210000000000151034f00000000055200190000000304400210000000000605043300000000064601cf000000000646022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000161019f0000000000150435000003f301000041000003f30420009c000000000201801900000040012002100000006002300210000000000121019f00000fca00010430000000400100043d00000044021000390000042e03000041000000000032043500000024021000390000000103000039000002c20000013d0000000e0110006c000007720000c13d0000000e010000290000000d020000290000000b030000290fc80e110000040f000000000100001900000fc90001042e000000400100043d00000044021000390000042503000041000000000032043500000024021000390000001e03000039000002c20000013d000003f303000041000003f30410009c00000000010380190000000a05000029000003f30450009c00000000030540190000004003300210000000c001100210000000000131019f00000432011001c70fc80fc30000040f0000000a0a00002900000000030100190000006003300270000003f303300197000000200430008c000000000403001900000020040080390000001f0540018f0000000506400272000007970000613d0000000007000019000000050870021000000000098a0019000000000881034f000000000808043b00000000008904350000000107700039000000000867004b0000078f0000413d000000000705004b000007a60000613d0000000506600210000000000761034f0000000a066000290000000305500210000000000806043300000000085801cf000000000858022f000000000707043b0000010005500089000000000757022f00000000055701cf000000000585019f0000000000560435000000000003001f00020000000103550000000102200190000007ff0000613d0000001f01400039000000600210018f0000000a01200029000000000221004b000000000200001900000001020040390000042c0410009c0000043a0000213d00000001022001900000043a0000c13d000000400010043f000000200230008c000003a90000413d0000000a020000290000000002020433000004190320009c000003a90000213d0000000003000411000000000223004b0000081c0000c13d000000800300043d0000042c0230009c0000043a0000213d0000003602000039000000000502041a000000010450019000000001065002700000007f0460018f000000000406c0190000001f0640008c00000000060000190000000106002039000000000565013f00000001055001900000033f0000c13d000000200540008c000007df0000413d0000001f05300039000000050550027000000434065000410000043405000041000000200730008c000000000506801900000000002004350000001f0440003900000005044002700000043404400041000000000645004b000007df0000813d000000000005041b0000000105500039000000000645004b000007db0000413d0000001f0430008c000008220000a13d00000000002004350000000e0630018000000020050000390000043404000041000007f10000613d00000434040000410000002005000039000000000700001900000080085000390000000008080433000000000084041b000000200550003900000001044000390000002007700039000000000867004b000007e90000413d000000000636004b000007fc0000813d0000000306300210000000f80660018f000000010700008a000000000667022f000000000676013f00000080055000390000000005050433000000000565016f000000000054041b000000010330021000000001033001bf0000082d0000013d000000400200043d0000001f0430018f00000005053002720000080c0000613d000000000600001900000005076002100000000008720019000000000771034f000000000707043b00000000007804350000000106600039000000000756004b000008040000413d000000000604004b0000075c0000613d0000000505500210000000000151034f00000000055200190000000304400210000000000605043300000000064601cf000000000646022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000161019f00000000001504350000075c0000013d00000044021000390000043303000041000000000032043500000024021000390000000203000039000002c20000013d000000000403004b0000000004000019000008260000613d000000a00400043d0000000305300210000000010600008a000000000556022f000000000565013f000000000454016f0000000103300210000000000334019f000000000032041b0000000d0200002900000000030204330000042c0230009c0000043a0000213d0000003702000039000000000502041a000000010450019000000001065002700000007f0460018f000000000406c0190000001f0640008c00000000060000190000000106002039000000000565013f00000001055001900000033f0000c13d000000200540008c000008500000413d0000001f05300039000000050550027000000435065000410000043505000041000000200730008c000000000506801900000000002004350000001f0440003900000005044002700000043504400041000000000645004b000008500000813d000000000005041b0000000105500039000000000645004b0000084c0000413d0000001f0430008c000008710000a13d00000000002004350000000e06300180000000200500003900000435040000410000000d09000029000008630000613d00000435040000410000002005000039000000000700001900000000089500190000000008080433000000000084041b000000200550003900000001044000390000002007700039000000000867004b0000085b0000413d000000000636004b0000086e0000813d0000000306300210000000f80660018f000000010700008a000000000667022f000000000676013f0000000d055000290000000005050433000000000565016f000000000054041b000000010330021000000001033001bf0000087d0000013d000000000403004b0000000004000019000008760000613d0000000c0400002900000000040404330000000305300210000000010600008a000000000556022f000000000565013f000000000454016f0000000103300210000000000334019f000000000032041b000000000200041a0000ff00022001900000088a0000c13d00000064021000390000044003000041000000000032043500000044021000390000044103000041000000000032043500000024021000390000002b03000039000006060000013d000004360210009c0000043a0000213d0000004002100039000000400020043f0000000102000039000000000221043600000437030000410000000000320435000000800400043d0000042c0340009c0000043a0000213d0000006703000039000000000603041a000000010560019000000001076002700000007f0570018f000000000507c0190000001f0750008c00000000070000190000000107002039000000000676013f00000001066001900000033f0000c13d000000200650008c000008b30000413d0000001f06400039000000050660027000000438076000410000043806000041000000200840008c000000000607801900000000003004350000001f0550003900000005055002700000043805500041000000000756004b000008b30000813d000000000006041b0000000106600039000000000756004b000008af0000413d0000001f0540008c000000010540021000000a030000a13d00000000003004350000000e0840018000000020070000390000043806000041000008c60000613d000004380600004100000020070000390000000009000019000000800a700039000000000a0a04330000000000a6041b000000200770003900000001066000390000002009900039000000000a89004b000008be0000413d000000000848004b000008d10000813d0000000304400210000000f80440018f000000010800008a000000000448022f000000000484013f00000080077000390000000007070433000000000447016f000000000046041b00000001045001bf00000a0d0000013d0000001f022000390000000d0220017f000003f3030000410000000605000029000003f30450009c0000000004030019000000000405401900000040044002100000004402200039000003f30520009c00000000020380190000006002200210000000000242019f000003f30410009c0000000001038019000000c001100210000000000121019f00000004020000290fc80fc30000040f0000000004000415000000130440008a00000020044000c900000000030100190000006003300270000003f30030019d000003f3033001970002000000010355001300000000001d0000000102200190000009590000613d0000001f0230018f00000005053002720000000609000029000008fe0000613d000000000600001900000005076002100000000008790019000000000771034f000000000707043b00000000007804350000000106600039000000000756004b000008f60000413d000000000602004b0000090d0000613d0000000505500210000000000651034f00000006055000290000000302200210000000000705043300000000072701cf000000000727022f000000000606043b0000010002200089000000000626022f00000000022601cf000000000272019f00000000002504350000001f023000390000000d0220017f0000000605200029000000000225004b00000000020000190000000102004039000b00000005001d0000042c0550009c0000043a0000213d00000001022001900000043a0000c13d0000042d02000041000000200530008c000000000500001900000000050240190000042d06300197000000000706004b000000000200a0190000042d0660009c000000000205c0190000000b05000029000000400050043f000000000202004b000003a90000c13d000000060200002900000000020204330000042c0520009c000003a90000213d000000060630002900000006022000290000001f052000390000042d07000041000000000865004b000000000800001900000000080780190000042d055001970000042d09600197000000000a95004b0000000007008019000000000595013f0000042d0550009c000000000708c019000000000507004b000003a90000c13d00000000520204340000042c0720009c0000000d080000290000043a0000213d0000003f07200039000000000787016f0000000b077000290000042c0870009c0000043a0000213d000000400070043f0000000b0700002900000000082704360000000007520019000000000667004b000003a90000213d000000000602004b000900000008001d0000000006080019000009550000613d000000000600001900000009076000290000000008560019000000000808043300000000008704350000002006600039000000000726004b0000094d0000413d0000000906200029000000000006043500000005024002700000000b0200002f0000095d0000013d000000010200003900000005040000290000000000240435000b00600000003d000000400500043d0000044d0200004100000000002504350000000402500039000000030400002900000000004204350000000808000029000000000208043300000024045000390000000000240435000600000005001d0000004404500039000000000502004b000009730000613d000000000500001900000000064500190000002005500039000000000785001900000000070704330000000000760435000000000625004b0000096c0000413d0000000004420019000000000004043500000000040004140000000405000029000000040550008c0000097e0000c13d0000000004000415000000120440008a00000020044000c9001200000000001d0000099c0000013d0000001f012000390000000d0110017f000003f3020000410000000605000029000003f30350009c0000000003020019000000000305401900000040033002100000004401100039000003f30510009c00000000010280190000006001100210000000000131019f000003f30340009c0000000004028019000000c002400210000000000112019f00000004020000290fc80fc30000040f0000000004000415000000110440008a00000020044000c900000000030100190000006003300270000003f30030019d000003f3033001970002000000010355001100000000001d000000010220019000000a4f0000613d0000001f0230018f00000005053002720000000609000029000009a90000613d000000000600001900000005076002100000000008790019000000000771034f000000000707043b00000000007804350000000106600039000000000756004b000009a10000413d000000000602004b000009b80000613d0000000505500210000000000151034f00000006055000290000000302200210000000000605043300000000062601cf000000000626022f000000000101043b0000010002200089000000000121022f00000000012101cf000000000161019f00000000001504350000001f013000390000000d0110017f0000000602100029000000000112004b00000000010000190000000101004039000800000002001d0000042c0220009c0000043a0000213d00000001011001900000043a0000c13d0000042d01000041000000200230008c000000000200001900000000020140190000042d05300197000000000605004b000000000100a0190000042d0550009c000000000102c0190000000802000029000000400020043f000000000101004b000003a90000c13d000000060100002900000000010104330000042c0210009c000003a90000213d000000060630002900000006011000290000001f021000390000042d05000041000000000762004b000000000700001900000000070580190000042d022001970000042d08600197000000000982004b0000000005008019000000000282013f0000042d0220009c000000000507c019000000000205004b000003a90000c13d00000000520104340000042c0120009c0000000d070000290000043a0000213d0000003f01200039000000000171016f00000008011000290000042c0710009c0000043a0000213d000000400010043f000000080100002900000000012104360000000007520019000000000667004b000003a90000213d000000000602004b0000000006010019000009ff0000613d000000000600001900000000071600190000000008560019000000000808043300000000008704350000002006600039000000000726004b000009f70000413d000000000612001900000000000604350000000502400270000000080200002f00000a540000013d000000000604004b000000000600001900000a070000613d000000a00600043d0000000304400210000000010700008a000000000447022f000000000474013f000000000446016f000000000454019f000000000043041b00000000040104330000042c0340009c0000043a0000213d0000006803000039000000000603041a000000010560019000000001076002700000007f0570018f000000000507c0190000001f0750008c00000000070000190000000107002039000000000676013f00000001066001900000033f0000c13d000000200650008c00000a2f0000413d0000001f06400039000000050660027000000439076000410000043906000041000000200840008c000000000607801900000000003004350000001f0550003900000005055002700000043905500041000000000756004b00000a2f0000813d000000000006041b0000000106600039000000000756004b00000a2b0000413d0000001f0540008c00000a9b0000a13d00000000003004350000000e064001800000002005000039000004390200004100000a410000613d00000439020000410000002005000039000000000700001900000000081500190000000008080433000000000082041b000000200550003900000001022000390000002007700039000000000867004b00000a390000413d000000000646004b00000a4c0000813d0000000306400210000000f80660018f000000010700008a000000000667022f000000000676013f00000000011500190000000001010433000000000161016f000000000012041b000000010140021000000001011001bf00000aa60000013d000000010100003900000002020000290000000000120435000800600000003d0000008001000039000000000200041a0000ff000220019000000a590000c13d000000400100043d000008810000013d0000000b0200002900000000040204330000042c0240009c0000043a0000213d0000003602000039000000000602041a000000010560019000000001076002700000007f0570018f000000000507c0190000001f0750008c00000000070000190000000107002039000000000676013f00000001066001900000033f0000c13d000000200650008c00000a7b0000413d0000001f06400039000000050660027000000434076000410000043406000041000000200840008c000000000607801900000000002004350000001f0550003900000005055002700000043405500041000000000756004b00000a7b0000813d000000000006041b0000000106600039000000000756004b00000a770000413d0000001f0540008c00000b2f0000a13d00000000002004350000000d074001800000002006000039000004340500004100000a8d0000613d0000043405000041000000200600003900000000080000190000000b096000290000000009090433000000000095041b000000200660003900000001055000390000002008800039000000000978004b00000a850000413d000000000747004b00000a980000813d0000000307400210000000f80770018f000000010800008a000000000778022f000000000787013f0000000b066000290000000006060433000000000676016f000000000065041b000000010440021000000001044001bf00000b3b0000013d000000000104004b000000000100001900000a9f0000613d00000000010204330000000302400210000000010500008a000000000225022f000000000252013f000000000121016f0000000102400210000000000121019f000000000013041b0000006501000039000000000001041b0000006601000039000000000001041b00000001020003670000000401200370000000000301043b000000000103004b0000000001000019000000010100c039000000000113004b000003a90000c13d000000cc01000039000000000401041a000001000500008a000000000454016f000000000334019f000000000031041b0000002404200370000000000404043b000000000504004b0000000005000019000000010500c039000000000554004b000003a90000c13d0000043a05000041000000000353016f000000000404004b000001000330c1bf000000000031041b0000004402200370000000000202043b000000000402004b0000000004000019000000010400c039000000000442004b000003a90000c13d0000043b04000041000000000202004b00000000040060190000043c02300197000000000224019f000000000021041b000000ce01000039000000000501041a000000cd01000039000000000201041a000000400100043d000000600300003900000000033104360000006006100039000000800400043d000000000046043500000080061000390000041905500197000000000704004b00000ae80000613d00000000070000190000000008670019000000a009700039000000000909043300000000009804350000002007700039000000000847004b00000ae10000413d000000ff0220018f000000000764001900000000000704350000001f044000390000000e0440017f0000000006640019000000000416004900000000004304350000000d0300002900000000040304330000000003460436000000000604004b00000afd0000613d0000000006000019000000000736001900000020066000390000000d0860002900000000080804330000000000870435000000000746004b00000af60000413d00000000063400190000000000060435000000400610003900000000002604350000001f024000390000000e0220017f00000000031300490000000002230019000003f304000041000003f30320009c00000000020480190000006002200210000003f30310009c00000000010480190000004001100210000000000112019f0000000002000414000003f30320009c0000000002048019000000c002200210000000000112019f00000420011001c70000800d0200003900000002030000390000043d040000410fc80fbe0000040f0000000101200190000003a90000613d0000043e01000041000000000200041a000000000112016f000000000010041b0000000b01000029000000ff0110018f000000400200043d00000000001204350000000001000414000003f30310009c000003f3040000410000000001048019000003f30320009c00000000020480190000004002200210000000c001100210000000000121019f0000043f011001c70000800d020000390000000103000039000003f9040000410000054c0000013d000000000504004b000000000500001900000b340000613d000000090500002900000000050504330000000306400210000000010700008a000000000667022f000000000676013f000000000565016f0000000104400210000000000445019f000000000042041b000000080200002900000000040204330000042c0240009c0000043a0000213d0000003702000039000000000602041a000000010560019000000001076002700000007f0570018f000000000507c0190000001f0750008c00000000070000190000000107002039000000000676013f00000001066001900000033f0000c13d000000200650008c00000b5e0000413d0000001f06400039000000050660027000000435076000410000043506000041000000200840008c000000000607801900000000002004350000001f0550003900000005055002700000043505500041000000000756004b00000b5e0000813d000000000006041b0000000106600039000000000756004b00000b5a0000413d0000001f0540008c00000b7e0000a13d00000000002004350000000d064001800000002005000039000004350100004100000b700000613d00000435010000410000002005000039000000000700001900000008085000290000000008080433000000000081041b000000200550003900000001011000390000002007700039000000000867004b00000b680000413d000000000646004b00000b7b0000813d0000000306400210000000f80660018f000000010700008a000000000667022f000000000676013f00000008055000290000000005050433000000000565016f000000000051041b000000010140021000000001011001bf00000b890000013d000000000504004b000000000500001900000b820000613d00000000050104330000000301400210000000010600008a000000000116022f000000000161013f000000000115016f0000000104400210000000000141019f000000000012041b000000000100041a0000ff000110019000000a570000613d000000400100043d000004360210009c0000043a0000213d0000004002100039000000400020043f0000000102000039000600000002001d0000000002210436000004370400004100000000004204350000000b0400002900000000050404330000042c0450009c0000043a0000213d0000006704000039000000000704041a000000010670019000000001087002700000007f0680018f000000000608c0190000001f0860008c00000000080000190000000108002039000000000787013f00000001077001900000033f0000c13d000000200760008c00000bb90000413d0000001f07500039000000050770027000000438087000410000043807000041000000200950008c000000000708801900000000004004350000001f0660003900000005066002700000043806600041000000000867004b00000bb90000813d000000000007041b0000000107700039000000000867004b00000bb50000413d0000001f0650008c000000010650021000000bd90000a13d00000000004004350000000d095001800000002008000039000004380700004100000bcc0000613d00000438070000410000002008000039000000000a0000190000000b0b800029000000000b0b04330000000000b7041b00000020088000390000000107700039000000200aa00039000000000b9a004b00000bc40000413d000000000959004b00000bd70000813d0000000305500210000000f80550018f000000010900008a000000000559022f000000000595013f0000000b088000290000000008080433000000000558016f000000000057041b00000001056001bf00000be40000013d000000000705004b000000000700001900000bde0000613d000000090700002900000000070704330000000305500210000000010800008a000000000558022f000000000585013f000000000557016f000000000565019f000000000054041b00000000050104330000042c0450009c0000043a0000213d0000006804000039000000000704041a000000010670019000000001087002700000007f0680018f000000000608c0190000001f0860008c00000000080000190000000108002039000000000787013f00000001077001900000033f0000c13d000000200760008c00000c060000413d0000001f07500039000000050770027000000439087000410000043907000041000000200950008c000000000708801900000000004004350000001f0660003900000005066002700000043906600041000000000867004b00000c060000813d000000000007041b0000000107700039000000000867004b00000c020000413d0000001f0650008c00000c260000a13d00000000004004350000000d075001800000043902000041000000030600002900000c180000613d00000439020000410000002006000039000000000800001900000000091600190000000009090433000000000092041b000000200660003900000001022000390000002008800039000000000978004b00000c100000413d000000000757004b00000c230000813d0000000307500210000000f80770018f000000010800008a000000000778022f000000000787013f00000000011600190000000001010433000000000171016f000000000012041b000000010150021000000001011001bf00000c310000013d000000000105004b000000000100001900000c2a0000613d00000000010204330000000302500210000000010600008a000000000226022f000000000262013f000000000121016f0000000102500210000000000121019f000000000014041b0000006501000039000000000001041b0000006601000039000000000001041b0000044e01000041000000400400043d00000000001404350000000401400039000000030200002900000000002104350000000701000029000000000101043300000024024000390000000000120435000900000004001d0000004402400039000000000401004b00000c4c0000613d000000000400001900000000052400190000002004400039000000070640002900000000060604330000000000650435000000000514004b00000c450000413d0000000002210019000000000002043500000000020004140000000404000029000000040440008c00000c5a0000c13d0000000005000415000000100550008a00000020055000c9000000200130008c00000000040300190000002004008039001000000000001d00000c960000013d0000001f011000390000000d0110017f000003f3030000410000000905000029000003f30450009c0000000004030019000000000405401900000040044002100000004401100039000003f30510009c00000000010380190000006001100210000000000141019f000003f30420009c0000000002038019000000c002200210000000000112019f00000004020000290fc80fc30000040f00000000030100190000006003300270000003f303300197000000200430008c000000000403001900000020040080390000001f0540018f000000050640027200000c7f0000613d000000000700001900000005087002100000000909800029000000000881034f000000000808043b00000000008904350000000107700039000000000867004b00000c770000413d000000000705004b00000c8e0000613d0000000506600210000000000761034f00000009066000290000000305500210000000000806043300000000085801cf000000000858022f000000000707043b0000010005500089000000000757022f00000000055701cf000000000585019f0000000000560435000000000003001f000200000001035500000000050004150000000f0550008a00000020055000c9000f00000000001d000000010120019000000cb50000613d0000001f01400039000000600210018f0000000901200029000000000221004b000000000200001900000001020040390000042c0410009c0000043a0000213d00000001022001900000043a0000c13d000000400010043f000000200230008c000003a90000413d00000009020000290000000002020433000000ff0320008c000003a90000213d0000000503500270000000000302001f0000000c05000029000000000305041a000001000400008a000000000343016f000000000223019f000000000025041b000000010300002900000000040304330000043b03000041000000000404004b000000000300601900000cbc0000013d0000000101000029000000060200002900000000002104350000043b03000041000000400100043d0000000c02000029000000000202041a00000005040000290000000004040433000000000404004b000000010330c1bf000000cc04000039000000000504041a0000044f05500197000000000353019f00000002050000290000000005050433000000000505004b000001000330c1bf000000000034041b000000600300003900000000033104360000000b0400002900000000040404330000006005100039000000000045043500000080061000390000000e050000290000041905500197000000000704004b00000cdc0000613d0000000007000019000000000867001900000020077000390000000b0970002900000000090904330000000000980435000000000847004b00000cd50000413d000000ff0220018f000000000764001900000000000704350000001f044000390000000d0440017f000000000664001900000000041600490000000000430435000000080300002900000000040304330000000003460436000000000604004b00000cf10000613d000000000600001900000000073600190000002006600039000000080860002900000000080804330000000000870435000000000746004b00000cea0000413d00000000063400190000000000060435000000400610003900000000002604350000001f024000390000000d0220017f00000000031300490000000002230019000003f303000041000003f30420009c00000000020380190000006002200210000003f30410009c00000000010380190000004001100210000000000112019f0000000002000414000003f30420009c0000000002038019000000c002200210000000000112019f00000420011001c70000800d0200003900000002030000390000043d040000410fc80fbe0000040f0000000101200190000003a90000613d0000000a0100006b0000054f0000c13d0000043e01000041000000000200041a000000000112016f000000000010041b000000400100043d00000006030000290000000000310435000003f3020000410000000005000414000003f30450009c0000000005028019000003f30410009c00000000010280190000004001100210000000c002500210000000000112019f0000043f011001c70000800d0200003900000b2d0000013d00000000030104330000000002320436000000000403004b00000d2e0000613d000000000400001900000000052400190000002004400039000000000614001900000000060604330000000000650435000000000534004b00000d270000413d000000000123001900000000000104350000001f01300039000000200300008a000000000131016f0000000001120019000000000001042d0000001f02200039000000200300008a000000000232016f0000000001120019000000000221004b000000000200001900000001020040390000042c0310009c00000d420000213d000000010220019000000d420000c13d000000400010043f000000000001042d0000045b0100004100000000001004350000004101000039000000040010043f0000045c0100004100000fca0001043000000000030100190000001f013000390000042d04000041000000000521004b000000000500001900000000050440190000042d062001970000042d01100197000000000761004b000000000400a019000000000161013f0000042d0110009c000000000405c019000000000104004b00000d930000613d0000000106000367000000000136034f000000000401043b000004650140009c00000d8d0000813d0000003f01400039000000200500008a000000000551016f000000400100043d0000000005510019000000000715004b000000000700001900000001070040390000042c0850009c00000d8d0000213d000000010770019000000d8d0000c13d000000400050043f000000000541043600000020033000390000000007430019000000000227004b00000d930000213d000000000336034f0000001f0240018f000000050640027200000d7b0000613d000000000700001900000005087002100000000009850019000000000883034f000000000808043b00000000008904350000000107700039000000000867004b00000d730000413d000000000702004b00000d8a0000613d0000000506600210000000000363034f00000000066500190000000302200210000000000706043300000000072701cf000000000727022f000000000303043b0000010002200089000000000323022f00000000022301cf000000000272019f000000000026043500000000024500190000000000020435000000000001042d0000045b0100004100000000001004350000004101000039000000040010043f0000045c0100004100000fca00010430000000000100001900000fca000104300005000000000002000500000003001d000004190110019800000de80000613d000304190020019c00000df20000613d000400000001001d00000000001004350000003301000039000200000001001d000000200010043f000003f3010000410000000002000414000003f30320009c0000000002018019000000c0012002100000041d011001c700008010020000390fc80fc30000040f000000010220019000000de60000613d000000000101043b000000000201041a000100000002001d000000050120006c00000dfc0000413d000000040100002900000000001004350000000201000029000000200010043f000003f3030000410000000001000414000003f30210009c0000000001038019000000c0011002100000041d011001c700008010020000390fc80fc30000040f000000010220019000000de60000613d0000000103000029000000050230006a000000000101043b000000000021041b000000030100002900000000001004350000000001000414000003f30210009c000003f301008041000000c0011002100000041d011001c700008010020000390fc80fc30000040f000000010220019000000de60000613d000000000101043b000000000201041a00000005030000290000000002320019000000000021041b000000400100043d0000000000310435000003f3020000410000000003000414000003f30430009c0000000003028019000003f30410009c00000000010280190000004001100210000000c002300210000000000112019f0000043f011001c70000800d0200003900000003030000390000045104000041000000040500002900000003060000290fc80fbe0000040f000000010120019000000de60000613d000000000001042d000000000100001900000fca00010430000000400100043d00000064021000390000046a03000041000000000032043500000044021000390000046b0300004100000000003204350000002402100039000000250300003900000e050000013d000000400100043d0000006402100039000004680300004100000000003204350000004402100039000004690300004100000000003204350000002402100039000000230300003900000e050000013d000000400100043d000000640210003900000466030000410000000000320435000000440210003900000467030000410000000000320435000000240210003900000026030000390000000000320435000003f4020000410000000000210435000000040210003900000020030000390000000000320435000003f302000041000003f30310009c000000000102801900000040011002100000042a011001c700000fca000104300003000000000002000004190110019800000e4c0000613d000200000003001d000304190020019c00000e560000613d000100000001001d00000000001004350000003401000039000000200010043f000003f3030000410000000001000414000003f30210009c0000000001038019000000c0011002100000041d011001c700008010020000390fc80fc30000040f0000000102200190000000030300002900000e4a0000613d000000000101043b0000000000300435000000200010043f0000000001000414000003f30210009c000003f301008041000000c0011002100000041d011001c700008010020000390fc80fc30000040f0000000306000029000000010220019000000e4a0000613d000000000101043b0000000202000029000000000021041b000000400100043d0000000000210435000003f3020000410000000003000414000003f30430009c0000000003028019000003f30410009c00000000010280190000004001100210000000c002300210000000000112019f0000043f011001c70000800d0200003900000003030000390000046c0400004100000001050000290fc80fbe0000040f000000010120019000000e4a0000613d000000000001042d000000000100001900000fca00010430000000400100043d00000064021000390000046f0300004100000000003204350000004402100039000004700300004100000000003204350000002402100039000000240300003900000e5f0000013d000000400100043d00000064021000390000046d03000041000000000032043500000044021000390000046e030000410000000000320435000000240210003900000022030000390000000000320435000003f4020000410000000000210435000000040210003900000020030000390000000000320435000003f302000041000003f30310009c000000000102801900000040011002100000042a011001c700000fca0001043000020000000000020000006705000039000000000405041a000000010640019000000001014002700000007f0210018f000000000201c0190000001f0120008c00000000010000190000000101002039000000010110018f000000000116004b00000f470000c13d000000400300043d0000000001230436000000000606004b00000e8a0000613d0000000000500435000000000402004b000000000400001900000e900000613d000004380500004100000000040000190000000006410019000000000705041a000000000076043500000001055000390000002004400039000000000624004b00000e820000413d00000e900000013d000001000500008a000000000454016f0000000000410435000000000202004b000000200400003900000000040060190000003f02400039000000200900008a000000000492016f0000000002340019000000000442004b000000000400001900000001040040390000042c0520009c00000f410000213d000000010440019000000f410000c13d000000400020043f0000000003030433000000000403004b00000eb60000613d000200000009001d000003f302000041000003f30430009c00000000030280190000006003300210000003f30410009c00000000010280190000004001100210000000000113019f0000000003000414000003f30430009c0000000003028019000000c002300210000000000112019f00000420011001c700008010020000390fc80fc30000040f000000010220019000000f450000613d000000400200043d000000000801043b000000020900002900000ebb0000013d0000006501000039000000000101041a0000047108000041000000000301004b000000000801c0190000006805000039000000000405041a000000010640019000000001014002700000007f0310018f000000000301c0190000001f0130008c00000000010000190000000101002039000000000114013f000000010110019000000f470000c13d0000000001320436000000000606004b00000ed80000613d0000000000500435000000000403004b000000000400001900000ede0000613d000004390500004100000000040000190000000006410019000000000705041a000000000076043500000001055000390000002004400039000000000634004b00000ed00000413d00000ede0000013d000001000500008a000000000454016f0000000000410435000000000303004b000000200400003900000000040060190000003f03400039000000000393016f0000000005230019000000000335004b000000000300001900000001030040390000042c0450009c00000f410000213d000000010330019000000f410000c13d000000400050043f0000000002020433000000000302004b00000f030000613d000200000008001d000003f303000041000003f30420009c00000000020380190000006002200210000003f30410009c00000000010380190000004001100210000000000112019f0000000002000414000003f30420009c0000000002038019000000c002200210000000000112019f00000420011001c700008010020000390fc80fc30000040f000000010220019000000f450000613d000000400500043d000000000101043b000000020800002900000f080000013d0000006601000039000000000201041a0000047101000041000000000302004b000000000102c019000200000005001d000000600250003900000000001204350000004001500039000000000081043500000020025000390000047201000041000100000002001d00000000001204350000045a010000410000000000100439000003f3010000410000000002000414000003f30320009c0000000002018019000000c0012002100000041c011001c70000800b020000390fc80fc30000040f000000010220019000000f4d0000613d000000000101043b0000000204000029000000a0024000390000000003000410000000000032043500000080024000390000000000120435000000a0010000390000000000140435000004730140009c000000000304001900000f410000213d000000c001300039000000400010043f000003f3010000410000000104000029000003f30240009c000000000401801900000040024002100000000003030433000003f30430009c00000000030180190000006003300210000000000223019f0000000003000414000003f30430009c0000000003018019000000c001300210000000000121019f00000420011001c700008010020000390fc80fc30000040f000000010220019000000f450000613d000000000101043b000000000001042d0000045b010000410000000000100435000000410100003900000f4a0000013d000000000100001900000fca000104300000045b0100004100000000001004350000002201000039000000040010043f0000045c0100004100000fca00010430000000000001042f00000000031200490000042d040000410000001f0530008c000000000500001900000000050420190000042d03300197000000000603004b00000000040080190000042d0330009c000000000405c019000000000304004b00000f8d0000613d00000000030104330000042c0430009c00000f8d0000213d00000000011300190000001f031000390000042d04000041000000000523004b000000000500001900000000050480190000042d033001970000042d06200197000000000763004b0000000004008019000000000363013f0000042d0330009c000000000405c019000000000304004b00000f8d0000c13d0000000043010434000004650130009c00000f8f0000813d0000003f01300039000000200500008a000000000551016f000000400100043d0000000005510019000000000615004b000000000600001900000001060040390000042c0750009c00000f8f0000213d000000010660019000000f8f0000c13d000000400050043f00000000053104360000000006430019000000000226004b00000f8d0000213d000000000203004b00000f8a0000613d000000000200001900000000065200190000000007420019000000000707043300000000007604350000002002200039000000000632004b00000f830000413d00000000023500190000000000020435000000000001042d000000000100001900000fca000104300000045b0100004100000000001004350000004101000039000000040010043f0000045c0100004100000fca0001043000000000021200490000042d030000410000001f0420008c000000000400001900000000040320190000042d02200197000000000502004b00000000030080190000042d0220009c000000000304c019000000000203004b00000fa50000613d0000000001010433000000ff0210008c00000fa50000213d000000000001042d000000000100001900000fca00010430000000000001042f000003f303000041000003f30410009c00000000010380190000004001100210000003f30420009c00000000020380190000006002200210000000000112019f0000000002000414000003f30420009c0000000002038019000000c002200210000000000112019f00000420011001c700008010020000390fc80fc30000040f000000010220019000000fbc0000613d000000000101043b000000000001042d000000000100001900000fca0001043000000fc1002104210000000102000039000000000001042d0000000002000019000000000001042d00000fc6002104230000000102000039000000000001042d0000000002000019000000000001042d00000fc80000043200000fc90001042e00000fca00010430000000000000000000000000000000000000000000000000000000000000000000000000ffffffff08c379a000000000000000000000000000000000000000000000000000000000496e697469616c697a61626c653a20636f6e747261637420697320696e697469616c697a696e6700000000000000000000000000000000000000000000000000000000000000000000000000000000000000008400000080000000000000000002000000000000000000000000000000000000200000008000000000000000007f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249800000002000000000000000000000000000000400000010000000000000000000000000000000000000000000000000000000000000000000000000084b0196d00000000000000000000000000000000000000000000000000000000a9059cba00000000000000000000000000000000000000000000000000000000c2eeeebc00000000000000000000000000000000000000000000000000000000c2eeeebd00000000000000000000000000000000000000000000000000000000d505accf00000000000000000000000000000000000000000000000000000000dd62ed3e00000000000000000000000000000000000000000000000000000000a9059cbb00000000000000000000000000000000000000000000000000000000ae1f6aaf00000000000000000000000000000000000000000000000000000000b71bcf900000000000000000000000000000000000000000000000000000000095d89b400000000000000000000000000000000000000000000000000000000095d89b410000000000000000000000000000000000000000000000000000000095f11a4000000000000000000000000000000000000000000000000000000000a457c2d70000000000000000000000000000000000000000000000000000000084b0196e000000000000000000000000000000000000000000000000000000008c2a993e0000000000000000000000000000000000000000000000000000000095ce3e93000000000000000000000000000000000000000000000000000000003644e5140000000000000000000000000000000000000000000000000000000074f4f5460000000000000000000000000000000000000000000000000000000074f4f547000000000000000000000000000000000000000000000000000000007ba8be34000000000000000000000000000000000000000000000000000000007ecebe00000000000000000000000000000000000000000000000000000000003644e51500000000000000000000000000000000000000000000000000000000395093510000000000000000000000000000000000000000000000000000000070a082310000000000000000000000000000000000000000000000000000000018160ddc0000000000000000000000000000000000000000000000000000000018160ddd0000000000000000000000000000000000000000000000000000000023b872dd00000000000000000000000000000000000000000000000000000000313ce5670000000000000000000000000000000000000000000000000000000006fdde0300000000000000000000000000000000000000000000000000000000095ea7b3000000000000000000000000ffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000020000000800000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d95539132020000020000000000000000000000000000000400000000000000000000000002000000000000000000000000000000000000400000000000000000000000006e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9000000000000000000000000000000000000000000000000ffffffffffffff1f0200000000000000000000000000000000000000000000000000000000000000190100000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000420000000000000000000000007fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0000000000000000000000000000000000000008000000000000000000000000045524332305065726d69743a20696e76616c6964207369676e61747572650000000000000000000000000000000000000000006400000000000000000000000045434453413a20696e76616c6964207369676e61747572650000000000000000756500000000000000000000000000000000000000000000000000000000000045434453413a20696e76616c6964207369676e6174757265202773272076616c000000000000000000000000000000000000008400000000000000000000000045524332305065726d69743a206578706972656420646561646c696e65000000000000000000000000000000000000000000000000000000ffffffffffffffff80000000000000000000000000000000000000000000000000000000000000007600000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000a3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d508da5cb5b00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000000000074740000000000000000000000000000000000000000000000000000000000004a11f94e20a93c79f6ec743a1954ec4fc2c08429ae2122118bf234b2185c81b842a7b7dd785cd69714a189dffb3fd7d7174edc9ece837694ce50f7078f7c31ae000000000000000000000000000000000000000000000000ffffffffffffffbf31000000000000000000000000000000000000000000000000000000000000009787eeb91fe3101235e4a76063c7023ecb40f923f97916639c598592fa30d6aea2153420d844928b4421650203c77babc8b33d7f2e7b450e2966db0c22097753ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00010000000000000000000000000000000000000000000000000000000000010000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00010181e8e92e5873539605a102eddae7ed06d19bea042099a437cbc3644415eb7404ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ff02000000000000000000000000000000000000200000000000000000000000006e697469616c697a696e67000000000000000000000000000000000000000000496e697469616c697a61626c653a20636f6e7472616374206973206e6f7420690000000000000000000000000000000000000020000000000000000000000000207a65726f00000000000000000000000000000000000000000000000000000045524332303a2064656372656173656420616c6c6f77616e63652062656c6f771806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000647920696e697469616c697a6564000000000000000000000000000000000000496e697469616c697a61626c653a20636f6e747261637420697320616c726561ffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffff0000000000000000000000000000000000000000ff000000000000000000000000000000000000000000000000ffffffffffffff9f95ce3e93000000000000000000000000000000000000000000000000000000007ba8be3400000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000696e360000000000000000000000000000000000000000000000000000000000ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef397b33b307fc137878ebfc75b295289ec0ee25a31bb5bf034f33256fe8ea2aa645524332303a206d696e7420746f20746865207a65726f20616464726573730000000000000000000000000000000000000000640000008000000000000000004549503731323a20556e696e697469616c697a65640000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffffffffffff000000000000007f000000000000000000000000000000000000000000000000ffffffffffffffdf0f000000000000000000000000000000000000000000000000000000000000009a8a0592ac89c5ad3bc6df8224c17b485976f597df104ee20d0df415241f670b4e487b71000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000024000000000000000000000000786e7400000000000000000000000000000000000000000000000000000000009b5b9a05e4726d8bb959f1440e05c6b8109443f2083bc4e386237d7654526553636500000000000000000000000000000000000000000000000000000000000045524332303a206275726e20616d6f756e7420657863656564732062616c616e45524332303a206275726e2066726f6d20746865207a65726f2061646472657373000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ff000045524332303a20696e73756666696369656e7420616c6c6f77616e63650000000000000000000000000000000000000000000000000000010000000000000000616c616e6365000000000000000000000000000000000000000000000000000045524332303a207472616e7366657220616d6f756e7420657863656564732062657373000000000000000000000000000000000000000000000000000000000045524332303a207472616e7366657220746f20746865207a65726f2061646472647265737300000000000000000000000000000000000000000000000000000045524332303a207472616e736665722066726f6d20746865207a65726f2061648c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925737300000000000000000000000000000000000000000000000000000000000045524332303a20617070726f766520746f20746865207a65726f206164647265726573730000000000000000000000000000000000000000000000000000000045524332303a20617070726f76652066726f6d20746865207a65726f20616464c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a4708b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f000000000000000000000000000000000000000000000000ffffffffffffff3ffa0de714ca057c79368fb664d0fd77f8d5f228c3d89c4714aaf05d804bb18a5d