Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta

More Options

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

// SPDX-License-Identifier: MIT

pragma solidity 0.8.24;

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

import {IL2StandardToken} from "./interfaces/IL2StandardToken.sol";
import {ZeroAddress, Unauthorized, NonSequentialVersion} from "../errors/L2ContractErrors.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 calldata _data) external initializer {
        if (_l1Address == address(0)) {
            revert ZeroAddress();
        }
        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 calldata _newName,
        string calldata _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();
        if (msg.sender != UpgradeableBeacon(beaconAddress).owner()) {
            revert Unauthorized(msg.sender);
        }

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

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

    modifier onlyBridge() {
        if (msg.sender != l2Bridge) {
            revert Unauthorized(msg.sender);
        }
        _;
    }

    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.
        if (_version != _getInitializedVersion() + 1) {
            revert NonSequentialVersion();
        }
        _;
    }

    /// @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.
        // solhint-disable-next-line reason-string, gas-custom-errors
        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.
        // solhint-disable-next-line reason-string, gas-custom-errors
        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.
        // solhint-disable-next-line reason-string, gas-custom-errors
        if (availableGetters.ignoreDecimals) revert();
        return decimals_;
    }

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

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

// SPDX-License-Identifier: MIT
// We use a floating point pragma here so it can be used within other projects that interact with the ZKsync ecosystem without using our exact pragma version.
pragma solidity ^0.8.20;

// 0x1f73225f
error AddressMismatch(address expected, address supplied);
// 0x5e85ae73
error AmountMustBeGreaterThanZero();
// 0xb4f54111
error DeployFailed();
// 0x7138356f
error EmptyAddress();
// 0x1c25715b
error EmptyBytes32();
// 0x1bdfd505
error FailedToTransferTokens(address tokenContract, address to, uint256 amount);
// 0x2a1b2dd8
error InsufficientAllowance(uint256 providedAllowance, uint256 requiredAmount);
// 0xcbd9d2e0
error InvalidCaller(address);
// 0xb4fa3fb3
error InvalidInput();
// 0x0ac76f01
error NonSequentialVersion();
// 0x8e4a23d6
error Unauthorized(address);
// 0x6e128399
error Unimplemented();
// 0xa4dde386
error UnimplementedMessage(string message);
// 0xff15b069
error UnsupportedPaymasterFlow();
// 0x750b219c
error WithdrawFailed();
// 0xd92e233d
error ZeroAddress();

string constant BRIDGE_MINT_NOT_IMPLEMENTED = "bridgeMint is not implemented! Use deposit/depositTo methods instead.";

// SPDX-License-Identifier: MIT
// We use a floating point pragma here so it can be used within other projects that interact with the ZKsync ecosystem without using our exact pragma version.
pragma solidity ^0.8.20;

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);
}

// 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/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) (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.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) (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 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 (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.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.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
        }
    }
}

// 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 (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 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/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) (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.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) (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) (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/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 (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 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.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);
        }
    }
}

{
  "evmVersion": "paris",
  "optimizer": {
    "enabled": true,
    "mode": "3"
  },
  "outputSelection": {
    "*": {
      "*": [
        "abi"
      ]
    }
  },
  "detectMissingLibraries": false,
  "forceEVMLA": false,
  "enableEraVMExtensions": true,
  "libraries": {}
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"NonSequentialVersion","type":"error"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"Unauthorized","type":"error"},{"inputs":[],"name":"ZeroAddress","type":"error"},{"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"}]

9c4d535b000000000000000000000000000000000000000000000000000000000000000001000455ca9d184ac8930bcbe52cf89af7f21d1aea8d56d313d1ebdc9308f0dc00000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000

0x00040000000000020014000000000002000000000601034f00000000010600190000006003100270000003cb0130019700030000001603550002000000060355000003cb0030019d0000008003000039000000400030043f0000000102200190000000460000c13d000000040210008c0000031e0000413d000000000206043b000000e002200270000003d30320009c0000006f0000a13d000003d40320009c000000850000213d000003dc0320009c000000eb0000213d000003e00320009c000002690000613d000003e10320009c000001ae0000613d000003e20220009c0000031e0000c13d000000240210008c0000031e0000413d0000000002000416000000000202004b0000031e0000c13d0000000402600370000000000202043b000004040320009c0000031e0000213d0000002303200039000000000313004b0000031e0000813d0000000404200039000000000346034f000000000303043b000004040530009c0000031e0000213d000000200530008c0000031e0000413d00000024022000390000000003230019000000000113004b0000031e0000213d0000002001400039000000000116034f000000000101043b000004040410009c0000031e0000213d00000000012100190000001f02100039000000000232004b0000031e0000813d000000000216034f000000000202043b00000020011000390f280d230000040f0000002002000039000000400300043d000c00000003001d0000000002230436000003970000013d0000000001000416000000000101004b0000031e0000c13d000000000100041a0000ff0002100190000000630000c13d000000ff0210018f000000ff0220008c0000005e0000613d000000ff011001bf000000000010041b000000ff01000039000000800010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003d0011001c70000800d020000390000000103000039000003d1040000410f280f1e0000040f00000001012001900000031e0000613d000000200100003900000100001004430000012000000443000003d20100004100000f290001042e000003cc01000041000000800010043f0000002001000039000000840010043f0000002701000039000000a40010043f000003cd01000041000000c40010043f000003ce01000041000000e40010043f000003cf0100004100000f2a00010430000003e30320009c000000d60000a13d000003e40320009c000001470000213d000003e80320009c000003090000613d000003e90320009c000002ba0000613d000003ea0220009c0000031e0000c13d000000240110008c0000031e0000413d0000000001000416000000000101004b0000031e0000c13d0000000401600370000000000101043b000003f10210009c0000031e0000213d00000000001004350000003301000039000001580000013d000003d50320009c000001270000213d000003d90320009c000002890000613d000003da0320009c000001cd0000613d000003db0220009c0000031e0000c13d000000c40210008c0000031e0000413d0000000002000416000000000202004b0000031e0000c13d0000006402600370000000000202043b000004040320009c0000031e0000213d0000002303200039000000000313004b0000031e0000813d000b00040020003d0000000b03600360000000000303043b000c00000003001d000004040330009c0000031e0000213d0000000c02200029000a00240020003d0000000a0210006b0000031e0000213d0000008402600370000000000202043b000004040320009c0000031e0000213d0000002303200039000000000313004b0000031e0000813d000800040020003d0000000803600360000000000303043b000900000003001d000004040330009c0000031e0000213d0000000902200029000700240020003d000000070110006b0000031e0000213d000000a401600370000000000101043b000600000001001d000000ff0110008c0000031e0000213d000000000100041a000000ff0210018f000000ff0320008c0000035d0000613d0000000103100039000000060330014f000000ff033001900000066e0000c13d0000ff0003100190000006b40000c13d000000060220006c000006b40000813d000004090110019700000006011001af00000100011001bf000000000010041b0000040a01000041000000000201041a0000040b01000041000000800010043f0000000001000414000003f102200197000000040320008c000006cf0000c13d0000000103000031000000200130008c00000020040000390000000004034019000006f60000013d000003eb0320009c0000015d0000a13d000003ec0320009c000001a60000613d000003ed0320009c0000016f0000613d000003ee0120009c0000031e0000c13d0000000001000416000000000101004b0000031e0000c13d000000cc01000039000000000101041a0000043e011001980000031e0000c13d000000cd01000039000000000101041a000000ff0110018f000000800010043f000003f20100004100000f290001042e000003dd0320009c000002980000613d000003de0320009c000001d70000613d000003df0220009c0000031e0000c13d000000440110008c0000031e0000413d0000000001000416000000000101004b0000031e0000c13d0000000401600370000000000101043b000c00000001001d000003f10110009c0000031e0000213d0000002401600370000000000101043b000b00000001001d000000000100041100000000001004350000003401000039000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f00000001022001900000031e0000613d000000000101043b0000000c020000290000000000200435000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f00000001022001900000031e0000613d000000000101043b000000000101041a0000000b03000029000000000231004b000003d90000813d000000400100043d00000064021000390000041d03000041000000000032043500000044021000390000041e03000041000000000032043500000024021000390000002503000039000005660000013d000003d60320009c000002b10000613d000003d70320009c0000020d0000613d000003d80220009c0000031e0000c13d000000440110008c0000031e0000413d0000000001000416000000000101004b0000031e0000c13d0000000401600370000000000101043b000003f10210009c0000031e0000213d0000002402600370000000000202043b000c00000002001d000003f10220009c0000031e0000213d00000000001004350000003401000039000000200010043f000000400200003900000000010000190f280f090000040f0000000c020000290000000000200435000000200010043f000000000100001900000040020000390000015b0000013d000003e50320009c000003140000613d000003e60320009c000002ec0000613d000003e70220009c0000031e0000c13d000000240110008c0000031e0000413d0000000001000416000000000101004b0000031e0000c13d0000000401600370000000000101043b000003f10210009c0000031e0000213d00000000001004350000009901000039000000200010043f000000400200003900000000010000190f280f090000040f000001aa0000013d000003ef0320009c000002460000613d000003f00220009c0000031e0000c13d000000440110008c0000031e0000413d0000000001000416000000000101004b0000031e0000c13d0000000401600370000000000201043b000003f10120009c0000031e0000213d0000002401600370000000000301043b00000000010004110f280d5d0000040f000002960000013d000000640110008c0000031e0000413d0000000001000416000000000101004b0000031e0000c13d0000000401600370000000000101043b000c00000001001d000003f10110009c0000031e0000213d0000002401600370000000000101043b000b00000001001d000003f10110009c0000031e0000213d0000004401600370000000000101043b000a00000001001d0000000c0100002900000000001004350000003401000039000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f00000001022001900000031e0000613d000000000101043b00000000020004110000000000200435000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f00000001022001900000031e0000613d000000000101043b000000000101041a000004400210009c000005560000613d0000000a03000029000000000231004b000005520000813d000000400100043d00000044021000390000043f03000041000002380000013d0000000001000416000000000101004b0000031e0000c13d0000003501000039000000000101041a000000800010043f000003f20100004100000f290001042e000000440110008c0000031e0000413d0000000001000416000000000101004b0000031e0000c13d0000000401600370000000000101043b000c00000001001d000003f10110009c0000031e0000213d0000002401600370000000000401043b000000cd01000039000000000101041a0000000801100270000003f1021001970000000001000411000000000221004b000003420000c13d0000000c0100006b000003550000c13d000003cc01000041000000800010043f0000002001000039000000840010043f0000001f01000039000000a40010043f0000043101000041000000c40010043f000004320100004100000f2a000104300000000001000416000000000101004b0000031e0000c13d000000cd01000039000000000101041a0000000801100270000003f101100197000000800010043f000003f20100004100000f290001042e000000440210008c0000031e0000413d0000000002000416000000000202004b0000031e0000c13d0000000402600370000000000202043b000c00000002001d000003f10220009c0000031e0000213d0000002402600370000000000202043b000004040320009c0000031e0000213d0000002303200039000000000313004b0000031e0000813d000a00040020003d0000000a03600360000000000303043b000b00000003001d000004040330009c0000031e0000213d0000002402200039000800000002001d0009000b0020002d000000090110006b0000031e0000213d000000000300041a0006ff0000300194000004800000c13d000000ff0130019000000000020000190000000102006039001300000002001d0000000002000415000000130220008a0007000500200218000000000101004b000004840000c13d000004090130019700000101011001bf000000000010041b0000000c03000029000000000103004b000005710000c13d000000400100043d0000042c020000410000000000210435000003cb0210009c000003cb0100804100000040011002100000042d011001c700000f2a00010430000000e40110008c0000031e0000413d0000000001000416000000000101004b0000031e0000c13d0000000401600370000000000101043b000c00000001001d000003f10110009c0000031e0000213d0000002401600370000000000101043b000b00000001001d000003f10110009c0000031e0000213d0000006401600370000000000101043b000a00000001001d0000004401600370000000000101043b000900000001001d0000008401600370000000000101043b000800000001001d000000ff0110008c0000031e0000213d000003f30100004100000000001004390000000001000414000003cb0210009c000003cb01008041000000c001100210000003f4011001c70000800b020000390f280f230000040f0000000102200190000005510000613d000000000101043b0000000a0110006c000004100000a13d000000400100043d00000044021000390000040303000041000000000032043500000024021000390000001d030000390000000000320435000003cc020000410000000000210435000000040210003900000020030000390000000000320435000003cb0210009c000003cb010080410000004001100210000003fe011001c700000f2a000104300000000001000416000000000101004b0000031e0000c13d000000cc01000039000000000101041a000000ff011001900000031e0000c13d0000003603000039000000000203041a000000010420019000000001052002700000007f0150018f000000000105c0190000001f0510008c00000000050000190000000105002039000000000554004b000002ab0000c13d000000800010043f000000000404004b0000034f0000613d0000000000300435000000000201004b0000034d0000613d0000040e0200004100000000040000190000000003040019000000000402041a000000a005300039000000000045043500000001022000390000002004300039000000000514004b000002600000413d0000038e0000013d0000000001000416000000000101004b0000031e0000c13d0000006501000039000000000101041a000000000101004b000003200000c13d0000006601000039000000000101041a000000000101004b000003200000c13d0000006703000039000000000203041a000000010420019000000001052002700000007f0150018f000000000105c0190000001f0510008c00000000050000190000000105002039000000000552013f0000000105500190000002ab0000c13d000000800010043f000000000404004b0000037e0000613d0000000000300435000000000201004b000003dd0000c13d0000002001000039000000a002000039000003f10000013d000000440110008c0000031e0000413d0000000001000416000000000101004b0000031e0000c13d0000000401600370000000000201043b000003f10120009c0000031e0000213d0000002401600370000000000301043b00000000010004110f280db40000040f00000001010000390000030d0000013d0000000001000416000000000101004b0000031e0000c13d000000cc01000039000000000101041a0000ff00011001900000031e0000c13d0000003703000039000000000203041a000000010420019000000001052002700000007f0150018f000000000105c0190000001f0510008c00000000050000190000000105002039000000000552013f0000000105500190000003470000613d000004380100004100000000001004350000002201000039000000040010043f0000040d0100004100000f2a000104300000000001000416000000000101004b0000031e0000c13d000000ce01000039000000000101041a000003f101100197000000800010043f000003f20100004100000f290001042e000000440110008c0000031e0000413d0000000001000416000000000101004b0000031e0000c13d0000000401600370000000000101043b000c00000001001d000003f10110009c0000031e0000213d000000000100041100000000001004350000003401000039000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c70000801002000039000b0000000603530f280f230000040f0000000b0300035f00000001022001900000031e0000613d000000000101043b0000000c020000290000000000200435000000200010043f0000002401300370000000000101043b000b00000001001d0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f00000001022001900000031e0000613d000000000101043b000000000101041a0000000b03100029000000000113004b00000000010000190000000101004039000000010110008c0000035d0000613d000003da0000013d000000240210008c0000031e0000413d0000000002000416000000000202004b0000031e0000c13d0000000402600370000000000202043b000004040320009c0000031e0000213d0000002303200039000000000313004b0000031e0000813d0000000403200039000000000436034f000000000404043b000004040540009c0000031e0000213d000000200540008c0000031e0000413d00000000024200190000002402200039000000000112004b0000031e0000213d0000002001300039000000000116034f000000000101043b000000ff0210008c000002b70000a13d0000031e0000013d0000000001000416000000000101004b0000031e0000c13d0f280e2b0000040f000000400200043d0000000000120435000003cb0120009c000003cb0200804100000040012002100000041c011001c700000f290001042e000000440110008c0000031e0000413d0000000001000416000000000101004b0000031e0000c13d0000000401600370000000000101043b000c00000001001d000003f10110009c0000032a0000a13d000000000100001900000f2a00010430000003cc01000041000000800010043f0000002001000039000000840010043f0000001501000039000000a40010043f0000043301000041000000c40010043f000004320100004100000f2a000104300000002401600370000000000301043b000000cd01000039000000000101041a0000000801100270000003f1021001970000000001000411000000000221004b000003420000c13d0000000c02000029000000000102004b000003630000c13d000003cc01000041000000800010043f0000002001000039000000840010043f0000002101000039000000a40010043f0000043c01000041000000c40010043f0000043d01000041000000e40010043f000003cf0100004100000f2a000104300000040c02000041000000800020043f000000840010043f0000042e0100004100000f2a00010430000000800010043f000000000404004b0000034f0000613d0000000000300435000000000201004b000003840000c13d000000a0010000390000038f0000013d0000044102200197000000a00020043f000000000101004b000000c001000039000000a0010060390000038f0000013d0000003501000039000000000301041a0000000002430019000000000332004b000000000300001900000001030040390000000103300190000003a20000613d000004380100004100000000001004350000001101000039000000040010043f0000040d0100004100000f2a00010430000b00000003001d00000000002004350000003301000039000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f00000001022001900000031e0000613d000000000101043b000000000201041a0000000b0120006c000004a40000813d000000400100043d00000064021000390000043a03000041000000000032043500000044021000390000043b03000041000000000032043500000024021000390000002203000039000005660000013d0000044102200197000000a00020043f000000000101004b00000020020000390000000002006019000003e60000013d000004100200004100000000040000190000000003040019000000000402041a000000a005300039000000000045043500000001022000390000002004300039000000000514004b000003860000413d000000c001300039000000800210008a00000080010000390f280d110000040f0000002001000039000000400200043d000c00000002001d000000000212043600000080010000390f280cff0000040f0000000c030000290000000001310049000003cb0210009c000003cb010080410000006001100210000003cb0230009c000003cb030080410000004002300210000000000121019f00000f290001042e000b00000004001d000000000021041b0000000c0100002900000000001004350000003301000039000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f00000001022001900000031e0000613d000000000101043b000000000201041a0000000b030000290000000002320019000000000021041b000000400100043d0000000000310435000003cb0210009c000003cb0100804100000040011002100000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f0000041b011001c70000800d0200003900000003030000390000042f0400004100000000050000190000000c060000290f280f1e0000040f00000001012001900000031e0000613d000000400100043d0000000b020000290000000000210435000003cb0210009c000003cb0100804100000040011002100000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f0000041b011001c70000800d0200003900000002030000390000043004000041000004dc0000013d000000000331004900000000010004110000000c020000290000016d0000013d00000414030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000412004b000003df0000413d0000003f012000390000044201100197000004340210009c000003f00000413d000004380100004100000000001004350000004101000039000000040010043f0000040d0100004100000f2a000104300000008002100039000000400020043f0000006805000039000000000405041a000000010640019000000001074002700000007f0370018f000000000307c0190000001f0730008c00000000070000190000000107002039000000000774013f0000000107700190000002ab0000c13d0000000000320435000000000606004b000004e20000613d0000000000500435000000000403004b0000000004000019000004e80000613d0000041605000041000000a00610003900000000040000190000000007460019000000000805041a000000000087043500000001055000390000002004400039000000000734004b000004080000413d000004e80000013d0000000c0100002900000000001004350000009901000039000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f00000001022001900000031e0000613d000000000101043b000000000201041a0000000103200039000000000031041b000000400100043d000000c0031000390000000a040000290000000000430435000000a003100039000000000023043500000080021000390000000903000029000000000032043500000060021000390000000b03000029000000000032043500000040021000390000000c030000290000000000320435000000c0020000390000000002210436000003f6030000410000000000320435000003f70310009c000003ea0000213d000000e003100039000000400030043f000003cb0320009c000003cb0200804100000040022002100000000001010433000003cb0310009c000003cb010080410000006001100210000000000121019f0000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f000003f8011001c700008010020000390f280f230000040f00000001022001900000031e0000613d000000000101043b000a00000001001d0f280e2b0000040f000003f902000041000000400300043d00000000002304350000000202300039000000000012043500000022013000390000000a0200002900000000002104350000000201000367000000c402100370000000000202043b000a00000002001d000000a401100370000000000101043b000700000001001d000003cb0130009c000003cb0300804100000040013002100000000002000414000003cb0320009c000003cb02008041000000c002200210000000000121019f000003fa011001c700008010020000390f280f230000040f00000001022001900000031e0000613d000000400200043d0000000a03000029000003fb0330009c000006720000a13d000000640120003900000400030000410000000000310435000000440120003900000401030000410000000000310435000000240120003900000022030000390000000000310435000003cc010000410000000000120435000000040120003900000020030000390000000000310435000003cb0120009c000003cb02008041000000400120021000000402011001c700000f2a000104300000000001000415000000140110008a0007000500100218001400000000001d000500000003001d0000041f010000410000000000100439000000000100041000000004001004430000000001000414000003cb0210009c000003cb01008041000000c00110021000000420011001c700008002020000390f280f230000040f0000000102200190000005510000613d000000000101043b000000000101004b0000055a0000c13d0000000501000029000000ff0110018f000000010110008c0000000001000019000000010100603900000007020000290000000502200270000000000201001f0000055d0000c13d000000060100006b0000000503000029000001ff0000613d000004410130019700000001011001bf000002010000013d000a00000002001d0000000c0100002900000000001004350000003301000039000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f00000001022001900000031e0000613d0000000b030000290000000a02300069000000000101043b000000000021041b0000003501000039000000000201041a0000000002320049000000000021041b000000400100043d0000000000310435000003cb0210009c000003cb0100804100000040011002100000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f0000041b011001c70000800d0200003900000003030000390000042f040000410000000c0500002900000000060000190f280f1e0000040f00000001012001900000031e0000613d000000400100043d0000000b020000290000000000210435000003cb0210009c000003cb0100804100000040011002100000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f0000041b011001c70000800d02000039000000020300003900000439040000410000000c050000290f280f1e0000040f00000001012001900000031e0000613d000000000100001900000f290001042e0000044104400197000000a0051000390000000000450435000000000303004b000000200400003900000000040060190000003f0340003900000442033001970000000005230019000000000335004b00000000030000190000000103004039000004040450009c000003ea0000213d0000000103300190000003ea0000c13d000000400050043f000004350350009c000003ea0000213d0000002003500039000800000003001d000000400030043f000b00000005001d0000000000050435000000400500043d0000002003500039000000e004000039000000000043043500000436030000410000000000350435000000e004500039000000800300043d0000000000340435000c00000005001d0000010004500039000000000503004b0000050f0000613d00000000050000190000000006450019000000a007500039000000000707043300000000007604350000002005500039000000000635004b000005080000413d000000000543001900000000000504350000001f03300039000004420330019700000000034300190000000c0500002900000000045300490000004005500039000000000045043500000000060204330000000005630436000000000206004b000005250000613d000000a001100039000000000200001900000000035200190000000004210019000000000404043300000000004304350000002002200039000000000362004b0000051e0000413d000a00000005001d000900000006001d00000000015600190000000000010435000004370100004100000000001004390000000001000414000003cb0210009c000003cb01008041000000c001100210000003f4011001c70000800b020000390f280f230000040f0000000102200190000005510000613d000000000101043b0000000c040000290000008002400039000000000300041000000000003204350000006002400039000000000012043500000009010000290000001f0110003900000442011001970000000a011000290000000002410049000000c0034000390000000000230435000000a00240003900000000000204350000000b0200002900000000020204330000000001210436000000000302004b000003980000613d00000000030000190000000805000029000000005405043400000000014104360000000103300039000000000423004b0000054b0000413d000003980000013d000000000001042f00000000033100490000000c0100002900000000020004110f280d5d0000040f0000000c010000290000000b020000290000000a03000029000002950000013d00000007010000290000000501100270000000000100001f000000400100043d00000064021000390000040803000041000000000032043500000044021000390000040703000041000000000032043500000024021000390000002e030000390000000000320435000003cc020000410000000000210435000000040210003900000020030000390000000000320435000003cb0210009c000003cb01008041000000400110021000000402011001c700000f2a00010430000000ce01000039000000000201041a0000042102200197000000000232019f000000000021041b000000000100041100000008011002100000042201100197000000cd03000039000000000203041a0000042302200197000000000121019f000000000013041b0000000b01000029000000600110008c0000031e0000413d0000000a0100002900000020041000390000000203000367000000000143034f000000000101043b000004040210009c0000031e0000213d00000008011000290000001f02100039000000090220006c0000031e0000813d000000000213034f000000000502043b000004040250009c000003ea0000213d0000001f0250003900000442022001970000003f022000390000044206200197000000400200043d0000000006620019000000000726004b00000000070000190000000107004039000004040860009c000003ea0000213d0000000107700190000003ea0000c13d0000002007100039000000400060043f00000000015204360000000006750019000000090660006c0000031e0000213d000000000773034f0000001f0650018f0000000508500272000005af0000613d00000005098002100000000009910019000000000a07034f000000000b01001900000000ac0a043c000000000bcb0436000000000c9b004b000005ab0000c13d000000000906004b000005be0000613d0000000508800210000000000787034f00000000088100190000000306600210000000000908043300000000096901cf000000000969022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000696019f0000000000680435000000000551001900000000000504350000002004400039000000000543034f000000000505043b000004040650009c0000031e0000213d00000008065000290000001f05600039000000090550006c0000031e0000813d000000000563034f000000000505043b000004040750009c000003ea0000213d0000001f0750003900000442077001970000003f077000390000044207700197000000400800043d0000000007780019000700000008001d000000000887004b00000000080000190000000108004039000004040970009c000003ea0000213d0000000108800190000003ea0000c13d0000002006600039000000400070043f00000007070000290000000007570436000b00000007001d0000000007650019000000090770006c0000031e0000213d000000000763034f0000001f0650018f00000005085002720000000508800210000005ef0000613d0000000b0b00002900000000098b0019000000000a07034f00000000ac0a043c000000000bcb0436000000000c9b004b000005eb0000c13d000000000906004b000005fd0000613d000000000787034f0000000b088000290000000306600210000000000908043300000000096901cf000000000969022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000696019f00000000006804350000000b0550002900000000000504350000002004400039000000000443034f000000000404043b000004040540009c0000031e0000213d00000008054000290000001f04500039000000090440006c0000031e0000813d000000000453034f000000000404043b000004040640009c000003ea0000213d0000001f0640003900000442066001970000003f066000390000044206600197000000400700043d0000000006670019000400000007001d000000000776004b00000000070000190000000107004039000004040860009c000003ea0000213d0000000107700190000003ea0000c13d0000002005500039000000400060043f00000004060000290000000006460436000500000006001d0000000006540019000000090660006c0000031e0000213d000000000553034f0000001f0340018f00000005064002720000062e0000613d000000050760021000000005090000290000000007790019000000000805034f000000008a08043c0000000009a90436000000000a79004b0000062a0000c13d000000000703004b0000063d0000613d0000000506600210000000000565034f00000005066000290000000303300210000000000706043300000000073701cf000000000737022f000000000505043b0000010003300089000000000535022f00000000033501cf000000000373019f000000000036043500000005034000290000000000030435000000400300043d000300000003001d000004240330009c000003ea0000213d00000003040000290000006003400039000000400030043f0000004003400039000100000003001d00000000000304350000000003040436000200000003001d00000000000304350000042503000041000000400500043d0000000000350435000000040350003900000020040000390000000000430435000000000202043300000024035000390000000000230435000a00000005001d0000004403500039000000000402004b000006610000613d000000000400001900000000053400190000000006140019000000000606043300000000006504350000002004400039000000000524004b0000065a0000413d0000000001320019000000000001043500000000010004140000000003000410000000040330008c000008a70000c13d0000000004000415000000120440008a000000050440021000000003010003670000000103000031001200000000001d000008c40000013d0000040501000041000000800010043f000004060100004100000f2a00010430000000000101043b00000060032000390000000a04000029000000000043043500000040032000390000000704000029000000000043043500000020032000390000000804000029000000000043043500000000001204350000000000000435000003cb0120009c000003cb0200804100000040012002100000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f000003fc011001c700000001020000390f280f230000040f00000000030100190000006003300270000003cb03300197000000200430008c000000200400003900000000040340190000001f0540018f0000000504400272000006980000613d000000000601034f0000000007000019000000006806043c000000000907004b0000000007870436000006940000c13d000000000605004b000006a60000613d00000003055002100000000504400210000000000604043300000000065601cf000000000656022f000000000741034f000000000707043b0000010005500089000000000757022f00000000055701cf000000000565019f0000000000540435000100000003001f00030000000103550000000102200190000006c00000613d0000000001000433000003f101100198000007950000c13d000000400100043d0000004402100039000003ff030000410000000000320435000000240210003900000018030000390000023b0000013d000003cc01000041000000800010043f0000002001000039000000840010043f0000002e01000039000000a40010043f0000040701000041000000c40010043f0000040801000041000000e40010043f000003cf0100004100000f2a00010430000000400200043d0000001f0430018f00000005053002720000000505500210000006cc0000613d0000000006520019000000000701034f0000000008020019000000007907043c0000000008980436000000000968004b000006c80000c13d000000000604004b000007b70000613d000007ab0000013d000003cb0310009c000003cb01008041000000c00110021000000406011001c70f280f230000040f00000000030100190000006003300270000003cb03300197000000200430008c000000200400003900000000040340190000001f0540018f00000005064002720000008009000039000006e30000613d000000000701034f000000007807043c0000000009890436000000a00890008c000006df0000c13d000000000705004b000006f20000613d0000000506600210000000000761034f00000003055002100000008006600039000000000806043300000000085801cf000000000858022f000000000707043b0000010005500089000000000757022f00000000055701cf000000000585019f0000000000560435000100000003001f000300000001035500000001022001900000079d0000613d0000001f01400039000000600210018f000000800e2001bf0000004000e0043f000000200130008c0000031e0000413d000000800300043d000003f10130009c0000031e0000213d0000000001000411000000000331004b000007c40000c13d0000000c010000290000001f0110003900000442011001970000003f03100039000004420b30019700000000060000310000000003be0019000004040430009c000003ea0000213d000000400030043f0000000c0300002900000000003e04350000000a0360006b0000031e0000213d0000000b0300002900000020033000390000000205000367000b0000003503530000000c040000290000001f0340018f000000a0072000390000000508400272000007210000613d000000050280021000000000022700190000000b0900035f000000000c070019000000009d09043c000000000cdc0436000000000d2c004b0000071d0000c13d000000000203004b000007300000613d00000005028002100000000b0920035f0000000002270019000000030c300210000000000d020433000000000dcd01cf000000000dcd022f000000000909043b000001000cc000890000000009c9022f0000000009c901cf0000000009d9019f00000000009204350000000c02000029000000200c2000390000000002ce0019000000000002043500000009020000290000001f022000390000044202200197000a00000002001d0000003f022000390000044202200197000000400d00043d00000000022d00190000000009d2004b00000000090000190000000109004039000004040f20009c000003ea0000213d0000000109900190000003ea0000c13d000000400020043f0000000902000029000000000f2d0436000000070260006b0000031e0000213d00000008020000290000002002200039000700000025035300000009020000290008001f00200193000500050020027a000007580000613d0000000502000029000000050220021000000000022f0019000000070600035f00000000090f0019000000006406043c0000000009490436000000000429004b000007540000c13d000000080200006b000007690000613d00000005020000290000000502200210000000070420035f00000000022f001900000008060000290000000306600210000000000902043300000000096901cf000000000969022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000494019f00000000004204350000000902f00029000000000002043500000000060e0433000004040260009c000003ea0000213d0000003602000039000000000202041a000000010420019000000001042002700000007f0940018f000000000904c0190000001f0490008c00000000040000190000000104002039000000000242013f0000000102200190000002ab0000c13d000000200290008c0000078c0000413d000000360200003900000000002004350000001f0260003900000005022002700000040e02200041000000200460008c0000040e020040410000001f0490003900000005044002700000040e09400041000000000492004b0000078c0000813d000000000002041b0000000102200039000000000492004b000007880000413d0000001f0260008c000007cb0000a13d00000036020000390000000000200435000404420060019c000007d60000c13d00000020090000390000040e07000041000007e30000013d0000000c0110006c000007bd0000c13d0000000c010000290000000b0200002900000009030000290f280d5d0000040f000000000100001900000f290001042e000000400200043d0000001f0430018f00000005053002720000000505500210000007a90000613d0000000006520019000000000701034f0000000008020019000000007907043c0000000008980436000000000968004b000007a50000c13d000000000604004b000007b70000613d000000000151034f00000000055200190000000304400210000000000605043300000000064601cf000000000646022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000161019f00000000001504350000006001300210000003cb0320009c000003cb020080410000004002200210000000000112019f00000f2a00010430000000400100043d0000004402100039000003fd03000041000000000032043500000024021000390000001e030000390000023b0000013d0000040c0300004100000000003e043500000084022001bf00000000001204350000004001e002100000040d011001c700000f2a00010430000000000206004b0000000002000019000007cf0000613d00000000020704330000000304600210000004400440027f0000044004400167000000000242016f0000000104600210000000000242019f000007ef0000013d0000040e0700004100000020090000390000000402000029000000010220008a00000005022002700000040f022000410000000004e900190000000004040433000000000047041b00000020099000390000000107700039000000000427004b000007dc0000c13d000000040260006b000007ed0000813d0000000302600210000000f80220018f000004400220027f00000440022001670000000004e900190000000004040433000000000224016f000000000027041b000000010260021000000001022001bf0000003604000039000000000024041b00000000060d0433000004040260009c000003ea0000213d0000003702000039000000000202041a000000010420019000000001042002700000007f0740018f000000000704c0190000001f0470008c00000000040000190000000104002039000000000242013f0000000102200190000002ab0000c13d000000200270008c000008120000413d000000370200003900000000002004350000001f0260003900000005022002700000041002200041000000200460008c00000410020040410000001f0470003900000005044002700000041007400041000000000472004b000008120000813d000000000002041b0000000102200039000000000472004b0000080e0000413d0000001f0260008c00000001096002100000081c0000a13d000000370200003900000000002004350000044207600198000008260000c13d000000200f000039000004100e000041000008320000013d000000000206004b0000000002000019000008200000613d00000000020f04330000000304600210000004400440027f0000044004400167000000000242016f000000000292019f0000083d0000013d000004100e000041000000200f000039000000010270008a000000050220027000000411022000410000000004df0019000000000404043300000000004e041b000000200ff00039000000010ee0003900000000042e004b0000082b0000c13d000000000267004b0000083c0000813d0000000302600210000000f80220018f000004400220027f00000440022001670000000004df00190000000004040433000000000224016f00000000002e041b00000001029001bf0000003704000039000000000024041b000000400d00043d0000000002bd00190000000004d2004b00000000060000190000000106004039000004040420009c000003ea0000213d0000000104600190000003ea0000c13d000000400020043f0000000c0200002900000000062d0436000000000208004b000008550000613d000000050280021000000000022600190000000b0700035f0000000009060019000000007407043c0000000009490436000000000429004b000008510000c13d000000000203004b000008640000613d00000005028002100000000b0420035f00000000022600190000000307300210000000000902043300000000097901cf000000000979022f000000000404043b0000010007700089000000000474022f00000000047401cf000000000494019f00000000004204350000000002cd00190000000000020435000000000200041a0000ff0002200190000008730000c13d000000400100043d00000064021000390000042a03000041000000000032043500000044021000390000042b03000041000000000032043500000024021000390000002b03000039000005660000013d000000400b00043d0000041202b0009c000003ea0000213d0000004002b00039000000400020043f0000000102000039000000000c2b0436000004130200004100000000002c043500000000090d0433000004040290009c000003ea0000213d0000006702000039000000000202041a000000010420019000000001042002700000007f0740018f000000000704c0190000001f0470008c00000000040000190000000104002039000000000242013f0000000102200190000002ab0000c13d000000200270008c0000089d0000413d000000670200003900000000002004350000001f0290003900000005022002700000041402200041000000200490008c00000414020040410000001f0470003900000005044002700000041407400041000000000472004b0000089d0000813d000000000002041b0000000102200039000000000472004b000008990000413d0000001f0290008c000000010e900210000009c50000a13d00000067020000390000000000200435000004420790019800000a000000c13d000000200f000039000004140600004100000a0c0000013d0000001f0220003900000442022001970000004402200039000003cb0320009c000003cb0200804100000060022002100000000a04000029000003cb0340009c000003cb0300004100000000030440190000004003300210000000000232019f000003cb0310009c000003cb01008041000000c001100210000000000121019f00000000020004100f280f230000040f0000000004000415000000110440008a000000050440021000000000030100190000006003300270000103cb0030019d000003cb033001970003000000010355001100000000001d0000000102200190000009230000613d0000001f0230018f00000005053002720000000505500210000008cf0000613d0000000a080000290000000006580019000000000701034f000000007907043c0000000008980436000000000968004b000008cb0000c13d000000000602004b000008dd0000613d000000000651034f0000000a055000290000000302200210000000000705043300000000072701cf000000000727022f000000000606043b0000010002200089000000000626022f00000000022601cf000000000272019f00000000002504350000001f0230003900000442022001970000000a05200029000000000225004b00000000020000190000000102004039000900000005001d000004040550009c000003ea0000213d0000000102200190000003ea0000c13d0000000902000029000000400020043f000004260230009c0000031e0000213d000000200230008c0000031e0000413d0000000a020000290000000002020433000004040520009c0000031e0000213d0000000a063000290000000a022000290000001f05200039000000000765004b0000000007000019000004270700804100000427055001970000042708600197000000000985013f000000000585004b00000000050000190000042705004041000004270890009c000000000507c019000000000505004b0000031e0000c13d0000000052020434000004040720009c000003ea0000213d0000001f0720003900000442077001970000003f0770003900000442077001970000000907700029000004040870009c000003ea0000213d000000400070043f00000009070000290000000007270436000a00000007001d0000000007520019000000000667004b0000031e0000213d000000000602004b0000000a060000290000091f0000613d00000000060000190000000a076000290000000008560019000000000808043300000000008704350000002006600039000000000726004b000009170000413d0000000a0620002900000000000604350000000502400270000000090200002f000009280000013d000000010200003900000003040000290000000000240435000900600000003d000a00800000003d000000400500043d000004250200004100000000002504350000000402500039000000200400003900000000004204350000000702000029000000000202043300000024045000390000000000240435000700000005001d0000004404500039000000000502004b0000093e0000613d000000000500001900000000064500190000000b07500029000000000707043300000000007604350000002005500039000000000625004b000009370000413d0000000004420019000000000004043500000000040004140000000005000410000000040550008c000009490000c13d0000000004000415000000100440008a0000000504400210001000000000001d000009660000013d0000001f0120003900000442011001970000004401100039000003cb0210009c000003cb0100804100000060011002100000000703000029000003cb0230009c000003cb0200004100000000020340190000004002200210000000000121019f000003cb0240009c000003cb04008041000000c002400210000000000112019f00000000020004100f280f230000040f00000000040004150000000f0440008a000000050440021000000000030100190000006003300270000103cb0030019d000003cb033001970003000000010355000f00000000001d0000000102200190000009cf0000613d0000001f0230018f00000005053002720000000505500210000009710000613d00000007080000290000000006580019000000000701034f000000007907043c0000000008980436000000000968004b0000096d0000c13d000000000602004b0000097f0000613d000000000151034f00000007055000290000000302200210000000000605043300000000062601cf000000000626022f000000000101043b0000010002200089000000000121022f00000000012101cf000000000161019f00000000001504350000001f0130003900000442011001970000000702100029000000000112004b00000000010000190000000101004039000800000002001d000004040220009c000003ea0000213d0000000101100190000003ea0000c13d0000000801000029000000400010043f000004260130009c0000031e0000213d000000200130008c0000031e0000413d00000007010000290000000001010433000004040210009c0000031e0000213d000000070530002900000007011000290000001f02100039000000000652004b0000000006000019000004270600804100000427022001970000042707500197000000000872013f000000000272004b00000000020000190000042702004041000004270780009c000000000206c019000000000202004b0000031e0000c13d0000000021010434000004040610009c000003ea0000213d0000001f0610003900000442066001970000003f0660003900000442066001970000000806600029000004040760009c000003ea0000213d000000400060043f00000008060000290000000006160436000b00000006001d0000000006210019000000000556004b0000031e0000213d000000000501004b0000000b05000029000009c10000613d00000000050000190000000b065000290000000007250019000000000707043300000000007604350000002005500039000000000615004b000009b90000413d0000000b0510002900000000000504350000000501400270000000080100002f000009d40000013d000000000209004b0000000002000019000009c90000613d00000000020604330000000304900210000004400440027f0000044004400167000000000242016f0000000002e2019f00000a170000013d000000010100003900000002020000290000000000120435000800600000003d000b00800000003d000000000100041a0000ff0001100190000008690000613d00000009010000290000000002010433000004040120009c000003ea0000213d0000003601000039000000000501041a000000010450019000000001065002700000007f0460018f000000000406c0190000001f0640008c00000000060000190000000106002039000000000565013f0000000105500190000002ab0000c13d000000200540008c000009f80000413d00000000001004350000001f0520003900000005055002700000040e05500041000000200620008c0000040e050040410000001f0440003900000005044002700000040e04400041000000000645004b000009f80000813d000000000005041b0000000105500039000000000645004b000009f40000413d0000001f0420008c00000b030000a13d0000000000100435000004420620019800000b0f0000c13d00000020050000390000040e0400004100000b1b0000013d0000041406000041000000200f000039000000010270008a000000050220027000000415022000410000000004df00190000000004040433000000000046041b000000200ff000390000000106600039000000000426004b00000a050000c13d000000000297004b00000a160000813d0000000302900210000000f80220018f000004400220027f00000440022001670000000004df00190000000004040433000000000224016f000000000026041b0000000102e001bf0000006704000039000000000024041b00000000060b0433000004040260009c000003ea0000213d0000006807000039000000000207041a000000010420019000000001042002700000007f0940018f000000000904c0190000001f0490008c00000000040000190000000104002039000000000242013f0000000102200190000002ab0000c13d000000200290008c00000a390000413d00000000007004350000001f0260003900000005022002700000041602200041000000200460008c00000416020040410000001f0490003900000005044002700000041609400041000000000492004b00000a390000813d000000000002041b0000000102200039000000000492004b00000a350000413d0000001f0260008c00000a410000a13d0000000000700435000004420c60019800000a4c0000c13d000000200a000039000004160900004100000a580000013d000000000206004b000000000200001900000a450000613d00000000020c04330000000304600210000004400440027f0000044004400167000000000242016f0000000104600210000000000242019f00000a640000013d0000041609000041000000200a0000390000000102c0008a000000050220027000000417022000410000000004ba00190000000004040433000000000049041b000000200aa000390000000109900039000000000429004b00000a510000c13d00000000026c004b00000a620000813d0000000302600210000000f80220018f000004400220027f00000440022001670000000004ba00190000000004040433000000000224016f000000000029041b000000010260021000000001022001bf000000000027041b0000006502000039000000000002041b0000006602000039000000000002041b0000000402500370000000000202043b000000000402004b0000000004000019000000010400c039000000000442004b0000031e0000c13d000000cc06000039000000000406041a0000044104400197000000000224019f000000000026041b0000002404500370000000000704043b000000000407004b0000000004000019000000010400c039000000000447004b0000031e0000c13d0000044302200197000000000407004b000001000220c1bf000000000026041b0000004404500370000000000504043b000000000405004b0000000004000019000000010400c039000000000445004b0000031e0000c13d0000041802200197000000000405004b00000419040000410000000004006019000000000224019f000000000026041b000000ce02000039000000000202041a000000cd04000039000000000704041a000000400600043d00000060046000390000000c05000029000000000054043500000060040000390000000009460436000000800a600039000003f105200197000000000208004b000000050880021000000aa30000613d00000000028a00190000000b0b00035f000000000c0a001900000000b40b043c000000000c4c043600000000042c004b00000a9f0000c13d000000000203004b00000ab10000613d0000000b0280035f00000000048a00190000000303300210000000000804043300000000083801cf000000000838022f000000000202043b0000010003300089000000000232022f00000000023201cf000000000282019f00000000002404350000000c02a00029000000000002043500000000011a001900000000026100490000000000290435000000090200002900000000012104360000000503000029000000000203004b000000050330021000000ac30000613d0000000002310019000000070400035f0000000008010019000000004904043c0000000008980436000000000928004b00000abf0000c13d000000ff0470018f000000080200006b00000ad30000613d000000070230035f000000000331001900000008070000290000000307700210000000000803043300000000087801cf000000000878022f000000000202043b0000010007700089000000000272022f00000000027201cf000000000282019f000000000023043500000009021000290000000000020435000000400260003900000000004204350000000a026000690000000001120019000003cb0210009c000003cb010080410000006001100210000003cb0260009c000003cb060080410000004002600210000000000121019f0000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f000003f8011001c70000800d0200003900000002030000390000041a040000410f280f1e0000040f00000001012001900000031e0000613d000000000200041a0000044401200197000000000010041b0000000601000029000000ff0110018f000000400200043d0000000000120435000003cb0120009c000003cb0200804100000040012002100000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f0000041b011001c70000800d020000390000000103000039000003d1040000410f280f1e0000040f00000001012001900000031e0000613d000004e00000013d000000000402004b000000000400001900000b080000613d0000000a0400002900000000040404330000000305200210000004400550027f0000044005500167000000000454016f0000000102200210000000000224019f00000b270000013d0000040e040000410000002005000039000000010760008a00000005077002700000040f0770004100000009085000290000000008080433000000000084041b00000020055000390000000104400039000000000874004b00000b140000c13d000000000626004b00000b250000813d0000000306200210000000f80660018f000004400660027f000004400660016700000009055000290000000005050433000000000565016f000000000054041b000000010220021000000001022001bf000000000021041b00000008010000290000000002010433000004040120009c000003ea0000213d0000003701000039000000000501041a000000010450019000000001065002700000007f0460018f000000000406c0190000001f0640008c00000000060000190000000106002039000000000565013f0000000105500190000002ab0000c13d000000200540008c00000b490000413d00000000001004350000001f0520003900000005055002700000041005500041000000200620008c00000410050040410000001f0440003900000005044002700000041004400041000000000645004b00000b490000813d000000000005041b0000000105500039000000000645004b00000b450000413d0000001f0420008c00000b510000a13d0000000000100435000004420620019800000b5d0000c13d0000002005000039000004100400004100000b690000013d000000000402004b000000000400001900000b560000613d0000000b0400002900000000040404330000000305200210000004400550027f0000044005500167000000000454016f0000000102200210000000000224019f00000b750000013d00000410040000410000002005000039000000010760008a0000000507700270000004110770004100000008085000290000000008080433000000000084041b00000020055000390000000104400039000000000874004b00000b620000c13d000000000626004b00000b730000813d0000000306200210000000f80660018f000004400660027f000004400660016700000008055000290000000005050433000000000565016f000000000054041b000000010220021000000001022001bf000000000021041b000000000100041a0000ff0001100190000008690000613d000000400100043d000004120210009c000003ea0000213d0000004002100039000000400020043f000000010200003900000000022104360000041304000041000000000042043500000009040000290000000005040433000004040450009c000003ea0000213d0000006704000039000000000704041a000000010670019000000001087002700000007f0680018f000000000608c0190000001f0860008c00000000080000190000000108002039000000000787013f0000000107700190000002ab0000c13d000000200760008c00000ba30000413d00000000004004350000001f0750003900000005077002700000041407700041000000200850008c00000414070040410000001f0660003900000005066002700000041406600041000000000867004b00000ba30000813d000000000007041b0000000107700039000000000867004b00000b9f0000413d0000001f0650008c000000010650021000000bac0000a13d0000000000400435000004420950019800000bb70000c13d0000002008000039000004140700004100000bc30000013d000000000705004b000000000700001900000bb10000613d0000000a0700002900000000070704330000000305500210000004400550027f0000044005500167000000000557016f000000000565019f00000bce0000013d00000414070000410000002008000039000000010a90008a000000050aa00270000004150aa00041000000090b800029000000000b0b04330000000000b7041b00000020088000390000000107700039000000000ba7004b00000bbc0000c13d000000000959004b00000bcd0000813d0000000305500210000000f80550018f000004400550027f000004400550016700000009088000290000000008080433000000000558016f000000000057041b00000001056001bf000000000054041b0000000005010433000004040450009c000003ea0000213d0000006804000039000000000704041a000000010670019000000001087002700000007f0680018f000000000608c0190000001f0860008c00000000080000190000000108002039000000000787013f0000000107700190000002ab0000c13d000000200760008c00000bef0000413d00000000004004350000001f0750003900000005077002700000041607700041000000200850008c00000416070040410000001f0660003900000005066002700000041606600041000000000867004b00000bef0000813d000000000007041b0000000107700039000000000867004b00000beb0000413d0000001f0650008c00000c0d0000a13d000000000040043500000442075001980000041602000041000000200600003900000c000000613d000000010870008a0000000508800270000004170880004100000000091600190000000009090433000000000092041b00000020066000390000000102200039000000000982004b00000bf90000c13d000000000757004b00000c0a0000813d0000000307500210000000f80770018f000004400770027f000004400770016700000000011600190000000001010433000000000171016f000000000012041b000000010150021000000001011001bf00000c170000013d000000000105004b000000000100001900000c110000613d00000000010204330000000302500210000004400220027f0000044002200167000000000121016f0000000102500210000000000121019f000000000014041b0000006501000039000000000001041b0000006601000039000000000001041b0000042801000041000000400400043d0000000001140436000700000001001d0000000401400039000000200200003900000000002104350000000401000029000000000101043300000024024000390000000000120435000400000004001d0000004402400039000000000401004b00000c330000613d000000000400001900000000052400190000000506400029000000000606043300000000006504350000002004400039000000000514004b00000c2c0000413d0000000002210019000000000002043500000000020004140000000004000410000000040440008c00000c400000c13d00000000050004150000000e0550008a0000000505500210000000200130008c0000002004000039000000000403401900000c770000013d0000001f0110003900000442011001970000004401100039000003cb0310009c000003cb0100804100000060011002100000000404000029000003cb0340009c000003cb0300004100000000030440190000004003300210000000000131019f000003cb0320009c000003cb02008041000000c002200210000000000112019f00000000020004100f280f230000040f00000000030100190000006003300270000003cb03300197000000200430008c000000200400003900000000040340190000001f0540018f000000050640027200000c610000613d000000000701034f0000000408000029000000007907043c0000000008980436000000070980006c00000c5d0000c13d000000000705004b00000c700000613d0000000506600210000000000761034f00000004066000290000000305500210000000000806043300000000085801cf000000000858022f000000000707043b0000010005500089000000000757022f00000000055701cf000000000585019f0000000000560435000100000003001f000300000001035500000000050004150000000d0550008a0000000505500210000000010120019000000c950000613d0000001f01400039000000600210018f0000000401200029000000000221004b00000000020000190000000102004039000004040410009c000003ea0000213d0000000102200190000003ea0000c13d000000400010043f000000200230008c0000031e0000413d00000004020000290000000002020433000000ff0320008c0000031e0000213d0000000503500270000000000302001f000000cd05000039000000000305041a0000044103300197000000000323019f000000000035041b00000001030000290000000003030433000000000303004b0000041903000041000000000300601900000c9d0000013d0000000101000029000000010200003900000000002104350000041903000041000000400100043d000000cd02000039000000000202041a000000ff0220018f00000003040000290000000004040433000000000404004b000000010330c1bf000000cc04000039000000000504041a0000042905500197000000000353019f00000002050000290000000005050433000000000505004b000001000330c1bf000000000034041b0000006003000039000000000331043600000009040000290000000004040433000000600510003900000000004504350000008005100039000000000604004b00000cbb0000613d000000000600001900000000075600190000000a08600029000000000808043300000000008704350000002006600039000000000746004b00000cb40000413d000000000654001900000000000604350000001f044000390000044204400197000000000554001900000000041500490000000000430435000000080300002900000000040304330000000003450436000000000504004b00000ccf0000613d000000000500001900000000063500190000000b07500029000000000707043300000000007604350000002005500039000000000645004b00000cc80000413d00000000053400190000000000050435000000400510003900000000002504350000001f02400039000004420220019700000000031300490000000002230019000003cb0320009c000003cb020080410000006002200210000003cb0310009c000003cb010080410000004001100210000000000112019f0000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f0000000c02000029000003f105200197000003f8011001c70000800d0200003900000002030000390000041a040000410f280f1e0000040f00000001012001900000031e0000613d000000060100006b000004e00000c13d000000000200041a0000044401200197000000000010041b000000400100043d00000001030000390000000000310435000003cb0210009c000003cb0100804100000040011002100000000002000414000003cb0420009c000003cb02008041000000c002200210000000000112019f0000041b011001c70000800d0200003900000afe0000013d00000000430104340000000001320436000000000203004b00000d0b0000613d000000000200001900000000051200190000000006240019000000000606043300000000006504350000002002200039000000000532004b00000d040000413d000000000213001900000000000204350000001f0230003900000442022001970000000001210019000000000001042d0000001f0220003900000442022001970000000001120019000000000221004b00000000020000190000000102004039000004040310009c00000d1d0000213d000000010220019000000d1d0000c13d000000400010043f000000000001042d000004380100004100000000001004350000004101000039000000040010043f0000040d0100004100000f2a000104300000000004010019000004450120009c00000d550000813d0000001f0120003900000442011001970000003f011000390000044205100197000000400100043d0000000005510019000000000615004b00000000060000190000000106004039000004040750009c00000d550000213d000000010660019000000d550000c13d000000400050043f00000000052104360000000006420019000000000336004b00000d5b0000213d0000001f0320018f00000002044003670000000506200272000000050660021000000d440000613d0000000007650019000000000804034f0000000009050019000000008a08043c0000000009a90436000000000a79004b00000d400000c13d000000000703004b00000d520000613d000000000464034f00000000066500190000000303300210000000000706043300000000073701cf000000000737022f000000000404043b0000010003300089000000000434022f00000000033401cf000000000373019f000000000036043500000000022500190000000000020435000000000001042d000004380100004100000000001004350000004101000039000000040010043f0000040d0100004100000f2a00010430000000000100001900000f2a000104300003000000000002000003f10110019800000d960000613d000200000003001d000303f10020019c00000da00000613d000100000001001d00000000001004350000003401000039000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f0000000102200190000000030300002900000d940000613d000000000101043b0000000000300435000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f0000000306000029000000010220019000000d940000613d000000000101043b0000000202000029000000000021041b000000400100043d0000000000210435000003cb0210009c000003cb0100804100000040011002100000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f0000041b011001c70000800d020000390000000303000039000004460400004100000001050000290f280f1e0000040f000000010120019000000d940000613d000000000001042d000000000100001900000f2a00010430000000400100043d00000064021000390000044903000041000000000032043500000044021000390000044a0300004100000000003204350000002402100039000000240300003900000da90000013d000000400100043d000000640210003900000447030000410000000000320435000000440210003900000448030000410000000000320435000000240210003900000022030000390000000000320435000003cc020000410000000000210435000000040210003900000020030000390000000000320435000003cb0210009c000003cb01008041000000400110021000000402011001c700000f2a000104300004000000000002000400000003001d000003f10110019800000e030000613d000203f10020019c00000e0d0000613d000300000001001d00000000001004350000003301000039000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f000000010220019000000e010000613d000000000101043b000000000201041a000100000002001d000000040120006c00000e170000413d000000030100002900000000001004350000003301000039000000200010043f0000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f000000010220019000000e010000613d0000000103000029000000040230006a000000000101043b000000000021041b000000020100002900000000001004350000000001000414000003cb0210009c000003cb01008041000000c001100210000003f5011001c700008010020000390f280f230000040f000000010220019000000e010000613d000000000101043b000000000201041a00000004030000290000000002320019000000000021041b000000400100043d0000000000310435000003cb0210009c000003cb0100804100000040011002100000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f0000041b011001c70000800d0200003900000003030000390000042f04000041000000030500002900000002060000290f280f1e0000040f000000010120019000000e010000613d000000000001042d000000000100001900000f2a00010430000000400100043d00000064021000390000044f0300004100000000003204350000004402100039000004500300004100000000003204350000002402100039000000250300003900000e200000013d000000400100043d00000064021000390000044d03000041000000000032043500000044021000390000044e0300004100000000003204350000002402100039000000230300003900000e200000013d000000400100043d00000064021000390000044b03000041000000000032043500000044021000390000044c030000410000000000320435000000240210003900000026030000390000000000320435000003cc020000410000000000210435000000040210003900000020030000390000000000320435000003cb0210009c000003cb01008041000000400110021000000402011001c700000f2a0001043000020000000000020000006705000039000000000405041a000000010640019000000001014002700000007f0210018f000000000201c0190000001f0120008c00000000010000190000000101002039000000000116004b00000f010000c13d000000400300043d0000000001230436000000000606004b00000e480000613d0000000000500435000000000402004b00000e4e0000613d000004140500004100000000040000190000000006410019000000000705041a000000000076043500000001055000390000002004400039000000000624004b00000e400000413d00000e4f0000013d00000441044001970000000000410435000000000202004b0000002004000039000000000400601900000e4f0000013d00000000040000190000003f02400039000000200900008a000000000492016f0000000002340019000000000442004b00000000040000190000000104004039000004040520009c00000ef90000213d000000010440019000000ef90000c13d000000400020043f0000000003030433000000000403004b00000e730000613d000003cb0230009c000003cb030080410000006002300210000003cb0310009c000003cb010080410000004001100210000000000112019f0000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f000003f8011001c700008010020000390f280f230000040f000000010220019000000eff0000613d000000400200043d000000000801043b000000200900008a00000e770000013d0000006501000039000000000801041a000000000108004b00000451080060410000006805000039000000000405041a000000010640019000000001014002700000007f0310018f000000000301c0190000001f0130008c00000000010000190000000101002039000000000114013f000000010110019000000f010000c13d0000000001320436000000000606004b00000e930000613d0000000000500435000000000403004b00000e990000613d000004160500004100000000040000190000000006410019000000000705041a000000000076043500000001055000390000002004400039000000000634004b00000e8b0000413d00000e9a0000013d00000441044001970000000000410435000000000303004b0000002004000039000000000400601900000e9a0000013d00000000040000190000003f03400039000000000393016f0000000005230019000000000335004b00000000030000190000000103004039000004040450009c00000ef90000213d000000010330019000000ef90000c13d000000400050043f0000000002020433000000000302004b00000ebe0000613d000200000008001d000003cb0320009c000003cb020080410000006002200210000003cb0310009c000003cb010080410000004001100210000000000112019f0000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f000003f8011001c700008010020000390f280f230000040f000000010220019000000eff0000613d000000400500043d000000000101043b000000020800002900000ec20000013d0000006601000039000000000101041a000000000201004b0000045101006041000200000005001d000000600250003900000000001204350000004001500039000000000081043500000020025000390000045201000041000100000002001d0000000000120435000004370100004100000000001004390000000001000414000003cb0210009c000003cb01008041000000c001100210000003f4011001c70000800b020000390f280f230000040f000000010220019000000f070000613d000000000101043b0000000204000029000000a0024000390000000003000410000000000032043500000080024000390000000000120435000000a0010000390000000000140435000004530140009c000000000204001900000ef90000213d000000c001200039000000400010043f0000000103000029000003cb0130009c000003cb0300804100000040013002100000000002020433000003cb0320009c000003cb020080410000006002200210000000000112019f0000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f000003f8011001c700008010020000390f280f230000040f000000010220019000000eff0000613d000000000101043b000000000001042d000004380100004100000000001004350000004101000039000000040010043f0000040d0100004100000f2a00010430000000000100001900000f2a00010430000004380100004100000000001004350000002201000039000000040010043f0000040d0100004100000f2a00010430000000000001042f000000000001042f000003cb0310009c000003cb010080410000004001100210000003cb0320009c000003cb020080410000006002200210000000000112019f0000000002000414000003cb0320009c000003cb02008041000000c002200210000000000112019f000003f8011001c700008010020000390f280f230000040f000000010220019000000f1c0000613d000000000101043b000000000001042d000000000100001900000f2a0001043000000f21002104210000000102000039000000000001042d0000000002000019000000000001042d00000f26002104230000000102000039000000000001042d0000000002000019000000000001042d00000f280000043200000f290001042e00000f2a00010430000000000000000000000000000000000000000000000000000000000000000000000000ffffffff08c379a000000000000000000000000000000000000000000000000000000000496e697469616c697a61626c653a20636f6e747261637420697320696e697469616c697a696e6700000000000000000000000000000000000000000000000000000000000000000000000000000000000000008400000080000000000000000002000000000000000000000000000000000000200000008000000000000000007f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249800000002000000000000000000000000000000400000010000000000000000000000000000000000000000000000000000000000000000000000000084b0196d00000000000000000000000000000000000000000000000000000000a9059cba00000000000000000000000000000000000000000000000000000000c2eeeebc00000000000000000000000000000000000000000000000000000000c2eeeebd00000000000000000000000000000000000000000000000000000000d505accf00000000000000000000000000000000000000000000000000000000dd62ed3e00000000000000000000000000000000000000000000000000000000a9059cbb00000000000000000000000000000000000000000000000000000000ae1f6aaf00000000000000000000000000000000000000000000000000000000b71bcf900000000000000000000000000000000000000000000000000000000095d89b400000000000000000000000000000000000000000000000000000000095d89b410000000000000000000000000000000000000000000000000000000095f11a4000000000000000000000000000000000000000000000000000000000a457c2d70000000000000000000000000000000000000000000000000000000084b0196e000000000000000000000000000000000000000000000000000000008c2a993e0000000000000000000000000000000000000000000000000000000095ce3e93000000000000000000000000000000000000000000000000000000003644e5140000000000000000000000000000000000000000000000000000000074f4f5460000000000000000000000000000000000000000000000000000000074f4f547000000000000000000000000000000000000000000000000000000007ba8be34000000000000000000000000000000000000000000000000000000007ecebe00000000000000000000000000000000000000000000000000000000003644e51500000000000000000000000000000000000000000000000000000000395093510000000000000000000000000000000000000000000000000000000070a082310000000000000000000000000000000000000000000000000000000018160ddc0000000000000000000000000000000000000000000000000000000018160ddd0000000000000000000000000000000000000000000000000000000023b872dd00000000000000000000000000000000000000000000000000000000313ce5670000000000000000000000000000000000000000000000000000000006fdde0300000000000000000000000000000000000000000000000000000000095ea7b3000000000000000000000000ffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000020000000800000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d95539132020000020000000000000000000000000000000400000000000000000000000002000000000000000000000000000000000000400000000000000000000000006e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9000000000000000000000000000000000000000000000000ffffffffffffff1f0200000000000000000000000000000000000000000000000000000000000000190100000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000420000000000000000000000007fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0000000000000000000000000000000000000008000000000000000000000000045524332305065726d69743a20696e76616c6964207369676e61747572650000000000000000000000000000000000000000006400000000000000000000000045434453413a20696e76616c6964207369676e61747572650000000000000000756500000000000000000000000000000000000000000000000000000000000045434453413a20696e76616c6964207369676e6174757265202773272076616c000000000000000000000000000000000000008400000000000000000000000045524332305065726d69743a206578706972656420646561646c696e65000000000000000000000000000000000000000000000000000000ffffffffffffffff0ac76f01000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000800000000000000000496e697469616c697a61626c653a20636f6e747261637420697320616c726561647920696e697469616c697a6564000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000a3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d508da5cb5b000000000000000000000000000000000000000000000000000000008e4a23d60000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000004a11f94e20a93c79f6ec743a1954ec4fc2c08429ae2122118bf234b2185c81b84a11f94e20a93c79f6ec743a1954ec4fc2c08429ae2122118bf234b2185c81b942a7b7dd785cd69714a189dffb3fd7d7174edc9ece837694ce50f7078f7c31ae42a7b7dd785cd69714a189dffb3fd7d7174edc9ece837694ce50f7078f7c31af000000000000000000000000000000000000000000000000ffffffffffffffbf31000000000000000000000000000000000000000000000000000000000000009787eeb91fe3101235e4a76063c7023ecb40f923f97916639c598592fa30d6ae9787eeb91fe3101235e4a76063c7023ecb40f923f97916639c598592fa30d6afa2153420d844928b4421650203c77babc8b33d7f2e7b450e2966db0c22097753a2153420d844928b4421650203c77babc8b33d7f2e7b450e2966db0c22097754ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000101000000000000000000000000000000000000000000000000000000000001000081e8e92e5873539605a102eddae7ed06d19bea042099a437cbc3644415eb740402000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000020000000000000000000000000207a65726f00000000000000000000000000000000000000000000000000000045524332303a2064656372656173656420616c6c6f77616e63652062656c6f771806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000ffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffff0000000000000000000000000000000000000000ff000000000000000000000000000000000000000000000000ffffffffffffff9f95ce3e93000000000000000000000000000000000000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff80000000000000000000000000000000000000000000000000000000000000007ba8be3400000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000006e697469616c697a696e67000000000000000000000000000000000000000000496e697469616c697a61626c653a20636f6e7472616374206973206e6f742069d92e233d0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000024000000800000000000000000ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef397b33b307fc137878ebfc75b295289ec0ee25a31bb5bf034f33256fe8ea2aa645524332303a206d696e7420746f20746865207a65726f20616464726573730000000000000000000000000000000000000000640000008000000000000000004549503731323a20556e696e697469616c697a65640000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff80000000000000000000000000000000000000000000000000ffffffffffffffdf0f000000000000000000000000000000000000000000000000000000000000009a8a0592ac89c5ad3bc6df8224c17b485976f597df104ee20d0df415241f670b4e487b71000000000000000000000000000000000000000000000000000000009b5b9a05e4726d8bb959f1440e05c6b8109443f2083bc4e386237d7654526553636500000000000000000000000000000000000000000000000000000000000045524332303a206275726e20616d6f756e7420657863656564732062616c616e45524332303a206275726e2066726f6d20746865207a65726f2061646472657373000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ff000045524332303a20696e73756666696369656e7420616c6c6f77616e6365000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0001ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ff00000000000000000000000000000000000000000000000100000000000000008c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925737300000000000000000000000000000000000000000000000000000000000045524332303a20617070726f766520746f20746865207a65726f206164647265726573730000000000000000000000000000000000000000000000000000000045524332303a20617070726f76652066726f6d20746865207a65726f20616464616c616e6365000000000000000000000000000000000000000000000000000045524332303a207472616e7366657220616d6f756e7420657863656564732062657373000000000000000000000000000000000000000000000000000000000045524332303a207472616e7366657220746f20746865207a65726f2061646472647265737300000000000000000000000000000000000000000000000000000045524332303a207472616e736665722066726f6d20746865207a65726f206164c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a4708b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f000000000000000000000000000000000000000000000000ffffffffffffff3f532c77e857e46dea3d602eb071d6822f53882f7719d44b2ce280ff1a2ebdb59a