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 {BitMaps} from "@openzeppelin/contracts/utils/structs/BitMaps.sol";
import {IMintableAndDelegatable} from "src/interfaces/IMintableAndDelegatable.sol";
import {EIP712} from "@openzeppelin/contracts/utils/cryptography/EIP712.sol";
import {ECDSA} from "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
import {MerkleProof} from "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol";
import {Nonces} from "src/lib/Nonces.sol";
import {SignatureChecker} from "@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol";

/// @title ZkMerkleDistributor
/// @author [ScopeLift](https://scopelift.co)
/// @notice A contract that allows a user to claim a token distribution against a Merkle tree root.
/// @custom:security-contact [email protected]
contract ZkMerkleDistributor is EIP712, Nonces {
  using BitMaps for BitMaps.BitMap;

  /// @dev A struct of delegate information used for signature based delegateOnBehalf.
  struct DelegateInfo {
    address delegatee;
    uint256 expiry;
    bytes signature;
  }

  /// @dev A struct of claim information used for signature based claiming.
  struct ClaimSignatureInfo {
    address claimant;
    uint256 expiry;
    bytes signature;
  }

  /// @notice Type hash of the data that makes up the claim request.
  bytes32 public constant ZK_CLAIM_TYPEHASH =
    keccak256("Claim(uint256 index,address claimant,uint256 amount,uint256 expiry,uint256 nonce)");

  /// @notice Type hash of the data that makes up the claim and delegate request.
  bytes32 public constant ZK_CLAIM_AND_DELEGATE_TYPEHASH = keccak256(
    "ClaimAndDelegate(uint256 index,address claimant,uint256 amount,address delegatee,uint256 expiry,uint256 nonce)"
  );

  /// @notice The address of the admin of the MerkleDistributor.
  address public immutable ADMIN;

  /// @notice The token contract for the tokens to be claimed / distributed.
  IMintableAndDelegatable public immutable TOKEN;

  /// @notice The Merkle root for the distribution.
  bytes32 public immutable MERKLE_ROOT;

  /// @notice The maximum number of tokens that may be claimed using the MerkleDistributor.
  uint256 public immutable MAXIMUM_TOTAL_CLAIMABLE;

  /// @notice The start of the period when claims may be made.
  uint256 public immutable WINDOW_START;

  /// @notice The end of the period when claims may be made.
  uint256 public immutable WINDOW_END;

  /// @notice This is a packed array of booleans for tracking completion of claims.
  BitMaps.BitMap internal claimedBitMap;

  /// @notice This is the total amount of tokens that have been claimed so far.
  uint256 public totalClaimed;

  /// @notice Event that is emitted whenever a call to claim succeeds.
  event Claimed(uint256 index, address account, uint256 amount);

  /// @notice Error thrown when the claim has already been claimed.
  error ZkMerkleDistributor__AlreadyClaimed();

  /// @notice Error thrown when the claim window is not open and should be.
  error ZkMerkleDistributor__ClaimWindowNotOpen();

  /// @notice Error thrown when the claim window is open and should not be.
  error ZkMerkleDistributor__ClaimWindowNotYetClosed();

  /// @notice Error for when the claim has an invalid proof.
  error ZkMerkleDistributor__InvalidProof();

  /// @notice Error for when the total claimed exceeds the maximum claimable amount.
  error ZkMerkleDistributor__ClaimAmountExceedsMaximum();

  /// @notice Error for when the sweep has already been done.
  error ZkMerkleDistributor__SweepAlreadyDone();

  /// @notice Error for when the caller is not the admin.
  error ZkMerkleDistributor__Unauthorized(address account);

  /// @notice Thrown if a caller supplies an invalid signature to a method that requires one.
  error ZkMerkleDistributor__InvalidSignature();

  /// @notice Thrown if the caller submits an expired signature
  error ZkMerkleDistributor__ExpiredSignature();

  /// @notice Constructor for a new MerkleDistributor contract
  /// @param _admin The address that is allowed to execute "sweepUnclaimed"
  /// @param _token The contract of the token distributed by the Merkle Distributor.
  /// @param _merkleRoot The Merkle root for the distribution.
  /// @param _maximumTotalClaimable The maximum number of tokens that may be claimed by the MerkleDistributor.
  /// @param _windowStart The start of the time window during which claims may be made.
  /// @param _windowEnd The end of the time window during which claims may be made.
  constructor(
    address _admin,
    IMintableAndDelegatable _token,
    bytes32 _merkleRoot,
    uint256 _maximumTotalClaimable,
    uint256 _windowStart,
    uint256 _windowEnd
  ) EIP712("ZkMerkleDistributor", "1") {
    ADMIN = _admin;
    TOKEN = _token;
    MERKLE_ROOT = _merkleRoot;
    MAXIMUM_TOTAL_CLAIMABLE = _maximumTotalClaimable;
    WINDOW_START = _windowStart;
    WINDOW_END = _windowEnd;
  }

  /// @notice Returns true if the index has been claimed.
  /// @param _index The index of the claim.
  /// @return Whether a claim has been claimed.
  function isClaimed(uint256 _index) public view returns (bool) {
    return claimedBitMap.get(_index);
  }

  /// @notice Claims the tokens for a caller, given the index, amount, and merkle proof.
  /// @param _index The index of the claim.
  /// @param _amount The quantity of tokens, in raw decimals, that will be created.
  /// @param _merkleProof The Merkle proof for the claim.
  function claim(uint256 _index, uint256 _amount, bytes32[] calldata _merkleProof) external {
    _claim(_index, msg.sender, _amount, _merkleProof);
  }

  /// @notice Claims on behalf of another account, using the ERC-712 or ERC-1271 signature standard.
  /// @dev This method makes use of the _signature parameter to verify the claim on behalf of the claimer.
  /// @param _index The index of the claim.
  /// @param _amount The quantity of tokens, in raw decimals, that will be created.
  /// @param _merkleProof The Merkle proof for the claim.
  /// @param _claimSignatureInfo Signature information provided by the claimer.
  function claimOnBehalf(
    uint256 _index,
    uint256 _amount,
    bytes32[] calldata _merkleProof,
    ClaimSignatureInfo calldata _claimSignatureInfo
  ) external {
    bytes32 _dataHash;

    if (block.timestamp > _claimSignatureInfo.expiry) {
      revert ZkMerkleDistributor__ExpiredSignature();
    }
    unchecked {
      _dataHash = ECDSA.toTypedDataHash(
        _domainSeparatorV4(),
        keccak256(
          abi.encode(
            ZK_CLAIM_TYPEHASH,
            _index,
            _claimSignatureInfo.claimant,
            _amount,
            _claimSignatureInfo.expiry,
            _useNonce(_claimSignatureInfo.claimant)
          )
        )
      );
    }
    _revertIfSignatureIsNotValidNow(_claimSignatureInfo.claimant, _dataHash, _claimSignatureInfo.signature);
    _claim(_index, _claimSignatureInfo.claimant, _amount, _merkleProof);
  }

  /// @notice Claims the tokens for a claimant, given a claimant address, an index, an amount, and a merkle proof.
  /// @dev This method makes use of signature parameters to delegate the claimant's voting power to another address.
  /// @param _index The index of the claim.
  /// @param _amount The quantity of tokens, in raw decimals, that will be created.
  /// @param _merkleProof The Merkle proof for the claim.
  /// @param _delegateInfo The address (and signature info) for where the claimer's voting power will be delegated.
  function claimAndDelegate(
    uint256 _index,
    uint256 _amount,
    bytes32[] calldata _merkleProof,
    DelegateInfo calldata _delegateInfo
  ) external virtual {
    _claim(_index, msg.sender, _amount, _merkleProof);

    // Use delegateOnBehalf to delegate on behalf of the claimer.
    // Catch delegateOnBehalf reverts caused by a front-run delegateOnBehalf so entire claim doesn't revert.
    try TOKEN.delegateOnBehalf(msg.sender, _delegateInfo.delegatee, _delegateInfo.expiry, _delegateInfo.signature) {}
      catch (bytes memory) {}
  }

  /// @notice Claims on behalf of another account, using the ERC-712 or ERC-1271 signature standard.
  /// @dev This method makes use of the _signature parameter to verify the claim on behalf of the claimer, and
  /// separate signature parameters to delegate the claimer's voting power to another address.
  /// @param _index The index of the claim.
  /// @param _amount The quantity of tokens, in raw decimals, that will be created.
  /// @param _merkleProof The Merkle proof for the claim.
  /// @param _claimSignatureInfo Signature information provided by the claimer.
  /// @param _delegateInfo The address (and signature info) for where claimer's voting power will be delegated.
  /// In this function the delegateInfo expiry will be ignored.
  function claimAndDelegateOnBehalf(
    uint256 _index,
    uint256 _amount,
    bytes32[] calldata _merkleProof,
    ClaimSignatureInfo calldata _claimSignatureInfo,
    DelegateInfo calldata _delegateInfo
  ) external {
    bytes32 _dataHash;

    if (block.timestamp > _claimSignatureInfo.expiry) {
      revert ZkMerkleDistributor__ExpiredSignature();
    }

    unchecked {
      _dataHash = keccak256(
        abi.encodePacked(
          "\x19\x01",
          _domainSeparatorV4(),
          keccak256(
            abi.encode(
              ZK_CLAIM_AND_DELEGATE_TYPEHASH,
              _index,
              _claimSignatureInfo.claimant,
              _amount,
              _delegateInfo.delegatee,
              _claimSignatureInfo.expiry,
              _useNonce(_claimSignatureInfo.claimant)
            )
          )
        )
      );
    }
    _revertIfSignatureIsNotValidNow(_claimSignatureInfo.claimant, _dataHash, _claimSignatureInfo.signature);
    _claim(_index, _claimSignatureInfo.claimant, _amount, _merkleProof);

    // Use delegateOnBehalf to delegate on behalf of the claimer.
    // Catch delegateOnBehalf reverts caused by a front-run delegateOnBehalf so entire claim doesn't revert.
    try TOKEN.delegateOnBehalf(
      _claimSignatureInfo.claimant, _delegateInfo.delegatee, _delegateInfo.expiry, _delegateInfo.signature
    ) {} catch (bytes memory) {}
  }

  /// @notice Allows the admin to sweep unclaimed tokens to a given address.
  /// @param _unclaimedReceiver The address that will receive the unclaimed tokens.
  function sweepUnclaimed(address _unclaimedReceiver) external {
    _revertIfClaimWindowHasNotClosed();
    _revertIfUnauthorized();
    _revertIfAlreadySwept();
    TOKEN.mint(_unclaimedReceiver, MAXIMUM_TOTAL_CLAIMABLE - totalClaimed);
    totalClaimed = MAXIMUM_TOTAL_CLAIMABLE;
  }

  /// @notice Claims the tokens for a given index, account, amount, and merkle proof.
  /// @param _index The index of the claim.
  /// @param _claimant The address that will receive the new tokens.
  /// @param _amount The quantity of tokens, in raw decimals, that will be created.
  /// @param _merkleProof The Merkle proof for the claim.
  /// @dev Internal method for claiming tokens, called by 'claim', 'claimOnBehalf', 'claimAndDelegate' and
  /// 'claimAndDelegateOnBehalf'.
  function _claim(uint256 _index, address _claimant, uint256 _amount, bytes32[] calldata _merkleProof) internal {
    _revertIfClaimWindowNotOpen();
    _revertIfClaimAmountExceedsMaximum(_amount);
    _revertIfAlreadyClaimed(_index);

    // Verify the merkle proof.
    bytes32 node = keccak256(abi.encodePacked(_index, _claimant, _amount));
    if (!MerkleProof.verifyCalldata(_merkleProof, MERKLE_ROOT, node)) {
      revert ZkMerkleDistributor__InvalidProof();
    }

    // Bump the total amount claimed, mark it claimed, send the token, and emit the event.
    totalClaimed += _amount;
    _setClaimed(_index);
    TOKEN.mint(_claimant, _amount);
    emit Claimed(_index, _claimant, _amount);
  }

  /// @notice Allows a msg.sender to increment their nonce and invalidate any of their pending signatures.
  function invalidateNonce() external {
    _useNonce(msg.sender);
  }

  /// @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
  /// @return The domain seperator.
  function DOMAIN_SEPARATOR() external view returns (bytes32) {
    return _domainSeparatorV4();
  }

  /// @notice Reverts if the caller is not the admin.
  function _revertIfUnauthorized() internal view {
    if (msg.sender != ADMIN) {
      revert ZkMerkleDistributor__Unauthorized(msg.sender);
    }
  }

  /// @notice Updates the tracking data to mark the claim has been done.
  /// @param _index The index of the claim.
  function _setClaimed(uint256 _index) private {
    claimedBitMap.set(_index);
  }

  /// @notice Reverts if already claimed.
  /// @param _index The index of the claim.
  function _revertIfAlreadyClaimed(uint256 _index) internal view {
    if (isClaimed(_index)) {
      revert ZkMerkleDistributor__AlreadyClaimed();
    }
  }

  /// @notice Reverts if the claim window is not open.
  function _revertIfClaimWindowNotOpen() internal view {
    if (block.timestamp < WINDOW_START || block.timestamp >= WINDOW_END) {
      revert ZkMerkleDistributor__ClaimWindowNotOpen();
    }
  }

  /// @notice Reverts if the claim window is open.
  function _revertIfClaimWindowHasNotClosed() internal view {
    if (block.timestamp < WINDOW_END) {
      revert ZkMerkleDistributor__ClaimWindowNotYetClosed();
    }
  }

  /// @notice Reverts if the claim amount exceeds the maximum.
  /// @param _amount The quantity of tokens, in raw decimals, that will be created.
  function _revertIfClaimAmountExceedsMaximum(uint256 _amount) internal view {
    if (_amount + totalClaimed > MAXIMUM_TOTAL_CLAIMABLE) {
      revert ZkMerkleDistributor__ClaimAmountExceedsMaximum();
    }
  }

  /// @notice Reverts if the sweep has already been done.
  function _revertIfAlreadySwept() internal view {
    if (totalClaimed >= MAXIMUM_TOTAL_CLAIMABLE) {
      revert ZkMerkleDistributor__SweepAlreadyDone();
    }
  }

  /// @notice Reverts if the signature is not valid
  /// @param _signer Address of the signer.
  /// @param _hash Hash of the message.
  /// @param _signature Signature to validate.
  function _revertIfSignatureIsNotValidNow(address _signer, bytes32 _hash, bytes memory _signature) internal view {
    bool _isValid = SignatureChecker.isValidSignatureNow(_signer, _hash, _signature);
    if (!_isValid) {
      revert ZkMerkleDistributor__InvalidSignature();
    }
  }
}

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

pragma solidity ^0.8.0;

import "../ERC1967/ERC1967Proxy.sol";

/**
 * @dev Interface for {TransparentUpgradeableProxy}. In order to implement transparency, {TransparentUpgradeableProxy}
 * does not implement this interface directly, and some of its functions are implemented by an internal dispatch
 * mechanism. The compiler is unaware that these functions are implemented by {TransparentUpgradeableProxy} and will not
 * include them in the ABI so this interface must be used to interact with it.
 */
interface ITransparentUpgradeableProxy is IERC1967 {
    function admin() external view returns (address);

    function implementation() external view returns (address);

    function changeAdmin(address) external;

    function upgradeTo(address) external;

    function upgradeToAndCall(address, bytes memory) external payable;
}

/**
 * @dev This contract implements a proxy that is upgradeable by an admin.
 *
 * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector
 * clashing], which can potentially be used in an attack, this contract uses the
 * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two
 * things that go hand in hand:
 *
 * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if
 * that call matches one of the admin functions exposed by the proxy itself.
 * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the
 * implementation. If the admin tries to call a function on the implementation it will fail with an error that says
 * "admin cannot fallback to proxy target".
 *
 * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing
 * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due
 * to sudden errors when trying to call a function from the proxy implementation.
 *
 * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,
 * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.
 *
 * NOTE: The real interface of this proxy is that defined in `ITransparentUpgradeableProxy`. This contract does not
 * inherit from that interface, and instead the admin functions are implicitly implemented using a custom dispatch
 * mechanism in `_fallback`. Consequently, the compiler will not produce an ABI for this contract. This is necessary to
 * fully implement transparency without decoding reverts caused by selector clashes between the proxy and the
 * implementation.
 *
 * WARNING: It is not recommended to extend this contract to add additional external functions. If you do so, the compiler
 * will not check that there are no selector conflicts, due to the note above. A selector clash between any new function
 * and the functions declared in {ITransparentUpgradeableProxy} will be resolved in favor of the new one. This could
 * render the admin operations inaccessible, which could prevent upgradeability. Transparency may also be compromised.
 */
contract TransparentUpgradeableProxy is ERC1967Proxy {
    /**
     * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and
     * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.
     */
    constructor(address _logic, address admin_, bytes memory _data) payable ERC1967Proxy(_logic, _data) {
        _changeAdmin(admin_);
    }

    /**
     * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
     *
     * CAUTION: This modifier is deprecated, as it could cause issues if the modified function has arguments, and the
     * implementation provides a function with the same selector.
     */
    modifier ifAdmin() {
        if (msg.sender == _getAdmin()) {
            _;
        } else {
            _fallback();
        }
    }

    /**
     * @dev If caller is the admin process the call internally, otherwise transparently fallback to the proxy behavior
     */
    function _fallback() internal virtual override {
        if (msg.sender == _getAdmin()) {
            bytes memory ret;
            bytes4 selector = msg.sig;
            if (selector == ITransparentUpgradeableProxy.upgradeTo.selector) {
                ret = _dispatchUpgradeTo();
            } else if (selector == ITransparentUpgradeableProxy.upgradeToAndCall.selector) {
                ret = _dispatchUpgradeToAndCall();
            } else if (selector == ITransparentUpgradeableProxy.changeAdmin.selector) {
                ret = _dispatchChangeAdmin();
            } else if (selector == ITransparentUpgradeableProxy.admin.selector) {
                ret = _dispatchAdmin();
            } else if (selector == ITransparentUpgradeableProxy.implementation.selector) {
                ret = _dispatchImplementation();
            } else {
                revert("TransparentUpgradeableProxy: admin cannot fallback to proxy target");
            }
            assembly {
                return(add(ret, 0x20), mload(ret))
            }
        } else {
            super._fallback();
        }
    }

    /**
     * @dev Returns the current admin.
     *
     * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
     * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
     * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
     */
    function _dispatchAdmin() private returns (bytes memory) {
        _requireZeroValue();

        address admin = _getAdmin();
        return abi.encode(admin);
    }

    /**
     * @dev Returns the current implementation.
     *
     * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
     * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
     * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
     */
    function _dispatchImplementation() private returns (bytes memory) {
        _requireZeroValue();

        address implementation = _implementation();
        return abi.encode(implementation);
    }

    /**
     * @dev Changes the admin of the proxy.
     *
     * Emits an {AdminChanged} event.
     */
    function _dispatchChangeAdmin() private returns (bytes memory) {
        _requireZeroValue();

        address newAdmin = abi.decode(msg.data[4:], (address));
        _changeAdmin(newAdmin);

        return "";
    }

    /**
     * @dev Upgrade the implementation of the proxy.
     */
    function _dispatchUpgradeTo() private returns (bytes memory) {
        _requireZeroValue();

        address newImplementation = abi.decode(msg.data[4:], (address));
        _upgradeToAndCall(newImplementation, bytes(""), false);

        return "";
    }

    /**
     * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified
     * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the
     * proxied contract.
     */
    function _dispatchUpgradeToAndCall() private returns (bytes memory) {
        (address newImplementation, bytes memory data) = abi.decode(msg.data[4:], (address, bytes));
        _upgradeToAndCall(newImplementation, data, true);

        return "";
    }

    /**
     * @dev Returns the current admin.
     *
     * CAUTION: This function is deprecated. Use {ERC1967Upgrade-_getAdmin} instead.
     */
    function _admin() internal view virtual returns (address) {
        return _getAdmin();
    }

    /**
     * @dev To keep this contract fully transparent, all `ifAdmin` functions must be payable. This helper is here to
     * emulate some proxy functions being non-payable while still allowing value to pass through.
     */
    function _requireZeroValue() private {
        require(msg.value == 0);
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.3) (proxy/transparent/ProxyAdmin.sol)

pragma solidity ^0.8.0;

import "./TransparentUpgradeableProxy.sol";
import "../../access/Ownable.sol";

/**
 * @dev This is an auxiliary contract meant to be assigned as the admin of a {TransparentUpgradeableProxy}. For an
 * explanation of why you would want to use this see the documentation for {TransparentUpgradeableProxy}.
 */
contract ProxyAdmin is Ownable {
    /**
     * @dev Returns the current implementation of `proxy`.
     *
     * Requirements:
     *
     * - This contract must be the admin of `proxy`.
     */
    function getProxyImplementation(ITransparentUpgradeableProxy proxy) public view virtual returns (address) {
        // We need to manually run the static call since the getter cannot be flagged as view
        // bytes4(keccak256("implementation()")) == 0x5c60da1b
        (bool success, bytes memory returndata) = address(proxy).staticcall(hex"5c60da1b");
        require(success);
        return abi.decode(returndata, (address));
    }

    /**
     * @dev Returns the current admin of `proxy`.
     *
     * Requirements:
     *
     * - This contract must be the admin of `proxy`.
     */
    function getProxyAdmin(ITransparentUpgradeableProxy proxy) public view virtual returns (address) {
        // We need to manually run the static call since the getter cannot be flagged as view
        // bytes4(keccak256("admin()")) == 0xf851a440
        (bool success, bytes memory returndata) = address(proxy).staticcall(hex"f851a440");
        require(success);
        return abi.decode(returndata, (address));
    }

    /**
     * @dev Changes the admin of `proxy` to `newAdmin`.
     *
     * Requirements:
     *
     * - This contract must be the current admin of `proxy`.
     */
    function changeProxyAdmin(ITransparentUpgradeableProxy proxy, address newAdmin) public virtual onlyOwner {
        proxy.changeAdmin(newAdmin);
    }

    /**
     * @dev Upgrades `proxy` to `implementation`. See {TransparentUpgradeableProxy-upgradeTo}.
     *
     * Requirements:
     *
     * - This contract must be the admin of `proxy`.
     */
    function upgrade(ITransparentUpgradeableProxy proxy, address implementation) public virtual onlyOwner {
        proxy.upgradeTo(implementation);
    }

    /**
     * @dev Upgrades `proxy` to `implementation` and calls a function on the new implementation. See
     * {TransparentUpgradeableProxy-upgradeToAndCall}.
     *
     * Requirements:
     *
     * - This contract must be the admin of `proxy`.
     */
    function upgradeAndCall(
        ITransparentUpgradeableProxy proxy,
        address implementation,
        bytes memory data
    ) public payable virtual onlyOwner {
        proxy.upgradeToAndCall{value: msg.value}(implementation, data);
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (proxy/beacon/BeaconProxy.sol)

pragma solidity ^0.8.0;

import "./IBeacon.sol";
import "../Proxy.sol";
import "../ERC1967/ERC1967Upgrade.sol";

/**
 * @dev This contract implements a proxy that gets the implementation address for each call from an {UpgradeableBeacon}.
 *
 * The beacon address is stored in storage slot `uint256(keccak256('eip1967.proxy.beacon')) - 1`, so that it doesn't
 * conflict with the storage layout of the implementation behind the proxy.
 *
 * _Available since v3.4._
 */
contract BeaconProxy is Proxy, ERC1967Upgrade {
    /**
     * @dev Initializes the proxy with `beacon`.
     *
     * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon. This
     * will typically be an encoded function call, and allows initializing the storage of the proxy like a Solidity
     * constructor.
     *
     * Requirements:
     *
     * - `beacon` must be a contract with the interface {IBeacon}.
     */
    constructor(address beacon, bytes memory data) payable {
        _upgradeBeaconToAndCall(beacon, data, false);
    }

    /**
     * @dev Returns the current beacon address.
     */
    function _beacon() internal view virtual returns (address) {
        return _getBeacon();
    }

    /**
     * @dev Returns the current implementation address of the associated beacon.
     */
    function _implementation() internal view virtual override returns (address) {
        return IBeacon(_getBeacon()).implementation();
    }

    /**
     * @dev Changes the proxy to use a new beacon. Deprecated: see {_upgradeBeaconToAndCall}.
     *
     * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon.
     *
     * Requirements:
     *
     * - `beacon` must be a contract.
     * - The implementation returned by `beacon` must be a contract.
     */
    function _setBeacon(address beacon, bytes memory data) internal virtual {
        _upgradeBeaconToAndCall(beacon, data, false);
    }
}

// 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.7.0) (proxy/ERC1967/ERC1967Proxy.sol)

pragma solidity ^0.8.0;

import "../Proxy.sol";
import "./ERC1967Upgrade.sol";

/**
 * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
 * implementation address that can be changed. This address is stored in storage in the location specified by
 * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
 * implementation behind the proxy.
 */
contract ERC1967Proxy is Proxy, ERC1967Upgrade {
    /**
     * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
     *
     * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
     * function call, and allows initializing the storage of the proxy like a Solidity constructor.
     */
    constructor(address _logic, bytes memory _data) payable {
        _upgradeToAndCall(_logic, _data, false);
    }

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

// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;

import {IMintable} from "src/interfaces/IMintable.sol";

interface IMintableAndDelegatable is IMintable {
  function DOMAIN_SEPARATOR() external view returns (bytes32);
  function delegateOnBehalf(address _signer, address _delegatee, uint256 _expiry, bytes calldata _signature) external;
  function delegates(address _account) external view returns (address);
}

// forgefmt: disable-start
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/Nonces.sol)
pragma solidity 0.8.24;

/**
 * @dev Provides tracking nonces for addresses. Nonces will only increment.
 * Vendored from https://github.com/OpenZeppelin/openzeppelin-contracts/blob/v5.0.2/contracts/utils/Nonces.sol
 */
abstract contract Nonces {
    /**
     * @dev The nonce used for an `account` is not the expected current nonce.
     */
    error InvalidAccountNonce(address account, uint256 currentNonce);

    mapping(address account => uint256) private _nonces;

    /**
     * @dev Returns the next unused nonce for an address.
     */
    function nonces(address owner) public view virtual returns (uint256) {
        return _nonces[owner];
    }

    /**
     * @dev Consumes a nonce.
     *
     * Returns the current value and increments nonce.
     */
    function _useNonce(address owner) internal virtual returns (uint256) {
        // For each account, the nonce has an initial value of 0, can only be incremented by one, and cannot be
        // decremented or reset. This guarantees that the nonce never overflows.
        unchecked {
            // It is important to do x++ and not ++x here.
            return _nonces[owner]++;
        }
    }

    /**
     * @dev Same as {_useNonce} but checking that `nonce` is the next valid for `owner`.
     */
    function _useCheckedNonce(address owner, uint256 nonce) internal virtual {
        uint256 current = _useNonce(owner);
        if (nonce != current) {
            revert InvalidAccountNonce(owner, current);
        }
    }
}
// forgefmt: disable-end

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

pragma solidity ^0.8.0;

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

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

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

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

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

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

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (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.6.0) (proxy/Proxy.sol)

pragma solidity ^0.8.0;

/**
 * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
 * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
 * be specified by overriding the virtual {_implementation} function.
 *
 * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
 * different contract through the {_delegate} function.
 *
 * The success and return data of the delegated call will be returned back to the caller of the proxy.
 */
abstract contract Proxy {
    /**
     * @dev Delegates the current call to `implementation`.
     *
     * This function does not return to its internal call site, it will return directly to the external caller.
     */
    function _delegate(address implementation) internal virtual {
        assembly {
            // Copy msg.data. We take full control of memory in this inline assembly
            // block because it will not return to Solidity code. We overwrite the
            // Solidity scratch pad at memory position 0.
            calldatacopy(0, 0, calldatasize())

            // Call the implementation.
            // out and outsize are 0 because we don't know the size yet.
            let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)

            // Copy the returned data.
            returndatacopy(0, 0, returndatasize())

            switch result
            // delegatecall returns 0 on error.
            case 0 {
                revert(0, returndatasize())
            }
            default {
                return(0, returndatasize())
            }
        }
    }

    /**
     * @dev This is a virtual function that should be overridden so it returns the address to which the fallback function
     * and {_fallback} should delegate.
     */
    function _implementation() internal view virtual returns (address);

    /**
     * @dev Delegates the current call to the address returned by `_implementation()`.
     *
     * This function does not return to its internal call site, it will return directly to the external caller.
     */
    function _fallback() internal virtual {
        _beforeFallback();
        _delegate(_implementation());
    }

    /**
     * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
     * function in the contract matches the call data.
     */
    fallback() external payable virtual {
        _fallback();
    }

    /**
     * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
     * is empty.
     */
    receive() external payable virtual {
        _fallback();
    }

    /**
     * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
     * call, or as part of the Solidity `fallback` or `receive` functions.
     *
     * If overridden should call `super._beforeFallback()`.
     */
    function _beforeFallback() internal virtual {}
}

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

pragma solidity ^0.8.0;

/**
 * @dev These functions deal with verification of Merkle Tree proofs.
 *
 * The tree and the proofs can be generated using our
 * https://github.com/OpenZeppelin/merkle-tree[JavaScript library].
 * You will find a quickstart guide in the readme.
 *
 * WARNING: You should avoid using leaf values that are 64 bytes long prior to
 * hashing, or use a hash function other than keccak256 for hashing leaves.
 * This is because the concatenation of a sorted pair of internal nodes in
 * the merkle tree could be reinterpreted as a leaf value.
 * OpenZeppelin's JavaScript library generates merkle trees that are safe
 * against this attack out of the box.
 */
library MerkleProof {
    /**
     * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
     * defined by `root`. For this, a `proof` must be provided, containing
     * sibling hashes on the branch from the leaf to the root of the tree. Each
     * pair of leaves and each pair of pre-images are assumed to be sorted.
     */
    function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
        return processProof(proof, leaf) == root;
    }

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

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

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

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

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

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

        // Check proof validity.
        require(leavesLen + proofLen - 1 == totalHashes, "MerkleProof: invalid multiproof");

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

        if (totalHashes > 0) {
            require(proofPos == proofLen, "MerkleProof: invalid multiproof");
            unchecked {
                return hashes[totalHashes - 1];
            }
        } else if (leavesLen > 0) {
            return leaves[0];
        } else {
            return proof[0];
        }
    }

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

        // Check proof validity.
        require(leavesLen + proofLen - 1 == totalHashes, "MerkleProof: invalid multiproof");

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

        if (totalHashes > 0) {
            require(proofPos == proofLen, "MerkleProof: invalid multiproof");
            unchecked {
                return hashes[totalHashes - 1];
            }
        } else if (leavesLen > 0) {
            return leaves[0];
        } else {
            return proof[0];
        }
    }

    function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) {
        return a < b ? _efficientHash(a, b) : _efficientHash(b, a);
    }

    function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, a)
            mstore(0x20, b)
            value := keccak256(0x00, 0x40)
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/structs/BitMaps.sol)
pragma solidity ^0.8.0;

/**
 * @dev Library for managing uint256 to bool mapping in a compact and efficient way, providing the keys are sequential.
 * Largely inspired by Uniswap's https://github.com/Uniswap/merkle-distributor/blob/master/contracts/MerkleDistributor.sol[merkle-distributor].
 */
library BitMaps {
    struct BitMap {
        mapping(uint256 => uint256) _data;
    }

    /**
     * @dev Returns whether the bit at `index` is set.
     */
    function get(BitMap storage bitmap, uint256 index) internal view returns (bool) {
        uint256 bucket = index >> 8;
        uint256 mask = 1 << (index & 0xff);
        return bitmap._data[bucket] & mask != 0;
    }

    /**
     * @dev Sets the bit at `index` to the boolean `value`.
     */
    function setTo(BitMap storage bitmap, uint256 index, bool value) internal {
        if (value) {
            set(bitmap, index);
        } else {
            unset(bitmap, index);
        }
    }

    /**
     * @dev Sets the bit at `index`.
     */
    function set(BitMap storage bitmap, uint256 index) internal {
        uint256 bucket = index >> 8;
        uint256 mask = 1 << (index & 0xff);
        bitmap._data[bucket] |= mask;
    }

    /**
     * @dev Unsets the bit at `index`.
     */
    function unset(BitMap storage bitmap, uint256 index) internal {
        uint256 bucket = index >> 8;
        uint256 mask = 1 << (index & 0xff);
        bitmap._data[bucket] &= ~mask;
    }
}

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

pragma solidity ^0.8.0;

import "../Strings.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 ECDSA {
    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", Strings.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 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/cryptography/EIP712.sol)

pragma solidity ^0.8.8;

import "./ECDSA.sol";
import "../ShortStrings.sol";
import "../../interfaces/IERC5267.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:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment
 */
abstract contract EIP712 is IERC5267 {
    using ShortStrings for *;

    bytes32 private constant _TYPE_HASH =
        keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");

    // Cache the domain separator as an immutable value, but also store the chain id that it corresponds to, in order to
    // invalidate the cached domain separator if the chain id changes.
    bytes32 private immutable _cachedDomainSeparator;
    uint256 private immutable _cachedChainId;
    address private immutable _cachedThis;

    bytes32 private immutable _hashedName;
    bytes32 private immutable _hashedVersion;

    ShortString private immutable _name;
    ShortString private immutable _version;
    string private _nameFallback;
    string private _versionFallback;

    /**
     * @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].
     */
    constructor(string memory name, string memory version) {
        _name = name.toShortStringWithFallback(_nameFallback);
        _version = version.toShortStringWithFallback(_versionFallback);
        _hashedName = keccak256(bytes(name));
        _hashedVersion = keccak256(bytes(version));

        _cachedChainId = block.chainid;
        _cachedDomainSeparator = _buildDomainSeparator();
        _cachedThis = address(this);
    }

    /**
     * @dev Returns the domain separator for the current chain.
     */
    function _domainSeparatorV4() internal view returns (bytes32) {
        if (address(this) == _cachedThis && block.chainid == _cachedChainId) {
            return _cachedDomainSeparator;
        } else {
            return _buildDomainSeparator();
        }
    }

    function _buildDomainSeparator() private view returns (bytes32) {
        return keccak256(abi.encode(_TYPE_HASH, _hashedName, _hashedVersion, 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 ECDSA.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
        )
    {
        return (
            hex"0f", // 01111
            _name.toStringWithFallback(_nameFallback),
            _version.toStringWithFallback(_versionFallback),
            block.chainid,
            address(this),
            bytes32(0),
            new uint256[](0)
        );
    }
}

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

pragma solidity ^0.8.0;

import "./ECDSA.sol";
import "../../interfaces/IERC1271.sol";

/**
 * @dev Signature verification helper that can be used instead of `ECDSA.recover` to seamlessly support both ECDSA
 * signatures from externally owned accounts (EOAs) as well as ERC1271 signatures from smart contract wallets like
 * Argent and Gnosis Safe.
 *
 * _Available since v4.1._
 */
library SignatureChecker {
    /**
     * @dev Checks if a signature is valid for a given signer and data hash. If the signer is a smart contract, the
     * signature is validated against that smart contract using ERC1271, otherwise it's validated using `ECDSA.recover`.
     *
     * NOTE: Unlike ECDSA signatures, contract signatures are revocable, and the outcome of this function can thus
     * change through time. It could return true at block N and false at block N+1 (or the opposite).
     */
    function isValidSignatureNow(address signer, bytes32 hash, bytes memory signature) internal view returns (bool) {
        (address recovered, ECDSA.RecoverError error) = ECDSA.tryRecover(hash, signature);
        return
            (error == ECDSA.RecoverError.NoError && recovered == signer) ||
            isValidERC1271SignatureNow(signer, hash, signature);
    }

    /**
     * @dev Checks if a signature is valid for a given signer and data hash. The signature is validated
     * against the signer smart contract using ERC1271.
     *
     * NOTE: Unlike ECDSA signatures, contract signatures are revocable, and the outcome of this function can thus
     * change through time. It could return true at block N and false at block N+1 (or the opposite).
     */
    function isValidERC1271SignatureNow(
        address signer,
        bytes32 hash,
        bytes memory signature
    ) internal view returns (bool) {
        (bool success, bytes memory result) = signer.staticcall(
            abi.encodeWithSelector(IERC1271.isValidSignature.selector, hash, signature)
        );
        return (success &&
            result.length >= 32 &&
            abi.decode(result, (bytes32)) == bytes32(IERC1271.isValidSignature.selector));
    }
}

// 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
pragma solidity 0.8.24;

interface IMintable {
  function mint(address _to, uint256 _amount) external;
}

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

pragma solidity ^0.8.0;

interface IERC5267 {
    /**
     * @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.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 (interfaces/IERC1271.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC1271 standard signature validation method for
 * contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].
 *
 * _Available since v4.1._
 */
interface IERC1271 {
    /**
     * @dev Should return whether the signature provided is valid for the provided data
     * @param hash      Hash of the data to be signed
     * @param signature Signature byte array associated with _data
     */
    function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);
}

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

pragma solidity ^0.8.0;

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

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

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

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

pragma solidity ^0.8.0;

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (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.0) (utils/Strings.sol)

pragma solidity ^0.8.0;

import "./math/Math.sol";
import "./math/SignedMath.sol";

/**
 * @dev String operations.
 */
library Strings {
    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 = Math.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(SignedMath.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, Math.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/ShortStrings.sol)

pragma solidity ^0.8.8;

import "./StorageSlot.sol";

// | string  | 0xAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA   |
// | length  | 0x                                                              BB |
type ShortString is bytes32;

/**
 * @dev This library provides functions to convert short memory strings
 * into a `ShortString` type that can be used as an immutable variable.
 *
 * Strings of arbitrary length can be optimized using this library if
 * they are short enough (up to 31 bytes) by packing them with their
 * length (1 byte) in a single EVM word (32 bytes). Additionally, a
 * fallback mechanism can be used for every other case.
 *
 * Usage example:
 *
 * ```solidity
 * contract Named {
 *     using ShortStrings for *;
 *
 *     ShortString private immutable _name;
 *     string private _nameFallback;
 *
 *     constructor(string memory contractName) {
 *         _name = contractName.toShortStringWithFallback(_nameFallback);
 *     }
 *
 *     function name() external view returns (string memory) {
 *         return _name.toStringWithFallback(_nameFallback);
 *     }
 * }
 * ```
 */
library ShortStrings {
    // Used as an identifier for strings longer than 31 bytes.
    bytes32 private constant _FALLBACK_SENTINEL = 0x00000000000000000000000000000000000000000000000000000000000000FF;

    error StringTooLong(string str);
    error InvalidShortString();

    /**
     * @dev Encode a string of at most 31 chars into a `ShortString`.
     *
     * This will trigger a `StringTooLong` error is the input string is too long.
     */
    function toShortString(string memory str) internal pure returns (ShortString) {
        bytes memory bstr = bytes(str);
        if (bstr.length > 31) {
            revert StringTooLong(str);
        }
        return ShortString.wrap(bytes32(uint256(bytes32(bstr)) | bstr.length));
    }

    /**
     * @dev Decode a `ShortString` back to a "normal" string.
     */
    function toString(ShortString sstr) internal pure returns (string memory) {
        uint256 len = byteLength(sstr);
        // using `new string(len)` would work locally but is not memory safe.
        string memory str = new string(32);
        /// @solidity memory-safe-assembly
        assembly {
            mstore(str, len)
            mstore(add(str, 0x20), sstr)
        }
        return str;
    }

    /**
     * @dev Return the length of a `ShortString`.
     */
    function byteLength(ShortString sstr) internal pure returns (uint256) {
        uint256 result = uint256(ShortString.unwrap(sstr)) & 0xFF;
        if (result > 31) {
            revert InvalidShortString();
        }
        return result;
    }

    /**
     * @dev Encode a string into a `ShortString`, or write it to storage if it is too long.
     */
    function toShortStringWithFallback(string memory value, string storage store) internal returns (ShortString) {
        if (bytes(value).length < 32) {
            return toShortString(value);
        } else {
            StorageSlot.getStringSlot(store).value = value;
            return ShortString.wrap(_FALLBACK_SENTINEL);
        }
    }

    /**
     * @dev Decode a string that was encoded to `ShortString` or written to storage using {setWithFallback}.
     */
    function toStringWithFallback(ShortString value, string storage store) internal pure returns (string memory) {
        if (ShortString.unwrap(value) != _FALLBACK_SENTINEL) {
            return toString(value);
        } else {
            return store;
        }
    }

    /**
     * @dev Return the length of a string that was encoded to `ShortString` or written to storage using {setWithFallback}.
     *
     * WARNING: This will return the "byte length" of the string. This may not reflect the actual length in terms of
     * actual characters as the UTF-8 encoding of a single character can span over multiple bytes.
     */
    function byteLengthWithFallback(ShortString value, string storage store) internal view returns (uint256) {
        if (ShortString.unwrap(value) != _FALLBACK_SENTINEL) {
            return byteLength(value);
        } else {
            return bytes(store).length;
        }
    }
}

// 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 Math {
    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 SignedMath {
    /**
     * @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"
      ]
    }
  },
  "libraries": {},
  "isSystem": false,
  "forceEvmla": false
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"address","name":"_admin","type":"address"},{"internalType":"contract IMintableAndDelegatable","name":"_token","type":"address"},{"internalType":"bytes32","name":"_merkleRoot","type":"bytes32"},{"internalType":"uint256","name":"_maximumTotalClaimable","type":"uint256"},{"internalType":"uint256","name":"_windowStart","type":"uint256"},{"internalType":"uint256","name":"_windowEnd","type":"uint256"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"currentNonce","type":"uint256"}],"name":"InvalidAccountNonce","type":"error"},{"inputs":[],"name":"InvalidShortString","type":"error"},{"inputs":[{"internalType":"string","name":"str","type":"string"}],"name":"StringTooLong","type":"error"},{"inputs":[],"name":"ZkMerkleDistributor__AlreadyClaimed","type":"error"},{"inputs":[],"name":"ZkMerkleDistributor__ClaimAmountExceedsMaximum","type":"error"},{"inputs":[],"name":"ZkMerkleDistributor__ClaimWindowNotOpen","type":"error"},{"inputs":[],"name":"ZkMerkleDistributor__ClaimWindowNotYetClosed","type":"error"},{"inputs":[],"name":"ZkMerkleDistributor__ExpiredSignature","type":"error"},{"inputs":[],"name":"ZkMerkleDistributor__InvalidProof","type":"error"},{"inputs":[],"name":"ZkMerkleDistributor__InvalidSignature","type":"error"},{"inputs":[],"name":"ZkMerkleDistributor__SweepAlreadyDone","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"ZkMerkleDistributor__Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"index","type":"uint256"},{"indexed":false,"internalType":"address","name":"account","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Claimed","type":"event"},{"anonymous":false,"inputs":[],"name":"EIP712DomainChanged","type":"event"},{"inputs":[],"name":"ADMIN","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DOMAIN_SEPARATOR","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAXIMUM_TOTAL_CLAIMABLE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MERKLE_ROOT","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"TOKEN","outputs":[{"internalType":"contract IMintableAndDelegatable","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WINDOW_END","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WINDOW_START","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"ZK_CLAIM_AND_DELEGATE_TYPEHASH","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"ZK_CLAIM_TYPEHASH","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_index","type":"uint256"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"bytes32[]","name":"_merkleProof","type":"bytes32[]"}],"name":"claim","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_index","type":"uint256"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"bytes32[]","name":"_merkleProof","type":"bytes32[]"},{"components":[{"internalType":"address","name":"delegatee","type":"address"},{"internalType":"uint256","name":"expiry","type":"uint256"},{"internalType":"bytes","name":"signature","type":"bytes"}],"internalType":"struct ZkMerkleDistributor.DelegateInfo","name":"_delegateInfo","type":"tuple"}],"name":"claimAndDelegate","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_index","type":"uint256"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"bytes32[]","name":"_merkleProof","type":"bytes32[]"},{"components":[{"internalType":"address","name":"claimant","type":"address"},{"internalType":"uint256","name":"expiry","type":"uint256"},{"internalType":"bytes","name":"signature","type":"bytes"}],"internalType":"struct ZkMerkleDistributor.ClaimSignatureInfo","name":"_claimSignatureInfo","type":"tuple"},{"components":[{"internalType":"address","name":"delegatee","type":"address"},{"internalType":"uint256","name":"expiry","type":"uint256"},{"internalType":"bytes","name":"signature","type":"bytes"}],"internalType":"struct ZkMerkleDistributor.DelegateInfo","name":"_delegateInfo","type":"tuple"}],"name":"claimAndDelegateOnBehalf","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_index","type":"uint256"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"bytes32[]","name":"_merkleProof","type":"bytes32[]"},{"components":[{"internalType":"address","name":"claimant","type":"address"},{"internalType":"uint256","name":"expiry","type":"uint256"},{"internalType":"bytes","name":"signature","type":"bytes"}],"internalType":"struct ZkMerkleDistributor.ClaimSignatureInfo","name":"_claimSignatureInfo","type":"tuple"}],"name":"claimOnBehalf","outputs":[],"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":[],"name":"invalidateNonce","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_index","type":"uint256"}],"name":"isClaimed","outputs":[{"internalType":"bool","name":"","type":"bool"}],"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":"_unclaimedReceiver","type":"address"}],"name":"sweepUnclaimed","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"totalClaimed","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"}]

0x00040000000000020019000000000002000000000302001900000000020100190000006004200270000003380240019700030000002103550002000000010355000003380040019d0000000103300190000000220000c13d000000800b0000390000004000b0043f000000040320008c000007b30000413d000000000301043b000000e003300270000003480430009c000000d70000a13d000003490430009c000000e80000213d000003500430009c0000011e0000a13d000003510430009c000003470000613d000003520430009c000001fd0000613d000003530130009c000007b30000c13d0000000001000416000000000101004b000007b30000c13d0000036d010000410000038a0000013d0000000003000416000000000303004b000007b30000c13d00000339032000410000033a0330009c0000002e0000213d0000037a0100004100000000001004350000004101000039000000040010043f0000037b0100004100000cdd000104300000023f032000390000033b03300197000000400030043f0000001f0320018f00000005042002720000003d0000613d00000000050000190000000506500210000000000761034f000000000707043b000002200660003900000000007604350000000105500039000000000645004b000000350000413d000000000503004b0000004c0000613d0000000504400210000000000141034f00000003033002100000022004400039000000000504043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f0000000000140435000000c00120008c000007b30000413d000002200100043d000d00000001001d0000033c0110009c000007b30000213d000002400100043d000c00000001001d0000033c0110009c000007b30000213d000002c00400043d000002a00500043d000002800600043d000002600700043d000000400a00043d0000033d01a0009c000000280000213d0000004001a00039000000400010043f0000001301000039000000000b1a04360000033e0100004100000000001b0435000000400800043d0000033d0180009c000000280000213d0000004001800039000000400010043f000000010c0000390000000009c804360000033f010000410000000000190435000000000d0a04330000002001d0008c000003a10000413d0000034001d0009c000000280000213d000000000100041a000000010210019000000001011002700000007f0310018f000000000301c0190000001f0130008c00000000010000190000000101002039000000010110018f000000000112004b0000058b0000c13d00020000000d001d00050000000c001d00030000000b001d00040000000a001d000a00000009001d000b00000008001d000600000007001d000700000006001d000800000005001d000900000004001d000000200130008c000000a30000413d000100000003001d000000000000043500000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000341011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d000000000201043b00000002010000290000001f011000390000000501100270000000000112001900000001030000290000001f0330003900000005033002700000000002320019000000000321004b000000a30000813d000000000001041b0000000101100039000000000321004b0000009f0000413d000000000000043500000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000341011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d000000200200008a000000020d00002900000000032d01700000002002000039000000000101043b000000040a000029000000030b000029000000c00000613d000000200200003900000000040000190000000005a200190000000005050433000000000051041b000000200220003900000001011000390000002004400039000000000534004b000000b80000413d0000000003d3004b000000070600002900000006070000290000000b080000290000000a09000029000000050c000029000000d00000813d0000000303d00210000000f80330018f000000010400008a000000000334022f000000000343013f0000000002a200190000000002020433000000000232016f000000000021041b0000000101d0021000000001011001bf000000000010041b000000ff0100003900000009040000290000000805000029000003ac0000013d000003560430009c000000f50000a13d000003570430009c0000010f0000a13d000003580430009c000001c80000613d000003590130009c000001bd0000613d0000035a0130009c000007b30000c13d0000000001000416000000000101004b000007b30000c13d00000000010004110cdb09d90000040f000000000100001900000cdc0001042e0000034a0430009c0000012d0000a13d0000034b0430009c000003740000613d0000034c0430009c0000024d0000613d0000034d0130009c000007b30000c13d0000000001000416000000000101004b000007b30000c13d0000000401000039000003890000013d0000035d0430009c000001060000213d000003600430009c0000014b0000613d000003610130009c000007b30000c13d0000000001000416000000000101004b000007b30000c13d0000000001000412001900000001001d001801800000003d000080050100003900000044030000390000000004000415000000190440008a000003430000013d0000035e0130009c000001ae0000613d0000035f0130009c000007b30000c13d0000000001000416000000000101004b000007b30000c13d0cdb092b0000040f000003990000013d0000035b0130009c000003390000613d0000035c0130009c000007b30000c13d0000000001000416000000000101004b000007b30000c13d0000000001000412001300000001001d001201400000003d000080050100003900000044030000390000000004000415000000130440008a000003430000013d000003540430009c000003790000613d000003550130009c000007b30000c13d0000000001000416000000000101004b000007b30000c13d0000000001000412000f00000001001d000e01000000003d0000800501000039000000440300003900000000040004150000000f0440008a000001b80000013d0000034e0430009c0000038d0000613d0000034f0330009c000007b30000c13d0000000003000416000000000303004b000007b30000c13d000000040320008a000000600330008c000007b30000413d0000004401100370000000000101043b000003400310009c000007b30000213d00000004011000390cdb09100000040f00000002040003670000002403400370000000000303043b0000000404400370000000000404043b0000000005010019000000000602001900000000020004110000000001040019000000000405001900000000050600190cdb0afb0000040f000000000100001900000cdc0001042e0000000003000416000000000303004b000007b30000c13d000000040320008a000000a00430008c000007b30000413d0000002404100370000000000404043b000d00000004001d0000000404100370000000000404043b000c00000004001d0000004404100370000000000404043b000003400540009c000007b30000213d00000023054000390000036306000041000000000725004b000000000700001900000000070680190000036305500197000000000805004b0000000006008019000003630550009c000000000607c019000000000506004b000007b30000c13d0000000405400039000000000551034f000000000505043b000b00000005001d000003400550009c000007b30000213d000a00240040003d0000000b0400002900000005044002100000000a04400029000000000224004b000007b30000213d0000006402100370000000000202043b000900000002001d000003400220009c000007b30000213d000000090230006a0000036304000041000000600520008c000000000500001900000000050440190000036302200197000000000602004b000000000400a019000003630220009c000000000405c019000000000204004b000007b30000c13d0000008402100370000000000202043b000700000002001d000003400220009c000007b30000213d000000070230006a0000036303000041000000600420008c000000000400001900000000040340190000036302200197000000000502004b000000000300a019000003630220009c000000000304c019000000000203004b000007b30000c13d00080000000b001d0000000902000029000500240020003d0000000501100360000000000101043b000600000001001d0000036e01000041000000000010043900000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000344011001c70000800b020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b000000060110006c0000070a0000a13d0000037301000041000000800010043f000003830100004100000cdd000104300000000001000416000000000101004b000007b30000c13d0000000001000412001700000001001d001600e00000003d000080050100003900000044030000390000000004000415000000170440008a000000050440021000000364020000410cdb0cb20000040f0000033c011001970000038a0000013d0000000001000416000000000101004b000007b30000c13d0000000001000412001100000001001d001001200000003d000080050100003900000044030000390000000004000415000000110440008a000003430000013d0000000003000416000000000303004b000007b30000c13d000000040220008a000000200220008c000007b30000413d0000000401100370000000000101043b000d00000001001d0000033c0110009c000007b30000213d000003640100004100000000001004390000000001000412000c00000001001d00000004001004430000018001000039000000240010044300000338030000410000000001000414000003380210009c0000000001038019000000c00110021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b000b00000001001d0000036e0100004100000000001004390000000001000414000003380210009c0000033801008041000000c00110021000000344011001c70000800b020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b0000000b0110006c000004d50000813d000000400100043d000003800200004100000000002104350000033802000041000003380310009c0000000001028019000000400110021000000374011001c700000cdd000104300000000003000416000000000303004b000007b30000c13d000000040320008a000000800430008c000007b30000413d0000002404100370000000000404043b000d00000004001d0000000404100370000000000404043b000c00000004001d0000004404100370000000000404043b000003400540009c000007b30000213d00000023054000390000036306000041000000000725004b000000000700001900000000070680190000036305500197000000000805004b0000000006008019000003630550009c000000000607c019000000000506004b000007b30000c13d0000000405400039000000000551034f000000000505043b000b00000005001d000003400550009c000007b30000213d000900240040003d0000000b0400002900000005044002100000000904400029000000000224004b000007b30000213d0000006402100370000000000202043b000a00000002001d000003400220009c000007b30000213d0000000a0230006a0000036303000041000000600420008c000000000400001900000000040340190000036302200197000000000502004b000000000300a019000003630220009c000000000304c019000000000203004b000007b30000c13d0000000a02000029000700240020003d0000000701100360000000000101043b000800000001001d0000036e01000041000000000010043900000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000344011001c70000800b020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b000000080110006c0000063c0000a13d000000400100043d0000037302000041000001f60000013d0000000003000416000000000303004b000007b30000c13d000000040720008a000000800370008c000007b30000413d0000002403100370000000000303043b0000000404100370000000000604043b0000004404100370000000000404043b000003400540009c000007b30000213d00000023054000390000036308000041000000000925004b000000000900001900000000090880190000036305500197000000000a05004b0000000008008019000003630550009c000000000809c019000000000508004b000007b30000c13d0000000405400039000000000551034f000000000505043b000003400850009c000007b30000213d000000240440003900000005085002100000000008480019000000000228004b000007b30000213d0000006401100370000000000101043b000d00000001001d000003400110009c000007b30000213d0000000d0170006a0000036302000041000000600710008c000000000700001900000000070240190000036301100197000000000801004b000000000200a019000003630110009c000000000207c019000000000102004b000007b30000c13d00080000000b001d00000000020004110000000001060019000c00000002001d0cdb0afb0000040f00000364010000410000000000100439000000000100041200000004001004430000010001000039000000240010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000008f10000613d0000000d0200002900000004022000390000000203000367000000000423034f000000000101043b000b033c0010019b000000000104043b000a00000001001d0000033c0110009c000007b30000213d00000000010000310000000d0410006a000000230540008a000d00400020003d0000000d04300360000000000404043b0000036306000041000000000754004b0000000007000019000000000706801900000363055001970000036308400197000000000958004b0000000006008019000000000558013f000003630550009c000000000607c019000000000506004b000007b30000c13d0000000002240019000000000323034f000000000303043b000900000003001d000003400330009c000007b30000213d000000090110006a00000020042000390000036302000041000000000314004b000000000300001900000000030220190000036301100197000700000004001d0000036304400197000000000514004b0000000002008019000000000114013f000003630110009c000000000203c019000000000102004b000007b30000c13d000003660100004100000000001004390000000b01000029000000040010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000367011001c700008002020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b000000000101004b0000000804000029000007b30000613d000000400500043d000003680100004100000000001504350000000d01000029000000200110008a0000000201100367000000000101043b000000640350003900000000004304350000004403500039000000000013043500000024015000390000000a0300002900000000003104350000000c010000290000033c0110019700000004035000390000000000130435000000840150003900000009040000290000000000410435000000070100002900000002031003670000001f0240018f000d00000005001d000000a4015000390000000504400272000003010000613d000000000500001900000005065002100000000007610019000000000663034f000000000606043b00000000006704350000000105500039000000000645004b000002f90000413d000000000502004b000003100000613d0000000504400210000000000343034f00000000044100190000000302200210000000000504043300000000052501cf000000000525022f000000000303043b0000010002200089000000000323022f00000000022301cf000000000252019f00000000002404350000000901100029000000000001043500000000010004140000000b02000029000000040220008c000003330000613d00000009020000290000001f02200039000000200300008a000000000232016f0000036903000041000003690420009c000000000203801900000338030000410000000d05000029000003380450009c0000000004030019000000000405401900000040044002100000006002200210000000000242019f000003380410009c0000000001038019000000c001100210000000000112019f0000036a011000410000000b020000290cdb0cd10000040f00000000030100190000006003300270000103380030019d000003380330019700030000000103550000000102200190000007d80000613d0000000d01000029000003400110009c000000280000213d0000000d01000029000000400010043f000008020000013d0000000001000416000000000101004b000007b30000c13d0000000001000412001500000001001d001401600000003d000080050100003900000044030000390000000004000415000000150440008a000000050440021000000364020000410cdb0cb20000040f0000038a0000013d0000000001000416000000000101004b000007b30000c13d000003640100004100000000001004390000000001000412000d00000001001d0000000400100443000000a001000039000000240010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000008f10000613d000000400700043d000000000101043b000000ff0210008c000004140000c13d000000000300041a000000010430019000000001023002700000007f0120018f000000000102c0190000001f0210008c00000000020000190000000102002039000000000223013f00000001022001900000058b0000c13d0000000002170436000000000404004b000005500000c13d000001000400008a000000000343016f0000000000320435000000000101004b000000200300003900000000030060190000055d0000013d0000000001000416000000000101004b000007b30000c13d0000036b010000410000038a0000013d0000000003000416000000000303004b000007b30000c13d000000040220008a000000200220008c000007b30000413d0000000401100370000000000101043b0000033c0210009c000007b30000213d00000000001004350000000201000039000000200010043f000000400200003900000000010000190cdb0c9c0000040f000000000101041a000000800010043f000003620100004100000cdc0001042e0000000003000416000000000303004b000007b30000c13d000000040220008a000000200220008c000007b30000413d0000000401100370000000000101043b0cdb0c820000040f000000000101004b0000000001000019000000010100c039000000400200043d00000000001204350000033801000041000003380320009c000000000201801900000040012002100000036c011001c700000cdc0001042e0000000301d002100000010002100089000000010300008a00000000022301cf0000000001100049000001000300008a000000000131004b000000000200401900000000010b0433000000000121016f0000000001d1019f000001200010043f000000000d0804330000002001d0008c0000041f0000413d0000034001d0009c000000280000213d00000000010c041a000000010210019000000001021002700000007f0320018f000000000302c0190000001f0230008c00000000020000190000000102002039000000000121013f00000001011001900000058b0000c13d00020000000d001d00030000000b001d00040000000a001d000a00000009001d000b00000008001d000600000007001d000700000006001d000800000005001d000900000004001d000000200130008c00050000000c001d000003e50000413d000100000003001d0000000000c0043500000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000341011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d000000000201043b00000002010000290000001f011000390000000501100270000000000112001900000001030000290000001f0330003900000005033002700000000002320019000000000321004b000000050c000029000003e50000813d000000000001041b0000000101100039000000000321004b000003e10000413d0000000000c0043500000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000341011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d000000200200008a000000020700002900000000032701700000002002000039000000000101043b0000000b06000029000004010000613d0000002002000039000000000400001900000000056200190000000005050433000000000051041b000000200220003900000001011000390000002004400039000000000534004b000003f90000413d000000000373004b0000040c0000813d0000000303700210000000f80330018f000000010400008a000000000334022f000000000343013f00000000026200190000000002020433000000000232016f000000000021041b000000010170021000000001011001bf0000000502000029000000000012041b000000ff01000039000000040a000029000000030b000029000004300000013d000000ff0210018f000000200320008c000004cc0000413d000003750100004100000000001704350000033801000041000003380270009c0000000007018019000000400170021000000374011001c700000cdd00010430000b00000008001d000600000007001d000700000006001d000800000005001d000900000004001d0000000301d002100000010002100089000000010300008a00000000022301cf0000000001100049000001000300008a000000000131004b0000000002004019000a00000009001d0000000001090433000000000121016f0000000001d1019f000001400010043f00000338040000410000033801b0009c000000000b0480190000004001b0021000000000020a0433000003380320009c00000000020480190000006002200210000000000112019f0000000002000414000003380320009c0000000002048019000000c002200210000000000112019f00000342011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d000000000101043b000500000001001d000000e00010043f0000000a02000029000003380120009c0000033804000041000000000204801900000040012002100000000b020000290000000002020433000003380320009c00000000020480190000006002200210000000000112019f0000000002000414000003380320009c0000000002048019000000c002200210000000000112019f00000342011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d000000000101043b000b00000001001d000001000010043f0000034301000041000000000010043900000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000344011001c70000800b020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b000000a00010043f000000400200043d0000008003200039000000000013043500000060012000390000000b030000290000000000310435000000400120003900000005030000290000000000310435000000a001000039000b00000001001d0000000001120436000000a0032000390000000004000410000a00000004001d000000000043043500000345030000410000000000310435000003460320009c0000000904000029000000080500002900000007060000290000000607000029000000280000213d000000c003200039000000400030043f0000000002020433000900000004001d000800000005001d000700000006001d000600000007001d0cdb0c9c0000040f000000800010043f0000000a03000029000000c00030043f0000000d04000029000001600040043f0000000c05000029000001800050043f0000000609000029000001a00090043f0000000708000029000001c00080043f0000000807000029000001e00070043f0000000906000029000002000060043f000001400000044300000160001004430000002001000039000000a00200043d0000018000100443000001a0002004430000004002000039000001c000200443000001e0003004430000006002000039000000e00300043d000002000020044300000220003004430000008002000039000001000300043d00000240002004430000026000300443000001200200043d0000000b030000290000028000300443000002a000200443000000c002000039000001400300043d000002c000200443000002e000300443000000e0020000390000030000200443000003200040044300000100020000390000034000200443000003600050044300000120020000390000038000200443000003a0009004430000014002000039000003c000200443000003e00080044300000160020000390000040000200443000004200070044300000180020000390000044000200443000004600060044300000100001004430000000d010000390000012000100443000003470100004100000cdc0001042e0000033d0370009c000000280000213d0000004003700039000000400030043f00000020037000390000000000130435000c00000007001d00000000002704350000056a0000013d000003640100004100000000001004390000000c010000290000000400100443000000e001000039000000240010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b0000033c021001970000000001000411000000000221004b0000059a0000c13d0000000401000039000a00000001001d000000000101041a000b00000001001d000003640100004100000000001004390000000c0100002900000004001004430000014001000039000000240010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b000900000001001d0000000b0110006c000007070000a13d000003640100004100000000001004390000000c0100002900000004001004430000010001000039000000240010044300000338030000410000000001000414000003380210009c0000000001038019000000c00110021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b000003660200004100000000002004390000033c01100197000c00000001001d00000004001004430000000001000414000003380210009c0000033801008041000000c00110021000000367011001c700008002020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b000000000101004b000007b30000613d0000000b020000290000000901200069000000400300043d000000240230003900000000001204350000037e010000410000000000130435000b00000003001d00000004013000390000000d02000029000000000021043500000000010004140000000c02000029000000040220008c000005460000613d0000033802000041000003380310009c00000000010280190000000b04000029000003380340009c00000000020440190000004002200210000000c001100210000000000121019f0000037f011001c70000000c020000290cdb0cd10000040f00000000030100190000006003300270000103380030019d000003380330019700030000000103550000000102200190000007b50000613d0000000b01000029000003400110009c000000280000213d0000000b01000029000000400010043f0000000a010000290000000902000029000000000021041b000000000100001900000cdc0001042e0000000000000435000000000301004b00000000030000190000055d0000613d000003760400004100000000030000190000000005320019000000000604041a000000000065043500000001044000390000002003300039000000000513004b000005560000413d0000003f01300039000000200200008a000000000221016f0000000001720019000000000221004b00000000020000190000000102004039000003400310009c000000280000213d0000000102200190000000280000c13d000c00000007001d000000400010043f000003640100004100000000001004390000000d010000290000000400100443000000c001000039000000240010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000008f10000613d000000400200043d000000000101043b000000ff0310008c0000058f0000c13d0000000105000039000000000405041a000000010640019000000001034002700000007f0130018f000000000103c0190000001f0310008c00000000030000190000000103002039000000000334013f00000001033001900000000c08000029000005a50000613d0000037a01000041000000000010043500000022010000390000002b0000013d000000ff0310018f000000200430008c000005af0000413d000003750100004100000000001204350000033801000041000003380320009c0000000002018019000000400120021000000374011001c700000cdd00010430000000400200043d0000037c030000410000000000320435000000040320003900000000001304350000033801000041000003380320009c000000000201801900000040012002100000037b011001c700000cdd000104300000000003120436000000000606004b000005b90000c13d000001000500008a000000000454016f0000000000430435000000000101004b00000020040000390000000004006019000005c60000013d0000033d0420009c0000000c07000029000000280000213d0000004004200039000000400040043f000000200420003900000000001404350000000000320435000000400400043d000005d30000013d0000000000500435000000000401004b0000000004000019000005c60000613d000003770500004100000000040000190000000006430019000000000705041a000000000076043500000001055000390000002004400039000000000614004b000005bf0000413d0000003f01400039000000200300008a000000000131016f0000000004210019000000000114004b00000000010000190000000101004039000003400340009c0000000007080019000000280000213d0000000101100190000000280000c13d000000400040043f000003780140009c000000280000213d0000002001400039000c00000001001d000000400010043f000b00000004001d0000000000040435000000400400043d0000002001400039000000e0030000390000000000310435000003790100004100000000001404350000000001070433000000e0034000390000000000130435000d00000004001d0000010003400039000000000401004b000005ef0000613d000000000400001900000000053400190000002004400039000000000674001900000000060604330000000000650435000000000514004b000005e80000413d000000000431001900000000000404350000001f01100039000a0020000000920000000a0110017f00000000013100190000000d0400002900000000034100490000004004400039000000000034043500000000060204330000000005610436000000000106004b000006050000613d000000000100001900000000035100190000002001100039000000000421001900000000040404330000000000430435000000000361004b000005fe0000413d000900000005001d000800000006001d000000000156001900000000000104350000034301000041000000000010043900000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000344011001c70000800b020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b0000000d040000290000008002400039000000000300041000000000003204350000006002400039000000000012043500000008010000290000001f011000390000000a0110017f00000009011000290000000002410049000000c0034000390000000000230435000000a00240003900000000000204350000000b0200002900000000020204330000000001210436000000000302004b0000000c05000029000006310000613d0000000003000019000000005405043400000000014104360000000103300039000000000423004b0000062c0000413d0000000d0400002900000000014100490000033802000041000003380310009c0000000001028019000003380340009c000000000402801900000040024002100000006001100210000000000121019f00000cdc0001042e0cdb092b0000040f000600000001001d0000000701000029000000200110008a000500000001001d0000000201100367000000000101043b000700000001001d0000033c0110009c000007b30000213d000000070100002900000000001004350000000201000039000000200010043f00000338010000410000000002000414000003380320009c0000000002018019000000c0012002100000036f011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d000000000101043b000000000201041a0000000103200039000000000031041b000000400300043d000000c0013000390000000000210435000000a0013000390000000802000029000000000021043500000080013000390000000d02000029000000000021043500000060013000390000000702000029000000000021043500000040013000390000000c020000290000000000210435000000c00100003900000000011304360000036d020000410000000000210435000800000003001d000003700230009c000000280000213d0000000803000029000000e002300039000700000002001d000000400020043f0000033804000041000003380210009c000000000104801900000040011002100000000002030433000003380320009c00000000020480190000006002200210000000000112019f0000000002000414000003380320009c0000000002048019000000c002200210000000000112019f00000342011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d000000000101043b000003710200004100000007040000290000000000240435000000080300002900000102023000390000000000120435000000e201300039000000060200002900000000002104350000000001000414000003380210009c00000338030000410000000001038019000003380240009c00000000040380190000004002400210000000c001100210000000000112019f00000372011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d00000002050003670000000503500360000000000201043b000000000103043b0000033c0310009c000007b30000213d00000005030000290000004003300039000000000335034f00000000060000310000000a0460006a000000230440008a000000000303043b0000036307000041000000000843004b0000000008000019000000000807801900000363044001970000036309300197000000000a49004b0000000007008019000000000449013f000003630440009c000000000708c019000000000407004b000007b30000c13d0000000a0400002900000004044000390000000003430019000000000435034f000000000404043b000003400740009c000007b30000213d000000000746004900000020083000390000036303000041000000000978004b000000000900001900000000090320190000036307700197000003630a800197000000000b7a004b000000000300801900000000077a013f000003630770009c000000000309c019000000000303004b000007b30000c13d0000003f03400039000000200700008a000000000773016f000000400300043d0000000007730019000000000937004b00000000090000190000000109004039000003400a70009c000000280000213d0000000109900190000000280000c13d000000400070043f00000000074304360000000009840019000000000669004b000007b30000213d000000000685034f0000001f0540018f0000000508400272000006eb0000613d0000000009000019000000050a900210000000000ba70019000000000aa6034f000000000a0a043b0000000000ab04350000000109900039000000000a89004b000006e30000413d000000000905004b000006fa0000613d0000000508800210000000000686034f00000000088700190000000305500210000000000908043300000000095901cf000000000959022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000595019f0000000000580435000000000447001900000000000404350cdb09ee0000040f00000005010000290000000201100367000000000201043b0000033c0120009c000007b30000213d0000000c010000290000000d0300002900000009040000290000000b05000029000001480000013d000000400100043d0000037d02000041000001f60000013d0cdb092b0000040f0000000502000029000300200020009200000002020003670000000303200360000400000001001d000000000103043b000500000001001d0000033c0110009c000007b30000213d0000000701000029000100040010003d0000000101200360000000000101043b000200000001001d0000033c0110009c000007b30000213d000000050100002900000000001004350000000201000039000000200010043f00000338010000410000000002000414000003380320009c0000000002018019000000c0012002100000036f011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d000000000101043b000000000201041a0000000103200039000000000031041b000000400300043d000000e0013000390000000000210435000000c00130003900000006020000290000000000210435000000a0013000390000000202000029000000000021043500000080013000390000000d02000029000000000021043500000060013000390000000502000029000000000021043500000040013000390000000c020000290000000000210435000000e00100003900000000011304360000036b020000410000000000210435000600000003001d000003810230009c000000280000213d00000006040000290000010002400039000500000002001d000000400020043f0000033802000041000003380310009c000000000102801900000040011002100000000003040433000003380430009c00000000030280190000006003300210000000000113019f0000000003000414000003380430009c0000000003028019000000c002300210000000000112019f00000342011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d000000000101043b000000060300002900000142023000390000000000120435000001200130003900000371020000410000000000210435000001220230003900000004030000290000000000320435000000420200003900000005030000290000000000230435000003820230009c000000280000213d00000006020000290000018002200039000000400020043f0000033802000041000003380310009c0000000001028019000000400110021000000005030000290000000003030433000003380430009c00000000030280190000006003300210000000000113019f0000000003000414000003380430009c0000000003028019000000c002300210000000000112019f00000342011001c700008010020000390cdb0cd60000040f0000000102200190000007b30000613d00000002050003670000000303500360000000000201043b000000000103043b0000033c0310009c000007b30000213d00000003030000290000004003300039000000000335034f0000000006000031000000090460006a000000230440008a000000000303043b0000036307000041000000000843004b0000000008000019000000000807801900000363044001970000036309300197000000000a49004b0000000007008019000000000449013f000003630440009c000000000708c019000000000407004b000007b30000c13d000000090400002900000004044000390000000003430019000000000435034f000000000404043b000003400740009c000007b30000213d000000000746004900000020083000390000036303000041000000000978004b000000000900001900000000090320190000036307700197000003630a800197000000000b7a004b000000000300801900000000077a013f000003630770009c000000000309c019000000000303004b000008040000613d000000000100001900000cdd00010430000000400200043d0000001f0430018f0000000505300272000007c20000613d000000000600001900000005076002100000000008720019000000000771034f000000000707043b00000000007804350000000106600039000000000756004b000007ba0000413d000000000604004b000007d10000613d0000000505500210000000000151034f00000000055200190000000304400210000000000605043300000000064601cf000000000646022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000161019f00000000001504350000033801000041000003380420009c000000000201801900000040012002100000006002300210000000000121019f00000cdd00010430000000000203004b000008020000613d0000003f023000390000033b02200197000000400400043d0000000002240019000000000542004b00000000050000190000000105004039000003400620009c000000280000213d0000000105500190000000280000c13d000000400020043f0000001f0230018f00000000043404360000000503300272000007f30000613d000000000500001900000005065002100000000007640019000000000661034f000000000606043b00000000006704350000000105500039000000000635004b000007eb0000413d000000000502004b000008020000613d0000000503300210000000000131034f00000000033400190000000302200210000000000403043300000000042401cf000000000424022f000000000101043b0000010002200089000000000121022f00000000012101cf000000000141019f0000000000130435000000000100001900000cdc0001042e0000003f034000390009002000000092000000090730017f000000400300043d0000000007730019000000000937004b00000000090000190000000109004039000003400a70009c000000280000213d0000000109900190000000280000c13d000000400070043f00000000074304360000000009840019000000000669004b000007b30000213d000000000685034f0000001f0540018f0000000508400272000008220000613d0000000009000019000000050a900210000000000ba70019000000000aa6034f000000000a0a043b0000000000ab04350000000109900039000000000a89004b0000081a0000413d000000000905004b000008310000613d0000000508800210000000000686034f00000000088700190000000305500210000000000908043300000000095901cf000000000959022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000595019f0000000000580435000000000447001900000000000404350cdb09ee0000040f00000003010000290000000201100367000000000201043b0000033c0120009c000007b30000213d0000000c010000290000000d030000290000000a040000290000000b050000290cdb0afb0000040f00000364010000410000000000100439000000000100041200000004001004430000010001000039000000240010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000008f10000613d00000002020003670000000303200360000000000101043b000d033c0010019b000000000103043b000c00000001001d0000033c0110009c000007b30000213d0000000101200360000000000101043b000b00000001001d0000033c0110009c000007b30000213d0000000001000031000000070310006a000000230430008a0000000103000029000a00400030003d0000000a03200360000000000303043b0000036305000041000000000643004b0000000006000019000000000605801900000363044001970000036307300197000000000847004b0000000005008019000000000447013f000003630440009c000000000506c019000000000405004b000007b30000c13d0000000103300029000000000232034f000000000202043b000700000002001d000003400220009c000007b30000213d000000070110006a00000020043000390000036302000041000000000314004b000000000300001900000000030220190000036301100197000600000004001d0000036304400197000000000514004b0000000002008019000000000114013f000003630110009c000000000203c019000000000102004b000007b30000c13d000003660100004100000000001004390000000d01000029000000040010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000367011001c700008002020000390cdb0cd60000040f0000000102200190000008f10000613d000000000101043b000000000101004b0000000804000029000007b30000613d000000400500043d000003680100004100000000001504350000000a01000029000000200110008a0000000201100367000000000101043b000000640350003900000000004304350000004403500039000000000013043500000024015000390000000b03000029000000000031043500000004015000390000000c030000290000000000310435000000840150003900000007040000290000000000410435000000060100002900000002031003670000001f0240018f000c00000005001d000000a4015000390000000504400272000008bb0000613d000000000500001900000005065002100000000007610019000000000663034f000000000606043b00000000006704350000000105500039000000000645004b000008b30000413d000000000502004b000008ca0000613d0000000504400210000000000343034f00000000044100190000000302200210000000000504043300000000052501cf000000000525022f000000000303043b0000010002200089000000000323022f00000000022301cf000000000252019f00000000002404350000000701100029000000000001043500000000010004140000000d02000029000000040220008c000008ec0000613d00000007020000290000001f02200039000000090220017f0000036903000041000003690420009c000000000203801900000338030000410000000c05000029000003380450009c0000000004030019000000000405401900000040044002100000006002200210000000000242019f000003380410009c0000000001038019000000c001100210000000000112019f0000036a011000410000000d020000290cdb0cd10000040f00000000030100190000006003300270000103380030019d000003380330019700030000000103550000000102200190000008f20000613d0000000c01000029000003400110009c000000280000213d0000000c01000029000003370000013d000000000001042f000000000203004b000008020000613d0000003f023000390000033b02200197000000400400043d0000000002240019000000000542004b00000000050000190000000105004039000003400620009c000000280000213d0000000105500190000000280000c13d000000400020043f0000001f0230018f000000000434043600000005033002720000090d0000613d000000000500001900000005065002100000000007640019000000000661034f000000000606043b00000000006704350000000105500039000000000635004b000009050000413d000000000502004b000008020000613d000007f50000013d0000001f031000390000036304000041000000000523004b0000000005000019000000000504401900000363062001970000036303300197000000000763004b000000000400a019000000000363013f000003630330009c000000000405c019000000000304004b000009290000613d0000000203100367000000000303043b000003400430009c000009290000213d000000050430021000000020011000390000000004410019000000000224004b000009290000213d0000000002030019000000000001042d000000000100001900000cdd000104300004000000000002000003640100004100000000001004390000000001000412000300000001001d00000004001004430000004001000039000000240010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000009d00000613d000000000101043b0000033c011001970000000002000410000200000002001d000000000112004b000009730000c13d00000364010000410000000000100439000000030100002900000004001004430000002001000039000000240010044300000338030000410000000001000414000003380210009c0000000001038019000000c00110021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000009d00000613d000000000101043b000400000001001d000003430100004100000000001004390000000001000414000003380210009c0000033801008041000000c00110021000000344011001c70000800b020000390cdb0cd60000040f0000000102200190000009d00000613d000000000101043b000000040110006c000009730000c13d0000036401000041000000000010043900000003010000290000000400100443000000240000044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000009ce0000c13d000009d00000013d000000400100043d000400000001001d00000020021000390000034501000041000100000002001d000000000012043500000364010000410000000000100439000000030100002900000004001004430000006001000039000000240010044300000338030000410000000001000414000003380210009c0000000001038019000000c00110021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000009d00000613d000000000101043b0000000402000029000000400220003900000000001204350000036401000041000000000010043900000003010000290000000400100443000000800100003900000024001004430000000001000414000003380210009c0000033801008041000000c00110021000000365011001c700008005020000390cdb0cd60000040f0000000102200190000009d00000613d000000000101043b0000000402000029000000600220003900000000001204350000034301000041000000000010043900000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000344011001c70000800b020000390cdb0cd60000040f0000000102200190000009d00000613d000000000101043b0000000404000029000000a0024000390000000203000029000000000032043500000080024000390000000000120435000000a0010000390000000000140435000003840140009c000009d10000813d0000000403000029000000c001300039000000400010043f00000338010000410000000104000029000003380240009c000000000401801900000040024002100000000003030433000003380430009c00000000030180190000006003300210000000000223019f0000000003000414000003380430009c0000000003018019000000c001300210000000000121019f00000342011001c700008010020000390cdb0cd60000040f0000000102200190000009d70000613d000000000101043b000000000001042d000000000001042f0000037a0100004100000000001004350000004101000039000000040010043f0000037b0100004100000cdd00010430000000000100001900000cdd000104300000033c0110019700000000001004350000000201000039000000200010043f00000338010000410000000002000414000003380320009c0000000002018019000000c0012002100000036f011001c700008010020000390cdb0cd60000040f0000000102200190000009ec0000613d000000000101043b000000000201041a0000000102200039000000000021041b000000000001042d000000000100001900000cdd00010430000300000000000200000000080100190000000014030434000000410440008c00000a3f0000c13d00000040043000390000000006040433000003850460009c00000a3f0000213d000300000008001d000200000003001d000000600330003900000000030304330000000001010433000000400400043d0000006005400039000000000065043500000040054000390000000000150435000000f80130027000000020034000390000000000130435000100000002001d0000000000240435000000000000043500000338010000410000000002000414000003380320009c0000000002018019000003380340009c00000000040180190000004001400210000000c002200210000000000112019f00000386011001c700000001020000390cdb0cd60000040f000000000301001900000060033002700000033809300197000000200490008c000000000409001900000020040080390000001f0540018f000000050440027200000a240000613d00000000060000190000000507600210000000000871034f000000000808043b00000000008704350000000106600039000000000746004b00000a1d0000413d000000000605004b00000a320000613d00000003055002100000000504400210000000000604043300000000065601cf000000000656022f000000000741034f000000000707043b0000010005500089000000000757022f00000000055701cf000000000565019f0000000000540435000100000009001f000300000001035500000001022001900000000308000029000000020300002900000ad80000613d00000000010004330000033c02100198000000010200002900000a3f0000613d000000000181013f0000033c0110019800000ac60000613d000000400a00043d0000004401a00039000000400400003900000000004104350000002001a00039000003870400004100000000004104350000002404a00039000000000024043500000000090304330000006404a0003900000000009404350000008404a00039000000000509004b00000a560000613d000000000500001900000000064500190000002005500039000000000735001900000000070704330000000000760435000000000695004b00000a4f0000413d000000000449001900000000000404350000001f03900039000000200600008a000000000363016f000000640430003900000000004a0435000000a303300039000000000463016f0000000003a40019000000000443004b00000000040000190000000104004039000003400530009c00000ad00000213d000000010440019000000ad00000c13d000000400030043f00000000030a04330000000002000414000000040480008c00000a6f0000c13d0000000102000039000000010400003100000a840000013d0000033804000041000003380510009c00000000010480190000004001100210000003380530009c00000000030480190000006003300210000000000113019f000003380320009c0000000002048019000000c002200210000000000121019f0000000002080019000300000006001d0cdb0cd60000040f0000000306000029000000010220018f00030000000103550000006001100270000103380010019d000003380410019700000060030000390000008001000039000000000504004b00000ab30000613d000003400140009c00000ad00000213d0000003f01400039000000000161016f000000400300043d0000000001130019000000000531004b00000000050000190000000105004039000003400610009c00000ad00000213d000000010550019000000ad00000c13d000000400010043f0000001f0540018f00000000014304360000000306000367000000050440027200000aa40000613d000000000700001900000005087002100000000009810019000000000886034f000000000808043b00000000008904350000000107700039000000000847004b00000a9c0000413d000000000705004b00000ab30000613d0000000504400210000000000646034f00000000044100190000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000000000202004b00000ac70000613d0000000002030433000000200320008c00000ac70000413d00000363030000410000001f0420008c000000000400001900000000040320190000036302200197000000000502004b0000000003008019000003630220009c000000000304c019000000000203004b00000ad60000613d0000000001010433000003870110009c00000ac70000c13d000000000001042d000000400100043d000003880200004100000000002104350000033802000041000003380310009c0000000001028019000000400110021000000374011001c700000cdd000104300000037a0100004100000000001004350000004101000039000000040010043f0000037b0100004100000cdd00010430000000000100001900000cdd00010430000000400200043d0000001f0490018f000000050590027200000ae50000613d000000000600001900000005076002100000000008720019000000000771034f000000000707043b00000000007804350000000106600039000000000756004b00000add0000413d000000000604004b00000af40000613d0000000505500210000000000151034f00000000055200190000000304400210000000000605043300000000064601cf000000000646022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000161019f00000000001504350000033801000041000003380420009c000000000201801900000040012002100000006002900210000000000121019f00000cdd00010430000e000000000002000d00000005001d000c00000004001d000900000003001d000600000002001d000800000001001d000003640100004100000000001004390000000001000412000a00000001001d00000004001004430000016001000039000000240010044300000338030000410000000001000414000003380210009c0000000001038019000000c00110021000000365011001c700008005020000390cdb0cd60000040f000000010220019000000c3d0000613d000000000101043b000e00000001001d0000036e0100004100000000001004390000000001000414000003380210009c0000033801008041000000c00110021000000344011001c70000800b020000390cdb0cd60000040f000000010220019000000c3d0000613d000000000101043b000b00000001001d0000000e0110006c00000c3e0000413d000003640100004100000000001004390000000a0100002900000004001004430000018001000039000000240010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000365011001c700008005020000390cdb0cd60000040f000000010220019000000c3d0000613d000000000101043b0000000b0110006b00000c3e0000813d0000000401000039000400000001001d000000000301041a0000000902300029000500000003001d000000000132004b00000000010000190000000101004039000000010110019000000c410000c13d000700000002001d000003640100004100000000001004390000000a0100002900000004001004430000014001000039000000240010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000365011001c700008005020000390cdb0cd60000040f000000010220019000000c3d0000613d000000000101043b000000070110006b00000c4b0000213d00000008010000290000000801100270000300000001001d00000000001004350000000301000039000200000001001d000000200010043f00000338010000410000000002000414000003380320009c0000000002018019000000c0012002100000036f011001c700008010020000390cdb0cd60000040f000000010220019000000c3b0000613d000000400200043d0000000804000029000000ff0340018f000000010330020f000000000101043b000000000101041a000000000131017000000c4e0000c13d000100000003001d00000006010000290000006001100210000000400320003900000000001304350000005401200039000000090300002900000000003104350000005401000039000000000112043600000000004104350000038a0320009c00000c450000813d0000008003200039000000400030043f0000033803000041000003380410009c000000000103801900000040011002100000000002020433000003380420009c00000000020380190000006002200210000000000112019f0000000002000414000003380420009c0000000002038019000000c002200210000000000112019f00000342011001c700008010020000390cdb0cd60000040f000000010220019000000c3b0000613d000000000301043b0000000d0100006b00000baf0000613d000b80100000003d0000000002000019000e00000002001d00000005012002100000000c011000290000000201100367000000000101043b000000000213004b00000b9f0000813d0000000000300435000000200010043f000000000100041400000ba20000013d0000000000100435000000200030043f0000000001000414000003380210009c0000033801008041000000c0011002100000036f011001c70000000b020000290cdb0cd60000040f000000010220019000000c3b0000613d000000000301043b0000000e0200002900000001022000390000000d0120006c00000b940000413d000e00000003001d000003640100004100000000001004390000000a0100002900000004001004430000012001000039000000240010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000365011001c700008005020000390cdb0cd60000040f000000010220019000000c3d0000613d000000000101043b0000000e0110006b000000070200002900000c560000c13d000000050120006c00000c410000413d0000000401000029000000000021041b000000030100002900000000001004350000000201000029000000200010043f00000338030000410000000001000414000003380210009c0000000001038019000000c0011002100000036f011001c700008010020000390cdb0cd60000040f000000010220019000000c3b0000613d000000000101043b000000000201041a00000001022001af000000000021041b000003640100004100000000001004390000000a010000290000000400100443000001000100003900000024001004430000000001000414000003380210009c0000033801008041000000c00110021000000365011001c700008005020000390cdb0cd60000040f000000010220019000000c3d0000613d000000000101043b000003660200004100000000002004390000033c01100197000e00000001001d000000040010044300000338010000410000000002000414000003380320009c0000000002018019000000c00120021000000367011001c700008002020000390cdb0cd60000040f000000010220019000000c3d0000613d000000000101043b000000000101004b00000c3b0000613d000000400400043d0000002401400039000000090200002900000000002104350000037e01000041000000000514043600000006010000290000033c061001970000000401400039000000000061043500000000010004140000000e02000029000000040320008c00000c210000613d000d00000005001d0000033805000041000003380310009c0000000001058019000003380340009c00000000050440190000004003500210000000c001100210000000000131019f0000037f011001c7000e00000004001d000c00000006001d0cdb0cd10000040f0000000c060000290000000d050000290000000e0400002900000000030100190000006003300270000103380030019d00000338033001970003000000010355000000010220019000000c5f0000613d000003400140009c000000080200002900000c450000213d000000400040043f0000004001400039000000090300002900000000003104350000000000650435000000000024043500000338010000410000000002000414000003380320009c0000000002018019000003380340009c00000000040180190000004001400210000000c002200210000000000112019f0000038c011001c70000800d0200003900000001030000390000038d040000410cdb0cd10000040f000000010120019000000c3b0000613d000000000001042d000000000100001900000cdd00010430000000000001042f000000400100043d0000038f0200004100000c580000013d0000037a010000410000000000100435000000110100003900000c480000013d0000037a0100004100000000001004350000004101000039000000040010043f0000037b0100004100000cdd00010430000000400100043d0000038e0200004100000c580000013d000003890100004100000000001204350000033801000041000003380320009c0000000002018019000000400120021000000374011001c700000cdd00010430000000400100043d0000038b0200004100000000002104350000033802000041000003380310009c0000000001028019000000400110021000000374011001c700000cdd00010430000000400200043d0000001f0430018f000000050530027200000c6c0000613d000000000600001900000005076002100000000008720019000000000771034f000000000707043b00000000007804350000000106600039000000000756004b00000c640000413d000000000604004b00000c7b0000613d0000000505500210000000000151034f00000000055200190000000304400210000000000605043300000000064601cf000000000646022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000161019f00000000001504350000033801000041000003380420009c000000000201801900000040012002100000006002300210000000000121019f00000cdd000104300001000000000002000100000001001d000000080110027000000000001004350000000301000039000000200010043f00000338010000410000000002000414000003380320009c0000000002018019000000c0012002100000036f011001c700008010020000390cdb0cd60000040f000000010220019000000c990000613d0000000102000029000000ff0220018f000000000101043b000000000101041a000000000121022f000000010110018f000000000001042d000000000100001900000cdd00010430000000000001042f0000033803000041000003380410009c00000000010380190000004001100210000003380420009c00000000020380190000006002200210000000000112019f0000000002000414000003380420009c0000000002038019000000c002200210000000000112019f00000342011001c700008010020000390cdb0cd60000040f000000010220019000000cb00000613d000000000101043b000000000001042d000000000100001900000cdd0001043000000000050100190000000000200439000000050130008c00000cc00000413d000000040100003900000000020000190000000506200210000000000664001900000005066002700000000006060031000000000161043a0000000102200039000000000631004b00000cb80000413d00000338010000410000000002000414000003380420009c0000000002018019000003380430009c00000000030180190000006001300210000000c002200210000000000112019f00000390011001c700000000020500190cdb0cd60000040f000000010220019000000cd00000613d000000000101043b000000000001042d000000000001042f00000cd4002104210000000102000039000000000001042d0000000002000019000000000001042d00000cd9002104230000000102000039000000000001042d0000000002000019000000000001042d00000cdb0000043200000cdc0001042e00000cdd000104300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000023fffffffffffffffffffffffffffffffffffffffffffffffff000000000000021f00000000000000000000000000000000000000000000000000000001ffffffe0000000000000000000000000ffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffffbf5a6b4d65726b6c654469737472696275746f72000000000000000000000000003100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffff020000000000000000000000000000000000002000000000000000000000000002000000000000000000000000000000000000000000000000000000000000009a8a0592ac89c5ad3bc6df8224c17b485976f597df104ee20d0df415241f670b02000002000000000000000000000000000000040000000000000000000000008b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f000000000000000000000000000000000000000000000000ffffffffffffff3f0000000200000000000000000000000000000380000001000000000000000000000000000000000000000000000000000000000000000000000000007ecebdff000000000000000000000000000000000000000000000000000000009e34070e00000000000000000000000000000000000000000000000000000000b217293b00000000000000000000000000000000000000000000000000000000b217293c00000000000000000000000000000000000000000000000000000000c41ac88700000000000000000000000000000000000000000000000000000000d54ad2a1000000000000000000000000000000000000000000000000000000009e34070f00000000000000000000000000000000000000000000000000000000ae0b51df0000000000000000000000000000000000000000000000000000000084b0196d0000000000000000000000000000000000000000000000000000000084b0196e00000000000000000000000000000000000000000000000000000000875a00c30000000000000000000000000000000000000000000000000000000092a233c4000000000000000000000000000000000000000000000000000000007ecebe000000000000000000000000000000000000000000000000000000000082bfefc80000000000000000000000000000000000000000000000000000000037b8255500000000000000000000000000000000000000000000000000000000404330bb00000000000000000000000000000000000000000000000000000000404330bc0000000000000000000000000000000000000000000000000000000051e75e8b000000000000000000000000000000000000000000000000000000005a57b46f0000000000000000000000000000000000000000000000000000000037b8255600000000000000000000000000000000000000000000000000000000392e2303000000000000000000000000000000000000000000000000000000002a0acc69000000000000000000000000000000000000000000000000000000002a0acc6a000000000000000000000000000000000000000000000000000000003644e5150000000000000000000000000000000000000000000000000000000000d8e391000000000000000000000000000000000000000000000000000000001f23c68a00000000000000000000000000000000000000200000008000000000000000008000000000000000000000000000000000000000000000000000000000000000310ab089e4439a4c15d089f94afb7896ff553aecb10793d0ab882de59d99a32e02000002000000000000000000000000000000440000000000000000000000001806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b8302000002000000000000000000000000000000240000000000000000000000003499bfcb0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffff5b00000000000000000000000000000000000000a4000000000000000000000000ae3fe996b21a77e99e206811ded00bbf51c40c417539e9de35cbc3f624ec7b8e000000000000000000000000000000000000002000000000000000000000000005a8c1e01c4158f66a0a3a1ba720f639b380f6c904e3f3fb996d06c1d5991bd8796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d955391320200000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff1f19010000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000042000000000000000000000000501bf2a3000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000b3512b0c00000000000000000000000000000000000000000000000000000000290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e563b10e2d527612073b26eecdfd717e6a320cf44b4afac2b0732d9fcbe2b7fa0cf6000000000000000000000000000000000000000000000000ffffffffffffffdf0f000000000000000000000000000000000000000000000000000000000000004e487b710000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000002dcea62d000000000000000000000000000000000000000000000000000000001198c63f0000000000000000000000000000000000000000000000000000000040c10f19000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044000000000000000000000000534ebe4600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000fffffffffffffeff000000000000000000000000000000000000000000000000ffffffffffffff7f0000000000000000000000000000000000000004000000800000000000000000000000000000000000000000000000000000000000000000ffffffffffffff407fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a000000000000000000000000000000000000000800000000000000000000000001626ba7e0000000000000000000000000000000000000000000000000000000029450527000000000000000000000000000000000000000000000000000000005397a2ec00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff80884798e70000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000600000000000000000000000004ec90e965519d92681267467f775ada5bd214aa92c0dc93d90a5e880ce9ed026f36be90d000000000000000000000000000000000000000000000000000000005fb7f2ba00000000000000000000000000000000000000000000000000000000020000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003b886081aba77b979240f58707662312750e8c79c16fba028db2337fd35cf7bc