ETH Price: $2,574.87 (+2.52%)

Transaction Decoder

Block:
22854029 at Jul-05-2025 03:52:11 PM +UTC
Transaction Fee:
0.000527733762588 ETH $1.36
Gas Used:
147,360 Gas / 3.581255175 Gwei

Emitted Events:

24 ERC1967Proxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x0000000000000000000000005f9ecf757137d5ef4330ab72d18163c2f221befd, 0x00000000000000000000000011108d34607ea7cd5f0d2a8a5c9831da89c82187, 000000000000000000000000000000000000000000000000000023bce51b5ec0 )
25 ERC1967Proxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x0000000000000000000000005f9ecf757137d5ef4330ab72d18163c2f221befd, 0x000000000000000000000000a4846b20c03959051192d9451901a06281a42eec, 000000000000000000000000000000000000000000000000000023bce51b5ec0 )
26 ERC1967Proxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x0000000000000000000000005f9ecf757137d5ef4330ab72d18163c2f221befd, 0x0000000000000000000000000000000000000000000000000000000000000000, 000000000000000000000000000000000000000000000000000011de728daf60 )
27 ERC1967Proxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x0000000000000000000000005f9ecf757137d5ef4330ab72d18163c2f221befd, 0x00000000000000000000000043a68a9f1f234e639b142f0aba946b7add26418d, 000000000000000000000000000000000000000000000000000d9c7141ec9620 )
28 TetherToken.Transfer( from=UniswapV2Pair, to=0x457ff5ee36e8E7d3f99cAc52F822C719F09B3021, value=445243974 )
29 UniswapV2Pair.Sync( reserve0=583492038414777662, reserve1=67568417384 )
30 UniswapV2Pair.Swap( sender=[Receiver] 0x5f9ecf757137d5ef4330ab72d18163c2f221befd, amount0In=3831184948500000, amount1In=0, amount0Out=0, amount1Out=445243974, to=0x457ff5ee36e8E7d3f99cAc52F822C719F09B3021 )

Account State Difference:

  Address   Before After State Difference Code
0x20011FA1...439a7da4A
0.757222753441585117 Eth
Nonce: 175224
0.756695019678997117 Eth
Nonce: 175225
0.000527733762588
0x43a68A9f...Add26418d
0xD1e64bcc...69b4bcdAe
0xdAC17F95...13D831ec7
(BuilderNet)
29.332520125725284206 Eth29.332977491846689006 Eth0.0004573661214048

Execution Trace

MEV Bot: 0x5f9...efd.d4e4634a( )
  • ERC1967Proxy.70a08231( )
    • PikaMoon.balanceOf( account=0x5f9Ecf757137d5Ef4330aB72d18163c2f221befD ) => ( 3929420460000000 )
    • UniswapV2Pair.STATICCALL( )
    • ERC1967Proxy.a9059cbb( )
      • PikaMoon.transfer( to=0x43a68A9f1F234e639B142F0ABa946B7Add26418d, value=3929420460000000 ) => ( True )
      • UniswapV2Pair.STATICCALL( )
      • ERC1967Proxy.70a08231( )
        • PikaMoon.balanceOf( account=0x43a68A9f1F234e639B142F0ABa946B7Add26418d ) => ( 583492038414777662 )
        • UniswapV2Pair.swap( amount0Out=0, amount1Out=445243974, to=0x457ff5ee36e8E7d3f99cAc52F822C719F09B3021, data=0x )
          • TetherToken.transfer( _to=0x457ff5ee36e8E7d3f99cAc52F822C719F09B3021, _value=445243974 )
          • ERC1967Proxy.70a08231( )
            • PikaMoon.balanceOf( account=0x43a68A9f1F234e639B142F0ABa946B7Add26418d ) => ( 583492038414777662 )
            • TetherToken.balanceOf( who=0x43a68A9f1F234e639B142F0ABa946B7Add26418d ) => ( 67568417384 )
              File 1 of 4: ERC1967Proxy
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/ERC1967/ERC1967Proxy.sol)
              pragma solidity ^0.8.20;
              import {Proxy} from "../Proxy.sol";
              import {ERC1967Utils} from "./ERC1967Utils.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 {
                  /**
                   * @dev Initializes the upgradeable proxy with an initial implementation specified by `implementation`.
                   *
                   * If `_data` is nonempty, it's used as data in a delegate call to `implementation`. This will typically be an
                   * encoded function call, and allows initializing the storage of the proxy like a Solidity constructor.
                   *
                   * Requirements:
                   *
                   * - If `data` is empty, `msg.value` must be zero.
                   */
                  constructor(address implementation, bytes memory _data) payable {
                      ERC1967Utils.upgradeToAndCall(implementation, _data);
                  }
                  /**
                   * @dev Returns the current implementation address.
                   *
                   * 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 _implementation() internal view virtual override returns (address) {
                      return ERC1967Utils.getImplementation();
                  }
              }
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/ERC1967/ERC1967Utils.sol)
              pragma solidity ^0.8.20;
              import {IBeacon} from "../beacon/IBeacon.sol";
              import {Address} from "../../utils/Address.sol";
              import {StorageSlot} from "../../utils/StorageSlot.sol";
              /**
               * @dev This abstract contract provides getters and event emitting update functions for
               * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
               */
              library ERC1967Utils {
                  // We re-declare ERC-1967 events here because they can't be used directly from IERC1967.
                  // This will be fixed in Solidity 0.8.21. At that point we should remove these events.
                  /**
                   * @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);
                  /**
                   * @dev Storage slot with the address of the current implementation.
                   * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1.
                   */
                  // solhint-disable-next-line private-vars-leading-underscore
                  bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                  /**
                   * @dev The `implementation` of the proxy is invalid.
                   */
                  error ERC1967InvalidImplementation(address implementation);
                  /**
                   * @dev The `admin` of the proxy is invalid.
                   */
                  error ERC1967InvalidAdmin(address admin);
                  /**
                   * @dev The `beacon` of the proxy is invalid.
                   */
                  error ERC1967InvalidBeacon(address beacon);
                  /**
                   * @dev An upgrade function sees `msg.value > 0` that may be lost.
                   */
                  error ERC1967NonPayable();
                  /**
                   * @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 {
                      if (newImplementation.code.length == 0) {
                          revert ERC1967InvalidImplementation(newImplementation);
                      }
                      StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value = newImplementation;
                  }
                  /**
                   * @dev Performs implementation upgrade with additional setup call if data is nonempty.
                   * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
                   * to avoid stuck value in the contract.
                   *
                   * Emits an {IERC1967-Upgraded} event.
                   */
                  function upgradeToAndCall(address newImplementation, bytes memory data) internal {
                      _setImplementation(newImplementation);
                      emit Upgraded(newImplementation);
                      if (data.length > 0) {
                          Address.functionDelegateCall(newImplementation, data);
                      } else {
                          _checkNonPayable();
                      }
                  }
                  /**
                   * @dev Storage slot with the admin of the contract.
                   * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1.
                   */
                  // solhint-disable-next-line private-vars-leading-underscore
                  bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                  /**
                   * @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 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 {
                      if (newAdmin == address(0)) {
                          revert ERC1967InvalidAdmin(address(0));
                      }
                      StorageSlot.getAddressSlot(ADMIN_SLOT).value = newAdmin;
                  }
                  /**
                   * @dev Changes the admin of the proxy.
                   *
                   * Emits an {IERC1967-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 the keccak-256 hash of "eip1967.proxy.beacon" subtracted by 1.
                   */
                  // solhint-disable-next-line private-vars-leading-underscore
                  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 {
                      if (newBeacon.code.length == 0) {
                          revert ERC1967InvalidBeacon(newBeacon);
                      }
                      StorageSlot.getAddressSlot(BEACON_SLOT).value = newBeacon;
                      address beaconImplementation = IBeacon(newBeacon).implementation();
                      if (beaconImplementation.code.length == 0) {
                          revert ERC1967InvalidImplementation(beaconImplementation);
                      }
                  }
                  /**
                   * @dev Change the beacon and trigger a setup call if data is nonempty.
                   * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
                   * to avoid stuck value in the contract.
                   *
                   * Emits an {IERC1967-BeaconUpgraded} event.
                   *
                   * CAUTION: Invoking this function has no effect on an instance of {BeaconProxy} since v5, since
                   * it uses an immutable beacon without looking at the value of the ERC-1967 beacon slot for
                   * efficiency.
                   */
                  function upgradeBeaconToAndCall(address newBeacon, bytes memory data) internal {
                      _setBeacon(newBeacon);
                      emit BeaconUpgraded(newBeacon);
                      if (data.length > 0) {
                          Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                      } else {
                          _checkNonPayable();
                      }
                  }
                  /**
                   * @dev Reverts if `msg.value` is not zero. It can be used to avoid `msg.value` stuck in the contract
                   * if an upgrade doesn't perform an initialization call.
                   */
                  function _checkNonPayable() private {
                      if (msg.value > 0) {
                          revert ERC1967NonPayable();
                      }
                  }
              }
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/Proxy.sol)
              pragma solidity ^0.8.20;
              /**
               * @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 {
                      _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();
                  }
              }
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (utils/StorageSlot.sol)
              // This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
              pragma solidity ^0.8.20;
              /**
               * @dev Library for reading and writing primitive types to specific storage slots.
               *
               * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
               * This library helps with reading and writing to such slots without the need for inline assembly.
               *
               * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
               *
               * Example usage to set ERC1967 implementation slot:
               * ```solidity
               * contract ERC1967 {
               *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
               *
               *     function _getImplementation() internal view returns (address) {
               *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
               *     }
               *
               *     function _setImplementation(address newImplementation) internal {
               *         require(newImplementation.code.length > 0);
               *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
               *     }
               * }
               * ```
               */
              library StorageSlot {
                  struct AddressSlot {
                      address value;
                  }
                  struct BooleanSlot {
                      bool value;
                  }
                  struct Bytes32Slot {
                      bytes32 value;
                  }
                  struct Uint256Slot {
                      uint256 value;
                  }
                  struct StringSlot {
                      string value;
                  }
                  struct BytesSlot {
                      bytes value;
                  }
                  /**
                   * @dev Returns an `AddressSlot` with member `value` located at `slot`.
                   */
                  function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
                   */
                  function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
                   */
                  function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
                   */
                  function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `StringSlot` with member `value` located at `slot`.
                   */
                  function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
                   */
                  function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := store.slot
                      }
                  }
                  /**
                   * @dev Returns an `BytesSlot` with member `value` located at `slot`.
                   */
                  function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
                   */
                  function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := store.slot
                      }
                  }
              }
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol)
              pragma solidity ^0.8.20;
              /**
               * @dev Collection of functions related to the address type
               */
              library Address {
                  /**
                   * @dev The ETH balance of the account is not enough to perform the operation.
                   */
                  error AddressInsufficientBalance(address account);
                  /**
                   * @dev There's no code at `target` (it is not a contract).
                   */
                  error AddressEmptyCode(address target);
                  /**
                   * @dev A call to an address target failed. The target may have reverted.
                   */
                  error FailedInnerCall();
                  /**
                   * @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.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                   */
                  function sendValue(address payable recipient, uint256 amount) internal {
                      if (address(this).balance < amount) {
                          revert AddressInsufficientBalance(address(this));
                      }
                      (bool success, ) = recipient.call{value: amount}("");
                      if (!success) {
                          revert FailedInnerCall();
                      }
                  }
                  /**
                   * @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 or custom error, it is bubbled
                   * up by this function (like regular Solidity function calls). However, if
                   * the call reverted with no returned reason, this function reverts with a
                   * {FailedInnerCall} error.
                   *
                   * 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.
                   */
                  function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                      return functionCallWithValue(target, data, 0);
                  }
                  /**
                   * @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`.
                   */
                  function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                      if (address(this).balance < value) {
                          revert AddressInsufficientBalance(address(this));
                      }
                      (bool success, bytes memory returndata) = target.call{value: value}(data);
                      return verifyCallResultFromTarget(target, success, returndata);
                  }
                  /**
                   * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                   * but performing a static call.
                   */
                  function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                      (bool success, bytes memory returndata) = target.staticcall(data);
                      return verifyCallResultFromTarget(target, success, returndata);
                  }
                  /**
                   * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                   * but performing a delegate call.
                   */
                  function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                      (bool success, bytes memory returndata) = target.delegatecall(data);
                      return verifyCallResultFromTarget(target, success, returndata);
                  }
                  /**
                   * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target
                   * was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an
                   * unsuccessful call.
                   */
                  function verifyCallResultFromTarget(
                      address target,
                      bool success,
                      bytes memory returndata
                  ) internal view returns (bytes memory) {
                      if (!success) {
                          _revert(returndata);
                      } else {
                          // only check if target is a contract if the call was successful and the return data is empty
                          // otherwise we already know that it was a contract
                          if (returndata.length == 0 && target.code.length == 0) {
                              revert AddressEmptyCode(target);
                          }
                          return returndata;
                      }
                  }
                  /**
                   * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the
                   * revert reason or with a default {FailedInnerCall} error.
                   */
                  function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) {
                      if (!success) {
                          _revert(returndata);
                      } else {
                          return returndata;
                      }
                  }
                  /**
                   * @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}.
                   */
                  function _revert(bytes memory returndata) 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 FailedInnerCall();
                      }
                  }
              }
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/beacon/IBeacon.sol)
              pragma solidity ^0.8.20;
              /**
               * @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.
                   *
                   * {UpgradeableBeacon} will check that this address is a contract.
                   */
                  function implementation() external view returns (address);
              }
              

              File 2 of 4: UniswapV2Pair
              // File: contracts/interfaces/IUniswapV2Pair.sol
              
              pragma solidity >=0.5.0;
              
              interface IUniswapV2Pair {
                  event Approval(address indexed owner, address indexed spender, uint value);
                  event Transfer(address indexed from, address indexed to, uint value);
              
                  function name() external pure returns (string memory);
                  function symbol() external pure returns (string memory);
                  function decimals() external pure returns (uint8);
                  function totalSupply() external view returns (uint);
                  function balanceOf(address owner) external view returns (uint);
                  function allowance(address owner, address spender) external view returns (uint);
              
                  function approve(address spender, uint value) external returns (bool);
                  function transfer(address to, uint value) external returns (bool);
                  function transferFrom(address from, address to, uint value) external returns (bool);
              
                  function DOMAIN_SEPARATOR() external view returns (bytes32);
                  function PERMIT_TYPEHASH() external pure returns (bytes32);
                  function nonces(address owner) external view returns (uint);
              
                  function permit(address owner, address spender, uint value, uint deadline, uint8 v, bytes32 r, bytes32 s) external;
              
                  event Mint(address indexed sender, uint amount0, uint amount1);
                  event Burn(address indexed sender, uint amount0, uint amount1, address indexed to);
                  event Swap(
                      address indexed sender,
                      uint amount0In,
                      uint amount1In,
                      uint amount0Out,
                      uint amount1Out,
                      address indexed to
                  );
                  event Sync(uint112 reserve0, uint112 reserve1);
              
                  function MINIMUM_LIQUIDITY() external pure returns (uint);
                  function factory() external view returns (address);
                  function token0() external view returns (address);
                  function token1() external view returns (address);
                  function getReserves() external view returns (uint112 reserve0, uint112 reserve1, uint32 blockTimestampLast);
                  function price0CumulativeLast() external view returns (uint);
                  function price1CumulativeLast() external view returns (uint);
                  function kLast() external view returns (uint);
              
                  function mint(address to) external returns (uint liquidity);
                  function burn(address to) external returns (uint amount0, uint amount1);
                  function swap(uint amount0Out, uint amount1Out, address to, bytes calldata data) external;
                  function skim(address to) external;
                  function sync() external;
              
                  function initialize(address, address) external;
              }
              
              // File: contracts/interfaces/IUniswapV2ERC20.sol
              
              pragma solidity >=0.5.0;
              
              interface IUniswapV2ERC20 {
                  event Approval(address indexed owner, address indexed spender, uint value);
                  event Transfer(address indexed from, address indexed to, uint value);
              
                  function name() external pure returns (string memory);
                  function symbol() external pure returns (string memory);
                  function decimals() external pure returns (uint8);
                  function totalSupply() external view returns (uint);
                  function balanceOf(address owner) external view returns (uint);
                  function allowance(address owner, address spender) external view returns (uint);
              
                  function approve(address spender, uint value) external returns (bool);
                  function transfer(address to, uint value) external returns (bool);
                  function transferFrom(address from, address to, uint value) external returns (bool);
              
                  function DOMAIN_SEPARATOR() external view returns (bytes32);
                  function PERMIT_TYPEHASH() external pure returns (bytes32);
                  function nonces(address owner) external view returns (uint);
              
                  function permit(address owner, address spender, uint value, uint deadline, uint8 v, bytes32 r, bytes32 s) external;
              }
              
              // File: contracts/libraries/SafeMath.sol
              
              pragma solidity =0.5.16;
              
              // a library for performing overflow-safe math, courtesy of DappHub (https://github.com/dapphub/ds-math)
              
              library SafeMath {
                  function add(uint x, uint y) internal pure returns (uint z) {
                      require((z = x + y) >= x, 'ds-math-add-overflow');
                  }
              
                  function sub(uint x, uint y) internal pure returns (uint z) {
                      require((z = x - y) <= x, 'ds-math-sub-underflow');
                  }
              
                  function mul(uint x, uint y) internal pure returns (uint z) {
                      require(y == 0 || (z = x * y) / y == x, 'ds-math-mul-overflow');
                  }
              }
              
              // File: contracts/UniswapV2ERC20.sol
              
              pragma solidity =0.5.16;
              
              
              
              contract UniswapV2ERC20 is IUniswapV2ERC20 {
                  using SafeMath for uint;
              
                  string public constant name = 'Uniswap V2';
                  string public constant symbol = 'UNI-V2';
                  uint8 public constant decimals = 18;
                  uint  public totalSupply;
                  mapping(address => uint) public balanceOf;
                  mapping(address => mapping(address => uint)) public allowance;
              
                  bytes32 public DOMAIN_SEPARATOR;
                  // keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)");
                  bytes32 public constant PERMIT_TYPEHASH = 0x6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9;
                  mapping(address => uint) public nonces;
              
                  event Approval(address indexed owner, address indexed spender, uint value);
                  event Transfer(address indexed from, address indexed to, uint value);
              
                  constructor() public {
                      uint chainId;
                      assembly {
                          chainId := chainid
                      }
                      DOMAIN_SEPARATOR = keccak256(
                          abi.encode(
                              keccak256('EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)'),
                              keccak256(bytes(name)),
                              keccak256(bytes('1')),
                              chainId,
                              address(this)
                          )
                      );
                  }
              
                  function _mint(address to, uint value) internal {
                      totalSupply = totalSupply.add(value);
                      balanceOf[to] = balanceOf[to].add(value);
                      emit Transfer(address(0), to, value);
                  }
              
                  function _burn(address from, uint value) internal {
                      balanceOf[from] = balanceOf[from].sub(value);
                      totalSupply = totalSupply.sub(value);
                      emit Transfer(from, address(0), value);
                  }
              
                  function _approve(address owner, address spender, uint value) private {
                      allowance[owner][spender] = value;
                      emit Approval(owner, spender, value);
                  }
              
                  function _transfer(address from, address to, uint value) private {
                      balanceOf[from] = balanceOf[from].sub(value);
                      balanceOf[to] = balanceOf[to].add(value);
                      emit Transfer(from, to, value);
                  }
              
                  function approve(address spender, uint value) external returns (bool) {
                      _approve(msg.sender, spender, value);
                      return true;
                  }
              
                  function transfer(address to, uint value) external returns (bool) {
                      _transfer(msg.sender, to, value);
                      return true;
                  }
              
                  function transferFrom(address from, address to, uint value) external returns (bool) {
                      if (allowance[from][msg.sender] != uint(-1)) {
                          allowance[from][msg.sender] = allowance[from][msg.sender].sub(value);
                      }
                      _transfer(from, to, value);
                      return true;
                  }
              
                  function permit(address owner, address spender, uint value, uint deadline, uint8 v, bytes32 r, bytes32 s) external {
                      require(deadline >= block.timestamp, 'UniswapV2: EXPIRED');
                      bytes32 digest = keccak256(
                          abi.encodePacked(
                              '\x19\x01',
                              DOMAIN_SEPARATOR,
                              keccak256(abi.encode(PERMIT_TYPEHASH, owner, spender, value, nonces[owner]++, deadline))
                          )
                      );
                      address recoveredAddress = ecrecover(digest, v, r, s);
                      require(recoveredAddress != address(0) && recoveredAddress == owner, 'UniswapV2: INVALID_SIGNATURE');
                      _approve(owner, spender, value);
                  }
              }
              
              // File: contracts/libraries/Math.sol
              
              pragma solidity =0.5.16;
              
              // a library for performing various math operations
              
              library Math {
                  function min(uint x, uint y) internal pure returns (uint z) {
                      z = x < y ? x : y;
                  }
              
                  // babylonian method (https://en.wikipedia.org/wiki/Methods_of_computing_square_roots#Babylonian_method)
                  function sqrt(uint y) internal pure returns (uint z) {
                      if (y > 3) {
                          z = y;
                          uint x = y / 2 + 1;
                          while (x < z) {
                              z = x;
                              x = (y / x + x) / 2;
                          }
                      } else if (y != 0) {
                          z = 1;
                      }
                  }
              }
              
              // File: contracts/libraries/UQ112x112.sol
              
              pragma solidity =0.5.16;
              
              // a library for handling binary fixed point numbers (https://en.wikipedia.org/wiki/Q_(number_format))
              
              // range: [0, 2**112 - 1]
              // resolution: 1 / 2**112
              
              library UQ112x112 {
                  uint224 constant Q112 = 2**112;
              
                  // encode a uint112 as a UQ112x112
                  function encode(uint112 y) internal pure returns (uint224 z) {
                      z = uint224(y) * Q112; // never overflows
                  }
              
                  // divide a UQ112x112 by a uint112, returning a UQ112x112
                  function uqdiv(uint224 x, uint112 y) internal pure returns (uint224 z) {
                      z = x / uint224(y);
                  }
              }
              
              // File: contracts/interfaces/IERC20.sol
              
              pragma solidity >=0.5.0;
              
              interface IERC20 {
                  event Approval(address indexed owner, address indexed spender, uint value);
                  event Transfer(address indexed from, address indexed to, uint value);
              
                  function name() external view returns (string memory);
                  function symbol() external view returns (string memory);
                  function decimals() external view returns (uint8);
                  function totalSupply() external view returns (uint);
                  function balanceOf(address owner) external view returns (uint);
                  function allowance(address owner, address spender) external view returns (uint);
              
                  function approve(address spender, uint value) external returns (bool);
                  function transfer(address to, uint value) external returns (bool);
                  function transferFrom(address from, address to, uint value) external returns (bool);
              }
              
              // File: contracts/interfaces/IUniswapV2Factory.sol
              
              pragma solidity >=0.5.0;
              
              interface IUniswapV2Factory {
                  event PairCreated(address indexed token0, address indexed token1, address pair, uint);
              
                  function feeTo() external view returns (address);
                  function feeToSetter() external view returns (address);
              
                  function getPair(address tokenA, address tokenB) external view returns (address pair);
                  function allPairs(uint) external view returns (address pair);
                  function allPairsLength() external view returns (uint);
              
                  function createPair(address tokenA, address tokenB) external returns (address pair);
              
                  function setFeeTo(address) external;
                  function setFeeToSetter(address) external;
              }
              
              // File: contracts/interfaces/IUniswapV2Callee.sol
              
              pragma solidity >=0.5.0;
              
              interface IUniswapV2Callee {
                  function uniswapV2Call(address sender, uint amount0, uint amount1, bytes calldata data) external;
              }
              
              // File: contracts/UniswapV2Pair.sol
              
              pragma solidity =0.5.16;
              
              
              
              
              
              
              
              
              contract UniswapV2Pair is IUniswapV2Pair, UniswapV2ERC20 {
                  using SafeMath  for uint;
                  using UQ112x112 for uint224;
              
                  uint public constant MINIMUM_LIQUIDITY = 10**3;
                  bytes4 private constant SELECTOR = bytes4(keccak256(bytes('transfer(address,uint256)')));
              
                  address public factory;
                  address public token0;
                  address public token1;
              
                  uint112 private reserve0;           // uses single storage slot, accessible via getReserves
                  uint112 private reserve1;           // uses single storage slot, accessible via getReserves
                  uint32  private blockTimestampLast; // uses single storage slot, accessible via getReserves
              
                  uint public price0CumulativeLast;
                  uint public price1CumulativeLast;
                  uint public kLast; // reserve0 * reserve1, as of immediately after the most recent liquidity event
              
                  uint private unlocked = 1;
                  modifier lock() {
                      require(unlocked == 1, 'UniswapV2: LOCKED');
                      unlocked = 0;
                      _;
                      unlocked = 1;
                  }
              
                  function getReserves() public view returns (uint112 _reserve0, uint112 _reserve1, uint32 _blockTimestampLast) {
                      _reserve0 = reserve0;
                      _reserve1 = reserve1;
                      _blockTimestampLast = blockTimestampLast;
                  }
              
                  function _safeTransfer(address token, address to, uint value) private {
                      (bool success, bytes memory data) = token.call(abi.encodeWithSelector(SELECTOR, to, value));
                      require(success && (data.length == 0 || abi.decode(data, (bool))), 'UniswapV2: TRANSFER_FAILED');
                  }
              
                  event Mint(address indexed sender, uint amount0, uint amount1);
                  event Burn(address indexed sender, uint amount0, uint amount1, address indexed to);
                  event Swap(
                      address indexed sender,
                      uint amount0In,
                      uint amount1In,
                      uint amount0Out,
                      uint amount1Out,
                      address indexed to
                  );
                  event Sync(uint112 reserve0, uint112 reserve1);
              
                  constructor() public {
                      factory = msg.sender;
                  }
              
                  // called once by the factory at time of deployment
                  function initialize(address _token0, address _token1) external {
                      require(msg.sender == factory, 'UniswapV2: FORBIDDEN'); // sufficient check
                      token0 = _token0;
                      token1 = _token1;
                  }
              
                  // update reserves and, on the first call per block, price accumulators
                  function _update(uint balance0, uint balance1, uint112 _reserve0, uint112 _reserve1) private {
                      require(balance0 <= uint112(-1) && balance1 <= uint112(-1), 'UniswapV2: OVERFLOW');
                      uint32 blockTimestamp = uint32(block.timestamp % 2**32);
                      uint32 timeElapsed = blockTimestamp - blockTimestampLast; // overflow is desired
                      if (timeElapsed > 0 && _reserve0 != 0 && _reserve1 != 0) {
                          // * never overflows, and + overflow is desired
                          price0CumulativeLast += uint(UQ112x112.encode(_reserve1).uqdiv(_reserve0)) * timeElapsed;
                          price1CumulativeLast += uint(UQ112x112.encode(_reserve0).uqdiv(_reserve1)) * timeElapsed;
                      }
                      reserve0 = uint112(balance0);
                      reserve1 = uint112(balance1);
                      blockTimestampLast = blockTimestamp;
                      emit Sync(reserve0, reserve1);
                  }
              
                  // if fee is on, mint liquidity equivalent to 1/6th of the growth in sqrt(k)
                  function _mintFee(uint112 _reserve0, uint112 _reserve1) private returns (bool feeOn) {
                      address feeTo = IUniswapV2Factory(factory).feeTo();
                      feeOn = feeTo != address(0);
                      uint _kLast = kLast; // gas savings
                      if (feeOn) {
                          if (_kLast != 0) {
                              uint rootK = Math.sqrt(uint(_reserve0).mul(_reserve1));
                              uint rootKLast = Math.sqrt(_kLast);
                              if (rootK > rootKLast) {
                                  uint numerator = totalSupply.mul(rootK.sub(rootKLast));
                                  uint denominator = rootK.mul(5).add(rootKLast);
                                  uint liquidity = numerator / denominator;
                                  if (liquidity > 0) _mint(feeTo, liquidity);
                              }
                          }
                      } else if (_kLast != 0) {
                          kLast = 0;
                      }
                  }
              
                  // this low-level function should be called from a contract which performs important safety checks
                  function mint(address to) external lock returns (uint liquidity) {
                      (uint112 _reserve0, uint112 _reserve1,) = getReserves(); // gas savings
                      uint balance0 = IERC20(token0).balanceOf(address(this));
                      uint balance1 = IERC20(token1).balanceOf(address(this));
                      uint amount0 = balance0.sub(_reserve0);
                      uint amount1 = balance1.sub(_reserve1);
              
                      bool feeOn = _mintFee(_reserve0, _reserve1);
                      uint _totalSupply = totalSupply; // gas savings, must be defined here since totalSupply can update in _mintFee
                      if (_totalSupply == 0) {
                          liquidity = Math.sqrt(amount0.mul(amount1)).sub(MINIMUM_LIQUIDITY);
                         _mint(address(0), MINIMUM_LIQUIDITY); // permanently lock the first MINIMUM_LIQUIDITY tokens
                      } else {
                          liquidity = Math.min(amount0.mul(_totalSupply) / _reserve0, amount1.mul(_totalSupply) / _reserve1);
                      }
                      require(liquidity > 0, 'UniswapV2: INSUFFICIENT_LIQUIDITY_MINTED');
                      _mint(to, liquidity);
              
                      _update(balance0, balance1, _reserve0, _reserve1);
                      if (feeOn) kLast = uint(reserve0).mul(reserve1); // reserve0 and reserve1 are up-to-date
                      emit Mint(msg.sender, amount0, amount1);
                  }
              
                  // this low-level function should be called from a contract which performs important safety checks
                  function burn(address to) external lock returns (uint amount0, uint amount1) {
                      (uint112 _reserve0, uint112 _reserve1,) = getReserves(); // gas savings
                      address _token0 = token0;                                // gas savings
                      address _token1 = token1;                                // gas savings
                      uint balance0 = IERC20(_token0).balanceOf(address(this));
                      uint balance1 = IERC20(_token1).balanceOf(address(this));
                      uint liquidity = balanceOf[address(this)];
              
                      bool feeOn = _mintFee(_reserve0, _reserve1);
                      uint _totalSupply = totalSupply; // gas savings, must be defined here since totalSupply can update in _mintFee
                      amount0 = liquidity.mul(balance0) / _totalSupply; // using balances ensures pro-rata distribution
                      amount1 = liquidity.mul(balance1) / _totalSupply; // using balances ensures pro-rata distribution
                      require(amount0 > 0 && amount1 > 0, 'UniswapV2: INSUFFICIENT_LIQUIDITY_BURNED');
                      _burn(address(this), liquidity);
                      _safeTransfer(_token0, to, amount0);
                      _safeTransfer(_token1, to, amount1);
                      balance0 = IERC20(_token0).balanceOf(address(this));
                      balance1 = IERC20(_token1).balanceOf(address(this));
              
                      _update(balance0, balance1, _reserve0, _reserve1);
                      if (feeOn) kLast = uint(reserve0).mul(reserve1); // reserve0 and reserve1 are up-to-date
                      emit Burn(msg.sender, amount0, amount1, to);
                  }
              
                  // this low-level function should be called from a contract which performs important safety checks
                  function swap(uint amount0Out, uint amount1Out, address to, bytes calldata data) external lock {
                      require(amount0Out > 0 || amount1Out > 0, 'UniswapV2: INSUFFICIENT_OUTPUT_AMOUNT');
                      (uint112 _reserve0, uint112 _reserve1,) = getReserves(); // gas savings
                      require(amount0Out < _reserve0 && amount1Out < _reserve1, 'UniswapV2: INSUFFICIENT_LIQUIDITY');
              
                      uint balance0;
                      uint balance1;
                      { // scope for _token{0,1}, avoids stack too deep errors
                      address _token0 = token0;
                      address _token1 = token1;
                      require(to != _token0 && to != _token1, 'UniswapV2: INVALID_TO');
                      if (amount0Out > 0) _safeTransfer(_token0, to, amount0Out); // optimistically transfer tokens
                      if (amount1Out > 0) _safeTransfer(_token1, to, amount1Out); // optimistically transfer tokens
                      if (data.length > 0) IUniswapV2Callee(to).uniswapV2Call(msg.sender, amount0Out, amount1Out, data);
                      balance0 = IERC20(_token0).balanceOf(address(this));
                      balance1 = IERC20(_token1).balanceOf(address(this));
                      }
                      uint amount0In = balance0 > _reserve0 - amount0Out ? balance0 - (_reserve0 - amount0Out) : 0;
                      uint amount1In = balance1 > _reserve1 - amount1Out ? balance1 - (_reserve1 - amount1Out) : 0;
                      require(amount0In > 0 || amount1In > 0, 'UniswapV2: INSUFFICIENT_INPUT_AMOUNT');
                      { // scope for reserve{0,1}Adjusted, avoids stack too deep errors
                      uint balance0Adjusted = balance0.mul(1000).sub(amount0In.mul(3));
                      uint balance1Adjusted = balance1.mul(1000).sub(amount1In.mul(3));
                      require(balance0Adjusted.mul(balance1Adjusted) >= uint(_reserve0).mul(_reserve1).mul(1000**2), 'UniswapV2: K');
                      }
              
                      _update(balance0, balance1, _reserve0, _reserve1);
                      emit Swap(msg.sender, amount0In, amount1In, amount0Out, amount1Out, to);
                  }
              
                  // force balances to match reserves
                  function skim(address to) external lock {
                      address _token0 = token0; // gas savings
                      address _token1 = token1; // gas savings
                      _safeTransfer(_token0, to, IERC20(_token0).balanceOf(address(this)).sub(reserve0));
                      _safeTransfer(_token1, to, IERC20(_token1).balanceOf(address(this)).sub(reserve1));
                  }
              
                  // force reserves to match balances
                  function sync() external lock {
                      _update(IERC20(token0).balanceOf(address(this)), IERC20(token1).balanceOf(address(this)), reserve0, reserve1);
                  }
              }

              File 3 of 4: TetherToken
              pragma solidity ^0.4.17;
              
              /**
               * @title SafeMath
               * @dev Math operations with safety checks that throw on error
               */
              library SafeMath {
                  function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                      if (a == 0) {
                          return 0;
                      }
                      uint256 c = a * b;
                      assert(c / a == b);
                      return c;
                  }
              
                  function div(uint256 a, uint256 b) internal pure returns (uint256) {
                      // assert(b > 0); // Solidity automatically throws when dividing by 0
                      uint256 c = a / b;
                      // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                      return c;
                  }
              
                  function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                      assert(b <= a);
                      return a - b;
                  }
              
                  function add(uint256 a, uint256 b) internal pure returns (uint256) {
                      uint256 c = a + b;
                      assert(c >= a);
                      return c;
                  }
              }
              
              /**
               * @title Ownable
               * @dev The Ownable contract has an owner address, and provides basic authorization control
               * functions, this simplifies the implementation of "user permissions".
               */
              contract Ownable {
                  address public owner;
              
                  /**
                    * @dev The Ownable constructor sets the original `owner` of the contract to the sender
                    * account.
                    */
                  function Ownable() public {
                      owner = msg.sender;
                  }
              
                  /**
                    * @dev Throws if called by any account other than the owner.
                    */
                  modifier onlyOwner() {
                      require(msg.sender == owner);
                      _;
                  }
              
                  /**
                  * @dev Allows the current owner to transfer control of the contract to a newOwner.
                  * @param newOwner The address to transfer ownership to.
                  */
                  function transferOwnership(address newOwner) public onlyOwner {
                      if (newOwner != address(0)) {
                          owner = newOwner;
                      }
                  }
              
              }
              
              /**
               * @title ERC20Basic
               * @dev Simpler version of ERC20 interface
               * @dev see https://github.com/ethereum/EIPs/issues/20
               */
              contract ERC20Basic {
                  uint public _totalSupply;
                  function totalSupply() public constant returns (uint);
                  function balanceOf(address who) public constant returns (uint);
                  function transfer(address to, uint value) public;
                  event Transfer(address indexed from, address indexed to, uint value);
              }
              
              /**
               * @title ERC20 interface
               * @dev see https://github.com/ethereum/EIPs/issues/20
               */
              contract ERC20 is ERC20Basic {
                  function allowance(address owner, address spender) public constant returns (uint);
                  function transferFrom(address from, address to, uint value) public;
                  function approve(address spender, uint value) public;
                  event Approval(address indexed owner, address indexed spender, uint value);
              }
              
              /**
               * @title Basic token
               * @dev Basic version of StandardToken, with no allowances.
               */
              contract BasicToken is Ownable, ERC20Basic {
                  using SafeMath for uint;
              
                  mapping(address => uint) public balances;
              
                  // additional variables for use if transaction fees ever became necessary
                  uint public basisPointsRate = 0;
                  uint public maximumFee = 0;
              
                  /**
                  * @dev Fix for the ERC20 short address attack.
                  */
                  modifier onlyPayloadSize(uint size) {
                      require(!(msg.data.length < size + 4));
                      _;
                  }
              
                  /**
                  * @dev transfer token for a specified address
                  * @param _to The address to transfer to.
                  * @param _value The amount to be transferred.
                  */
                  function transfer(address _to, uint _value) public onlyPayloadSize(2 * 32) {
                      uint fee = (_value.mul(basisPointsRate)).div(10000);
                      if (fee > maximumFee) {
                          fee = maximumFee;
                      }
                      uint sendAmount = _value.sub(fee);
                      balances[msg.sender] = balances[msg.sender].sub(_value);
                      balances[_to] = balances[_to].add(sendAmount);
                      if (fee > 0) {
                          balances[owner] = balances[owner].add(fee);
                          Transfer(msg.sender, owner, fee);
                      }
                      Transfer(msg.sender, _to, sendAmount);
                  }
              
                  /**
                  * @dev Gets the balance of the specified address.
                  * @param _owner The address to query the the balance of.
                  * @return An uint representing the amount owned by the passed address.
                  */
                  function balanceOf(address _owner) public constant returns (uint balance) {
                      return balances[_owner];
                  }
              
              }
              
              /**
               * @title Standard ERC20 token
               *
               * @dev Implementation of the basic standard token.
               * @dev https://github.com/ethereum/EIPs/issues/20
               * @dev Based oncode by FirstBlood: https://github.com/Firstbloodio/token/blob/master/smart_contract/FirstBloodToken.sol
               */
              contract StandardToken is BasicToken, ERC20 {
              
                  mapping (address => mapping (address => uint)) public allowed;
              
                  uint public constant MAX_UINT = 2**256 - 1;
              
                  /**
                  * @dev Transfer tokens from one address to another
                  * @param _from address The address which you want to send tokens from
                  * @param _to address The address which you want to transfer to
                  * @param _value uint the amount of tokens to be transferred
                  */
                  function transferFrom(address _from, address _to, uint _value) public onlyPayloadSize(3 * 32) {
                      var _allowance = allowed[_from][msg.sender];
              
                      // Check is not needed because sub(_allowance, _value) will already throw if this condition is not met
                      // if (_value > _allowance) throw;
              
                      uint fee = (_value.mul(basisPointsRate)).div(10000);
                      if (fee > maximumFee) {
                          fee = maximumFee;
                      }
                      if (_allowance < MAX_UINT) {
                          allowed[_from][msg.sender] = _allowance.sub(_value);
                      }
                      uint sendAmount = _value.sub(fee);
                      balances[_from] = balances[_from].sub(_value);
                      balances[_to] = balances[_to].add(sendAmount);
                      if (fee > 0) {
                          balances[owner] = balances[owner].add(fee);
                          Transfer(_from, owner, fee);
                      }
                      Transfer(_from, _to, sendAmount);
                  }
              
                  /**
                  * @dev Approve the passed address to spend the specified amount of tokens on behalf of msg.sender.
                  * @param _spender The address which will spend the funds.
                  * @param _value The amount of tokens to be spent.
                  */
                  function approve(address _spender, uint _value) public onlyPayloadSize(2 * 32) {
              
                      // To change the approve amount you first have to reduce the addresses`
                      //  allowance to zero by calling `approve(_spender, 0)` if it is not
                      //  already 0 to mitigate the race condition described here:
                      //  https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                      require(!((_value != 0) && (allowed[msg.sender][_spender] != 0)));
              
                      allowed[msg.sender][_spender] = _value;
                      Approval(msg.sender, _spender, _value);
                  }
              
                  /**
                  * @dev Function to check the amount of tokens than an owner allowed to a spender.
                  * @param _owner address The address which owns the funds.
                  * @param _spender address The address which will spend the funds.
                  * @return A uint specifying the amount of tokens still available for the spender.
                  */
                  function allowance(address _owner, address _spender) public constant returns (uint remaining) {
                      return allowed[_owner][_spender];
                  }
              
              }
              
              
              /**
               * @title Pausable
               * @dev Base contract which allows children to implement an emergency stop mechanism.
               */
              contract Pausable is Ownable {
                event Pause();
                event Unpause();
              
                bool public paused = false;
              
              
                /**
                 * @dev Modifier to make a function callable only when the contract is not paused.
                 */
                modifier whenNotPaused() {
                  require(!paused);
                  _;
                }
              
                /**
                 * @dev Modifier to make a function callable only when the contract is paused.
                 */
                modifier whenPaused() {
                  require(paused);
                  _;
                }
              
                /**
                 * @dev called by the owner to pause, triggers stopped state
                 */
                function pause() onlyOwner whenNotPaused public {
                  paused = true;
                  Pause();
                }
              
                /**
                 * @dev called by the owner to unpause, returns to normal state
                 */
                function unpause() onlyOwner whenPaused public {
                  paused = false;
                  Unpause();
                }
              }
              
              contract BlackList is Ownable, BasicToken {
              
                  /////// Getters to allow the same blacklist to be used also by other contracts (including upgraded Tether) ///////
                  function getBlackListStatus(address _maker) external constant returns (bool) {
                      return isBlackListed[_maker];
                  }
              
                  function getOwner() external constant returns (address) {
                      return owner;
                  }
              
                  mapping (address => bool) public isBlackListed;
                  
                  function addBlackList (address _evilUser) public onlyOwner {
                      isBlackListed[_evilUser] = true;
                      AddedBlackList(_evilUser);
                  }
              
                  function removeBlackList (address _clearedUser) public onlyOwner {
                      isBlackListed[_clearedUser] = false;
                      RemovedBlackList(_clearedUser);
                  }
              
                  function destroyBlackFunds (address _blackListedUser) public onlyOwner {
                      require(isBlackListed[_blackListedUser]);
                      uint dirtyFunds = balanceOf(_blackListedUser);
                      balances[_blackListedUser] = 0;
                      _totalSupply -= dirtyFunds;
                      DestroyedBlackFunds(_blackListedUser, dirtyFunds);
                  }
              
                  event DestroyedBlackFunds(address _blackListedUser, uint _balance);
              
                  event AddedBlackList(address _user);
              
                  event RemovedBlackList(address _user);
              
              }
              
              contract UpgradedStandardToken is StandardToken{
                  // those methods are called by the legacy contract
                  // and they must ensure msg.sender to be the contract address
                  function transferByLegacy(address from, address to, uint value) public;
                  function transferFromByLegacy(address sender, address from, address spender, uint value) public;
                  function approveByLegacy(address from, address spender, uint value) public;
              }
              
              contract TetherToken is Pausable, StandardToken, BlackList {
              
                  string public name;
                  string public symbol;
                  uint public decimals;
                  address public upgradedAddress;
                  bool public deprecated;
              
                  //  The contract can be initialized with a number of tokens
                  //  All the tokens are deposited to the owner address
                  //
                  // @param _balance Initial supply of the contract
                  // @param _name Token Name
                  // @param _symbol Token symbol
                  // @param _decimals Token decimals
                  function TetherToken(uint _initialSupply, string _name, string _symbol, uint _decimals) public {
                      _totalSupply = _initialSupply;
                      name = _name;
                      symbol = _symbol;
                      decimals = _decimals;
                      balances[owner] = _initialSupply;
                      deprecated = false;
                  }
              
                  // Forward ERC20 methods to upgraded contract if this one is deprecated
                  function transfer(address _to, uint _value) public whenNotPaused {
                      require(!isBlackListed[msg.sender]);
                      if (deprecated) {
                          return UpgradedStandardToken(upgradedAddress).transferByLegacy(msg.sender, _to, _value);
                      } else {
                          return super.transfer(_to, _value);
                      }
                  }
              
                  // Forward ERC20 methods to upgraded contract if this one is deprecated
                  function transferFrom(address _from, address _to, uint _value) public whenNotPaused {
                      require(!isBlackListed[_from]);
                      if (deprecated) {
                          return UpgradedStandardToken(upgradedAddress).transferFromByLegacy(msg.sender, _from, _to, _value);
                      } else {
                          return super.transferFrom(_from, _to, _value);
                      }
                  }
              
                  // Forward ERC20 methods to upgraded contract if this one is deprecated
                  function balanceOf(address who) public constant returns (uint) {
                      if (deprecated) {
                          return UpgradedStandardToken(upgradedAddress).balanceOf(who);
                      } else {
                          return super.balanceOf(who);
                      }
                  }
              
                  // Forward ERC20 methods to upgraded contract if this one is deprecated
                  function approve(address _spender, uint _value) public onlyPayloadSize(2 * 32) {
                      if (deprecated) {
                          return UpgradedStandardToken(upgradedAddress).approveByLegacy(msg.sender, _spender, _value);
                      } else {
                          return super.approve(_spender, _value);
                      }
                  }
              
                  // Forward ERC20 methods to upgraded contract if this one is deprecated
                  function allowance(address _owner, address _spender) public constant returns (uint remaining) {
                      if (deprecated) {
                          return StandardToken(upgradedAddress).allowance(_owner, _spender);
                      } else {
                          return super.allowance(_owner, _spender);
                      }
                  }
              
                  // deprecate current contract in favour of a new one
                  function deprecate(address _upgradedAddress) public onlyOwner {
                      deprecated = true;
                      upgradedAddress = _upgradedAddress;
                      Deprecate(_upgradedAddress);
                  }
              
                  // deprecate current contract if favour of a new one
                  function totalSupply() public constant returns (uint) {
                      if (deprecated) {
                          return StandardToken(upgradedAddress).totalSupply();
                      } else {
                          return _totalSupply;
                      }
                  }
              
                  // Issue a new amount of tokens
                  // these tokens are deposited into the owner address
                  //
                  // @param _amount Number of tokens to be issued
                  function issue(uint amount) public onlyOwner {
                      require(_totalSupply + amount > _totalSupply);
                      require(balances[owner] + amount > balances[owner]);
              
                      balances[owner] += amount;
                      _totalSupply += amount;
                      Issue(amount);
                  }
              
                  // Redeem tokens.
                  // These tokens are withdrawn from the owner address
                  // if the balance must be enough to cover the redeem
                  // or the call will fail.
                  // @param _amount Number of tokens to be issued
                  function redeem(uint amount) public onlyOwner {
                      require(_totalSupply >= amount);
                      require(balances[owner] >= amount);
              
                      _totalSupply -= amount;
                      balances[owner] -= amount;
                      Redeem(amount);
                  }
              
                  function setParams(uint newBasisPoints, uint newMaxFee) public onlyOwner {
                      // Ensure transparency by hardcoding limit beyond which fees can never be added
                      require(newBasisPoints < 20);
                      require(newMaxFee < 50);
              
                      basisPointsRate = newBasisPoints;
                      maximumFee = newMaxFee.mul(10**decimals);
              
                      Params(basisPointsRate, maximumFee);
                  }
              
                  // Called when new token are issued
                  event Issue(uint amount);
              
                  // Called when tokens are redeemed
                  event Redeem(uint amount);
              
                  // Called when contract is deprecated
                  event Deprecate(address newAddress);
              
                  // Called if contract ever adds fees
                  event Params(uint feeBasisPoints, uint maxFee);
              }

              File 4 of 4: PikaMoon
              // SPDX-License-Identifier: UNLICENSED
              
              pragma solidity 0.8.20;
              
              /**
               * @dev This smart contract defines custom errors that can be thrown during specific conditions in contracts.
               */
              
              library CommanErrors {
                  error ZeroAmount();
                  error ZeroAddress();
                  error WrongTax();
                  error PairIsAlreadyGivenValue();
              }
              
              // File: @openzeppelin/contracts/utils/StorageSlot.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (utils/StorageSlot.sol)
              // This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
              
              pragma solidity ^0.8.20;
              
              /**
               * @dev Library for reading and writing primitive types to specific storage slots.
               *
               * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
               * This library helps with reading and writing to such slots without the need for inline assembly.
               *
               * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
               *
               * Example usage to set ERC1967 implementation slot:
               * ```solidity
               * contract ERC1967 {
               *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
               *
               *     function _getImplementation() internal view returns (address) {
               *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
               *     }
               *
               *     function _setImplementation(address newImplementation) internal {
               *         require(newImplementation.code.length > 0);
               *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
               *     }
               * }
               * ```
               */
              library StorageSlot {
                  struct AddressSlot {
                      address value;
                  }
              
                  struct BooleanSlot {
                      bool value;
                  }
              
                  struct Bytes32Slot {
                      bytes32 value;
                  }
              
                  struct Uint256Slot {
                      uint256 value;
                  }
              
                  struct StringSlot {
                      string value;
                  }
              
                  struct BytesSlot {
                      bytes value;
                  }
              
                  /**
                   * @dev Returns an `AddressSlot` with member `value` located at `slot`.
                   */
                  function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
              
                  /**
                   * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
                   */
                  function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
              
                  /**
                   * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
                   */
                  function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
              
                  /**
                   * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
                   */
                  function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
              
                  /**
                   * @dev Returns an `StringSlot` with member `value` located at `slot`.
                   */
                  function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
              
                  /**
                   * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
                   */
                  function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := store.slot
                      }
                  }
              
                  /**
                   * @dev Returns an `BytesSlot` with member `value` located at `slot`.
                   */
                  function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
              
                  /**
                   * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
                   */
                  function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := store.slot
                      }
                  }
              }
              
              // File: @openzeppelin/contracts/utils/Address.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol)
              
              pragma solidity ^0.8.20;
              
              /**
               * @dev Collection of functions related to the address type
               */
              library Address {
                  /**
                   * @dev The ETH balance of the account is not enough to perform the operation.
                   */
                  error AddressInsufficientBalance(address account);
              
                  /**
                   * @dev There's no code at `target` (it is not a contract).
                   */
                  error AddressEmptyCode(address target);
              
                  /**
                   * @dev A call to an address target failed. The target may have reverted.
                   */
                  error FailedInnerCall();
              
                  /**
                   * @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.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                   */
                  function sendValue(address payable recipient, uint256 amount) internal {
                      if (address(this).balance < amount) {
                          revert AddressInsufficientBalance(address(this));
                      }
              
                      (bool success, ) = recipient.call{value: amount}("");
                      if (!success) {
                          revert FailedInnerCall();
                      }
                  }
              
                  /**
                   * @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 or custom error, it is bubbled
                   * up by this function (like regular Solidity function calls). However, if
                   * the call reverted with no returned reason, this function reverts with a
                   * {FailedInnerCall} error.
                   *
                   * 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.
                   */
                  function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                      return functionCallWithValue(target, data, 0);
                  }
              
                  /**
                   * @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`.
                   */
                  function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                      if (address(this).balance < value) {
                          revert AddressInsufficientBalance(address(this));
                      }
                      (bool success, bytes memory returndata) = target.call{value: value}(data);
                      return verifyCallResultFromTarget(target, success, returndata);
                  }
              
                  /**
                   * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                   * but performing a static call.
                   */
                  function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                      (bool success, bytes memory returndata) = target.staticcall(data);
                      return verifyCallResultFromTarget(target, success, returndata);
                  }
              
                  /**
                   * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                   * but performing a delegate call.
                   */
                  function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                      (bool success, bytes memory returndata) = target.delegatecall(data);
                      return verifyCallResultFromTarget(target, success, returndata);
                  }
              
                  /**
                   * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target
                   * was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an
                   * unsuccessful call.
                   */
                  function verifyCallResultFromTarget(
                      address target,
                      bool success,
                      bytes memory returndata
                  ) internal view returns (bytes memory) {
                      if (!success) {
                          _revert(returndata);
                      } else {
                          // only check if target is a contract if the call was successful and the return data is empty
                          // otherwise we already know that it was a contract
                          if (returndata.length == 0 && target.code.length == 0) {
                              revert AddressEmptyCode(target);
                          }
                          return returndata;
                      }
                  }
              
                  /**
                   * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the
                   * revert reason or with a default {FailedInnerCall} error.
                   */
                  function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) {
                      if (!success) {
                          _revert(returndata);
                      } else {
                          return returndata;
                      }
                  }
              
                  /**
                   * @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}.
                   */
                  function _revert(bytes memory returndata) 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 FailedInnerCall();
                      }
                  }
              }
              
              // File: @openzeppelin/contracts/proxy/beacon/IBeacon.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/beacon/IBeacon.sol)
              
              pragma solidity ^0.8.20;
              
              /**
               * @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.
                   *
                   * {UpgradeableBeacon} will check that this address is a contract.
                   */
                  function implementation() external view returns (address);
              }
              
              // File: @openzeppelin/contracts/proxy/ERC1967/ERC1967Utils.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/ERC1967/ERC1967Utils.sol)
              
              pragma solidity ^0.8.20;
              
              
              
              
              /**
               * @dev This abstract contract provides getters and event emitting update functions for
               * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
               */
              library ERC1967Utils {
                  // We re-declare ERC-1967 events here because they can't be used directly from IERC1967.
                  // This will be fixed in Solidity 0.8.21. At that point we should remove these events.
                  /**
                   * @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);
              
                  /**
                   * @dev Storage slot with the address of the current implementation.
                   * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1.
                   */
                  // solhint-disable-next-line private-vars-leading-underscore
                  bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
              
                  /**
                   * @dev The `implementation` of the proxy is invalid.
                   */
                  error ERC1967InvalidImplementation(address implementation);
              
                  /**
                   * @dev The `admin` of the proxy is invalid.
                   */
                  error ERC1967InvalidAdmin(address admin);
              
                  /**
                   * @dev The `beacon` of the proxy is invalid.
                   */
                  error ERC1967InvalidBeacon(address beacon);
              
                  /**
                   * @dev An upgrade function sees `msg.value > 0` that may be lost.
                   */
                  error ERC1967NonPayable();
              
                  /**
                   * @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 {
                      if (newImplementation.code.length == 0) {
                          revert ERC1967InvalidImplementation(newImplementation);
                      }
                      StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value = newImplementation;
                  }
              
                  /**
                   * @dev Performs implementation upgrade with additional setup call if data is nonempty.
                   * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
                   * to avoid stuck value in the contract.
                   *
                   * Emits an {IERC1967-Upgraded} event.
                   */
                  function upgradeToAndCall(address newImplementation, bytes memory data) internal {
                      _setImplementation(newImplementation);
                      emit Upgraded(newImplementation);
              
                      if (data.length > 0) {
                          Address.functionDelegateCall(newImplementation, data);
                      } else {
                          _checkNonPayable();
                      }
                  }
              
                  /**
                   * @dev Storage slot with the admin of the contract.
                   * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1.
                   */
                  // solhint-disable-next-line private-vars-leading-underscore
                  bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
              
                  /**
                   * @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 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 {
                      if (newAdmin == address(0)) {
                          revert ERC1967InvalidAdmin(address(0));
                      }
                      StorageSlot.getAddressSlot(ADMIN_SLOT).value = newAdmin;
                  }
              
                  /**
                   * @dev Changes the admin of the proxy.
                   *
                   * Emits an {IERC1967-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 the keccak-256 hash of "eip1967.proxy.beacon" subtracted by 1.
                   */
                  // solhint-disable-next-line private-vars-leading-underscore
                  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 {
                      if (newBeacon.code.length == 0) {
                          revert ERC1967InvalidBeacon(newBeacon);
                      }
              
                      StorageSlot.getAddressSlot(BEACON_SLOT).value = newBeacon;
              
                      address beaconImplementation = IBeacon(newBeacon).implementation();
                      if (beaconImplementation.code.length == 0) {
                          revert ERC1967InvalidImplementation(beaconImplementation);
                      }
                  }
              
                  /**
                   * @dev Change the beacon and trigger a setup call if data is nonempty.
                   * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
                   * to avoid stuck value in the contract.
                   *
                   * Emits an {IERC1967-BeaconUpgraded} event.
                   *
                   * CAUTION: Invoking this function has no effect on an instance of {BeaconProxy} since v5, since
                   * it uses an immutable beacon without looking at the value of the ERC-1967 beacon slot for
                   * efficiency.
                   */
                  function upgradeBeaconToAndCall(address newBeacon, bytes memory data) internal {
                      _setBeacon(newBeacon);
                      emit BeaconUpgraded(newBeacon);
              
                      if (data.length > 0) {
                          Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                      } else {
                          _checkNonPayable();
                      }
                  }
              
                  /**
                   * @dev Reverts if `msg.value` is not zero. It can be used to avoid `msg.value` stuck in the contract
                   * if an upgrade doesn't perform an initialization call.
                   */
                  function _checkNonPayable() private {
                      if (msg.value > 0) {
                          revert ERC1967NonPayable();
                      }
                  }
              }
              
              // File: @openzeppelin/contracts/interfaces/draft-IERC1822.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC1822.sol)
              
              pragma solidity ^0.8.20;
              
              /**
               * @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);
              }
              
              // File: @openzeppelin/contracts/utils/introspection/IERC165.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/IERC165.sol)
              
              pragma solidity ^0.8.20;
              
              /**
               * @dev Interface of the ERC165 standard, as defined in the
               * https://eips.ethereum.org/EIPS/eip-165[EIP].
               *
               * Implementers can declare support of contract interfaces, which can then be
               * queried by others ({ERC165Checker}).
               *
               * For an implementation, see {ERC165}.
               */
              interface IERC165 {
                  /**
                   * @dev Returns true if this contract implements the interface defined by
                   * `interfaceId`. See the corresponding
                   * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
                   * to learn more about how these ids are created.
                   *
                   * This function call must use less than 30 000 gas.
                   */
                  function supportsInterface(bytes4 interfaceId) external view returns (bool);
              }
              
              // File: @openzeppelin/contracts/access/IAccessControl.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (access/IAccessControl.sol)
              
              pragma solidity ^0.8.20;
              
              /**
               * @dev External interface of AccessControl declared to support ERC165 detection.
               */
              interface IAccessControl {
                  /**
                   * @dev The `account` is missing a role.
                   */
                  error AccessControlUnauthorizedAccount(address account, bytes32 neededRole);
              
                  /**
                   * @dev The caller of a function is not the expected one.
                   *
                   * NOTE: Don't confuse with {AccessControlUnauthorizedAccount}.
                   */
                  error AccessControlBadConfirmation();
              
                  /**
                   * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
                   *
                   * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
                   * {RoleAdminChanged} not being emitted signaling this.
                   */
                  event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
              
                  /**
                   * @dev Emitted when `account` is granted `role`.
                   *
                   * `sender` is the account that originated the contract call, an admin role
                   * bearer except when using {AccessControl-_setupRole}.
                   */
                  event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);
              
                  /**
                   * @dev Emitted when `account` is revoked `role`.
                   *
                   * `sender` is the account that originated the contract call:
                   *   - if using `revokeRole`, it is the admin role bearer
                   *   - if using `renounceRole`, it is the role bearer (i.e. `account`)
                   */
                  event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);
              
                  /**
                   * @dev Returns `true` if `account` has been granted `role`.
                   */
                  function hasRole(bytes32 role, address account) external view returns (bool);
              
                  /**
                   * @dev Returns the admin role that controls `role`. See {grantRole} and
                   * {revokeRole}.
                   *
                   * To change a role's admin, use {AccessControl-_setRoleAdmin}.
                   */
                  function getRoleAdmin(bytes32 role) external view returns (bytes32);
              
                  /**
                   * @dev Grants `role` to `account`.
                   *
                   * If `account` had not been already granted `role`, emits a {RoleGranted}
                   * event.
                   *
                   * Requirements:
                   *
                   * - the caller must have ``role``'s admin role.
                   */
                  function grantRole(bytes32 role, address account) external;
              
                  /**
                   * @dev Revokes `role` from `account`.
                   *
                   * If `account` had been granted `role`, emits a {RoleRevoked} event.
                   *
                   * Requirements:
                   *
                   * - the caller must have ``role``'s admin role.
                   */
                  function revokeRole(bytes32 role, address account) external;
              
                  /**
                   * @dev Revokes `role` from the calling account.
                   *
                   * Roles are often managed via {grantRole} and {revokeRole}: this function's
                   * purpose is to provide a mechanism for accounts to lose their privileges
                   * if they are compromised (such as when a trusted device is misplaced).
                   *
                   * If the calling account had been granted `role`, emits a {RoleRevoked}
                   * event.
                   *
                   * Requirements:
                   *
                   * - the caller must be `callerConfirmation`.
                   */
                  function renounceRole(bytes32 role, address callerConfirmation) external;
              }
              
              // File: @openzeppelin/contracts/interfaces/draft-IERC6093.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol)
              pragma solidity ^0.8.20;
              
              /**
               * @dev Standard ERC20 Errors
               * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens.
               */
              interface IERC20Errors {
                  /**
                   * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
                   * @param sender Address whose tokens are being transferred.
                   * @param balance Current balance for the interacting account.
                   * @param needed Minimum amount required to perform a transfer.
                   */
                  error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);
              
                  /**
                   * @dev Indicates a failure with the token `sender`. Used in transfers.
                   * @param sender Address whose tokens are being transferred.
                   */
                  error ERC20InvalidSender(address sender);
              
                  /**
                   * @dev Indicates a failure with the token `receiver`. Used in transfers.
                   * @param receiver Address to which tokens are being transferred.
                   */
                  error ERC20InvalidReceiver(address receiver);
              
                  /**
                   * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers.
                   * @param spender Address that may be allowed to operate on tokens without being their owner.
                   * @param allowance Amount of tokens a `spender` is allowed to operate with.
                   * @param needed Minimum amount required to perform a transfer.
                   */
                  error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);
              
                  /**
                   * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
                   * @param approver Address initiating an approval operation.
                   */
                  error ERC20InvalidApprover(address approver);
              
                  /**
                   * @dev Indicates a failure with the `spender` to be approved. Used in approvals.
                   * @param spender Address that may be allowed to operate on tokens without being their owner.
                   */
                  error ERC20InvalidSpender(address spender);
              }
              
              /**
               * @dev Standard ERC721 Errors
               * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens.
               */
              interface IERC721Errors {
                  /**
                   * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20.
                   * Used in balance queries.
                   * @param owner Address of the current owner of a token.
                   */
                  error ERC721InvalidOwner(address owner);
              
                  /**
                   * @dev Indicates a `tokenId` whose `owner` is the zero address.
                   * @param tokenId Identifier number of a token.
                   */
                  error ERC721NonexistentToken(uint256 tokenId);
              
                  /**
                   * @dev Indicates an error related to the ownership over a particular token. Used in transfers.
                   * @param sender Address whose tokens are being transferred.
                   * @param tokenId Identifier number of a token.
                   * @param owner Address of the current owner of a token.
                   */
                  error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner);
              
                  /**
                   * @dev Indicates a failure with the token `sender`. Used in transfers.
                   * @param sender Address whose tokens are being transferred.
                   */
                  error ERC721InvalidSender(address sender);
              
                  /**
                   * @dev Indicates a failure with the token `receiver`. Used in transfers.
                   * @param receiver Address to which tokens are being transferred.
                   */
                  error ERC721InvalidReceiver(address receiver);
              
                  /**
                   * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
                   * @param operator Address that may be allowed to operate on tokens without being their owner.
                   * @param tokenId Identifier number of a token.
                   */
                  error ERC721InsufficientApproval(address operator, uint256 tokenId);
              
                  /**
                   * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
                   * @param approver Address initiating an approval operation.
                   */
                  error ERC721InvalidApprover(address approver);
              
                  /**
                   * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
                   * @param operator Address that may be allowed to operate on tokens without being their owner.
                   */
                  error ERC721InvalidOperator(address operator);
              }
              
              /**
               * @dev Standard ERC1155 Errors
               * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens.
               */
              interface IERC1155Errors {
                  /**
                   * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
                   * @param sender Address whose tokens are being transferred.
                   * @param balance Current balance for the interacting account.
                   * @param needed Minimum amount required to perform a transfer.
                   * @param tokenId Identifier number of a token.
                   */
                  error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);
              
                  /**
                   * @dev Indicates a failure with the token `sender`. Used in transfers.
                   * @param sender Address whose tokens are being transferred.
                   */
                  error ERC1155InvalidSender(address sender);
              
                  /**
                   * @dev Indicates a failure with the token `receiver`. Used in transfers.
                   * @param receiver Address to which tokens are being transferred.
                   */
                  error ERC1155InvalidReceiver(address receiver);
              
                  /**
                   * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
                   * @param operator Address that may be allowed to operate on tokens without being their owner.
                   * @param owner Address of the current owner of a token.
                   */
                  error ERC1155MissingApprovalForAll(address operator, address owner);
              
                  /**
                   * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
                   * @param approver Address initiating an approval operation.
                   */
                  error ERC1155InvalidApprover(address approver);
              
                  /**
                   * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
                   * @param operator Address that may be allowed to operate on tokens without being their owner.
                   */
                  error ERC1155InvalidOperator(address operator);
              
                  /**
                   * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation.
                   * Used in batch transfers.
                   * @param idsLength Length of the array of token identifiers
                   * @param valuesLength Length of the array of token amounts
                   */
                  error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);
              }
              
              // File: @openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/Initializable.sol)
              
              pragma solidity ^0.8.20;
              
              /**
               * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
               * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
               * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
               * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
               *
               * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
               * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
               * case an upgrade adds a module that needs to be initialized.
               *
               * For example:
               *
               * [.hljs-theme-light.nopadding]
               * ```solidity
               * contract MyToken is ERC20Upgradeable {
               *     function initialize() initializer public {
               *         __ERC20_init("MyToken", "MTK");
               *     }
               * }
               *
               * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
               *     function initializeV2() reinitializer(2) public {
               *         __ERC20Permit_init("MyToken");
               *     }
               * }
               * ```
               *
               * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
               * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
               *
               * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
               * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
               *
               * [CAUTION]
               * ====
               * Avoid leaving a contract uninitialized.
               *
               * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
               * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
               * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
               *
               * [.hljs-theme-light.nopadding]
               * ```
               * /// @custom:oz-upgrades-unsafe-allow constructor
               * constructor() {
               *     _disableInitializers();
               * }
               * ```
               * ====
               */
              abstract contract Initializable {
                  /**
                   * @dev Storage of the initializable contract.
                   *
                   * It's implemented on a custom ERC-7201 namespace to reduce the risk of storage collisions
                   * when using with upgradeable contracts.
                   *
                   * @custom:storage-location erc7201:openzeppelin.storage.Initializable
                   */
                  struct InitializableStorage {
                      /**
                       * @dev Indicates that the contract has been initialized.
                       */
                      uint64 _initialized;
                      /**
                       * @dev Indicates that the contract is in the process of being initialized.
                       */
                      bool _initializing;
                  }
              
                  // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Initializable")) - 1)) & ~bytes32(uint256(0xff))
                  bytes32 private constant INITIALIZABLE_STORAGE = 0xf0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00;
              
                  /**
                   * @dev The contract is already initialized.
                   */
                  error InvalidInitialization();
              
                  /**
                   * @dev The contract is not initializing.
                   */
                  error NotInitializing();
              
                  /**
                   * @dev Triggered when the contract has been initialized or reinitialized.
                   */
                  event Initialized(uint64 version);
              
                  /**
                   * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
                   * `onlyInitializing` functions can be used to initialize parent contracts.
                   *
                   * Similar to `reinitializer(1)`, except that in the context of a constructor an `initializer` may be invoked any
                   * number of times. This behavior in the constructor can be useful during testing and is not expected to be used in
                   * production.
                   *
                   * Emits an {Initialized} event.
                   */
                  modifier initializer() {
                      // solhint-disable-next-line var-name-mixedcase
                      InitializableStorage storage $ = _getInitializableStorage();
              
                      // Cache values to avoid duplicated sloads
                      bool isTopLevelCall = !$._initializing;
                      uint64 initialized = $._initialized;
              
                      // Allowed calls:
                      // - initialSetup: the contract is not in the initializing state and no previous version was
                      //                 initialized
                      // - construction: the contract is initialized at version 1 (no reininitialization) and the
                      //                 current contract is just being deployed
                      bool initialSetup = initialized == 0 && isTopLevelCall;
                      bool construction = initialized == 1 && address(this).code.length == 0;
              
                      if (!initialSetup && !construction) {
                          revert InvalidInitialization();
                      }
                      $._initialized = 1;
                      if (isTopLevelCall) {
                          $._initializing = true;
                      }
                      _;
                      if (isTopLevelCall) {
                          $._initializing = false;
                          emit Initialized(1);
                      }
                  }
              
                  /**
                   * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
                   * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
                   * used to initialize parent contracts.
                   *
                   * A reinitializer may be used after the original initialization step. This is essential to configure modules that
                   * are added through upgrades and that require initialization.
                   *
                   * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
                   * cannot be nested. If one is invoked in the context of another, execution will revert.
                   *
                   * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
                   * a contract, executing them in the right order is up to the developer or operator.
                   *
                   * WARNING: Setting the version to 2**64 - 1 will prevent any future reinitialization.
                   *
                   * Emits an {Initialized} event.
                   */
                  modifier reinitializer(uint64 version) {
                      // solhint-disable-next-line var-name-mixedcase
                      InitializableStorage storage $ = _getInitializableStorage();
              
                      if ($._initializing || $._initialized >= version) {
                          revert InvalidInitialization();
                      }
                      $._initialized = version;
                      $._initializing = true;
                      _;
                      $._initializing = false;
                      emit Initialized(version);
                  }
              
                  /**
                   * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
                   * {initializer} and {reinitializer} modifiers, directly or indirectly.
                   */
                  modifier onlyInitializing() {
                      _checkInitializing();
                      _;
                  }
              
                  /**
                   * @dev Reverts if the contract is not in an initializing state. See {onlyInitializing}.
                   */
                  function _checkInitializing() internal view virtual {
                      if (!_isInitializing()) {
                          revert NotInitializing();
                      }
                  }
              
                  /**
                   * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
                   * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
                   * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
                   * through proxies.
                   *
                   * Emits an {Initialized} event the first time it is successfully executed.
                   */
                  function _disableInitializers() internal virtual {
                      // solhint-disable-next-line var-name-mixedcase
                      InitializableStorage storage $ = _getInitializableStorage();
              
                      if ($._initializing) {
                          revert InvalidInitialization();
                      }
                      if ($._initialized != type(uint64).max) {
                          $._initialized = type(uint64).max;
                          emit Initialized(type(uint64).max);
                      }
                  }
              
                  /**
                   * @dev Returns the highest version that has been initialized. See {reinitializer}.
                   */
                  function _getInitializedVersion() internal view returns (uint64) {
                      return _getInitializableStorage()._initialized;
                  }
              
                  /**
                   * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
                   */
                  function _isInitializing() internal view returns (bool) {
                      return _getInitializableStorage()._initializing;
                  }
              
                  /**
                   * @dev Returns a pointer to the storage namespace.
                   */
                  // solhint-disable-next-line var-name-mixedcase
                  function _getInitializableStorage() private pure returns (InitializableStorage storage $) {
                      assembly {
                          $.slot := INITIALIZABLE_STORAGE
                      }
                  }
              }
              
              // File: @openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/UUPSUpgradeable.sol)
              
              pragma solidity ^0.8.20;
              
              
              
              
              /**
               * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an
               * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.
               *
               * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is
               * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing
               * `UUPSUpgradeable` with a custom implementation of upgrades.
               *
               * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.
               */
              abstract contract UUPSUpgradeable is Initializable, IERC1822Proxiable {
                  /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
                  address private immutable __self = address(this);
              
                  /**
                   * @dev The version of the upgrade interface of the contract. If this getter is missing, both `upgradeTo(address)`
                   * and `upgradeToAndCall(address,bytes)` are present, and `upgradeTo` must be used if no function should be called,
                   * while `upgradeToAndCall` will invoke the `receive` function if the second argument is the empty byte string.
                   * If the getter returns `"5.0.0"`, only `upgradeToAndCall(address,bytes)` is present, and the second argument must
                   * be the empty byte string if no function should be called, making it impossible to invoke the `receive` function
                   * during an upgrade.
                   */
                  string public constant UPGRADE_INTERFACE_VERSION = "5.0.0";
              
                  /**
                   * @dev The call is from an unauthorized context.
                   */
                  error UUPSUnauthorizedCallContext();
              
                  /**
                   * @dev The storage `slot` is unsupported as a UUID.
                   */
                  error UUPSUnsupportedProxiableUUID(bytes32 slot);
              
                  /**
                   * @dev Check that the execution is being performed through a delegatecall call and that the execution context is
                   * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case
                   * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a
                   * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to
                   * fail.
                   */
                  modifier onlyProxy() {
                      _checkProxy();
                      _;
                  }
              
                  /**
                   * @dev Check that the execution is not being performed through a delegate call. This allows a function to be
                   * callable on the implementing contract but not through proxies.
                   */
                  modifier notDelegated() {
                      _checkNotDelegated();
                      _;
                  }
              
                  function __UUPSUpgradeable_init() internal onlyInitializing {
                  }
              
                  function __UUPSUpgradeable_init_unchained() internal onlyInitializing {
                  }
                  /**
                   * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the
                   * implementation. It is used to validate the implementation's compatibility when performing an upgrade.
                   *
                   * 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. This is guaranteed by the `notDelegated` modifier.
                   */
                  function proxiableUUID() external view virtual notDelegated returns (bytes32) {
                      return ERC1967Utils.IMPLEMENTATION_SLOT;
                  }
              
                  /**
                   * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call
                   * encoded in `data`.
                   *
                   * Calls {_authorizeUpgrade}.
                   *
                   * Emits an {Upgraded} event.
                   *
                   * @custom:oz-upgrades-unsafe-allow-reachable delegatecall
                   */
                  function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {
                      _authorizeUpgrade(newImplementation);
                      _upgradeToAndCallUUPS(newImplementation, data);
                  }
              
                  /**
                   * @dev Reverts if the execution is not performed via delegatecall or the execution
                   * context is not of a proxy with an ERC1967-compliant implementation pointing to self.
                   * See {_onlyProxy}.
                   */
                  function _checkProxy() internal view virtual {
                      if (
                          address(this) == __self || // Must be called through delegatecall
                          ERC1967Utils.getImplementation() != __self // Must be called through an active proxy
                      ) {
                          revert UUPSUnauthorizedCallContext();
                      }
                  }
              
                  /**
                   * @dev Reverts if the execution is performed via delegatecall.
                   * See {notDelegated}.
                   */
                  function _checkNotDelegated() internal view virtual {
                      if (address(this) != __self) {
                          // Must not be called through delegatecall
                          revert UUPSUnauthorizedCallContext();
                      }
                  }
              
                  /**
                   * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by
                   * {upgradeToAndCall}.
                   *
                   * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.
                   *
                   * ```solidity
                   * function _authorizeUpgrade(address) internal onlyOwner {}
                   * ```
                   */
                  function _authorizeUpgrade(address newImplementation) internal virtual;
              
                  /**
                   * @dev Performs an implementation upgrade with a security check for UUPS proxies, and additional setup call.
                   *
                   * As a security check, {proxiableUUID} is invoked in the new implementation, and the return value
                   * is expected to be the implementation slot in ERC1967.
                   *
                   * Emits an {IERC1967-Upgraded} event.
                   */
                  function _upgradeToAndCallUUPS(address newImplementation, bytes memory data) private {
                      try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
                          if (slot != ERC1967Utils.IMPLEMENTATION_SLOT) {
                              revert UUPSUnsupportedProxiableUUID(slot);
                          }
                          ERC1967Utils.upgradeToAndCall(newImplementation, data);
                      } catch {
                          // The implementation is not UUPS
                          revert ERC1967Utils.ERC1967InvalidImplementation(newImplementation);
                      }
                  }
              }
              
              // File: @openzeppelin/contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/ERC165.sol)
              
              pragma solidity ^0.8.20;
              
              
              
              /**
               * @dev Implementation of the {IERC165} interface.
               *
               * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
               * for the additional interface id that will be supported. For example:
               *
               * ```solidity
               * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
               *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
               * }
               * ```
               */
              abstract contract ERC165Upgradeable is Initializable, IERC165 {
                  function __ERC165_init() internal onlyInitializing {
                  }
              
                  function __ERC165_init_unchained() internal onlyInitializing {
                  }
                  /**
                   * @dev See {IERC165-supportsInterface}.
                   */
                  function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
                      return interfaceId == type(IERC165).interfaceId;
                  }
              }
              
              // File: @openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)
              
              pragma solidity ^0.8.20;
              
              
              /**
               * @dev Provides information about the current execution context, including the
               * sender of the transaction and its data. While these are generally available
               * via msg.sender and msg.data, they should not be accessed in such a direct
               * manner, since when dealing with meta-transactions the account sending and
               * paying for execution may not be the actual sender (as far as an application
               * is concerned).
               *
               * This contract is only required for intermediate, library-like contracts.
               */
              abstract contract ContextUpgradeable is Initializable {
                  function __Context_init() internal onlyInitializing {
                  }
              
                  function __Context_init_unchained() internal onlyInitializing {
                  }
                  function _msgSender() internal view virtual returns (address) {
                      return msg.sender;
                  }
              
                  function _msgData() internal view virtual returns (bytes calldata) {
                      return msg.data;
                  }
              
                  function _contextSuffixLength() internal view virtual returns (uint256) {
                      return 0;
                  }
              }
              
              // File: @openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (access/AccessControl.sol)
              
              pragma solidity ^0.8.20;
              
              
              
              
              
              /**
               * @dev Contract module that allows children to implement role-based access
               * control mechanisms. This is a lightweight version that doesn't allow enumerating role
               * members except through off-chain means by accessing the contract event logs. Some
               * applications may benefit from on-chain enumerability, for those cases see
               * {AccessControlEnumerable}.
               *
               * Roles are referred to by their `bytes32` identifier. These should be exposed
               * in the external API and be unique. The best way to achieve this is by
               * using `public constant` hash digests:
               *
               * ```solidity
               * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
               * ```
               *
               * Roles can be used to represent a set of permissions. To restrict access to a
               * function call, use {hasRole}:
               *
               * ```solidity
               * function foo() public {
               *     require(hasRole(MY_ROLE, msg.sender));
               *     ...
               * }
               * ```
               *
               * Roles can be granted and revoked dynamically via the {grantRole} and
               * {revokeRole} functions. Each role has an associated admin role, and only
               * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
               *
               * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
               * that only accounts with this role will be able to grant or revoke other
               * roles. More complex role relationships can be created by using
               * {_setRoleAdmin}.
               *
               * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
               * grant and revoke this role. Extra precautions should be taken to secure
               * accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules}
               * to enforce additional security measures for this role.
               */
              abstract contract AccessControlUpgradeable is Initializable, ContextUpgradeable, IAccessControl, ERC165Upgradeable {
                  struct RoleData {
                      mapping(address account => bool) hasRole;
                      bytes32 adminRole;
                  }
              
                  bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
              
              
                  /// @custom:storage-location erc7201:openzeppelin.storage.AccessControl
                  struct AccessControlStorage {
                      mapping(bytes32 role => RoleData) _roles;
                  }
              
                  // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.AccessControl")) - 1)) & ~bytes32(uint256(0xff))
                  bytes32 private constant AccessControlStorageLocation = 0x02dd7bc7dec4dceedda775e58dd541e08a116c6c53815c0bd028192f7b626800;
              
                  function _getAccessControlStorage() private pure returns (AccessControlStorage storage $) {
                      assembly {
                          $.slot := AccessControlStorageLocation
                      }
                  }
              
                  /**
                   * @dev Modifier that checks that an account has a specific role. Reverts
                   * with an {AccessControlUnauthorizedAccount} error including the required role.
                   */
                  modifier onlyRole(bytes32 role) {
                      _checkRole(role);
                      _;
                  }
              
                  function __AccessControl_init() internal onlyInitializing {
                  }
              
                  function __AccessControl_init_unchained() internal onlyInitializing {
                  }
                  /**
                   * @dev See {IERC165-supportsInterface}.
                   */
                  function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                      return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);
                  }
              
                  /**
                   * @dev Returns `true` if `account` has been granted `role`.
                   */
                  function hasRole(bytes32 role, address account) public view virtual returns (bool) {
                      AccessControlStorage storage $ = _getAccessControlStorage();
                      return $._roles[role].hasRole[account];
                  }
              
                  /**
                   * @dev Reverts with an {AccessControlUnauthorizedAccount} error if `_msgSender()`
                   * is missing `role`. Overriding this function changes the behavior of the {onlyRole} modifier.
                   */
                  function _checkRole(bytes32 role) internal view virtual {
                      _checkRole(role, _msgSender());
                  }
              
                  /**
                   * @dev Reverts with an {AccessControlUnauthorizedAccount} error if `account`
                   * is missing `role`.
                   */
                  function _checkRole(bytes32 role, address account) internal view virtual {
                      if (!hasRole(role, account)) {
                          revert AccessControlUnauthorizedAccount(account, role);
                      }
                  }
              
                  /**
                   * @dev Returns the admin role that controls `role`. See {grantRole} and
                   * {revokeRole}.
                   *
                   * To change a role's admin, use {_setRoleAdmin}.
                   */
                  function getRoleAdmin(bytes32 role) public view virtual returns (bytes32) {
                      AccessControlStorage storage $ = _getAccessControlStorage();
                      return $._roles[role].adminRole;
                  }
              
                  /**
                   * @dev Grants `role` to `account`.
                   *
                   * If `account` had not been already granted `role`, emits a {RoleGranted}
                   * event.
                   *
                   * Requirements:
                   *
                   * - the caller must have ``role``'s admin role.
                   *
                   * May emit a {RoleGranted} event.
                   */
                  function grantRole(bytes32 role, address account) public virtual onlyRole(getRoleAdmin(role)) {
                      _grantRole(role, account);
                  }
              
                  /**
                   * @dev Revokes `role` from `account`.
                   *
                   * If `account` had been granted `role`, emits a {RoleRevoked} event.
                   *
                   * Requirements:
                   *
                   * - the caller must have ``role``'s admin role.
                   *
                   * May emit a {RoleRevoked} event.
                   */
                  function revokeRole(bytes32 role, address account) public virtual onlyRole(getRoleAdmin(role)) {
                      _revokeRole(role, account);
                  }
              
                  /**
                   * @dev Revokes `role` from the calling account.
                   *
                   * Roles are often managed via {grantRole} and {revokeRole}: this function's
                   * purpose is to provide a mechanism for accounts to lose their privileges
                   * if they are compromised (such as when a trusted device is misplaced).
                   *
                   * If the calling account had been revoked `role`, emits a {RoleRevoked}
                   * event.
                   *
                   * Requirements:
                   *
                   * - the caller must be `callerConfirmation`.
                   *
                   * May emit a {RoleRevoked} event.
                   */
                  function renounceRole(bytes32 role, address callerConfirmation) public virtual {
                      if (callerConfirmation != _msgSender()) {
                          revert AccessControlBadConfirmation();
                      }
              
                      _revokeRole(role, callerConfirmation);
                  }
              
                  /**
                   * @dev Sets `adminRole` as ``role``'s admin role.
                   *
                   * Emits a {RoleAdminChanged} event.
                   */
                  function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
                      AccessControlStorage storage $ = _getAccessControlStorage();
                      bytes32 previousAdminRole = getRoleAdmin(role);
                      $._roles[role].adminRole = adminRole;
                      emit RoleAdminChanged(role, previousAdminRole, adminRole);
                  }
              
                  /**
                   * @dev Attempts to grant `role` to `account` and returns a boolean indicating if `role` was granted.
                   *
                   * Internal function without access restriction.
                   *
                   * May emit a {RoleGranted} event.
                   */
                  function _grantRole(bytes32 role, address account) internal virtual returns (bool) {
                      AccessControlStorage storage $ = _getAccessControlStorage();
                      if (!hasRole(role, account)) {
                          $._roles[role].hasRole[account] = true;
                          emit RoleGranted(role, account, _msgSender());
                          return true;
                      } else {
                          return false;
                      }
                  }
              
                  /**
                   * @dev Attempts to revoke `role` to `account` and returns a boolean indicating if `role` was revoked.
                   *
                   * Internal function without access restriction.
                   *
                   * May emit a {RoleRevoked} event.
                   */
                  function _revokeRole(bytes32 role, address account) internal virtual returns (bool) {
                      AccessControlStorage storage $ = _getAccessControlStorage();
                      if (hasRole(role, account)) {
                          $._roles[role].hasRole[account] = false;
                          emit RoleRevoked(role, account, _msgSender());
                          return true;
                      } else {
                          return false;
                      }
                  }
              }
              
              // File: @openzeppelin/contracts/token/ERC20/IERC20.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/IERC20.sol)
              
              pragma solidity ^0.8.20;
              
              /**
               * @dev Interface of the ERC20 standard as defined in the EIP.
               */
              interface IERC20 {
                  /**
                   * @dev Emitted when `value` tokens are moved from one account (`from`) to
                   * another (`to`).
                   *
                   * Note that `value` may be zero.
                   */
                  event Transfer(address indexed from, address indexed to, uint256 value);
              
                  /**
                   * @dev Emitted when the allowance of a `spender` for an `owner` is set by
                   * a call to {approve}. `value` is the new allowance.
                   */
                  event Approval(address indexed owner, address indexed spender, uint256 value);
              
                  /**
                   * @dev Returns the value of tokens in existence.
                   */
                  function totalSupply() external view returns (uint256);
              
                  /**
                   * @dev Returns the value of tokens owned by `account`.
                   */
                  function balanceOf(address account) external view returns (uint256);
              
                  /**
                   * @dev Moves a `value` amount of tokens from the caller's account to `to`.
                   *
                   * Returns a boolean value indicating whether the operation succeeded.
                   *
                   * Emits a {Transfer} event.
                   */
                  function transfer(address to, uint256 value) external returns (bool);
              
                  /**
                   * @dev Returns the remaining number of tokens that `spender` will be
                   * allowed to spend on behalf of `owner` through {transferFrom}. This is
                   * zero by default.
                   *
                   * This value changes when {approve} or {transferFrom} are called.
                   */
                  function allowance(address owner, address spender) external view returns (uint256);
              
                  /**
                   * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
                   * caller's tokens.
                   *
                   * Returns a boolean value indicating whether the operation succeeded.
                   *
                   * IMPORTANT: Beware that changing an allowance with this method brings the risk
                   * that someone may use both the old and the new allowance by unfortunate
                   * transaction ordering. One possible solution to mitigate this race
                   * condition is to first reduce the spender's allowance to 0 and set the
                   * desired value afterwards:
                   * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                   *
                   * Emits an {Approval} event.
                   */
                  function approve(address spender, uint256 value) external returns (bool);
              
                  /**
                   * @dev Moves a `value` amount of tokens from `from` to `to` using the
                   * allowance mechanism. `value` is then deducted from the caller's
                   * allowance.
                   *
                   * Returns a boolean value indicating whether the operation succeeded.
                   *
                   * Emits a {Transfer} event.
                   */
                  function transferFrom(address from, address to, uint256 value) external returns (bool);
              }
              
              // File: @openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Metadata.sol)
              
              pragma solidity ^0.8.20;
              
              
              /**
               * @dev Interface for the optional metadata functions from the ERC20 standard.
               */
              interface IERC20Metadata is IERC20 {
                  /**
                   * @dev Returns the name of the token.
                   */
                  function name() external view returns (string memory);
              
                  /**
                   * @dev Returns the symbol of the token.
                   */
                  function symbol() external view returns (string memory);
              
                  /**
                   * @dev Returns the decimals places of the token.
                   */
                  function decimals() external view returns (uint8);
              }
              
              // File: @openzeppelin/contracts-upgradeable/token/ERC20/ERC20Upgradeable.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/ERC20.sol)
              
              pragma solidity ^0.8.20;
              
              
              
              
              
              
              /**
               * @dev Implementation of the {IERC20} interface.
               *
               * This implementation is agnostic to the way tokens are created. This means
               * that a supply mechanism has to be added in a derived contract using {_mint}.
               *
               * TIP: For a detailed writeup see our guide
               * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How
               * to implement supply mechanisms].
               *
               * The default value of {decimals} is 18. To change this, you should override
               * this function so it returns a different value.
               *
               * We have followed general OpenZeppelin Contracts guidelines: functions revert
               * instead returning `false` on failure. This behavior is nonetheless
               * conventional and does not conflict with the expectations of ERC20
               * applications.
               *
               * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
               * This allows applications to reconstruct the allowance for all accounts just
               * by listening to said events. Other implementations of the EIP may not emit
               * these events, as it isn't required by the specification.
               */
              abstract contract ERC20Upgradeable is Initializable, ContextUpgradeable, IERC20, IERC20Metadata, IERC20Errors {
                  /// @custom:storage-location erc7201:openzeppelin.storage.ERC20
                  struct ERC20Storage {
                      mapping(address account => uint256) _balances;
              
                      mapping(address account => mapping(address spender => uint256)) _allowances;
              
                      uint256 _totalSupply;
              
                      string _name;
                      string _symbol;
                  }
              
                  // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ERC20")) - 1)) & ~bytes32(uint256(0xff))
                  bytes32 private constant ERC20StorageLocation = 0x52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace00;
              
                  function _getERC20Storage() private pure returns (ERC20Storage storage $) {
                      assembly {
                          $.slot := ERC20StorageLocation
                      }
                  }
              
                  /**
                   * @dev Sets the values for {name} and {symbol}.
                   *
                   * All two of these values are immutable: they can only be set once during
                   * construction.
                   */
                  function __ERC20_init(string memory name_, string memory symbol_) internal onlyInitializing {
                      __ERC20_init_unchained(name_, symbol_);
                  }
              
                  function __ERC20_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
                      ERC20Storage storage $ = _getERC20Storage();
                      $._name = name_;
                      $._symbol = symbol_;
                  }
              
                  /**
                   * @dev Returns the name of the token.
                   */
                  function name() public view virtual returns (string memory) {
                      ERC20Storage storage $ = _getERC20Storage();
                      return $._name;
                  }
              
                  /**
                   * @dev Returns the symbol of the token, usually a shorter version of the
                   * name.
                   */
                  function symbol() public view virtual returns (string memory) {
                      ERC20Storage storage $ = _getERC20Storage();
                      return $._symbol;
                  }
              
                  /**
                   * @dev Returns the number of decimals used to get its user representation.
                   * For example, if `decimals` equals `2`, a balance of `505` tokens should
                   * be displayed to a user as `5.05` (`505 / 10 ** 2`).
                   *
                   * Tokens usually opt for a value of 18, imitating the relationship between
                   * Ether and Wei. This is the default value returned by this function, unless
                   * it's overridden.
                   *
                   * NOTE: This information is only used for _display_ purposes: it in
                   * no way affects any of the arithmetic of the contract, including
                   * {IERC20-balanceOf} and {IERC20-transfer}.
                   */
                  function decimals() public view virtual returns (uint8) {
                      return 18;
                  }
              
                  /**
                   * @dev See {IERC20-totalSupply}.
                   */
                  function totalSupply() public view virtual returns (uint256) {
                      ERC20Storage storage $ = _getERC20Storage();
                      return $._totalSupply;
                  }
              
                  /**
                   * @dev See {IERC20-balanceOf}.
                   */
                  function balanceOf(address account) public view virtual returns (uint256) {
                      ERC20Storage storage $ = _getERC20Storage();
                      return $._balances[account];
                  }
              
                  /**
                   * @dev See {IERC20-transfer}.
                   *
                   * Requirements:
                   *
                   * - `to` cannot be the zero address.
                   * - the caller must have a balance of at least `value`.
                   */
                  function transfer(address to, uint256 value) public virtual returns (bool) {
                      address owner = _msgSender();
                      _transfer(owner, to, value);
                      return true;
                  }
              
                  /**
                   * @dev See {IERC20-allowance}.
                   */
                  function allowance(address owner, address spender) public view virtual returns (uint256) {
                      ERC20Storage storage $ = _getERC20Storage();
                      return $._allowances[owner][spender];
                  }
              
                  /**
                   * @dev See {IERC20-approve}.
                   *
                   * NOTE: If `value` is the maximum `uint256`, the allowance is not updated on
                   * `transferFrom`. This is semantically equivalent to an infinite approval.
                   *
                   * Requirements:
                   *
                   * - `spender` cannot be the zero address.
                   */
                  function approve(address spender, uint256 value) public virtual returns (bool) {
                      address owner = _msgSender();
                      _approve(owner, spender, value);
                      return true;
                  }
              
                  /**
                   * @dev See {IERC20-transferFrom}.
                   *
                   * Emits an {Approval} event indicating the updated allowance. This is not
                   * required by the EIP. See the note at the beginning of {ERC20}.
                   *
                   * NOTE: Does not update the allowance if the current allowance
                   * is the maximum `uint256`.
                   *
                   * Requirements:
                   *
                   * - `from` and `to` cannot be the zero address.
                   * - `from` must have a balance of at least `value`.
                   * - the caller must have allowance for ``from``'s tokens of at least
                   * `value`.
                   */
                  function transferFrom(address from, address to, uint256 value) public virtual returns (bool) {
                      address spender = _msgSender();
                      _spendAllowance(from, spender, value);
                      _transfer(from, to, value);
                      return true;
                  }
              
                  /**
                   * @dev Moves a `value` amount of tokens from `from` to `to`.
                   *
                   * This internal function is equivalent to {transfer}, and can be used to
                   * e.g. implement automatic token fees, slashing mechanisms, etc.
                   *
                   * Emits a {Transfer} event.
                   *
                   * NOTE: This function is not virtual, {_update} should be overridden instead.
                   */
                  function _transfer(address from, address to, uint256 value) internal {
                      if (from == address(0)) {
                          revert ERC20InvalidSender(address(0));
                      }
                      if (to == address(0)) {
                          revert ERC20InvalidReceiver(address(0));
                      }
                      _update(from, to, value);
                  }
              
                  /**
                   * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from`
                   * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding
                   * this function.
                   *
                   * Emits a {Transfer} event.
                   */
                  function _update(address from, address to, uint256 value) internal virtual {
                      ERC20Storage storage $ = _getERC20Storage();
                      if (from == address(0)) {
                          // Overflow check required: The rest of the code assumes that totalSupply never overflows
                          $._totalSupply += value;
                      } else {
                          uint256 fromBalance = $._balances[from];
                          if (fromBalance < value) {
                              revert ERC20InsufficientBalance(from, fromBalance, value);
                          }
                          unchecked {
                              // Overflow not possible: value <= fromBalance <= totalSupply.
                              $._balances[from] = fromBalance - value;
                          }
                      }
              
                      if (to == address(0)) {
                          unchecked {
                              // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply.
                              $._totalSupply -= value;
                          }
                      } else {
                          unchecked {
                              // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256.
                              $._balances[to] += value;
                          }
                      }
              
                      emit Transfer(from, to, value);
                  }
              
                  /**
                   * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0).
                   * Relies on the `_update` mechanism
                   *
                   * Emits a {Transfer} event with `from` set to the zero address.
                   *
                   * NOTE: This function is not virtual, {_update} should be overridden instead.
                   */
                  function _mint(address account, uint256 value) internal {
                      if (account == address(0)) {
                          revert ERC20InvalidReceiver(address(0));
                      }
                      _update(address(0), account, value);
                  }
              
                  /**
                   * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply.
                   * Relies on the `_update` mechanism.
                   *
                   * Emits a {Transfer} event with `to` set to the zero address.
                   *
                   * NOTE: This function is not virtual, {_update} should be overridden instead
                   */
                  function _burn(address account, uint256 value) internal {
                      if (account == address(0)) {
                          revert ERC20InvalidSender(address(0));
                      }
                      _update(account, address(0), value);
                  }
              
                  /**
                   * @dev Sets `value` as the allowance of `spender` over the `owner` s tokens.
                   *
                   * This internal function is equivalent to `approve`, and can be used to
                   * e.g. set automatic allowances for certain subsystems, etc.
                   *
                   * Emits an {Approval} event.
                   *
                   * Requirements:
                   *
                   * - `owner` cannot be the zero address.
                   * - `spender` cannot be the zero address.
                   *
                   * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument.
                   */
                  function _approve(address owner, address spender, uint256 value) internal {
                      _approve(owner, spender, value, true);
                  }
              
                  /**
                   * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event.
                   *
                   * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by
                   * `_spendAllowance` during the `transferFrom` operation set the flag to false. This saves gas by not emitting any
                   * `Approval` event during `transferFrom` operations.
                   *
                   * Anyone who wishes to continue emitting `Approval` events on the`transferFrom` operation can force the flag to
                   * true using the following override:
                   * ```
                   * function _approve(address owner, address spender, uint256 value, bool) internal virtual override {
                   *     super._approve(owner, spender, value, true);
                   * }
                   * ```
                   *
                   * Requirements are the same as {_approve}.
                   */
                  function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual {
                      ERC20Storage storage $ = _getERC20Storage();
                      if (owner == address(0)) {
                          revert ERC20InvalidApprover(address(0));
                      }
                      if (spender == address(0)) {
                          revert ERC20InvalidSpender(address(0));
                      }
                      $._allowances[owner][spender] = value;
                      if (emitEvent) {
                          emit Approval(owner, spender, value);
                      }
                  }
              
                  /**
                   * @dev Updates `owner` s allowance for `spender` based on spent `value`.
                   *
                   * Does not update the allowance value in case of infinite allowance.
                   * Revert if not enough allowance is available.
                   *
                   * Does not emit an {Approval} event.
                   */
                  function _spendAllowance(address owner, address spender, uint256 value) internal virtual {
                      uint256 currentAllowance = allowance(owner, spender);
                      if (currentAllowance != type(uint256).max) {
                          if (currentAllowance < value) {
                              revert ERC20InsufficientAllowance(spender, currentAllowance, value);
                          }
                          unchecked {
                              _approve(owner, spender, currentAllowance - value, false);
                          }
                      }
                  }
              }
              
              // File: @openzeppelin/contracts-upgradeable/token/ERC20/extensions/ERC20CappedUpgradeable.sol
              
              
              // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/ERC20Capped.sol)
              
              pragma solidity ^0.8.20;
              
              
              
              /**
               * @dev Extension of {ERC20} that adds a cap to the supply of tokens.
               */
              abstract contract ERC20CappedUpgradeable is Initializable, ERC20Upgradeable {
                  /// @custom:storage-location erc7201:openzeppelin.storage.ERC20Capped
                  struct ERC20CappedStorage {
                      uint256 _cap;
                  }
              
                  // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ERC20Capped")) - 1)) & ~bytes32(uint256(0xff))
                  bytes32 private constant ERC20CappedStorageLocation = 0x0f070392f17d5f958cc1ac31867dabecfc5c9758b4a419a200803226d7155d00;
              
                  function _getERC20CappedStorage() private pure returns (ERC20CappedStorage storage $) {
                      assembly {
                          $.slot := ERC20CappedStorageLocation
                      }
                  }
              
                  /**
                   * @dev Total supply cap has been exceeded.
                   */
                  error ERC20ExceededCap(uint256 increasedSupply, uint256 cap);
              
                  /**
                   * @dev The supplied cap is not a valid cap.
                   */
                  error ERC20InvalidCap(uint256 cap);
              
                  /**
                   * @dev Sets the value of the `cap`. This value is immutable, it can only be
                   * set once during construction.
                   */
                  function __ERC20Capped_init(uint256 cap_) internal onlyInitializing {
                      __ERC20Capped_init_unchained(cap_);
                  }
              
                  function __ERC20Capped_init_unchained(uint256 cap_) internal onlyInitializing {
                      ERC20CappedStorage storage $ = _getERC20CappedStorage();
                      if (cap_ == 0) {
                          revert ERC20InvalidCap(0);
                      }
                      $._cap = cap_;
                  }
              
                  /**
                   * @dev Returns the cap on the token's total supply.
                   */
                  function cap() public view virtual returns (uint256) {
                      ERC20CappedStorage storage $ = _getERC20CappedStorage();
                      return $._cap;
                  }
              
                  /**
                   * @dev See {ERC20-_update}.
                   */
                  function _update(address from, address to, uint256 value) internal virtual override {
                      super._update(from, to, value);
              
                      if (from == address(0)) {
                          uint256 maxSupply = cap();
                          uint256 supply = totalSupply();
                          if (supply > maxSupply) {
                              revert ERC20ExceededCap(supply, maxSupply);
                          }
                      }
                  }
              }
              
              // File: contracts/PikaMoon.sol
              
              
              pragma solidity 0.8.20;
              
              
              
              
              
              
              
              /**
               * @title PikaMoon Token
               * @dev A simple ERC20 token contract that allows minting and burning of tokens.
               */
              contract PikaMoon is
                  Initializable,
                  ERC20CappedUpgradeable,
                  AccessControlUpgradeable,
                  UUPSUpgradeable
              {
                  //storage
                  bytes32 private constant OWNER_ROLE = keccak256("OWNER_ROLE");
                  uint32 public constant feeMultiply = 1000;
                  uint16 constant public marketingTax = 10; 
                  uint16 constant public ecosystemTax = 10; 
                  uint16 constant public burnTax = 5; 
                  address public ecoSystemWallet;
                  address public marketingWallet;
                  mapping(address => bool) public isExcludeFromTax;
                  mapping(address => bool) public automatedMarketMakerPairs;
              
                  bool public isTaxEnabled;
              
                  // events
                  event SetAutomatedMarketMakerPair(address pair, bool value);
                  event ToggleTax(bool tax);
                  event ExcludeFromTax(address _user, bool _isExcludeFromTax);
                  event EventEcoSystemWallet(
                      address ecoSystemWallet,
                      address _ecoSystemWallet
                  );
                  event EventMarketingWallet(
                      address marketingWallet,
                      address _marketingWallet
                  );
              
                  /// @custom:oz-upgrades-unsafe-allow constructor
                  constructor() {
                      _disableInitializers();
                  }
              
                  /**
                   * @dev Initializer function to initialize the contract.
                   * @param _name The name of the token.
                   * @param _symbol The symbol of the token.
                   * @param _ecosystemdevelopment ecosystem wallet.
                   * @param _marketing marketing wallet.
                   */
                  function initialize(
                      string memory _name, // Pikamoon
                      string memory _symbol, // PIKA
                      address _ecosystemdevelopment,
                      address _marketing
                  ) external initializer {
                      __ERC20_init(_name, _symbol);
                      __ERC20Capped_init(50_000_000_000 * 10 ** decimals());
                      __AccessControl_init();
                      __UUPSUpgradeable_init();
              
                      _grantRole(OWNER_ROLE, _msgSender());
                      _setRoleAdmin(OWNER_ROLE, OWNER_ROLE);
              
                      if (_ecosystemdevelopment == address(0)) {
                          revert CommanErrors.ZeroAddress();
                      }
                      if (_marketing == address(0)) {
                          revert CommanErrors.ZeroAddress();
                      }
              
                      isTaxEnabled = true;
                     
                      //set marketing and ecosystem wallet
                      ecoSystemWallet = _ecosystemdevelopment;
                      marketingWallet = _marketing;
                      // exclude owner & this contract from tax
                      isExcludeFromTax[address(this)] = true;
                  }
              
                  /**
                   * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by
                   * {upgradeToAndCall}.
                   */
                  function _authorizeUpgrade(
                      address newImplementation
                  ) internal override onlyRole(OWNER_ROLE) {}
              
                  /**
                   * @dev function for setting Automated MarketMaker Pair
                   * @param pair address for pair.
                   * @param value boolean true or false.
                   */
                  function setAutomatedMarketMakerPair(
                      address pair,
                      bool value
                  ) external onlyRole(OWNER_ROLE) {
                      _setAutomatedMarketMakerPair(pair, value);
                  }
              
                  /**
                   * @dev private function for setting Automated MarketMaker Pair
                   * @param pair address for pair.
                   * @param value boolean true or false.
                   */
                  function _setAutomatedMarketMakerPair(address pair, bool value) private {
                      if (automatedMarketMakerPairs[pair] == value) {
                          revert CommanErrors.PairIsAlreadyGivenValue();
                      }
              
                      automatedMarketMakerPairs[pair] = value;
                      emit SetAutomatedMarketMakerPair(pair, value);
                  }
              
                  /**
                   * @dev Function to get decimals.
                   */
                  function decimals() public pure override returns (uint8) {
                      return 9;
                  }
              
                  /**
                   * @dev Function to mint new tokens and assign them to a specified address.
                   * @param to The address to which the new tokens are minted.
                   * @param amount The amount of tokens to be minted.
                   */
                  function mint(address to, uint amount) external onlyRole(OWNER_ROLE) {
                      // Call the internal _mint function from ERC20 to create new tokens
                      _mint(to, amount);
                  }
              
                  /**
                   * @dev Function for user to burn there balance.
                   * @param amount The amount of tokens to be burned.
                   */
                  function burn(uint amount) external {
                      // Call the internal _burn function from ERC20 to destroy tokens
                      _burn(_msgSender(), amount);
                  }
              
                  /**
                   * @dev Function to set ecosystem address.
                   * @param _ecoSystemWallet The address to ecosystem wallet.
                   */
                  function changeEcoSystemWallet(
                      address _ecoSystemWallet
                  ) external onlyRole(OWNER_ROLE) {
                      if (_ecoSystemWallet == address(0)) {
                          revert CommanErrors.ZeroAddress();
                      }
                      emit EventEcoSystemWallet(ecoSystemWallet, _ecoSystemWallet);
                      ecoSystemWallet = _ecoSystemWallet;
                  }
              
                  /**
                   * @dev Function to set marketing address.
                   * @param _marketing The address to  marketing wallet.
                   */
                  function changeMarketingWallet(
                      address _marketing
                  ) external onlyRole(OWNER_ROLE) {
                      if (_marketing == address(0)) {
                          revert CommanErrors.ZeroAddress();
                      }
                      emit EventMarketingWallet(marketingWallet, _marketing);
                      marketingWallet = _marketing;
                  }
              
                  /**
                   * @dev Function to update isExcludeFromTax mapping to exclude or include From Tax
                   * @param _user The address to be exclude or include From Tax
                   * @param _isExcludeFromTax true or false
                   */
                  function excludeFromTax(
                      address _user,
                      bool _isExcludeFromTax
                  ) external onlyRole(OWNER_ROLE) {
                      isExcludeFromTax[_user] = _isExcludeFromTax;
                      emit ExcludeFromTax(_user, _isExcludeFromTax);
                  }
              
                  /**
                   * @dev Function to toggle tax
                   */
                  function toggleTax() external onlyRole(OWNER_ROLE) {
                      isTaxEnabled = !isTaxEnabled;
                      emit ToggleTax(isTaxEnabled);
                  }
              
                  /**
                   * @dev Moves a `value` amount of tokens from the caller's account to `to`.
                   * @param to The address to which the tokens are being transfered.
                   * @param value The amount of tokens to be transfered.
                   * @notice Pikamoon incorporates a small 2.5% transaction tax on Sell orders & Transfers.
                   * There is NO buy Tax when purchasing $PIKA. The Pikamoon token is used to support our metaverse
                   * and marketplace, therefore we want to reward hodlers of Pikamoon by punishing those leaving our ecosystem.
                   * 1% of the tax will go towards marketing, 1% towards the ecosystem development fund / P2E Rewards
                   * and 0.5% burned forever!
                   */
                  function transfer(
                      address to,
                      uint256 value
                  ) public override(ERC20Upgradeable) returns (bool) {
                      (
                          uint256 tax,
                          uint256 burnAmount,
                          uint256 marketingAmount,
                          uint256 ecosystemAmount
                      ) = calculateTax(_msgSender(), to, value);
                      if (tax > 0) {
                          unchecked {
                              value -= tax;
                          }
              
                          // deduct tax
                          if (marketingAmount > 0) {
                              super._transfer(_msgSender(), marketingWallet, marketingAmount);
                          }
                          if (ecosystemAmount > 0) {
                              super._transfer(_msgSender(), ecoSystemWallet, ecosystemAmount);
                          }
                          if (burnAmount > 0) {
                              super._burn(_msgSender(), burnAmount);
                          }
                      }
                      // normal transfer
                      super._transfer(_msgSender(), to, value);
                      return true;
                  }
              
                  /**
                   * @dev Moves a `value` amount of tokens from `from` to `to` using the
                   * allowance mechanism. `value` is then deducted from the caller's
                   * allowance.
                   * @param from The address from which the tokens are being transfered.
                   * @param to The address to which the tokens are being transfered.
                   * @param value The amount of tokens to be transfered.
                   * @notice Pikamoon incorporates a small 2.5% transaction tax on Sell orders & Transfers.
                   * There is NO buy Tax when purchasing $PIKA. The Pikamoon token is used to support our metaverse
                   * and marketplace, therefore we want to reward hodlers of Pikamoon by punishing those leaving our ecosystem.
                   * 1% of the tax will go towards marketing, 1% towards the ecosystem development fund / P2E Rewards
                   * and 0.5% burned forever!
                   */
                  function transferFrom(
                      address from,
                      address to,
                      uint256 value
                  ) public override(ERC20Upgradeable) returns (bool) {
                      _spendAllowance(from, _msgSender(), value);
                      (
                          uint256 tax,
                          uint256 burnAmount,
                          uint256 marketingAmount,
                          uint256 ecosystemAmount
                      ) = calculateTax(from, to, value);
                      if (tax > 0) {
                          unchecked {
                              value -= tax;
                          }
              
                          // deduct tax
                          if (marketingAmount > 0) {
                              super._transfer(from, marketingWallet, marketingAmount);
                          }
                          if (ecosystemAmount > 0) {
                              super._transfer(from, ecoSystemWallet, ecosystemAmount);
                          }
                          if (burnAmount > 0) {
                              super._burn(from, burnAmount);
                          }
                      }
                      // normal transfer
                      super._transfer(from, to, value);
                      return true;
                  }
              
                  /**
                   * @dev Function to calculate the tax
                   * @param from address on which tax is applied
                   * @param to address on which tax is applied
                   * @param value amount on which tax is calculated
                   */
                  function calculateTax(
                      address from,
                      address to,
                      uint256 value
                  )
                      public
                      view
                      returns (
                          uint256 tax,
                          uint256 burnAmount,
                          uint256 marketingAmount,
                          uint256 ecosystemAmount
                      )
                  {
                      // calculate tax
                      if (
                          isTaxEnabled &&
                          !automatedMarketMakerPairs[from] &&
                          !isExcludeFromTax[from] &&
                          !isExcludeFromTax[to]
                      ) {
                          burnAmount = (value * burnTax) / feeMultiply;
                          marketingAmount = (value * marketingTax) / feeMultiply;
                          ecosystemAmount = (value * ecosystemTax) / feeMultiply;
                          unchecked {
                              tax = burnAmount + marketingAmount + ecosystemAmount;
                          }
                      }
                  }
              }