ETH Price: $2,257.25 (-0.63%)

Transaction Decoder

Block:
20765556 at Sep-16-2024 08:27:11 PM +UTC
Transaction Fee:
0.000456726752991678 ETH $1.03
Gas Used:
83,343 Gas / 5.480085346 Gwei

Emitted Events:

528 BridgeToken.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x000000000000000000000000cf560347c6380033467314875d2c0ca4ff04e975, 0x000000000000000000000000f3f3485f85951030865a8f80b597cf5ec24f5a9b, 00000000000000000000000000000000000000000000000000000000512b91f5 )
529 TransparentUpgradeableProxy.0xfc30cddea38e2bf4d6ea7d3f9ed3b6ad7f176419f4963bd81318067a4aee73fe( 0xfc30cddea38e2bf4d6ea7d3f9ed3b6ad7f176419f4963bd81318067a4aee73fe, 0x000000000000000000000000f3f3485f85951030865a8f80b597cf5ec24f5a9b, 00000000000000000000000000000000000000000000000000000000512b91f5 )

Account State Difference:

  Address   Before After State Difference Code
0x89E8E084...656e8bFA9
(beaverbuild)
18.211289745459468173 Eth18.211289828802468173 Eth0.000000083343
0xCF560347...4FF04E975
0xF3f3485f...ec24F5A9b
0.781585217963688758 Eth
Nonce: 346
0.78112849121069708 Eth
Nonce: 347
0.000456726752991678

Execution Trace

TransparentUpgradeableProxy.CALL( )
  • stakingManagerV3.DELEGATECALL( )
    • BridgeToken.a9059cbb( )
      • TokenBridge.STATICCALL( )
        • BridgeImplementation.DELEGATECALL( )
        • TokenImplementation.transfer( recipient_=0xF3f3485f85951030865A8F80B597cf5ec24F5A9b, amount_=1361809909 ) => ( True )
          File 1 of 6: TransparentUpgradeableProxy
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol)
          pragma solidity ^0.8.0;
          import "../utils/Context.sol";
          /**
           * @dev Contract module which provides a basic access control mechanism, where
           * there is an account (an owner) that can be granted exclusive access to
           * specific functions.
           *
           * By default, the owner account will be the one that deploys the contract. This
           * can later be changed with {transferOwnership}.
           *
           * This module is used through inheritance. It will make available the modifier
           * `onlyOwner`, which can be applied to your functions to restrict their use to
           * the owner.
           */
          abstract contract Ownable is Context {
              address private _owner;
              event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
              /**
               * @dev Initializes the contract setting the deployer as the initial owner.
               */
              constructor() {
                  _transferOwnership(_msgSender());
              }
              /**
               * @dev Throws if called by any account other than the owner.
               */
              modifier onlyOwner() {
                  _checkOwner();
                  _;
              }
              /**
               * @dev Returns the address of the current owner.
               */
              function owner() public view virtual returns (address) {
                  return _owner;
              }
              /**
               * @dev Throws if the sender is not the owner.
               */
              function _checkOwner() internal view virtual {
                  require(owner() == _msgSender(), "Ownable: caller is not the owner");
              }
              /**
               * @dev Leaves the contract without owner. It will not be possible to call
               * `onlyOwner` functions anymore. Can only be called by the current owner.
               *
               * NOTE: Renouncing ownership will leave the contract without an owner,
               * thereby removing any functionality that is only available to the owner.
               */
              function renounceOwnership() public virtual onlyOwner {
                  _transferOwnership(address(0));
              }
              /**
               * @dev Transfers ownership of the contract to a new account (`newOwner`).
               * Can only be called by the current owner.
               */
              function transferOwnership(address newOwner) public virtual onlyOwner {
                  require(newOwner != address(0), "Ownable: new owner is the zero address");
                  _transferOwnership(newOwner);
              }
              /**
               * @dev Transfers ownership of the contract to a new account (`newOwner`).
               * Internal function without access restriction.
               */
              function _transferOwnership(address newOwner) internal virtual {
                  address oldOwner = _owner;
                  _owner = newOwner;
                  emit OwnershipTransferred(oldOwner, newOwner);
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
           * proxy whose upgrades are fully controlled by the current implementation.
           */
          interface IERC1822Proxiable {
              /**
               * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
               * address.
               *
               * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
               * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
               * function revert if invoked through a proxy.
               */
              function proxiableUUID() external view returns (bytes32);
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.8.3) (interfaces/IERC1967.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.
           *
           * _Available since v4.9._
           */
          interface IERC1967 {
              /**
               * @dev Emitted when the implementation is upgraded.
               */
              event Upgraded(address indexed implementation);
              /**
               * @dev Emitted when the admin account has changed.
               */
              event AdminChanged(address previousAdmin, address newAdmin);
              /**
               * @dev Emitted when the beacon is changed.
               */
              event BeaconUpgraded(address indexed beacon);
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.7.0) (proxy/beacon/BeaconProxy.sol)
          pragma solidity ^0.8.0;
          import "./IBeacon.sol";
          import "../Proxy.sol";
          import "../ERC1967/ERC1967Upgrade.sol";
          /**
           * @dev This contract implements a proxy that gets the implementation address for each call from an {UpgradeableBeacon}.
           *
           * The beacon address is stored in storage slot `uint256(keccak256('eip1967.proxy.beacon')) - 1`, so that it doesn't
           * conflict with the storage layout of the implementation behind the proxy.
           *
           * _Available since v3.4._
           */
          contract BeaconProxy is Proxy, ERC1967Upgrade {
              /**
               * @dev Initializes the proxy with `beacon`.
               *
               * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon. This
               * will typically be an encoded function call, and allows initializing the storage of the proxy like a Solidity
               * constructor.
               *
               * Requirements:
               *
               * - `beacon` must be a contract with the interface {IBeacon}.
               */
              constructor(address beacon, bytes memory data) payable {
                  _upgradeBeaconToAndCall(beacon, data, false);
              }
              /**
               * @dev Returns the current beacon address.
               */
              function _beacon() internal view virtual returns (address) {
                  return _getBeacon();
              }
              /**
               * @dev Returns the current implementation address of the associated beacon.
               */
              function _implementation() internal view virtual override returns (address) {
                  return IBeacon(_getBeacon()).implementation();
              }
              /**
               * @dev Changes the proxy to use a new beacon. Deprecated: see {_upgradeBeaconToAndCall}.
               *
               * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon.
               *
               * Requirements:
               *
               * - `beacon` must be a contract.
               * - The implementation returned by `beacon` must be a contract.
               */
              function _setBeacon(address beacon, bytes memory data) internal virtual {
                  _upgradeBeaconToAndCall(beacon, data, false);
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev This is the interface that {BeaconProxy} expects of its beacon.
           */
          interface IBeacon {
              /**
               * @dev Must return an address that can be used as a delegate call target.
               *
               * {BeaconProxy} will check that this address is a contract.
               */
              function implementation() external view returns (address);
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (proxy/beacon/UpgradeableBeacon.sol)
          pragma solidity ^0.8.0;
          import "./IBeacon.sol";
          import "../../access/Ownable.sol";
          import "../../utils/Address.sol";
          /**
           * @dev This contract is used in conjunction with one or more instances of {BeaconProxy} to determine their
           * implementation contract, which is where they will delegate all function calls.
           *
           * An owner is able to change the implementation the beacon points to, thus upgrading the proxies that use this beacon.
           */
          contract UpgradeableBeacon is IBeacon, Ownable {
              address private _implementation;
              /**
               * @dev Emitted when the implementation returned by the beacon is changed.
               */
              event Upgraded(address indexed implementation);
              /**
               * @dev Sets the address of the initial implementation, and the deployer account as the owner who can upgrade the
               * beacon.
               */
              constructor(address implementation_) {
                  _setImplementation(implementation_);
              }
              /**
               * @dev Returns the current implementation address.
               */
              function implementation() public view virtual override returns (address) {
                  return _implementation;
              }
              /**
               * @dev Upgrades the beacon to a new implementation.
               *
               * Emits an {Upgraded} event.
               *
               * Requirements:
               *
               * - msg.sender must be the owner of the contract.
               * - `newImplementation` must be a contract.
               */
              function upgradeTo(address newImplementation) public virtual onlyOwner {
                  _setImplementation(newImplementation);
                  emit Upgraded(newImplementation);
              }
              /**
               * @dev Sets the implementation contract address for this beacon
               *
               * Requirements:
               *
               * - `newImplementation` must be a contract.
               */
              function _setImplementation(address newImplementation) private {
                  require(Address.isContract(newImplementation), "UpgradeableBeacon: implementation is not a contract");
                  _implementation = newImplementation;
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.7.0) (proxy/ERC1967/ERC1967Proxy.sol)
          pragma solidity ^0.8.0;
          import "../Proxy.sol";
          import "./ERC1967Upgrade.sol";
          /**
           * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
           * implementation address that can be changed. This address is stored in storage in the location specified by
           * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
           * implementation behind the proxy.
           */
          contract ERC1967Proxy is Proxy, ERC1967Upgrade {
              /**
               * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
               *
               * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
               * function call, and allows initializing the storage of the proxy like a Solidity constructor.
               */
              constructor(address _logic, bytes memory _data) payable {
                  _upgradeToAndCall(_logic, _data, false);
              }
              /**
               * @dev Returns the current implementation address.
               */
              function _implementation() internal view virtual override returns (address impl) {
                  return ERC1967Upgrade._getImplementation();
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.8.3) (proxy/ERC1967/ERC1967Upgrade.sol)
          pragma solidity ^0.8.2;
          import "../beacon/IBeacon.sol";
          import "../../interfaces/IERC1967.sol";
          import "../../interfaces/draft-IERC1822.sol";
          import "../../utils/Address.sol";
          import "../../utils/StorageSlot.sol";
          /**
           * @dev This abstract contract provides getters and event emitting update functions for
           * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
           *
           * _Available since v4.1._
           *
           * @custom:oz-upgrades-unsafe-allow delegatecall
           */
          abstract contract ERC1967Upgrade is IERC1967 {
              // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
              bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
              /**
               * @dev Storage slot with the address of the current implementation.
               * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
              /**
               * @dev Returns the current implementation address.
               */
              function _getImplementation() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
              }
              /**
               * @dev Stores a new address in the EIP1967 implementation slot.
               */
              function _setImplementation(address newImplementation) private {
                  require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                  StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
              }
              /**
               * @dev Perform implementation upgrade
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeTo(address newImplementation) internal {
                  _setImplementation(newImplementation);
                  emit Upgraded(newImplementation);
              }
              /**
               * @dev Perform implementation upgrade with additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCall(
                  address newImplementation,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  _upgradeTo(newImplementation);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(newImplementation, data);
                  }
              }
              /**
               * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCallUUPS(
                  address newImplementation,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  // Upgrades from old implementations will perform a rollback test. This test requires the new
                  // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
                  // this special case will break upgrade paths from old UUPS implementation to new ones.
                  if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {
                      _setImplementation(newImplementation);
                  } else {
                      try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
                          require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
                      } catch {
                          revert("ERC1967Upgrade: new implementation is not UUPS");
                      }
                      _upgradeToAndCall(newImplementation, data, forceCall);
                  }
              }
              /**
               * @dev Storage slot with the admin of the contract.
               * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
              /**
               * @dev Returns the current admin.
               */
              function _getAdmin() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
              }
              /**
               * @dev Stores a new address in the EIP1967 admin slot.
               */
              function _setAdmin(address newAdmin) private {
                  require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                  StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
              }
              /**
               * @dev Changes the admin of the proxy.
               *
               * Emits an {AdminChanged} event.
               */
              function _changeAdmin(address newAdmin) internal {
                  emit AdminChanged(_getAdmin(), newAdmin);
                  _setAdmin(newAdmin);
              }
              /**
               * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
               * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
               */
              bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
              /**
               * @dev Returns the current beacon.
               */
              function _getBeacon() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
              }
              /**
               * @dev Stores a new beacon in the EIP1967 beacon slot.
               */
              function _setBeacon(address newBeacon) private {
                  require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract");
                  require(
                      Address.isContract(IBeacon(newBeacon).implementation()),
                      "ERC1967: beacon implementation is not a contract"
                  );
                  StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
              }
              /**
               * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
               * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
               *
               * Emits a {BeaconUpgraded} event.
               */
              function _upgradeBeaconToAndCall(
                  address newBeacon,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  _setBeacon(newBeacon);
                  emit BeaconUpgraded(newBeacon);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.6.0) (proxy/Proxy.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
           * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
           * be specified by overriding the virtual {_implementation} function.
           *
           * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
           * different contract through the {_delegate} function.
           *
           * The success and return data of the delegated call will be returned back to the caller of the proxy.
           */
          abstract contract Proxy {
              /**
               * @dev Delegates the current call to `implementation`.
               *
               * This function does not return to its internal call site, it will return directly to the external caller.
               */
              function _delegate(address implementation) internal virtual {
                  assembly {
                      // Copy msg.data. We take full control of memory in this inline assembly
                      // block because it will not return to Solidity code. We overwrite the
                      // Solidity scratch pad at memory position 0.
                      calldatacopy(0, 0, calldatasize())
                      // Call the implementation.
                      // out and outsize are 0 because we don't know the size yet.
                      let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
                      // Copy the returned data.
                      returndatacopy(0, 0, returndatasize())
                      switch result
                      // delegatecall returns 0 on error.
                      case 0 {
                          revert(0, returndatasize())
                      }
                      default {
                          return(0, returndatasize())
                      }
                  }
              }
              /**
               * @dev This is a virtual function that should be overridden so it returns the address to which the fallback function
               * and {_fallback} should delegate.
               */
              function _implementation() internal view virtual returns (address);
              /**
               * @dev Delegates the current call to the address returned by `_implementation()`.
               *
               * This function does not return to its internal call site, it will return directly to the external caller.
               */
              function _fallback() internal virtual {
                  _beforeFallback();
                  _delegate(_implementation());
              }
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
               * function in the contract matches the call data.
               */
              fallback() external payable virtual {
                  _fallback();
              }
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
               * is empty.
               */
              receive() external payable virtual {
                  _fallback();
              }
              /**
               * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
               * call, or as part of the Solidity `fallback` or `receive` functions.
               *
               * If overridden should call `super._beforeFallback()`.
               */
              function _beforeFallback() internal virtual {}
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.8.3) (proxy/transparent/ProxyAdmin.sol)
          pragma solidity ^0.8.0;
          import "./TransparentUpgradeableProxy.sol";
          import "../../access/Ownable.sol";
          /**
           * @dev This is an auxiliary contract meant to be assigned as the admin of a {TransparentUpgradeableProxy}. For an
           * explanation of why you would want to use this see the documentation for {TransparentUpgradeableProxy}.
           */
          contract ProxyAdmin is Ownable {
              /**
               * @dev Returns the current implementation of `proxy`.
               *
               * Requirements:
               *
               * - This contract must be the admin of `proxy`.
               */
              function getProxyImplementation(ITransparentUpgradeableProxy proxy) public view virtual returns (address) {
                  // We need to manually run the static call since the getter cannot be flagged as view
                  // bytes4(keccak256("implementation()")) == 0x5c60da1b
                  (bool success, bytes memory returndata) = address(proxy).staticcall(hex"5c60da1b");
                  require(success);
                  return abi.decode(returndata, (address));
              }
              /**
               * @dev Returns the current admin of `proxy`.
               *
               * Requirements:
               *
               * - This contract must be the admin of `proxy`.
               */
              function getProxyAdmin(ITransparentUpgradeableProxy proxy) public view virtual returns (address) {
                  // We need to manually run the static call since the getter cannot be flagged as view
                  // bytes4(keccak256("admin()")) == 0xf851a440
                  (bool success, bytes memory returndata) = address(proxy).staticcall(hex"f851a440");
                  require(success);
                  return abi.decode(returndata, (address));
              }
              /**
               * @dev Changes the admin of `proxy` to `newAdmin`.
               *
               * Requirements:
               *
               * - This contract must be the current admin of `proxy`.
               */
              function changeProxyAdmin(ITransparentUpgradeableProxy proxy, address newAdmin) public virtual onlyOwner {
                  proxy.changeAdmin(newAdmin);
              }
              /**
               * @dev Upgrades `proxy` to `implementation`. See {TransparentUpgradeableProxy-upgradeTo}.
               *
               * Requirements:
               *
               * - This contract must be the admin of `proxy`.
               */
              function upgrade(ITransparentUpgradeableProxy proxy, address implementation) public virtual onlyOwner {
                  proxy.upgradeTo(implementation);
              }
              /**
               * @dev Upgrades `proxy` to `implementation` and calls a function on the new implementation. See
               * {TransparentUpgradeableProxy-upgradeToAndCall}.
               *
               * Requirements:
               *
               * - This contract must be the admin of `proxy`.
               */
              function upgradeAndCall(
                  ITransparentUpgradeableProxy proxy,
                  address implementation,
                  bytes memory data
              ) public payable virtual onlyOwner {
                  proxy.upgradeToAndCall{value: msg.value}(implementation, data);
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.8.3) (proxy/transparent/TransparentUpgradeableProxy.sol)
          pragma solidity ^0.8.0;
          import "../ERC1967/ERC1967Proxy.sol";
          /**
           * @dev Interface for {TransparentUpgradeableProxy}. In order to implement transparency, {TransparentUpgradeableProxy}
           * does not implement this interface directly, and some of its functions are implemented by an internal dispatch
           * mechanism. The compiler is unaware that these functions are implemented by {TransparentUpgradeableProxy} and will not
           * include them in the ABI so this interface must be used to interact with it.
           */
          interface ITransparentUpgradeableProxy is IERC1967 {
              function admin() external view returns (address);
              function implementation() external view returns (address);
              function changeAdmin(address) external;
              function upgradeTo(address) external;
              function upgradeToAndCall(address, bytes memory) external payable;
          }
          /**
           * @dev This contract implements a proxy that is upgradeable by an admin.
           *
           * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector
           * clashing], which can potentially be used in an attack, this contract uses the
           * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two
           * things that go hand in hand:
           *
           * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if
           * that call matches one of the admin functions exposed by the proxy itself.
           * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the
           * implementation. If the admin tries to call a function on the implementation it will fail with an error that says
           * "admin cannot fallback to proxy target".
           *
           * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing
           * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due
           * to sudden errors when trying to call a function from the proxy implementation.
           *
           * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,
           * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.
           *
           * NOTE: The real interface of this proxy is that defined in `ITransparentUpgradeableProxy`. This contract does not
           * inherit from that interface, and instead the admin functions are implicitly implemented using a custom dispatch
           * mechanism in `_fallback`. Consequently, the compiler will not produce an ABI for this contract. This is necessary to
           * fully implement transparency without decoding reverts caused by selector clashes between the proxy and the
           * implementation.
           *
           * WARNING: It is not recommended to extend this contract to add additional external functions. If you do so, the compiler
           * will not check that there are no selector conflicts, due to the note above. A selector clash between any new function
           * and the functions declared in {ITransparentUpgradeableProxy} will be resolved in favor of the new one. This could
           * render the admin operations inaccessible, which could prevent upgradeability. Transparency may also be compromised.
           */
          contract TransparentUpgradeableProxy is ERC1967Proxy {
              /**
               * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and
               * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.
               */
              constructor(
                  address _logic,
                  address admin_,
                  bytes memory _data
              ) payable ERC1967Proxy(_logic, _data) {
                  _changeAdmin(admin_);
              }
              /**
               * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
               *
               * CAUTION: This modifier is deprecated, as it could cause issues if the modified function has arguments, and the
               * implementation provides a function with the same selector.
               */
              modifier ifAdmin() {
                  if (msg.sender == _getAdmin()) {
                      _;
                  } else {
                      _fallback();
                  }
              }
              /**
               * @dev If caller is the admin process the call internally, otherwise transparently fallback to the proxy behavior
               */
              function _fallback() internal virtual override {
                  if (msg.sender == _getAdmin()) {
                      bytes memory ret;
                      bytes4 selector = msg.sig;
                      if (selector == ITransparentUpgradeableProxy.upgradeTo.selector) {
                          ret = _dispatchUpgradeTo();
                      } else if (selector == ITransparentUpgradeableProxy.upgradeToAndCall.selector) {
                          ret = _dispatchUpgradeToAndCall();
                      } else if (selector == ITransparentUpgradeableProxy.changeAdmin.selector) {
                          ret = _dispatchChangeAdmin();
                      } else if (selector == ITransparentUpgradeableProxy.admin.selector) {
                          ret = _dispatchAdmin();
                      } else if (selector == ITransparentUpgradeableProxy.implementation.selector) {
                          ret = _dispatchImplementation();
                      } else {
                          revert("TransparentUpgradeableProxy: admin cannot fallback to proxy target");
                      }
                      assembly {
                          return(add(ret, 0x20), mload(ret))
                      }
                  } else {
                      super._fallback();
                  }
              }
              /**
               * @dev Returns the current admin.
               *
               * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
               * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
               * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
               */
              function _dispatchAdmin() private returns (bytes memory) {
                  _requireZeroValue();
                  address admin = _getAdmin();
                  return abi.encode(admin);
              }
              /**
               * @dev Returns the current implementation.
               *
               * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
               * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
               * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
               */
              function _dispatchImplementation() private returns (bytes memory) {
                  _requireZeroValue();
                  address implementation = _implementation();
                  return abi.encode(implementation);
              }
              /**
               * @dev Changes the admin of the proxy.
               *
               * Emits an {AdminChanged} event.
               */
              function _dispatchChangeAdmin() private returns (bytes memory) {
                  _requireZeroValue();
                  address newAdmin = abi.decode(msg.data[4:], (address));
                  _changeAdmin(newAdmin);
                  return "";
              }
              /**
               * @dev Upgrade the implementation of the proxy.
               */
              function _dispatchUpgradeTo() private returns (bytes memory) {
                  _requireZeroValue();
                  address newImplementation = abi.decode(msg.data[4:], (address));
                  _upgradeToAndCall(newImplementation, bytes(""), false);
                  return "";
              }
              /**
               * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified
               * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the
               * proxied contract.
               */
              function _dispatchUpgradeToAndCall() private returns (bytes memory) {
                  (address newImplementation, bytes memory data) = abi.decode(msg.data[4:], (address, bytes));
                  _upgradeToAndCall(newImplementation, data, true);
                  return "";
              }
              /**
               * @dev Returns the current admin.
               */
              function _admin() internal view virtual returns (address) {
                  return _getAdmin();
              }
              /**
               * @dev To keep this contract fully transparent, all `ifAdmin` functions must be payable. This helper is here to
               * emulate some proxy functions being non-payable while still allowing value to pass through.
               */
              function _requireZeroValue() private {
                  require(msg.value == 0);
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)
          pragma solidity ^0.8.1;
          /**
           * @dev Collection of functions related to the address type
           */
          library Address {
              /**
               * @dev Returns true if `account` is a contract.
               *
               * [IMPORTANT]
               * ====
               * It is unsafe to assume that an address for which this function returns
               * false is an externally-owned account (EOA) and not a contract.
               *
               * Among others, `isContract` will return false for the following
               * types of addresses:
               *
               *  - an externally-owned account
               *  - a contract in construction
               *  - an address where a contract will be created
               *  - an address where a contract lived, but was destroyed
               * ====
               *
               * [IMPORTANT]
               * ====
               * You shouldn't rely on `isContract` to protect against flash loan attacks!
               *
               * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
               * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
               * constructor.
               * ====
               */
              function isContract(address account) internal view returns (bool) {
                  // This method relies on extcodesize/address.code.length, which returns 0
                  // for contracts in construction, since the code is only stored at the end
                  // of the constructor execution.
                  return account.code.length > 0;
              }
              /**
               * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
               * `recipient`, forwarding all available gas and reverting on errors.
               *
               * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
               * of certain opcodes, possibly making contracts go over the 2300 gas limit
               * imposed by `transfer`, making them unable to receive funds via
               * `transfer`. {sendValue} removes this limitation.
               *
               * https://diligence.consensys.net/posts/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.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
               */
              function sendValue(address payable recipient, uint256 amount) internal {
                  require(address(this).balance >= amount, "Address: insufficient balance");
                  (bool success, ) = recipient.call{value: amount}("");
                  require(success, "Address: unable to send value, recipient may have reverted");
              }
              /**
               * @dev Performs a Solidity function call using a low level `call`. A
               * plain `call` is an unsafe replacement for a function call: use this
               * function instead.
               *
               * If `target` reverts with a revert reason, it is bubbled up by this
               * function (like regular Solidity function calls).
               *
               * Returns the raw returned data. To convert to the expected return value,
               * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
               *
               * Requirements:
               *
               * - `target` must be a contract.
               * - calling `target` with `data` must not revert.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, "Address: low-level call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
               * `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but also transferring `value` wei to `target`.
               *
               * Requirements:
               *
               * - the calling contract must have an ETH balance of at least `value`.
               * - the called Solidity function must be `payable`.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value
              ) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
              }
              /**
               * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
               * with `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  require(address(this).balance >= value, "Address: insufficient balance for call");
                  (bool success, bytes memory returndata) = target.call{value: value}(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                  return functionStaticCall(target, data, "Address: low-level static call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal view returns (bytes memory) {
                  (bool success, bytes memory returndata) = target.staticcall(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionDelegateCall(target, data, "Address: low-level delegate call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  (bool success, bytes memory returndata) = target.delegatecall(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
               * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
               *
               * _Available since v4.8._
               */
              function verifyCallResultFromTarget(
                  address target,
                  bool success,
                  bytes memory returndata,
                  string memory errorMessage
              ) internal view returns (bytes memory) {
                  if (success) {
                      if (returndata.length == 0) {
                          // only check isContract if the call was successful and the return data is empty
                          // otherwise we already know that it was a contract
                          require(isContract(target), "Address: call to non-contract");
                      }
                      return returndata;
                  } else {
                      _revert(returndata, errorMessage);
                  }
              }
              /**
               * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
               * revert reason or using the provided one.
               *
               * _Available since v4.3._
               */
              function verifyCallResult(
                  bool success,
                  bytes memory returndata,
                  string memory errorMessage
              ) internal pure returns (bytes memory) {
                  if (success) {
                      return returndata;
                  } else {
                      _revert(returndata, errorMessage);
                  }
              }
              function _revert(bytes memory returndata, string memory errorMessage) private pure {
                  // Look for revert reason and bubble it up if present
                  if (returndata.length > 0) {
                      // The easiest way to bubble the revert reason is using memory via assembly
                      /// @solidity memory-safe-assembly
                      assembly {
                          let returndata_size := mload(returndata)
                          revert(add(32, returndata), returndata_size)
                      }
                  } else {
                      revert(errorMessage);
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev Provides information about the current execution context, including the
           * sender of the transaction and its data. While these are generally available
           * via msg.sender and msg.data, they should not be accessed in such a direct
           * manner, since when dealing with meta-transactions the account sending and
           * paying for execution may not be the actual sender (as far as an application
           * is concerned).
           *
           * This contract is only required for intermediate, library-like contracts.
           */
          abstract contract Context {
              function _msgSender() internal view virtual returns (address) {
                  return msg.sender;
              }
              function _msgData() internal view virtual returns (bytes calldata) {
                  return msg.data;
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.7.0) (utils/StorageSlot.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev Library for reading and writing primitive types to specific storage slots.
           *
           * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
           * This library helps with reading and writing to such slots without the need for inline assembly.
           *
           * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
           *
           * Example usage to set ERC1967 implementation slot:
           * ```
           * contract ERC1967 {
           *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
           *
           *     function _getImplementation() internal view returns (address) {
           *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
           *     }
           *
           *     function _setImplementation(address newImplementation) internal {
           *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
           *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
           *     }
           * }
           * ```
           *
           * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
           */
          library StorageSlot {
              struct AddressSlot {
                  address value;
              }
              struct BooleanSlot {
                  bool value;
              }
              struct Bytes32Slot {
                  bytes32 value;
              }
              struct Uint256Slot {
                  uint256 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
                  }
              }
          }
          

          File 2 of 6: BridgeToken
          // File: @openzeppelin/contracts/proxy/beacon/IBeacon.sol
          
          // SPDX-License-Identifier: MIT
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev This is the interface that {BeaconProxy} expects of its beacon.
           */
          interface IBeacon {
              /**
               * @dev Must return an address that can be used as a delegate call target.
               *
               * {BeaconProxy} will check that this address is a contract.
               */
              function implementation() external view returns (address);
          }
          
          // File: @openzeppelin/contracts/proxy/Proxy.sol
          
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
           * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
           * be specified by overriding the virtual {_implementation} function.
           *
           * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
           * different contract through the {_delegate} function.
           *
           * The success and return data of the delegated call will be returned back to the caller of the proxy.
           */
          abstract contract Proxy {
              /**
               * @dev Delegates the current call to `implementation`.
               *
               * This function does not return to its internall 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 overriden 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 internall call site, it will return directly to the external caller.
               */
              function _fallback() internal virtual {
                  _beforeFallback();
                  _delegate(_implementation());
              }
          
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
               * function in the contract matches the call data.
               */
              fallback() external payable virtual {
                  _fallback();
              }
          
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
               * is empty.
               */
              receive() external payable virtual {
                  _fallback();
              }
          
              /**
               * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
               * call, or as part of the Solidity `fallback` or `receive` functions.
               *
               * If overriden should call `super._beforeFallback()`.
               */
              function _beforeFallback() internal virtual {}
          }
          
          // File: @openzeppelin/contracts/utils/Address.sol
          
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev Collection of functions related to the address type
           */
          library Address {
              /**
               * @dev Returns true if `account` is a contract.
               *
               * [IMPORTANT]
               * ====
               * It is unsafe to assume that an address for which this function returns
               * false is an externally-owned account (EOA) and not a contract.
               *
               * Among others, `isContract` will return false for the following
               * types of addresses:
               *
               *  - an externally-owned account
               *  - a contract in construction
               *  - an address where a contract will be created
               *  - an address where a contract lived, but was destroyed
               * ====
               */
              function isContract(address account) internal view returns (bool) {
                  // This method relies on extcodesize, which returns 0 for contracts in
                  // construction, since the code is only stored at the end of the
                  // constructor execution.
          
                  uint256 size;
                  assembly {
                      size := extcodesize(account)
                  }
                  return size > 0;
              }
          
              /**
               * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
               * `recipient`, forwarding all available gas and reverting on errors.
               *
               * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
               * of certain opcodes, possibly making contracts go over the 2300 gas limit
               * imposed by `transfer`, making them unable to receive funds via
               * `transfer`. {sendValue} removes this limitation.
               *
               * https://diligence.consensys.net/posts/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.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
               */
              function sendValue(address payable recipient, uint256 amount) internal {
                  require(address(this).balance >= amount, "Address: insufficient balance");
          
                  (bool success, ) = recipient.call{value: amount}("");
                  require(success, "Address: unable to send value, recipient may have reverted");
              }
          
              /**
               * @dev Performs a Solidity function call using a low level `call`. A
               * plain `call` is an unsafe replacement for a function call: use this
               * function instead.
               *
               * If `target` reverts with a revert reason, it is bubbled up by this
               * function (like regular Solidity function calls).
               *
               * Returns the raw returned data. To convert to the expected return value,
               * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
               *
               * Requirements:
               *
               * - `target` must be a contract.
               * - calling `target` with `data` must not revert.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionCall(target, data, "Address: low-level call failed");
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
               * `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, errorMessage);
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but also transferring `value` wei to `target`.
               *
               * Requirements:
               *
               * - the calling contract must have an ETH balance of at least `value`.
               * - the called Solidity function must be `payable`.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value
              ) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
              }
          
              /**
               * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
               * with `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  require(address(this).balance >= value, "Address: insufficient balance for call");
                  require(isContract(target), "Address: call to non-contract");
          
                  (bool success, bytes memory returndata) = target.call{value: value}(data);
                  return verifyCallResult(success, returndata, errorMessage);
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                  return functionStaticCall(target, data, "Address: low-level static call failed");
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal view returns (bytes memory) {
                  require(isContract(target), "Address: static call to non-contract");
          
                  (bool success, bytes memory returndata) = target.staticcall(data);
                  return verifyCallResult(success, returndata, errorMessage);
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionDelegateCall(target, data, "Address: low-level delegate call failed");
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  require(isContract(target), "Address: delegate call to non-contract");
          
                  (bool success, bytes memory returndata) = target.delegatecall(data);
                  return verifyCallResult(success, returndata, errorMessage);
              }
          
              /**
               * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
               * revert reason using the provided one.
               *
               * _Available since v4.3._
               */
              function verifyCallResult(
                  bool success,
                  bytes memory returndata,
                  string memory errorMessage
              ) internal pure returns (bytes memory) {
                  if (success) {
                      return returndata;
                  } else {
                      // 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
          
                          assembly {
                              let returndata_size := mload(returndata)
                              revert(add(32, returndata), returndata_size)
                          }
                      } else {
                          revert(errorMessage);
                      }
                  }
              }
          }
          
          // File: @openzeppelin/contracts/utils/StorageSlot.sol
          
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev Library for reading and writing primitive types to specific storage slots.
           *
           * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
           * This library helps with reading and writing to such slots without the need for inline assembly.
           *
           * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
           *
           * Example usage to set ERC1967 implementation slot:
           * ```
           * contract ERC1967 {
           *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
           *
           *     function _getImplementation() internal view returns (address) {
           *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
           *     }
           *
           *     function _setImplementation(address newImplementation) internal {
           *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
           *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
           *     }
           * }
           * ```
           *
           * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
           */
          library StorageSlot {
              struct AddressSlot {
                  address value;
              }
          
              struct BooleanSlot {
                  bool value;
              }
          
              struct Bytes32Slot {
                  bytes32 value;
              }
          
              struct Uint256Slot {
                  uint256 value;
              }
          
              /**
               * @dev Returns an `AddressSlot` with member `value` located at `slot`.
               */
              function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
               */
              function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
               */
              function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
               */
              function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
          }
          
          // File: @openzeppelin/contracts/proxy/ERC1967/ERC1967Upgrade.sol
          
          
          pragma solidity ^0.8.2;
          
          
          
          /**
           * @dev This abstract contract provides getters and event emitting update functions for
           * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
           *
           * _Available since v4.1._
           *
           * @custom:oz-upgrades-unsafe-allow delegatecall
           */
          abstract contract ERC1967Upgrade {
              // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
              bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
          
              /**
               * @dev Storage slot with the address of the current implementation.
               * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
          
              /**
               * @dev Emitted when the implementation is upgraded.
               */
              event Upgraded(address indexed implementation);
          
              /**
               * @dev Returns the current implementation address.
               */
              function _getImplementation() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
              }
          
              /**
               * @dev Stores a new address in the EIP1967 implementation slot.
               */
              function _setImplementation(address newImplementation) private {
                  require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                  StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
              }
          
              /**
               * @dev Perform implementation upgrade
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeTo(address newImplementation) internal {
                  _setImplementation(newImplementation);
                  emit Upgraded(newImplementation);
              }
          
              /**
               * @dev Perform implementation upgrade with additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCall(
                  address newImplementation,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  _upgradeTo(newImplementation);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(newImplementation, data);
                  }
              }
          
              /**
               * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCallSecure(
                  address newImplementation,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  address oldImplementation = _getImplementation();
          
                  // Initial upgrade and setup call
                  _setImplementation(newImplementation);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(newImplementation, data);
                  }
          
                  // Perform rollback test if not already in progress
                  StorageSlot.BooleanSlot storage rollbackTesting = StorageSlot.getBooleanSlot(_ROLLBACK_SLOT);
                  if (!rollbackTesting.value) {
                      // Trigger rollback using upgradeTo from the new implementation
                      rollbackTesting.value = true;
                      Address.functionDelegateCall(
                          newImplementation,
                          abi.encodeWithSignature("upgradeTo(address)", oldImplementation)
                      );
                      rollbackTesting.value = false;
                      // Check rollback was effective
                      require(oldImplementation == _getImplementation(), "ERC1967Upgrade: upgrade breaks further upgrades");
                      // Finally reset to the new implementation and log the upgrade
                      _upgradeTo(newImplementation);
                  }
              }
          
              /**
               * @dev Storage slot with the admin of the contract.
               * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
          
              /**
               * @dev Emitted when the admin account has changed.
               */
              event AdminChanged(address previousAdmin, address newAdmin);
          
              /**
               * @dev Returns the current admin.
               */
              function _getAdmin() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
              }
          
              /**
               * @dev Stores a new address in the EIP1967 admin slot.
               */
              function _setAdmin(address newAdmin) private {
                  require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                  StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
              }
          
              /**
               * @dev Changes the admin of the proxy.
               *
               * Emits an {AdminChanged} event.
               */
              function _changeAdmin(address newAdmin) internal {
                  emit AdminChanged(_getAdmin(), newAdmin);
                  _setAdmin(newAdmin);
              }
          
              /**
               * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
               * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
               */
              bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
          
              /**
               * @dev Emitted when the beacon is upgraded.
               */
              event BeaconUpgraded(address indexed beacon);
          
              /**
               * @dev Returns the current beacon.
               */
              function _getBeacon() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
              }
          
              /**
               * @dev Stores a new beacon in the EIP1967 beacon slot.
               */
              function _setBeacon(address newBeacon) private {
                  require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract");
                  require(
                      Address.isContract(IBeacon(newBeacon).implementation()),
                      "ERC1967: beacon implementation is not a contract"
                  );
                  StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
              }
          
              /**
               * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
               * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
               *
               * Emits a {BeaconUpgraded} event.
               */
              function _upgradeBeaconToAndCall(
                  address newBeacon,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  _setBeacon(newBeacon);
                  emit BeaconUpgraded(newBeacon);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                  }
              }
          }
          
          // File: @openzeppelin/contracts/proxy/beacon/BeaconProxy.sol
          
          
          pragma solidity ^0.8.0;
          
          
          
          /**
           * @dev This contract implements a proxy that gets the implementation address for each call from a {UpgradeableBeacon}.
           *
           * The beacon address is stored in storage slot `uint256(keccak256('eip1967.proxy.beacon')) - 1`, so that it doesn't
           * conflict with the storage layout of the implementation behind the proxy.
           *
           * _Available since v3.4._
           */
          contract BeaconProxy is Proxy, ERC1967Upgrade {
              /**
               * @dev Initializes the proxy with `beacon`.
               *
               * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon. This
               * will typically be an encoded function call, and allows initializating the storage of the proxy like a Solidity
               * constructor.
               *
               * Requirements:
               *
               * - `beacon` must be a contract with the interface {IBeacon}.
               */
              constructor(address beacon, bytes memory data) payable {
                  assert(_BEACON_SLOT == bytes32(uint256(keccak256("eip1967.proxy.beacon")) - 1));
                  _upgradeBeaconToAndCall(beacon, data, false);
              }
          
              /**
               * @dev Returns the current beacon address.
               */
              function _beacon() internal view virtual returns (address) {
                  return _getBeacon();
              }
          
              /**
               * @dev Returns the current implementation address of the associated beacon.
               */
              function _implementation() internal view virtual override returns (address) {
                  return IBeacon(_getBeacon()).implementation();
              }
          
              /**
               * @dev Changes the proxy to use a new beacon. Deprecated: see {_upgradeBeaconToAndCall}.
               *
               * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon.
               *
               * Requirements:
               *
               * - `beacon` must be a contract.
               * - The implementation returned by `beacon` must be a contract.
               */
              function _setBeacon(address beacon, bytes memory data) internal virtual {
                  _upgradeBeaconToAndCall(beacon, data, false);
              }
          }
          
          // File: contracts/bridge/token/Token.sol
          
          // contracts/Structs.sol
          
          pragma solidity ^0.8.0;
          
          contract BridgeToken is BeaconProxy {
              constructor(address beacon, bytes memory data) BeaconProxy(beacon, data) {
          
              }
          }

          File 3 of 6: stakingManagerV3
          // SPDX-License-Identifier: MIT AND Unlicense
          // File @openzeppelin/contracts-upgradeable/utils/[email protected]
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
          pragma solidity ^0.8.1;
          /**
           * @dev Collection of functions related to the address type
           */
          library AddressUpgradeable {
              /**
               * @dev Returns true if `account` is a contract.
               *
               * [IMPORTANT]
               * ====
               * It is unsafe to assume that an address for which this function returns
               * false is an externally-owned account (EOA) and not a contract.
               *
               * Among others, `isContract` will return false for the following
               * types of addresses:
               *
               *  - an externally-owned account
               *  - a contract in construction
               *  - an address where a contract will be created
               *  - an address where a contract lived, but was destroyed
               *
               * Furthermore, `isContract` will also return true if the target contract within
               * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
               * which only has an effect at the end of a transaction.
               * ====
               *
               * [IMPORTANT]
               * ====
               * You shouldn't rely on `isContract` to protect against flash loan attacks!
               *
               * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
               * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
               * constructor.
               * ====
               */
              function isContract(address account) internal view returns (bool) {
                  // This method relies on extcodesize/address.code.length, which returns 0
                  // for contracts in construction, since the code is only stored at the end
                  // of the constructor execution.
                  return account.code.length > 0;
              }
              /**
               * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
               * `recipient`, forwarding all available gas and reverting on errors.
               *
               * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
               * of certain opcodes, possibly making contracts go over the 2300 gas limit
               * imposed by `transfer`, making them unable to receive funds via
               * `transfer`. {sendValue} removes this limitation.
               *
               * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
               *
               * IMPORTANT: because control is transferred to `recipient`, care must be
               * taken to not create reentrancy vulnerabilities. Consider using
               * {ReentrancyGuard} or the
               * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
               */
              function sendValue(address payable recipient, uint256 amount) internal {
                  require(address(this).balance >= amount, "Address: insufficient balance");
                  (bool success, ) = recipient.call{value: amount}("");
                  require(success, "Address: unable to send value, recipient may have reverted");
              }
              /**
               * @dev Performs a Solidity function call using a low level `call`. A
               * plain `call` is an unsafe replacement for a function call: use this
               * function instead.
               *
               * If `target` reverts with a revert reason, it is bubbled up by this
               * function (like regular Solidity function calls).
               *
               * Returns the raw returned data. To convert to the expected return value,
               * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
               *
               * Requirements:
               *
               * - `target` must be a contract.
               * - calling `target` with `data` must not revert.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, "Address: low-level call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
               * `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but also transferring `value` wei to `target`.
               *
               * Requirements:
               *
               * - the calling contract must have an ETH balance of at least `value`.
               * - the called Solidity function must be `payable`.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
              }
              /**
               * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
               * with `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  require(address(this).balance >= value, "Address: insufficient balance for call");
                  (bool success, bytes memory returndata) = target.call{value: value}(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                  return functionStaticCall(target, data, "Address: low-level static call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal view returns (bytes memory) {
                  (bool success, bytes memory returndata) = target.staticcall(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionDelegateCall(target, data, "Address: low-level delegate call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  (bool success, bytes memory returndata) = target.delegatecall(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
               * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
               *
               * _Available since v4.8._
               */
              function verifyCallResultFromTarget(
                  address target,
                  bool success,
                  bytes memory returndata,
                  string memory errorMessage
              ) internal view returns (bytes memory) {
                  if (success) {
                      if (returndata.length == 0) {
                          // only check isContract if the call was successful and the return data is empty
                          // otherwise we already know that it was a contract
                          require(isContract(target), "Address: call to non-contract");
                      }
                      return returndata;
                  } else {
                      _revert(returndata, errorMessage);
                  }
              }
              /**
               * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
               * revert reason or using the provided one.
               *
               * _Available since v4.3._
               */
              function verifyCallResult(
                  bool success,
                  bytes memory returndata,
                  string memory errorMessage
              ) internal pure returns (bytes memory) {
                  if (success) {
                      return returndata;
                  } else {
                      _revert(returndata, errorMessage);
                  }
              }
              function _revert(bytes memory returndata, string memory errorMessage) private pure {
                  // Look for revert reason and bubble it up if present
                  if (returndata.length > 0) {
                      // The easiest way to bubble the revert reason is using memory via assembly
                      /// @solidity memory-safe-assembly
                      assembly {
                          let returndata_size := mload(returndata)
                          revert(add(32, returndata), returndata_size)
                      }
                  } else {
                      revert(errorMessage);
                  }
              }
          }
          // File @openzeppelin/contracts-upgradeable/proxy/utils/[email protected]
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)
          pragma solidity ^0.8.2;
          /**
           * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
           * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
           * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
           * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
           *
           * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
           * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
           * case an upgrade adds a module that needs to be initialized.
           *
           * For example:
           *
           * [.hljs-theme-light.nopadding]
           * ```solidity
           * contract MyToken is ERC20Upgradeable {
           *     function initialize() initializer public {
           *         __ERC20_init("MyToken", "MTK");
           *     }
           * }
           *
           * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
           *     function initializeV2() reinitializer(2) public {
           *         __ERC20Permit_init("MyToken");
           *     }
           * }
           * ```
           *
           * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
           * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
           *
           * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
           * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
           *
           * [CAUTION]
           * ====
           * Avoid leaving a contract uninitialized.
           *
           * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
           * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
           * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
           *
           * [.hljs-theme-light.nopadding]
           * ```
           * /// @custom:oz-upgrades-unsafe-allow constructor
           * constructor() {
           *     _disableInitializers();
           * }
           * ```
           * ====
           */
          abstract contract Initializable {
              /**
               * @dev Indicates that the contract has been initialized.
               * @custom:oz-retyped-from bool
               */
              uint8 private _initialized;
              /**
               * @dev Indicates that the contract is in the process of being initialized.
               */
              bool private _initializing;
              /**
               * @dev Triggered when the contract has been initialized or reinitialized.
               */
              event Initialized(uint8 version);
              /**
               * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
               * `onlyInitializing` functions can be used to initialize parent contracts.
               *
               * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
               * constructor.
               *
               * Emits an {Initialized} event.
               */
              modifier initializer() {
                  bool isTopLevelCall = !_initializing;
                  require(
                      (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
                      "Initializable: contract is already initialized"
                  );
                  _initialized = 1;
                  if (isTopLevelCall) {
                      _initializing = true;
                  }
                  _;
                  if (isTopLevelCall) {
                      _initializing = false;
                      emit Initialized(1);
                  }
              }
              /**
               * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
               * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
               * used to initialize parent contracts.
               *
               * A reinitializer may be used after the original initialization step. This is essential to configure modules that
               * are added through upgrades and that require initialization.
               *
               * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
               * cannot be nested. If one is invoked in the context of another, execution will revert.
               *
               * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
               * a contract, executing them in the right order is up to the developer or operator.
               *
               * WARNING: setting the version to 255 will prevent any future reinitialization.
               *
               * Emits an {Initialized} event.
               */
              modifier reinitializer(uint8 version) {
                  require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
                  _initialized = version;
                  _initializing = true;
                  _;
                  _initializing = false;
                  emit Initialized(version);
              }
              /**
               * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
               * {initializer} and {reinitializer} modifiers, directly or indirectly.
               */
              modifier onlyInitializing() {
                  require(_initializing, "Initializable: contract is not initializing");
                  _;
              }
              /**
               * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
               * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
               * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
               * through proxies.
               *
               * Emits an {Initialized} event the first time it is successfully executed.
               */
              function _disableInitializers() internal virtual {
                  require(!_initializing, "Initializable: contract is initializing");
                  if (_initialized != type(uint8).max) {
                      _initialized = type(uint8).max;
                      emit Initialized(type(uint8).max);
                  }
              }
              /**
               * @dev Returns the highest version that has been initialized. See {reinitializer}.
               */
              function _getInitializedVersion() internal view returns (uint8) {
                  return _initialized;
              }
              /**
               * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
               */
              function _isInitializing() internal view returns (bool) {
                  return _initializing;
              }
          }
          // File @openzeppelin/contracts-upgradeable/utils/[email protected]
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev Provides information about the current execution context, including the
           * sender of the transaction and its data. While these are generally available
           * via msg.sender and msg.data, they should not be accessed in such a direct
           * manner, since when dealing with meta-transactions the account sending and
           * paying for execution may not be the actual sender (as far as an application
           * is concerned).
           *
           * This contract is only required for intermediate, library-like contracts.
           */
          abstract contract 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;
              }
              /**
               * @dev This empty reserved space is put in place to allow future versions to add new
               * variables without shifting down storage in the inheritance chain.
               * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
               */
              uint256[50] private __gap;
          }
          // File @openzeppelin/contracts-upgradeable/access/[email protected]
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev Contract module which provides a basic access control mechanism, where
           * there is an account (an owner) that can be granted exclusive access to
           * specific functions.
           *
           * By default, the owner account will be the one that deploys the contract. This
           * can later be changed with {transferOwnership}.
           *
           * This module is used through inheritance. It will make available the modifier
           * `onlyOwner`, which can be applied to your functions to restrict their use to
           * the owner.
           */
          abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {
              address private _owner;
              event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
              /**
               * @dev Initializes the contract setting the deployer as the initial owner.
               */
              function __Ownable_init() internal onlyInitializing {
                  __Ownable_init_unchained();
              }
              function __Ownable_init_unchained() internal onlyInitializing {
                  _transferOwnership(_msgSender());
              }
              /**
               * @dev Throws if called by any account other than the owner.
               */
              modifier onlyOwner() {
                  _checkOwner();
                  _;
              }
              /**
               * @dev Returns the address of the current owner.
               */
              function owner() public view virtual returns (address) {
                  return _owner;
              }
              /**
               * @dev Throws if the sender is not the owner.
               */
              function _checkOwner() internal view virtual {
                  require(owner() == _msgSender(), "Ownable: caller is not the owner");
              }
              /**
               * @dev Leaves the contract without owner. It will not be possible to call
               * `onlyOwner` functions. Can only be called by the current owner.
               *
               * NOTE: Renouncing ownership will leave the contract without an owner,
               * thereby disabling any functionality that is only available to the owner.
               */
              function renounceOwnership() public virtual onlyOwner {
                  _transferOwnership(address(0));
              }
              /**
               * @dev Transfers ownership of the contract to a new account (`newOwner`).
               * Can only be called by the current owner.
               */
              function transferOwnership(address newOwner) public virtual onlyOwner {
                  require(newOwner != address(0), "Ownable: new owner is the zero address");
                  _transferOwnership(newOwner);
              }
              /**
               * @dev Transfers ownership of the contract to a new account (`newOwner`).
               * Internal function without access restriction.
               */
              function _transferOwnership(address newOwner) internal virtual {
                  address oldOwner = _owner;
                  _owner = newOwner;
                  emit OwnershipTransferred(oldOwner, newOwner);
              }
              /**
               * @dev This empty reserved space is put in place to allow future versions to add new
               * variables without shifting down storage in the inheritance chain.
               * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
               */
              uint256[49] private __gap;
          }
          // File @openzeppelin/contracts-upgradeable/token/ERC20/extensions/[email protected]
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/extensions/IERC20Permit.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
           * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
           *
           * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
           * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
           * need to send a transaction, and thus is not required to hold Ether at all.
           */
          interface IERC20PermitUpgradeable {
              /**
               * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
               * given ``owner``'s signed approval.
               *
               * IMPORTANT: The same issues {IERC20-approve} has related to transaction
               * ordering also apply here.
               *
               * Emits an {Approval} event.
               *
               * Requirements:
               *
               * - `spender` cannot be the zero address.
               * - `deadline` must be a timestamp in the future.
               * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
               * over the EIP712-formatted function arguments.
               * - the signature must use ``owner``'s current nonce (see {nonces}).
               *
               * For more information on the signature format, see the
               * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
               * section].
               */
              function permit(
                  address owner,
                  address spender,
                  uint256 value,
                  uint256 deadline,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) external;
              /**
               * @dev Returns the current nonce for `owner`. This value must be
               * included whenever a signature is generated for {permit}.
               *
               * Every successful call to {permit} increases ``owner``'s nonce by one. This
               * prevents a signature from being used multiple times.
               */
              function nonces(address owner) external view returns (uint256);
              /**
               * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
               */
              // solhint-disable-next-line func-name-mixedcase
              function DOMAIN_SEPARATOR() external view returns (bytes32);
          }
          // File @openzeppelin/contracts-upgradeable/token/ERC20/[email protected]
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev Interface of the ERC20 standard as defined in the EIP.
           */
          interface IERC20Upgradeable {
              /**
               * @dev Emitted when `value` tokens are moved from one account (`from`) to
               * another (`to`).
               *
               * Note that `value` may be zero.
               */
              event Transfer(address indexed from, address indexed to, uint256 value);
              /**
               * @dev Emitted when the allowance of a `spender` for an `owner` is set by
               * a call to {approve}. `value` is the new allowance.
               */
              event Approval(address indexed owner, address indexed spender, uint256 value);
              /**
               * @dev Returns the amount of tokens in existence.
               */
              function totalSupply() external view returns (uint256);
              /**
               * @dev Returns the amount of tokens owned by `account`.
               */
              function balanceOf(address account) external view returns (uint256);
              /**
               * @dev Moves `amount` tokens from the caller's account to `to`.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * Emits a {Transfer} event.
               */
              function transfer(address to, uint256 amount) external returns (bool);
              /**
               * @dev Returns the remaining number of tokens that `spender` will be
               * allowed to spend on behalf of `owner` through {transferFrom}. This is
               * zero by default.
               *
               * This value changes when {approve} or {transferFrom} are called.
               */
              function allowance(address owner, address spender) external view returns (uint256);
              /**
               * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * IMPORTANT: Beware that changing an allowance with this method brings the risk
               * that someone may use both the old and the new allowance by unfortunate
               * transaction ordering. One possible solution to mitigate this race
               * condition is to first reduce the spender's allowance to 0 and set the
               * desired value afterwards:
               * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
               *
               * Emits an {Approval} event.
               */
              function approve(address spender, uint256 amount) external returns (bool);
              /**
               * @dev Moves `amount` tokens from `from` to `to` using the
               * allowance mechanism. `amount` is then deducted from the caller's
               * allowance.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * Emits a {Transfer} event.
               */
              function transferFrom(address from, address to, uint256 amount) external returns (bool);
          }
          // File @openzeppelin/contracts-upgradeable/token/ERC20/utils/[email protected]
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)
          pragma solidity ^0.8.0;
          /**
           * @title SafeERC20
           * @dev Wrappers around ERC20 operations that throw on failure (when the token
           * contract returns false). Tokens that return no value (and instead revert or
           * throw on failure) are also supported, non-reverting calls are assumed to be
           * successful.
           * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
           * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
           */
          library SafeERC20Upgradeable {
              using AddressUpgradeable for address;
              /**
               * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,
               * non-reverting calls are assumed to be successful.
               */
              function safeTransfer(IERC20Upgradeable token, address to, uint256 value) internal {
                  _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
              }
              /**
               * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the
               * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.
               */
              function safeTransferFrom(IERC20Upgradeable token, address from, address to, uint256 value) internal {
                  _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
              }
              /**
               * @dev Deprecated. This function has issues similar to the ones found in
               * {IERC20-approve}, and its usage is discouraged.
               *
               * Whenever possible, use {safeIncreaseAllowance} and
               * {safeDecreaseAllowance} instead.
               */
              function safeApprove(IERC20Upgradeable token, address spender, uint256 value) internal {
                  // safeApprove should only be called when setting an initial allowance,
                  // or when resetting it to zero. To increase and decrease it, use
                  // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                  require(
                      (value == 0) || (token.allowance(address(this), spender) == 0),
                      "SafeERC20: approve from non-zero to non-zero allowance"
                  );
                  _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
              }
              /**
               * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,
               * non-reverting calls are assumed to be successful.
               */
              function safeIncreaseAllowance(IERC20Upgradeable token, address spender, uint256 value) internal {
                  uint256 oldAllowance = token.allowance(address(this), spender);
                  _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));
              }
              /**
               * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,
               * non-reverting calls are assumed to be successful.
               */
              function safeDecreaseAllowance(IERC20Upgradeable token, address spender, uint256 value) internal {
                  unchecked {
                      uint256 oldAllowance = token.allowance(address(this), spender);
                      require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
                      _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));
                  }
              }
              /**
               * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,
               * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval
               * to be set to zero before setting it to a non-zero value, such as USDT.
               */
              function forceApprove(IERC20Upgradeable token, address spender, uint256 value) internal {
                  bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);
                  if (!_callOptionalReturnBool(token, approvalCall)) {
                      _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));
                      _callOptionalReturn(token, approvalCall);
                  }
              }
              /**
               * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.
               * Revert on invalid signature.
               */
              function safePermit(
                  IERC20PermitUpgradeable token,
                  address owner,
                  address spender,
                  uint256 value,
                  uint256 deadline,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) internal {
                  uint256 nonceBefore = token.nonces(owner);
                  token.permit(owner, spender, value, deadline, v, r, s);
                  uint256 nonceAfter = token.nonces(owner);
                  require(nonceAfter == nonceBefore + 1, "SafeERC20: permit did not succeed");
              }
              /**
               * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
               * on the return value: the return value is optional (but if data is returned, it must not be false).
               * @param token The token targeted by the call.
               * @param data The call data (encoded using abi.encode or one of its variants).
               */
              function _callOptionalReturn(IERC20Upgradeable token, bytes memory data) private {
                  // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                  // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that
                  // the target address contains contract code and also asserts for success in the low-level call.
                  bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
                  require(returndata.length == 0 || abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
              }
              /**
               * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
               * on the return value: the return value is optional (but if data is returned, it must not be false).
               * @param token The token targeted by the call.
               * @param data The call data (encoded using abi.encode or one of its variants).
               *
               * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.
               */
              function _callOptionalReturnBool(IERC20Upgradeable token, bytes memory data) private returns (bool) {
                  // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                  // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false
                  // and not revert is the subcall reverts.
                  (bool success, bytes memory returndata) = address(token).call(data);
                  return
                      success && (returndata.length == 0 || abi.decode(returndata, (bool))) && AddressUpgradeable.isContract(address(token));
              }
          }
          // File contracts/stakingManagerV3.sol
          // Original license: SPDX_License_Identifier: Unlicense
          pragma solidity 0.8.9;
          contract stakingManagerV3 is OwnableUpgradeable {
            using SafeERC20Upgradeable for IERC20Upgradeable; // Wrappers around ERC20 operations that throw on failure
            IERC20Upgradeable public stakeToken; // Token to be staked and rewarded
            address public presaleContract; //presale contract address
            uint256 public tokensStakedByPresale; //total tokens staked by preSale
            uint256 public tokensStaked; // Total tokens staked
            uint256 public lockedTime; //To lock the tokens in contract for definite time.
            uint256 public apy; // fixed APY
            uint256 public rewardsPrecision; // A big number to perform mul and div operations  bool public withdrawLocked;
            bool public withdrawLocked; //
            bool public directStakeLocked; //
            bool public claimsLocked; //
            // Staking user for a pool
            struct PoolStaker {
              uint256 amount; // The tokens quantity the user has staked.
              uint256 stakedTime; //the time at tokens staked
              uint256 withdrawalTime; // the time when user can unstake tokens
              uint256 lastRewardsClaimTime; //
            }
            mapping(address => PoolStaker) public poolStakers;
            mapping(address => uint256) public userPendingRewards;
            mapping(address => bool) public isBlacklisted;
            address public burnWallet;
            bool public earlyUnstakingEnabled;
            // Events
            event Staked(address indexed user, uint256 amount);
            event Unstaked(address indexed user, uint256 amount);
            event EarlyUnstaked(address indexed user, uint256 actualAmount, uint256 amount);
            event RewardsClaimed(address indexed user, uint256 amount);
            /// @custom:oz-upgrades-unsafe-allow constructor
            constructor() {
              _disableInitializers();
            }
            function __stakingManager_init(address _stakeTokenAddress, address _presaleContract, uint _lockTime, uint _apy) public initializer {
              __Ownable_init_unchained();
              stakeToken = IERC20Upgradeable(_stakeTokenAddress);
              rewardsPrecision = 10 ** 18;
              presaleContract = _presaleContract;
              lockedTime = _lockTime;
              apy = _apy;
              withdrawLocked = true;
            }
            modifier onlyPresale() {
              require(msg.sender == presaleContract, 'This method is only for presale Contract');
              _;
            }
            /**
             * @dev stake tokens to the pool
             */
            function stake(uint256 _amount) external {
              require(!isBlacklisted[_msgSender()], 'This Address is Blacklisted');
              require(_amount > 0, "Deposit amount can't be zero");
              require(!directStakeLocked, 'Direct staking is locked');
              PoolStaker storage staker = poolStakers[msg.sender];
              if (staker.withdrawalTime >= block.timestamp) {
                userPendingRewards[msg.sender] += getRewards(msg.sender);
                staker.lastRewardsClaimTime = block.timestamp;
              } else {
                // claim pending rewards
                _claimRewards(msg.sender);
              }
              // Update current staker
              staker.amount += _amount;
              staker.stakedTime = block.timestamp;
              staker.withdrawalTime = block.timestamp + lockedTime;
              // Update pool
              tokensStaked += _amount;
              // Staked tokens
              emit Staked(msg.sender, _amount);
              stakeToken.safeTransferFrom(msg.sender, address(this), _amount);
            }
            /**
             * @dev stake tokens on behalf of users from presale contract
             */
            function stakeByPresale(address _user, uint256 _amount) external onlyPresale {
              require(!isBlacklisted[_user], 'This Address is Blacklisted');
              require(_amount > 0, "Deposit amount can't be zero");
              PoolStaker storage staker = poolStakers[_user];
              if (staker.withdrawalTime >= block.timestamp) {
                userPendingRewards[_user] += getRewards(_user);
                staker.lastRewardsClaimTime = block.timestamp;
              } else {
                // claim pending rewards
                _claimRewards(_user);
              }
              // Update current staker
              staker.amount += _amount;
              staker.stakedTime = block.timestamp;
              staker.withdrawalTime = block.timestamp + lockedTime;
              // Update pool
              tokensStaked += _amount;
              tokensStakedByPresale += _amount;
              // Staked tokens
              emit Staked(_user, _amount);
              stakeToken.safeTransferFrom(presaleContract, address(this), _amount);
            }
            /**
             * @dev claim user rewards
             */
            function claimRewards() public {
              require(!claimsLocked, 'Direct staking is locked');
              PoolStaker storage staker = poolStakers[msg.sender];
              require(staker.withdrawalTime <= block.timestamp, 'you are not allowed to claim rewards during lock');
              _claimRewards(msg.sender);
            }
            /**
             * @dev claim user rewards
             */
            function _claimRewards(address _user) private {
              require(!isBlacklisted[_user], 'This Address is Blacklisted');
              PoolStaker storage staker = poolStakers[_user];
              uint256 timePassedRatio = ((block.timestamp - staker.lastRewardsClaimTime) * rewardsPrecision) / (365 * 86400);
              uint256 rewards = ((timePassedRatio * apy * staker.amount) / rewardsPrecision) / 100;
              rewards += userPendingRewards[_user];
              delete userPendingRewards[_user];
              staker.lastRewardsClaimTime = block.timestamp;
              if (rewards > 0) {
                stakeToken.safeTransfer(_user, rewards);
                emit RewardsClaimed(_user, rewards);
              }
            }
            /**
             * @dev unstake all tokens from existing pool
             */
            function unstake() external {
              require(!isBlacklisted[_msgSender()], 'This Address is Blacklisted');
              require(!withdrawLocked, 'Withdrwals are Locked');
              PoolStaker memory staker = poolStakers[msg.sender];
              uint256 amount = staker.amount;
              require(amount > 0, "Withdraw amount can't be zero");
              if (staker.withdrawalTime >= block.timestamp) {
                require(earlyUnstakingEnabled, 'early unstake not enabled yet');
                uint256 userAmount = ((amount * ((block.timestamp - staker.stakedTime) * (rewardsPrecision))) / (staker.withdrawalTime - staker.stakedTime)) / (rewardsPrecision);
                // Unstaked tokens
                emit EarlyUnstaked(msg.sender, amount, userAmount);
                stakeToken.safeTransfer(burnWallet, amount - userAmount); //trafer to burn wallet
                stakeToken.safeTransfer(msg.sender, userAmount); // transfer to user
              } else {
                // claim pending rewards
                _claimRewards(msg.sender);
                // Unstaked tokens
                emit Unstaked(msg.sender, amount);
                stakeToken.safeTransfer(msg.sender, amount);
              }
              // Update pool
              tokensStaked -= amount;
              //delete staker
              delete poolStakers[msg.sender];
            }
            /**
             *@dev To get the number of rewards that user can get
             */
            function getRewards(address _user) public view returns (uint) {
              PoolStaker memory staker = poolStakers[_user];
              uint256 timePassedRatio = ((block.timestamp - staker.lastRewardsClaimTime) * rewardsPrecision) / (365 * 86400);
              uint256 rewards = ((timePassedRatio * apy * staker.amount) / rewardsPrecision) / 100;
              return rewards;
            }
            function setPresale(address _presale) external onlyOwner {
              presaleContract = _presale;
            }
            function setStakeToken(address _stakeToken) external onlyOwner {
              stakeToken = IERC20Upgradeable(_stakeToken);
            }
            function setLockedTime(uint _lockedTime) external onlyOwner {
              lockedTime = _lockedTime;
            }
            function setAPY(uint _apy) external onlyOwner {
              apy = _apy;
            }
            function setWithdrawLocked(bool _withdrawLocked) external onlyOwner {
              withdrawLocked = _withdrawLocked;
            }
            function setDirectStakeLocked(bool _directStakeLocked) external onlyOwner {
              directStakeLocked = _directStakeLocked;
            }
            function setClaimsLocked(bool _claimsLocked) external onlyOwner {
              claimsLocked = _claimsLocked;
            }
            function setBurnWallet(bool _earlyUnstakingEnabled, address _burnWallet) external onlyOwner {
              earlyUnstakingEnabled = _earlyUnstakingEnabled;
              burnWallet = _burnWallet;
            }
            /**
             * @dev To add users to blacklist which restricts blacklisted users from claiming
             * @param _usersToBlacklist addresses of the users
             */
            function blacklistUsers(address[] calldata _usersToBlacklist) external onlyOwner {
              for (uint256 i = 0; i < _usersToBlacklist.length; i++) {
                isBlacklisted[_usersToBlacklist[i]] = true;
              }
            }
            /**
             * @dev To remove users from blacklist which restricts blacklisted users from claiming
             * @param _userToRemoveFromBlacklist addresses of the users
             */
            function removeFromBlacklist(address[] calldata _userToRemoveFromBlacklist) external onlyOwner {
              for (uint256 i = 0; i < _userToRemoveFromBlacklist.length; i++) {
                isBlacklisted[_userToRemoveFromBlacklist[i]] = false;
              }
            }
          }
          

          File 4 of 6: TokenBridge
          // contracts/Wormhole.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          import "@openzeppelin/contracts/proxy/ERC1967/ERC1967Proxy.sol";
          contract TokenBridge is ERC1967Proxy {
              constructor (address implementation, bytes memory initData)
              ERC1967Proxy(
                  implementation,
                  initData
              )
              {}
          }// SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          import "../Proxy.sol";
          import "./ERC1967Upgrade.sol";
          /**
           * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
           * implementation address that can be changed. This address is stored in storage in the location specified by
           * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
           * implementation behind the proxy.
           */
          contract ERC1967Proxy is Proxy, ERC1967Upgrade {
              /**
               * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
               *
               * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
               * function call, and allows initializating the storage of the proxy like a Solidity constructor.
               */
              constructor(address _logic, bytes memory _data) payable {
                  assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256("eip1967.proxy.implementation")) - 1));
                  _upgradeToAndCall(_logic, _data, false);
              }
              /**
               * @dev Returns the current implementation address.
               */
              function _implementation() internal view virtual override returns (address impl) {
                  return ERC1967Upgrade._getImplementation();
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.2;
          import "../beacon/IBeacon.sol";
          import "../../utils/Address.sol";
          import "../../utils/StorageSlot.sol";
          /**
           * @dev This abstract contract provides getters and event emitting update functions for
           * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
           *
           * _Available since v4.1._
           *
           * @custom:oz-upgrades-unsafe-allow delegatecall
           */
          abstract contract ERC1967Upgrade {
              // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
              bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
              /**
               * @dev Storage slot with the address of the current implementation.
               * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
              /**
               * @dev Emitted when the implementation is upgraded.
               */
              event Upgraded(address indexed implementation);
              /**
               * @dev Returns the current implementation address.
               */
              function _getImplementation() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
              }
              /**
               * @dev Stores a new address in the EIP1967 implementation slot.
               */
              function _setImplementation(address newImplementation) private {
                  require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                  StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
              }
              /**
               * @dev Perform implementation upgrade
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeTo(address newImplementation) internal {
                  _setImplementation(newImplementation);
                  emit Upgraded(newImplementation);
              }
              /**
               * @dev Perform implementation upgrade with additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
                  _setImplementation(newImplementation);
                  emit Upgraded(newImplementation);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(newImplementation, data);
                  }
              }
              /**
               * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCallSecure(address newImplementation, bytes memory data, bool forceCall) internal {
                  address oldImplementation = _getImplementation();
                  // Initial upgrade and setup call
                  _setImplementation(newImplementation);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(newImplementation, data);
                  }
                  // Perform rollback test if not already in progress
                  StorageSlot.BooleanSlot storage rollbackTesting = StorageSlot.getBooleanSlot(_ROLLBACK_SLOT);
                  if (!rollbackTesting.value) {
                      // Trigger rollback using upgradeTo from the new implementation
                      rollbackTesting.value = true;
                      Address.functionDelegateCall(
                          newImplementation,
                          abi.encodeWithSignature(
                              "upgradeTo(address)",
                              oldImplementation
                          )
                      );
                      rollbackTesting.value = false;
                      // Check rollback was effective
                      require(oldImplementation == _getImplementation(), "ERC1967Upgrade: upgrade breaks further upgrades");
                      // Finally reset to the new implementation and log the upgrade
                      _setImplementation(newImplementation);
                      emit Upgraded(newImplementation);
                  }
              }
              /**
               * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
               * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
               *
               * Emits a {BeaconUpgraded} event.
               */
              function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
                  _setBeacon(newBeacon);
                  emit BeaconUpgraded(newBeacon);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                  }
              }
              /**
               * @dev Storage slot with the admin of the contract.
               * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
              /**
               * @dev Emitted when the admin account has changed.
               */
              event AdminChanged(address previousAdmin, address newAdmin);
              /**
               * @dev Returns the current admin.
               */
              function _getAdmin() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
              }
              /**
               * @dev Stores a new address in the EIP1967 admin slot.
               */
              function _setAdmin(address newAdmin) private {
                  require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                  StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
              }
              /**
               * @dev Changes the admin of the proxy.
               *
               * Emits an {AdminChanged} event.
               */
              function _changeAdmin(address newAdmin) internal {
                  emit AdminChanged(_getAdmin(), newAdmin);
                  _setAdmin(newAdmin);
              }
              /**
               * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
               * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
               */
              bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
              /**
               * @dev Emitted when the beacon is upgraded.
               */
              event BeaconUpgraded(address indexed beacon);
              /**
               * @dev Returns the current beacon.
               */
              function _getBeacon() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
              }
              /**
               * @dev Stores a new beacon in the EIP1967 beacon slot.
               */
              function _setBeacon(address newBeacon) private {
                  require(
                      Address.isContract(newBeacon),
                      "ERC1967: new beacon is not a contract"
                  );
                  require(
                      Address.isContract(IBeacon(newBeacon).implementation()),
                      "ERC1967: beacon implementation is not a contract"
                  );
                  StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
           * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
           * be specified by overriding the virtual {_implementation} function.
           *
           * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
           * different contract through the {_delegate} function.
           *
           * The success and return data of the delegated call will be returned back to the caller of the proxy.
           */
          abstract contract Proxy {
              /**
               * @dev Delegates the current call to `implementation`.
               *
               * This function does not return to its internall call site, it will return directly to the external caller.
               */
              function _delegate(address implementation) internal virtual {
                  // solhint-disable-next-line no-inline-assembly
                  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 overriden 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 internall call site, it will return directly to the external caller.
               */
              function _fallback() internal virtual {
                  _beforeFallback();
                  _delegate(_implementation());
              }
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
               * function in the contract matches the call data.
               */
              fallback () external payable virtual {
                  _fallback();
              }
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
               * is empty.
               */
              receive () external payable virtual {
                  _fallback();
              }
              /**
               * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
               * call, or as part of the Solidity `fallback` or `receive` functions.
               *
               * If overriden should call `super._beforeFallback()`.
               */
              function _beforeFallback() internal virtual {
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev This is the interface that {BeaconProxy} expects of its beacon.
           */
          interface IBeacon {
              /**
               * @dev Must return an address that can be used as a delegate call target.
               *
               * {BeaconProxy} will check that this address is a contract.
               */
              function implementation() external view returns (address);
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev Collection of functions related to the address type
           */
          library Address {
              /**
               * @dev Returns true if `account` is a contract.
               *
               * [IMPORTANT]
               * ====
               * It is unsafe to assume that an address for which this function returns
               * false is an externally-owned account (EOA) and not a contract.
               *
               * Among others, `isContract` will return false for the following
               * types of addresses:
               *
               *  - an externally-owned account
               *  - a contract in construction
               *  - an address where a contract will be created
               *  - an address where a contract lived, but was destroyed
               * ====
               */
              function isContract(address account) internal view returns (bool) {
                  // This method relies on extcodesize, which returns 0 for contracts in
                  // construction, since the code is only stored at the end of the
                  // constructor execution.
                  uint256 size;
                  // solhint-disable-next-line no-inline-assembly
                  assembly { size := extcodesize(account) }
                  return size > 0;
              }
              /**
               * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
               * `recipient`, forwarding all available gas and reverting on errors.
               *
               * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
               * of certain opcodes, possibly making contracts go over the 2300 gas limit
               * imposed by `transfer`, making them unable to receive funds via
               * `transfer`. {sendValue} removes this limitation.
               *
               * https://diligence.consensys.net/posts/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.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
               */
              function sendValue(address payable recipient, uint256 amount) internal {
                  require(address(this).balance >= amount, "Address: insufficient balance");
                  // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                  (bool success, ) = recipient.call{ value: amount }("");
                  require(success, "Address: unable to send value, recipient may have reverted");
              }
              /**
               * @dev Performs a Solidity function call using a low level `call`. A
               * plain`call` is an unsafe replacement for a function call: use this
               * function instead.
               *
               * If `target` reverts with a revert reason, it is bubbled up by this
               * function (like regular Solidity function calls).
               *
               * Returns the raw returned data. To convert to the expected return value,
               * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
               *
               * Requirements:
               *
               * - `target` must be a contract.
               * - calling `target` with `data` must not revert.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionCall(target, data, "Address: low-level call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
               * `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but also transferring `value` wei to `target`.
               *
               * Requirements:
               *
               * - the calling contract must have an ETH balance of at least `value`.
               * - the called Solidity function must be `payable`.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
              }
              /**
               * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
               * with `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
                  require(address(this).balance >= value, "Address: insufficient balance for call");
                  require(isContract(target), "Address: call to non-contract");
                  // solhint-disable-next-line avoid-low-level-calls
                  (bool success, bytes memory returndata) = target.call{ value: value }(data);
                  return _verifyCallResult(success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                  return functionStaticCall(target, data, "Address: low-level static call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(address target, bytes memory data, string memory errorMessage) internal view returns (bytes memory) {
                  require(isContract(target), "Address: static call to non-contract");
                  // solhint-disable-next-line avoid-low-level-calls
                  (bool success, bytes memory returndata) = target.staticcall(data);
                  return _verifyCallResult(success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionDelegateCall(target, data, "Address: low-level delegate call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                  require(isContract(target), "Address: delegate call to non-contract");
                  // solhint-disable-next-line avoid-low-level-calls
                  (bool success, bytes memory returndata) = target.delegatecall(data);
                  return _verifyCallResult(success, returndata, errorMessage);
              }
              function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {
                  if (success) {
                      return returndata;
                  } else {
                      // 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
                          // solhint-disable-next-line no-inline-assembly
                          assembly {
                              let returndata_size := mload(returndata)
                              revert(add(32, returndata), returndata_size)
                          }
                      } else {
                          revert(errorMessage);
                      }
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev Library for reading and writing primitive types to specific storage slots.
           *
           * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
           * This library helps with reading and writing to such slots without the need for inline assembly.
           *
           * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
           *
           * Example usage to set ERC1967 implementation slot:
           * ```
           * contract ERC1967 {
           *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
           *
           *     function _getImplementation() internal view returns (address) {
           *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
           *     }
           *
           *     function _setImplementation(address newImplementation) internal {
           *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
           *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
           *     }
           * }
           * ```
           *
           * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
           */
          library StorageSlot {
              struct AddressSlot {
                  address value;
              }
              struct BooleanSlot {
                  bool value;
              }
              struct Bytes32Slot {
                  bytes32 value;
              }
              struct Uint256Slot {
                  uint256 value;
              }
              /**
               * @dev Returns an `AddressSlot` with member `value` located at `slot`.
               */
              function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
               */
              function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
               */
              function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
               */
              function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
          }
          

          File 5 of 6: BridgeImplementation
          // contracts/Implementation.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          pragma experimental ABIEncoderV2;
          import "@openzeppelin/contracts/proxy/ERC1967/ERC1967Upgrade.sol";
          import "./Bridge.sol";
          contract BridgeImplementation is Bridge {
              // Beacon getter for the token contracts
              function implementation() public view returns (address) {
                  return tokenImplementation();
              }
              function initialize() initializer public virtual {
                  // this function needs to be exposed for an upgrade to pass
              }
              modifier initializer() {
                  address impl = ERC1967Upgrade._getImplementation();
                  require(
                      !isInitialized(impl),
                      "already initialized"
                  );
                  setInitialized(impl);
                  _;
              }
          }
          // SPDX-License-Identifier: Unlicense
          /*
           * @title Solidity Bytes Arrays Utils
           * @author Gonçalo Sá <[email protected]>
           *
           * @dev Bytes tightly packed arrays utility library for ethereum contracts written in Solidity.
           *      The library lets you concatenate, slice and type cast bytes arrays both in memory and storage.
           */
          pragma solidity >=0.8.0 <0.9.0;
          library BytesLib {
              function concat(
                  bytes memory _preBytes,
                  bytes memory _postBytes
              )
                  internal
                  pure
                  returns (bytes memory)
              {
                  bytes memory tempBytes;
                  assembly {
                      // Get a location of some free memory and store it in tempBytes as
                      // Solidity does for memory variables.
                      tempBytes := mload(0x40)
                      // Store the length of the first bytes array at the beginning of
                      // the memory for tempBytes.
                      let length := mload(_preBytes)
                      mstore(tempBytes, length)
                      // Maintain a memory counter for the current write location in the
                      // temp bytes array by adding the 32 bytes for the array length to
                      // the starting location.
                      let mc := add(tempBytes, 0x20)
                      // Stop copying when the memory counter reaches the length of the
                      // first bytes array.
                      let end := add(mc, length)
                      for {
                          // Initialize a copy counter to the start of the _preBytes data,
                          // 32 bytes into its memory.
                          let cc := add(_preBytes, 0x20)
                      } lt(mc, end) {
                          // Increase both counters by 32 bytes each iteration.
                          mc := add(mc, 0x20)
                          cc := add(cc, 0x20)
                      } {
                          // Write the _preBytes data into the tempBytes memory 32 bytes
                          // at a time.
                          mstore(mc, mload(cc))
                      }
                      // Add the length of _postBytes to the current length of tempBytes
                      // and store it as the new length in the first 32 bytes of the
                      // tempBytes memory.
                      length := mload(_postBytes)
                      mstore(tempBytes, add(length, mload(tempBytes)))
                      // Move the memory counter back from a multiple of 0x20 to the
                      // actual end of the _preBytes data.
                      mc := end
                      // Stop copying when the memory counter reaches the new combined
                      // length of the arrays.
                      end := add(mc, length)
                      for {
                          let cc := add(_postBytes, 0x20)
                      } lt(mc, end) {
                          mc := add(mc, 0x20)
                          cc := add(cc, 0x20)
                      } {
                          mstore(mc, mload(cc))
                      }
                      // Update the free-memory pointer by padding our last write location
                      // to 32 bytes: add 31 bytes to the end of tempBytes to move to the
                      // next 32 byte block, then round down to the nearest multiple of
                      // 32. If the sum of the length of the two arrays is zero then add
                      // one before rounding down to leave a blank 32 bytes (the length block with 0).
                      mstore(0x40, and(
                        add(add(end, iszero(add(length, mload(_preBytes)))), 31),
                        not(31) // Round down to the nearest 32 bytes.
                      ))
                  }
                  return tempBytes;
              }
              function concatStorage(bytes storage _preBytes, bytes memory _postBytes) internal {
                  assembly {
                      // Read the first 32 bytes of _preBytes storage, which is the length
                      // of the array. (We don't need to use the offset into the slot
                      // because arrays use the entire slot.)
                      let fslot := sload(_preBytes.slot)
                      // Arrays of 31 bytes or less have an even value in their slot,
                      // while longer arrays have an odd value. The actual length is
                      // the slot divided by two for odd values, and the lowest order
                      // byte divided by two for even values.
                      // If the slot is even, bitwise and the slot with 255 and divide by
                      // two to get the length. If the slot is odd, bitwise and the slot
                      // with -1 and divide by two.
                      let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)
                      let mlength := mload(_postBytes)
                      let newlength := add(slength, mlength)
                      // slength can contain both the length and contents of the array
                      // if length < 32 bytes so let's prepare for that
                      // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage
                      switch add(lt(slength, 32), lt(newlength, 32))
                      case 2 {
                          // Since the new array still fits in the slot, we just need to
                          // update the contents of the slot.
                          // uint256(bytes_storage) = uint256(bytes_storage) + uint256(bytes_memory) + new_length
                          sstore(
                              _preBytes.slot,
                              // all the modifications to the slot are inside this
                              // next block
                              add(
                                  // we can just add to the slot contents because the
                                  // bytes we want to change are the LSBs
                                  fslot,
                                  add(
                                      mul(
                                          div(
                                              // load the bytes from memory
                                              mload(add(_postBytes, 0x20)),
                                              // zero all bytes to the right
                                              exp(0x100, sub(32, mlength))
                                          ),
                                          // and now shift left the number of bytes to
                                          // leave space for the length in the slot
                                          exp(0x100, sub(32, newlength))
                                      ),
                                      // increase length by the double of the memory
                                      // bytes length
                                      mul(mlength, 2)
                                  )
                              )
                          )
                      }
                      case 1 {
                          // The stored value fits in the slot, but the combined value
                          // will exceed it.
                          // get the keccak hash to get the contents of the array
                          mstore(0x0, _preBytes.slot)
                          let sc := add(keccak256(0x0, 0x20), div(slength, 32))
                          // save new length
                          sstore(_preBytes.slot, add(mul(newlength, 2), 1))
                          // The contents of the _postBytes array start 32 bytes into
                          // the structure. Our first read should obtain the `submod`
                          // bytes that can fit into the unused space in the last word
                          // of the stored array. To get this, we read 32 bytes starting
                          // from `submod`, so the data we read overlaps with the array
                          // contents by `submod` bytes. Masking the lowest-order
                          // `submod` bytes allows us to add that value directly to the
                          // stored value.
                          let submod := sub(32, slength)
                          let mc := add(_postBytes, submod)
                          let end := add(_postBytes, mlength)
                          let mask := sub(exp(0x100, submod), 1)
                          sstore(
                              sc,
                              add(
                                  and(
                                      fslot,
                                      0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00
                                  ),
                                  and(mload(mc), mask)
                              )
                          )
                          for {
                              mc := add(mc, 0x20)
                              sc := add(sc, 1)
                          } lt(mc, end) {
                              sc := add(sc, 1)
                              mc := add(mc, 0x20)
                          } {
                              sstore(sc, mload(mc))
                          }
                          mask := exp(0x100, sub(mc, end))
                          sstore(sc, mul(div(mload(mc), mask), mask))
                      }
                      default {
                          // get the keccak hash to get the contents of the array
                          mstore(0x0, _preBytes.slot)
                          // Start copying to the last used word of the stored array.
                          let sc := add(keccak256(0x0, 0x20), div(slength, 32))
                          // save new length
                          sstore(_preBytes.slot, add(mul(newlength, 2), 1))
                          // Copy over the first `submod` bytes of the new data as in
                          // case 1 above.
                          let slengthmod := mod(slength, 32)
                          let mlengthmod := mod(mlength, 32)
                          let submod := sub(32, slengthmod)
                          let mc := add(_postBytes, submod)
                          let end := add(_postBytes, mlength)
                          let mask := sub(exp(0x100, submod), 1)
                          sstore(sc, add(sload(sc), and(mload(mc), mask)))
                          for {
                              sc := add(sc, 1)
                              mc := add(mc, 0x20)
                          } lt(mc, end) {
                              sc := add(sc, 1)
                              mc := add(mc, 0x20)
                          } {
                              sstore(sc, mload(mc))
                          }
                          mask := exp(0x100, sub(mc, end))
                          sstore(sc, mul(div(mload(mc), mask), mask))
                      }
                  }
              }
              function slice(
                  bytes memory _bytes,
                  uint256 _start,
                  uint256 _length
              )
                  internal
                  pure
                  returns (bytes memory)
              {
                  require(_length + 31 >= _length, "slice_overflow");
                  require(_bytes.length >= _start + _length, "slice_outOfBounds");
                  bytes memory tempBytes;
                  assembly {
                      switch iszero(_length)
                      case 0 {
                          // Get a location of some free memory and store it in tempBytes as
                          // Solidity does for memory variables.
                          tempBytes := mload(0x40)
                          // The first word of the slice result is potentially a partial
                          // word read from the original array. To read it, we calculate
                          // the length of that partial word and start copying that many
                          // bytes into the array. The first word we copy will start with
                          // data we don't care about, but the last `lengthmod` bytes will
                          // land at the beginning of the contents of the new array. When
                          // we're done copying, we overwrite the full first word with
                          // the actual length of the slice.
                          let lengthmod := and(_length, 31)
                          // The multiplication in the next line is necessary
                          // because when slicing multiples of 32 bytes (lengthmod == 0)
                          // the following copy loop was copying the origin's length
                          // and then ending prematurely not copying everything it should.
                          let mc := add(add(tempBytes, lengthmod), mul(0x20, iszero(lengthmod)))
                          let end := add(mc, _length)
                          for {
                              // The multiplication in the next line has the same exact purpose
                              // as the one above.
                              let cc := add(add(add(_bytes, lengthmod), mul(0x20, iszero(lengthmod))), _start)
                          } lt(mc, end) {
                              mc := add(mc, 0x20)
                              cc := add(cc, 0x20)
                          } {
                              mstore(mc, mload(cc))
                          }
                          mstore(tempBytes, _length)
                          //update free-memory pointer
                          //allocating the array padded to 32 bytes like the compiler does now
                          mstore(0x40, and(add(mc, 31), not(31)))
                      }
                      //if we want a zero-length slice let's just return a zero-length array
                      default {
                          tempBytes := mload(0x40)
                          //zero out the 32 bytes slice we are about to return
                          //we need to do it because Solidity does not garbage collect
                          mstore(tempBytes, 0)
                          mstore(0x40, add(tempBytes, 0x20))
                      }
                  }
                  return tempBytes;
              }
              function toAddress(bytes memory _bytes, uint256 _start) internal pure returns (address) {
                  require(_bytes.length >= _start + 20, "toAddress_outOfBounds");
                  address tempAddress;
                  assembly {
                      tempAddress := div(mload(add(add(_bytes, 0x20), _start)), 0x1000000000000000000000000)
                  }
                  return tempAddress;
              }
              function toUint8(bytes memory _bytes, uint256 _start) internal pure returns (uint8) {
                  require(_bytes.length >= _start + 1 , "toUint8_outOfBounds");
                  uint8 tempUint;
                  assembly {
                      tempUint := mload(add(add(_bytes, 0x1), _start))
                  }
                  return tempUint;
              }
              function toUint16(bytes memory _bytes, uint256 _start) internal pure returns (uint16) {
                  require(_bytes.length >= _start + 2, "toUint16_outOfBounds");
                  uint16 tempUint;
                  assembly {
                      tempUint := mload(add(add(_bytes, 0x2), _start))
                  }
                  return tempUint;
              }
              function toUint32(bytes memory _bytes, uint256 _start) internal pure returns (uint32) {
                  require(_bytes.length >= _start + 4, "toUint32_outOfBounds");
                  uint32 tempUint;
                  assembly {
                      tempUint := mload(add(add(_bytes, 0x4), _start))
                  }
                  return tempUint;
              }
              function toUint64(bytes memory _bytes, uint256 _start) internal pure returns (uint64) {
                  require(_bytes.length >= _start + 8, "toUint64_outOfBounds");
                  uint64 tempUint;
                  assembly {
                      tempUint := mload(add(add(_bytes, 0x8), _start))
                  }
                  return tempUint;
              }
              function toUint96(bytes memory _bytes, uint256 _start) internal pure returns (uint96) {
                  require(_bytes.length >= _start + 12, "toUint96_outOfBounds");
                  uint96 tempUint;
                  assembly {
                      tempUint := mload(add(add(_bytes, 0xc), _start))
                  }
                  return tempUint;
              }
              function toUint128(bytes memory _bytes, uint256 _start) internal pure returns (uint128) {
                  require(_bytes.length >= _start + 16, "toUint128_outOfBounds");
                  uint128 tempUint;
                  assembly {
                      tempUint := mload(add(add(_bytes, 0x10), _start))
                  }
                  return tempUint;
              }
              function toUint256(bytes memory _bytes, uint256 _start) internal pure returns (uint256) {
                  require(_bytes.length >= _start + 32, "toUint256_outOfBounds");
                  uint256 tempUint;
                  assembly {
                      tempUint := mload(add(add(_bytes, 0x20), _start))
                  }
                  return tempUint;
              }
              function toBytes32(bytes memory _bytes, uint256 _start) internal pure returns (bytes32) {
                  require(_bytes.length >= _start + 32, "toBytes32_outOfBounds");
                  bytes32 tempBytes32;
                  assembly {
                      tempBytes32 := mload(add(add(_bytes, 0x20), _start))
                  }
                  return tempBytes32;
              }
              function equal(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bool) {
                  bool success = true;
                  assembly {
                      let length := mload(_preBytes)
                      // if lengths don't match the arrays are not equal
                      switch eq(length, mload(_postBytes))
                      case 1 {
                          // cb is a circuit breaker in the for loop since there's
                          //  no said feature for inline assembly loops
                          // cb = 1 - don't breaker
                          // cb = 0 - break
                          let cb := 1
                          let mc := add(_preBytes, 0x20)
                          let end := add(mc, length)
                          for {
                              let cc := add(_postBytes, 0x20)
                          // the next line is the loop condition:
                          // while(uint256(mc < end) + cb == 2)
                          } eq(add(lt(mc, end), cb), 2) {
                              mc := add(mc, 0x20)
                              cc := add(cc, 0x20)
                          } {
                              // if any of these checks fails then arrays are not equal
                              if iszero(eq(mload(mc), mload(cc))) {
                                  // unsuccess:
                                  success := 0
                                  cb := 0
                              }
                          }
                      }
                      default {
                          // unsuccess:
                          success := 0
                      }
                  }
                  return success;
              }
              function equalStorage(
                  bytes storage _preBytes,
                  bytes memory _postBytes
              )
                  internal
                  view
                  returns (bool)
              {
                  bool success = true;
                  assembly {
                      // we know _preBytes_offset is 0
                      let fslot := sload(_preBytes.slot)
                      // Decode the length of the stored array like in concatStorage().
                      let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)
                      let mlength := mload(_postBytes)
                      // if lengths don't match the arrays are not equal
                      switch eq(slength, mlength)
                      case 1 {
                          // slength can contain both the length and contents of the array
                          // if length < 32 bytes so let's prepare for that
                          // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage
                          if iszero(iszero(slength)) {
                              switch lt(slength, 32)
                              case 1 {
                                  // blank the last byte which is the length
                                  fslot := mul(div(fslot, 0x100), 0x100)
                                  if iszero(eq(fslot, mload(add(_postBytes, 0x20)))) {
                                      // unsuccess:
                                      success := 0
                                  }
                              }
                              default {
                                  // cb is a circuit breaker in the for loop since there's
                                  //  no said feature for inline assembly loops
                                  // cb = 1 - don't breaker
                                  // cb = 0 - break
                                  let cb := 1
                                  // get the keccak hash to get the contents of the array
                                  mstore(0x0, _preBytes.slot)
                                  let sc := keccak256(0x0, 0x20)
                                  let mc := add(_postBytes, 0x20)
                                  let end := add(mc, mlength)
                                  // the next line is the loop condition:
                                  // while(uint256(mc < end) + cb == 2)
                                  for {} eq(add(lt(mc, end), cb), 2) {
                                      sc := add(sc, 1)
                                      mc := add(mc, 0x20)
                                  } {
                                      if iszero(eq(sload(sc), mload(mc))) {
                                          // unsuccess:
                                          success := 0
                                          cb := 0
                                      }
                                  }
                              }
                          }
                      }
                      default {
                          // unsuccess:
                          success := 0
                      }
                  }
                  return success;
              }
          }
          // contracts/Messages.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          interface IWormhole {
              struct GuardianSet {
                  address[] keys;
                  uint32 expirationTime;
              }
              struct Signature {
                  bytes32 r;
                  bytes32 s;
                  uint8 v;
                  uint8 guardianIndex;
              }
              struct VM {
                  uint8 version;
                  uint32 timestamp;
                  uint32 nonce;
                  uint16 emitterChainId;
                  bytes32 emitterAddress;
                  uint64 sequence;
                  uint8 consistencyLevel;
                  bytes payload;
                  uint32 guardianSetIndex;
                  Signature[] signatures;
                  bytes32 hash;
              }
              struct ContractUpgrade {
                  bytes32 module;
                  uint8 action;
                  uint16 chain;
                  address newContract;
              }
              struct GuardianSetUpgrade {
                  bytes32 module;
                  uint8 action;
                  uint16 chain;
                  GuardianSet newGuardianSet;
                  uint32 newGuardianSetIndex;
              }
              struct SetMessageFee {
                  bytes32 module;
                  uint8 action;
                  uint16 chain;
                  uint256 messageFee;
              }
              struct TransferFees {
                  bytes32 module;
                  uint8 action;
                  uint16 chain;
                  uint256 amount;
                  bytes32 recipient;
              }
              struct RecoverChainId {
                  bytes32 module;
                  uint8 action;
                  uint256 evmChainId;
                  uint16 newChainId;
              }
              event LogMessagePublished(address indexed sender, uint64 sequence, uint32 nonce, bytes payload, uint8 consistencyLevel);
              event ContractUpgraded(address indexed oldContract, address indexed newContract);
              event GuardianSetAdded(uint32 indexed index);
              function publishMessage(
                  uint32 nonce,
                  bytes memory payload,
                  uint8 consistencyLevel
              ) external payable returns (uint64 sequence);
              function initialize() external;
              function parseAndVerifyVM(bytes calldata encodedVM) external view returns (VM memory vm, bool valid, string memory reason);
              function verifyVM(VM memory vm) external view returns (bool valid, string memory reason);
              function verifySignatures(bytes32 hash, Signature[] memory signatures, GuardianSet memory guardianSet) external pure returns (bool valid, string memory reason);
              function parseVM(bytes memory encodedVM) external pure returns (VM memory vm);
              function quorum(uint numGuardians) external pure returns (uint numSignaturesRequiredForQuorum);
              function getGuardianSet(uint32 index) external view returns (GuardianSet memory);
              function getCurrentGuardianSetIndex() external view returns (uint32);
              function getGuardianSetExpiry() external view returns (uint32);
              function governanceActionIsConsumed(bytes32 hash) external view returns (bool);
              function isInitialized(address impl) external view returns (bool);
              function chainId() external view returns (uint16);
              function isFork() external view returns (bool);
              function governanceChainId() external view returns (uint16);
              function governanceContract() external view returns (bytes32);
              function messageFee() external view returns (uint256);
              function evmChainId() external view returns (uint256);
              function nextSequence(address emitter) external view returns (uint64);
              function parseContractUpgrade(bytes memory encodedUpgrade) external pure returns (ContractUpgrade memory cu);
              function parseGuardianSetUpgrade(bytes memory encodedUpgrade) external pure returns (GuardianSetUpgrade memory gsu);
              function parseSetMessageFee(bytes memory encodedSetMessageFee) external pure returns (SetMessageFee memory smf);
              function parseTransferFees(bytes memory encodedTransferFees) external pure returns (TransferFees memory tf);
              function parseRecoverChainId(bytes memory encodedRecoverChainId) external pure returns (RecoverChainId memory rci);
              function submitContractUpgrade(bytes memory _vm) external;
              function submitSetMessageFee(bytes memory _vm) external;
              function submitNewGuardianSet(bytes memory _vm) external;
              function submitTransferFees(bytes memory _vm) external;
              function submitRecoverChainId(bytes memory _vm) external;
          }
          // contracts/State.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          import "@openzeppelin/contracts/utils/Counters.sol";
          contract TokenStorage {
              struct State {
                  string name;
                  string symbol;
                  uint64 metaLastUpdatedSequence;
                  uint256 totalSupply;
                  uint8 decimals;
                  mapping(address => uint256) balances;
                  mapping(address => mapping(address => uint256)) allowances;
                  address owner;
                  bool initialized;
                  uint16 chainId;
                  bytes32 nativeContract;
                  // EIP712
                  // Cache the domain separator and salt, but also store the chain id that 
                  // it corresponds to, in order to invalidate the cached domain separator
                  // if the chain id changes.
                  bytes32 cachedDomainSeparator;
                  uint256 cachedChainId;
                  address cachedThis;
                  bytes32 cachedSalt;
                  bytes32 cachedHashedName;
                  // ERC20Permit draft
                  mapping(address => Counters.Counter) nonces;
              }
          }
          contract TokenState {
              using Counters for Counters.Counter;
              TokenStorage.State _state;
              /**
               * @dev See {IERC20Permit-nonces}.
               */
              function nonces(address owner_) public view returns (uint256) {
                  return _state.nonces[owner_].current();
              }
              /**
               * @dev "Consume a nonce": return the current value and increment.
               */
              function _useNonce(address owner_) internal returns (uint256 current) {
                  Counters.Counter storage nonce = _state.nonces[owner_];
                  current = nonce.current();
                  nonce.increment();
              }
          }// contracts/TokenImplementation.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          import "./TokenState.sol";
          import "@openzeppelin/contracts/access/Ownable.sol";
          import "@openzeppelin/contracts/utils/Context.sol";
          import "@openzeppelin/contracts/proxy/beacon/BeaconProxy.sol";
          import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
          // Based on the OpenZepplin ERC20 implementation, licensed under MIT
          contract TokenImplementation is TokenState, Context {
              event Transfer(address indexed from, address indexed to, uint256 value);
              event Approval(address indexed owner, address indexed spender, uint256 value);
              function initialize(
                  string memory name_,
                  string memory symbol_,
                  uint8 decimals_,
                  uint64 sequence_,
                  address owner_,
                  uint16 chainId_,
                  bytes32 nativeContract_
              ) initializer public {
                  _initializeNativeToken(
                      name_,
                      symbol_,
                      decimals_,
                      sequence_,
                      owner_,
                      chainId_,
                      nativeContract_
                  );
                  // initialize w/ EIP712 state variables for domain separator
                  _initializePermitStateIfNeeded();
              }
              function _initializeNativeToken(
                  string memory name_,
                  string memory symbol_,
                  uint8 decimals_,
                  uint64 sequence_,
                  address owner_,
                  uint16 chainId_,
                  bytes32 nativeContract_
              ) internal {
                  _state.name = name_;
                  _state.symbol = symbol_;
                  _state.decimals = decimals_;
                  _state.metaLastUpdatedSequence = sequence_;
                  _state.owner = owner_;
                  _state.chainId = chainId_;
                  _state.nativeContract = nativeContract_;
              }
              function _initializePermitStateIfNeeded() internal {
                  // If someone were to change the implementation of name(), we
                  // need to make sure we recache.
                  bytes32 hashedName = _eip712DomainNameHashed();
                  // If for some reason the salt generation changes with newer
                  // token implementations, we need to make sure the state reflects
                  // the new salt.
                  bytes32 salt = _eip712DomainSalt();
                  // check cached values
                  if (_state.cachedHashedName != hashedName || _state.cachedSalt != salt) {
                      _state.cachedChainId = block.chainid;
                      _state.cachedThis = address(this);
                      _state.cachedDomainSeparator = _buildDomainSeparator(hashedName, salt);
                      _state.cachedSalt = salt;
                      _state.cachedHashedName = hashedName;
                  }
              }
              function name() public view returns (string memory) {
                  return _state.name;
              }
              function symbol() public view returns (string memory) {
                  return _state.symbol;
              }
              function owner() public view returns (address) {
                  return _state.owner;
              }
              function decimals() public view returns (uint8) {
                  return _state.decimals;
              }
              function totalSupply() public view returns (uint256) {
                  return _state.totalSupply;
              }
              function chainId() public view returns (uint16) {
                  return _state.chainId;
              }
              function nativeContract() public view returns (bytes32) {
                  return _state.nativeContract;
              }
              function balanceOf(address account_) public view returns (uint256) {
                  return _state.balances[account_];
              }
              function transfer(address recipient_, uint256 amount_) public returns (bool) {
                  _transfer(_msgSender(), recipient_, amount_);
                  return true;
              }
              function allowance(address owner_, address spender_) public view returns (uint256) {
                  return _state.allowances[owner_][spender_];
              }
              function approve(address spender_, uint256 amount_) public returns (bool) {
                  _approve(_msgSender(), spender_, amount_);
                  return true;
              }
              function transferFrom(address sender_, address recipient_, uint256 amount_) public returns (bool) {
                  _transfer(sender_, recipient_, amount_);
                  uint256 currentAllowance = _state.allowances[sender_][_msgSender()];
                  require(currentAllowance >= amount_, "ERC20: transfer amount exceeds allowance");
                  _approve(sender_, _msgSender(), currentAllowance - amount_);
                  return true;
              }
              function increaseAllowance(address spender_, uint256 addedValue_) public returns (bool) {
                  _approve(_msgSender(), spender_, _state.allowances[_msgSender()][spender_] + addedValue_);
                  return true;
              }
              function decreaseAllowance(address spender_, uint256 subtractedValue_) public returns (bool) {
                  uint256 currentAllowance = _state.allowances[_msgSender()][spender_];
                  require(currentAllowance >= subtractedValue_, "ERC20: decreased allowance below zero");
                  _approve(_msgSender(), spender_, currentAllowance - subtractedValue_);
                  return true;
              }
              function _transfer(address sender_, address recipient_, uint256 amount_) internal {
                  require(sender_ != address(0), "ERC20: transfer from the zero address");
                  require(recipient_ != address(0), "ERC20: transfer to the zero address");
                  uint256 senderBalance = _state.balances[sender_];
                  require(senderBalance >= amount_, "ERC20: transfer amount exceeds balance");
                  _state.balances[sender_] = senderBalance - amount_;
                  _state.balances[recipient_] += amount_;
                  emit Transfer(sender_, recipient_, amount_);
              }
              function mint(address account_, uint256 amount_) public onlyOwner {
                  _mint(account_, amount_);
              }
              function _mint(address account_, uint256 amount_) internal {
                  require(account_ != address(0), "ERC20: mint to the zero address");
                  _state.totalSupply += amount_;
                  _state.balances[account_] += amount_;
                  emit Transfer(address(0), account_, amount_);
              }
              function burn(address account_, uint256 amount_) public onlyOwner {
                  _burn(account_, amount_);
              }
              function _burn(address account_, uint256 amount_) internal {
                  require(account_ != address(0), "ERC20: burn from the zero address");
                  uint256 accountBalance = _state.balances[account_];
                  require(accountBalance >= amount_, "ERC20: burn amount exceeds balance");
                  _state.balances[account_] = accountBalance - amount_;
                  _state.totalSupply -= amount_;
                  emit Transfer(account_, address(0), amount_);
              }
              function _approve(address owner_, address spender_, uint256 amount_) internal virtual {
                  require(owner_ != address(0), "ERC20: approve from the zero address");
                  require(spender_ != address(0), "ERC20: approve to the zero address");
                  _state.allowances[owner_][spender_] = amount_;
                  emit Approval(owner_, spender_, amount_);
              }
              function updateDetails(string memory name_, string memory symbol_, uint64 sequence_) public onlyOwner {
                  require(_state.metaLastUpdatedSequence < sequence_, "current metadata is up to date");
                  _state.name = name_;
                  _state.symbol = symbol_;
                  _state.metaLastUpdatedSequence = sequence_;
                  // Because the name is updated, we need to recache the domain separator.
                  // For old implementations, none of the caches may have been written to yet.
                  _initializePermitStateIfNeeded();
              }
              modifier onlyOwner() {
                  require(owner() == _msgSender(), "caller is not the owner");
                  _;
              }
              modifier initializer() {
                  require(
                      !_state.initialized,
                      "Already initialized"
                  );
                  _state.initialized = true;
                  _;
              }
              /**
               * @dev Returns the domain separator for the current chain.
               */
              function _domainSeparatorV4() internal view returns (bytes32) {
                  if (address(this) == _state.cachedThis && block.chainid == _state.cachedChainId) {
                      return _state.cachedDomainSeparator;
                  } else {
                      return _buildDomainSeparator(
                          _eip712DomainNameHashed(), _eip712DomainSalt()
                      );
                  }
              }
              function _buildDomainSeparator(bytes32 hashedName, bytes32 salt) internal view returns (bytes32) {
                  return keccak256(
                      abi.encode(
                          keccak256(
                              "EIP712Domain(string name,string version,uint256 chainId,address verifyingContract,bytes32 salt)"
                          ),
                          hashedName,
                          keccak256(abi.encodePacked(_eip712DomainVersion())),
                          block.chainid,
                          address(this),
                          salt
                      )
                  );
              }
              /**
               * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this
               * function returns the hash of the fully encoded EIP712 message for this domain.
               *
               * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:
               *
               * ```solidity
               * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(
               *     keccak256("Mail(address to,string contents)"),
               *     mailTo,
               *     keccak256(bytes(mailContents))
               * )));
               * address signer = ECDSA.recover(digest, signature);
               * ```
               */
              function _hashTypedDataV4(bytes32 structHash) internal view returns (bytes32) {
                  return ECDSA.toTypedDataHash(_domainSeparatorV4(), structHash);
              }
              /**
               * @dev See {IERC20Permit-permit}.
               */
              function permit(
                  address owner_,
                  address spender_,
                  uint256 value_,
                  uint256 deadline_,
                  uint8 v_,
                  bytes32 r_,
                  bytes32 s_
              ) public {
                  // for those tokens that have been initialized before permit, we need to set
                  // the permit state variables if they have not been set before
                  _initializePermitStateIfNeeded();
                  // permit is only allowed before the signature's deadline
                  require(block.timestamp <= deadline_, "ERC20Permit: expired deadline");
                  bytes32 structHash = keccak256(
                      abi.encode(
                          keccak256(
                              "Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)"
                          ),
                          owner_,
                          spender_,
                          value_,
                          _useNonce(owner_),
                          deadline_
                      )
                  );
                  bytes32 message = _hashTypedDataV4(structHash);
                  address signer = ECDSA.recover(message, v_, r_, s_);
                  // if we cannot recover the token owner, signature is invalid
                  require(signer == owner_, "ERC20Permit: invalid signature");
                  _approve(owner_, spender_, value_);
              }
              /**
               * @dev See {IERC20Permit-DOMAIN_SEPARATOR}.
               */
              // solhint-disable-next-line func-name-mixedcase
              function DOMAIN_SEPARATOR() public view returns (bytes32) {
                  return _domainSeparatorV4();
              }
              function eip712Domain() public view returns (
                  bytes1 domainFields,
                  string memory domainName,
                  string memory domainVersion,
                  uint256 domainChainId,
                  address domainVerifyingContract,
                  bytes32 domainSalt,
                  uint256[] memory domainExtensions
              ) {
                  return (
                      hex"1F", // 11111
                      name(),
                      _eip712DomainVersion(),
                      block.chainid,
                      address(this),
                      _eip712DomainSalt(),
                      new uint256[](0)
                  );
              }
              function _eip712DomainVersion() internal pure returns (string memory) {
                  return "1";
              }
              function _eip712DomainNameHashed() internal view returns (bytes32) {
                  return keccak256(abi.encodePacked(name()));
              }
              function _eip712DomainSalt() internal view returns (bytes32) {
                  return keccak256(abi.encodePacked(_state.chainId, _state.nativeContract));
              }
          }
          // contracts/Structs.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          import "@openzeppelin/contracts/proxy/beacon/BeaconProxy.sol";
          contract BridgeToken is BeaconProxy {
              constructor(address beacon, bytes memory data) BeaconProxy(beacon, data) {
              }
          }// contracts/Bridge.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
          interface IWETH is IERC20 {
              function deposit() external payable;
              function withdraw(uint amount) external;
          }// contracts/Structs.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          contract BridgeStructs {
              struct Transfer {
                  // PayloadID uint8 = 1
                  uint8 payloadID;
                  // Amount being transferred (big-endian uint256)
                  uint256 amount;
                  // Address of the token. Left-zero-padded if shorter than 32 bytes
                  bytes32 tokenAddress;
                  // Chain ID of the token
                  uint16 tokenChain;
                  // Address of the recipient. Left-zero-padded if shorter than 32 bytes
                  bytes32 to;
                  // Chain ID of the recipient
                  uint16 toChain;
                  // Amount of tokens (big-endian uint256) that the user is willing to pay as relayer fee. Must be <= Amount.
                  uint256 fee;
              }
              struct TransferWithPayload {
                  // PayloadID uint8 = 3
                  uint8 payloadID;
                  // Amount being transferred (big-endian uint256)
                  uint256 amount;
                  // Address of the token. Left-zero-padded if shorter than 32 bytes
                  bytes32 tokenAddress;
                  // Chain ID of the token
                  uint16 tokenChain;
                  // Address of the recipient. Left-zero-padded if shorter than 32 bytes
                  bytes32 to;
                  // Chain ID of the recipient
                  uint16 toChain;
                  // Address of the message sender. Left-zero-padded if shorter than 32 bytes
                  bytes32 fromAddress;
                  // An arbitrary payload
                  bytes payload;
              }
              struct TransferResult {
                  // Chain ID of the token
                  uint16  tokenChain;
                  // Address of the token. Left-zero-padded if shorter than 32 bytes
                  bytes32 tokenAddress;
                  // Amount being transferred (big-endian uint256)
                  uint256 normalizedAmount;
                  // Amount of tokens (big-endian uint256) that the user is willing to pay as relayer fee. Must be <= Amount.
                  uint256 normalizedArbiterFee;
                  // Portion of msg.value to be paid as the core bridge fee
                  uint wormholeFee;
              }
              struct AssetMeta {
                  // PayloadID uint8 = 2
                  uint8 payloadID;
                  // Address of the token. Left-zero-padded if shorter than 32 bytes
                  bytes32 tokenAddress;
                  // Chain ID of the token
                  uint16 tokenChain;
                  // Number of decimals of the token (big-endian uint256)
                  uint8 decimals;
                  // Symbol of the token (UTF-8)
                  bytes32 symbol;
                  // Name of the token (UTF-8)
                  bytes32 name;
              }
              struct RegisterChain {
                  // Governance Header
                  // module: "TokenBridge" left-padded
                  bytes32 module;
                  // governance action: 1
                  uint8 action;
                  // governance paket chain id: this or 0
                  uint16 chainId;
                  // Chain ID
                  uint16 emitterChainID;
                  // Emitter address. Left-zero-padded if shorter than 32 bytes
                  bytes32 emitterAddress;
              }
              struct UpgradeContract {
                  // Governance Header
                  // module: "TokenBridge" left-padded
                  bytes32 module;
                  // governance action: 2
                  uint8 action;
                  // governance paket chain id
                  uint16 chainId;
                  // Address of the new contract
                  bytes32 newContract;
              }
              struct RecoverChainId {
                  // Governance Header
                  // module: "TokenBridge" left-padded
                  bytes32 module;
                  // governance action: 3
                  uint8 action;
                  // EIP-155 Chain ID
                  uint256 evmChainId;
                  // Chain ID
                  uint16 newChainId;
              }
          }
          // contracts/State.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          import "./BridgeStructs.sol";
          contract BridgeStorage {
              struct Provider {
                  uint16 chainId;
                  uint16 governanceChainId;
                  // Required number of block confirmations to assume finality
                  uint8 finality;
                  bytes32 governanceContract;
                  address WETH;
              }
              struct Asset {
                  uint16 chainId;
                  bytes32 assetAddress;
              }
              struct State {
                  address payable wormhole;
                  address tokenImplementation;
                  Provider provider;
                  // Mapping of consumed governance actions
                  mapping(bytes32 => bool) consumedGovernanceActions;
                  // Mapping of consumed token transfers
                  mapping(bytes32 => bool) completedTransfers;
                  // Mapping of initialized implementations
                  mapping(address => bool) initializedImplementations;
                  // Mapping of wrapped assets (chainID => nativeAddress => wrappedAddress)
                  mapping(uint16 => mapping(bytes32 => address)) wrappedAssets;
                  // Mapping to safely identify wrapped assets
                  mapping(address => bool) isWrappedAsset;
                  // Mapping of native assets to amount outstanding on other chains
                  mapping(address => uint256) outstandingBridged;
                  // Mapping of bridge contracts on other chains
                  mapping(uint16 => bytes32) bridgeImplementations;
                  // EIP-155 Chain ID
                  uint256 evmChainId;
              }
          }
          contract BridgeState {
              BridgeStorage.State _state;
          }
          // contracts/Setters.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          import "./BridgeState.sol";
          contract BridgeSetters is BridgeState {
              function setInitialized(address implementatiom) internal {
                  _state.initializedImplementations[implementatiom] = true;
              }
              function setGovernanceActionConsumed(bytes32 hash) internal {
                  _state.consumedGovernanceActions[hash] = true;
              }
              function setTransferCompleted(bytes32 hash) internal {
                  _state.completedTransfers[hash] = true;
              }
              function setChainId(uint16 chainId) internal {
                  _state.provider.chainId = chainId;
              }
              function setGovernanceChainId(uint16 chainId) internal {
                  _state.provider.governanceChainId = chainId;
              }
              function setGovernanceContract(bytes32 governanceContract) internal {
                  _state.provider.governanceContract = governanceContract;
              }
              function setBridgeImplementation(uint16 chainId, bytes32 bridgeContract) internal {
                  _state.bridgeImplementations[chainId] = bridgeContract;
              }
              function setTokenImplementation(address impl) internal {
                  require(impl != address(0), "invalid implementation address");
                  _state.tokenImplementation = impl;
              }
              function setWETH(address weth) internal {
                  _state.provider.WETH = weth;
              }
              function setWormhole(address wh) internal {
                  _state.wormhole = payable(wh);
              }
              function setWrappedAsset(uint16 tokenChainId, bytes32 tokenAddress, address wrapper) internal {
                  _state.wrappedAssets[tokenChainId][tokenAddress] = wrapper;
                  _state.isWrappedAsset[wrapper] = true;
              }
              function setOutstandingBridged(address token, uint256 outstanding) internal {
                  _state.outstandingBridged[token] = outstanding;
              }
              function setFinality(uint8 finality) internal {
                  _state.provider.finality = finality;
              }
              function setEvmChainId(uint256 evmChainId) internal {
                  require(evmChainId == block.chainid, "invalid evmChainId");
                  _state.evmChainId = evmChainId;
              }
          }
          // contracts/Bridge.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
          import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
          import "@openzeppelin/contracts/proxy/ERC1967/ERC1967Upgrade.sol";
          import "../libraries/external/BytesLib.sol";
          import "./BridgeGetters.sol";
          import "./BridgeSetters.sol";
          import "./BridgeStructs.sol";
          import "./token/Token.sol";
          import "./token/TokenImplementation.sol";
          import "../interfaces/IWormhole.sol";
          contract BridgeGovernance is BridgeGetters, BridgeSetters, ERC1967Upgrade {
              using BytesLib for bytes;
              // "TokenBridge" (left padded)
              bytes32 constant module = 0x000000000000000000000000000000000000000000546f6b656e427269646765;
              // Execute a RegisterChain governance message
              function registerChain(bytes memory encodedVM) public {
                  (IWormhole.VM memory vm, bool valid, string memory reason) = verifyGovernanceVM(encodedVM);
                  require(valid, reason);
                  setGovernanceActionConsumed(vm.hash);
                  BridgeStructs.RegisterChain memory chain = parseRegisterChain(vm.payload);
                  require((chain.chainId == chainId() && !isFork()) || chain.chainId == 0, "invalid chain id");
                  require(bridgeContracts(chain.emitterChainID) == bytes32(0), "chain already registered");
                  setBridgeImplementation(chain.emitterChainID, chain.emitterAddress);
              }
              // Execute a UpgradeContract governance message
              function upgrade(bytes memory encodedVM) public {
                  require(!isFork(), "invalid fork");
                  (IWormhole.VM memory vm, bool valid, string memory reason) = verifyGovernanceVM(encodedVM);
                  require(valid, reason);
                  setGovernanceActionConsumed(vm.hash);
                  BridgeStructs.UpgradeContract memory implementation = parseUpgrade(vm.payload);
                  require(implementation.chainId == chainId(), "wrong chain id");
                  upgradeImplementation(address(uint160(uint256(implementation.newContract))));
              }
              /**
              * @dev Updates the `chainId` and `evmChainId` on a forked chain via Governance VAA/VM
              */
              function submitRecoverChainId(bytes memory encodedVM) public {
                  require(isFork(), "not a fork");
                  (IWormhole.VM memory vm, bool valid, string memory reason) = verifyGovernanceVM(encodedVM);
                  require(valid, reason);
                  setGovernanceActionConsumed(vm.hash);
                  BridgeStructs.RecoverChainId memory rci = parseRecoverChainId(vm.payload);
                  // Verify the VAA is for this chain
                  require(rci.evmChainId == block.chainid, "invalid EVM Chain");
                  // Update the chainIds
                  setEvmChainId(rci.evmChainId);
                  setChainId(rci.newChainId);
              }
              function verifyGovernanceVM(bytes memory encodedVM) internal view returns (IWormhole.VM memory parsedVM, bool isValid, string memory invalidReason){
                  (IWormhole.VM memory vm, bool valid, string memory reason) = wormhole().parseAndVerifyVM(encodedVM);
                  if (!valid) {
                      return (vm, valid, reason);
                  }
                  if (vm.emitterChainId != governanceChainId()) {
                      return (vm, false, "wrong governance chain");
                  }
                  if (vm.emitterAddress != governanceContract()) {
                      return (vm, false, "wrong governance contract");
                  }
                  if (governanceActionIsConsumed(vm.hash)) {
                      return (vm, false, "governance action already consumed");
                  }
                  return (vm, true, "");
              }
              event ContractUpgraded(address indexed oldContract, address indexed newContract);
              function upgradeImplementation(address newImplementation) internal {
                  address currentImplementation = _getImplementation();
                  _upgradeTo(newImplementation);
                  // Call initialize function of the new implementation
                  (bool success, bytes memory reason) = newImplementation.delegatecall(abi.encodeWithSignature("initialize()"));
                  require(success, string(reason));
                  emit ContractUpgraded(currentImplementation, newImplementation);
              }
              function parseRegisterChain(bytes memory encoded) public pure returns (BridgeStructs.RegisterChain memory chain) {
                  uint index = 0;
                  // governance header
                  chain.module = encoded.toBytes32(index);
                  index += 32;
                  require(chain.module == module, "wrong module");
                  chain.action = encoded.toUint8(index);
                  index += 1;
                  require(chain.action == 1, "wrong action");
                  chain.chainId = encoded.toUint16(index);
                  index += 2;
                  // payload
                  chain.emitterChainID = encoded.toUint16(index);
                  index += 2;
                  chain.emitterAddress = encoded.toBytes32(index);
                  index += 32;
                  require(encoded.length == index, "wrong length");
              }
              function parseUpgrade(bytes memory encoded) public pure returns (BridgeStructs.UpgradeContract memory chain) {
                  uint index = 0;
                  // governance header
                  chain.module = encoded.toBytes32(index);
                  index += 32;
                  require(chain.module == module, "wrong module");
                  chain.action = encoded.toUint8(index);
                  index += 1;
                  require(chain.action == 2, "wrong action");
                  chain.chainId = encoded.toUint16(index);
                  index += 2;
                  // payload
                  chain.newContract = encoded.toBytes32(index);
                  index += 32;
                  require(encoded.length == index, "wrong length");
              }
              /// @dev Parse a recoverChainId (action 3) with minimal validation
              function parseRecoverChainId(bytes memory encodedRecoverChainId) public pure returns (BridgeStructs.RecoverChainId memory rci) {
                  uint index = 0;
                  rci.module = encodedRecoverChainId.toBytes32(index);
                  index += 32;
                  require(rci.module == module, "wrong module");
                  rci.action = encodedRecoverChainId.toUint8(index);
                  index += 1;
                  require(rci.action == 3, "wrong action");
                  rci.evmChainId = encodedRecoverChainId.toUint256(index);
                  index += 32;
                  rci.newChainId = encodedRecoverChainId.toUint16(index);
                  index += 2;
                  require(encodedRecoverChainId.length == index, "wrong length");
              }
          }
          // contracts/Getters.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
          import "../interfaces/IWormhole.sol";
          import "./interfaces/IWETH.sol";
          import "./BridgeState.sol";
          contract BridgeGetters is BridgeState {
              function governanceActionIsConsumed(bytes32 hash) public view returns (bool) {
                  return _state.consumedGovernanceActions[hash];
              }
              function isInitialized(address impl) public view returns (bool) {
                  return _state.initializedImplementations[impl];
              }
              function isTransferCompleted(bytes32 hash) public view returns (bool) {
                  return _state.completedTransfers[hash];
              }
              function wormhole() public view returns (IWormhole) {
                  return IWormhole(_state.wormhole);
              }
              function chainId() public view returns (uint16){
                  return _state.provider.chainId;
              }
              function evmChainId() public view returns (uint256) {
                  return _state.evmChainId;
              }
              function isFork() public view returns (bool) {
                  return evmChainId() != block.chainid;
              }
              function governanceChainId() public view returns (uint16){
                  return _state.provider.governanceChainId;
              }
              function governanceContract() public view returns (bytes32){
                  return _state.provider.governanceContract;
              }
              function wrappedAsset(uint16 tokenChainId, bytes32 tokenAddress) public view returns (address){
                  return _state.wrappedAssets[tokenChainId][tokenAddress];
              }
              function bridgeContracts(uint16 chainId_) public view returns (bytes32){
                  return _state.bridgeImplementations[chainId_];
              }
              function tokenImplementation() public view returns (address){
                  return _state.tokenImplementation;
              }
              function WETH() public view returns (IWETH){
                  return IWETH(_state.provider.WETH);
              }
              function outstandingBridged(address token) public view returns (uint256){
                  return _state.outstandingBridged[token];
              }
              function isWrappedAsset(address token) public view returns (bool){
                  return _state.isWrappedAsset[token];
              }
              function finality() public view returns (uint8) {
                  return _state.provider.finality;
              }
          }
          // contracts/Bridge.sol
          // SPDX-License-Identifier: Apache 2
          pragma solidity ^0.8.0;
          import "@openzeppelin/contracts/security/ReentrancyGuard.sol";
          import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
          import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
          import "../libraries/external/BytesLib.sol";
          import "./BridgeGetters.sol";
          import "./BridgeSetters.sol";
          import "./BridgeStructs.sol";
          import "./BridgeGovernance.sol";
          import "./token/Token.sol";
          import "./token/TokenImplementation.sol";
          contract Bridge is BridgeGovernance, ReentrancyGuard {
              using BytesLib for bytes;
              /**
               * @notice Emitted when a transfer is completed by the token bridge.
               * @param emitterChainId Wormhole chain ID of emitter on the source chain.
               * @param emitterAddress Address (bytes32 zero-left-padded) of emitter on the source chain.
               * @param sequence Sequence of the Wormhole message.
               */
              event TransferRedeemed(
                  uint16 indexed emitterChainId,
                  bytes32 indexed emitterAddress,
                  uint64 indexed sequence
              );
              /*
               *  @dev Produce a AssetMeta message for a given token
               */
              function attestToken(address tokenAddress, uint32 nonce) public payable returns (uint64 sequence) {
                  // decimals, symbol & token are not part of the core ERC20 token standard, so we need to support contracts that dont implement them
                  (,bytes memory queriedDecimals) = tokenAddress.staticcall(abi.encodeWithSignature("decimals()"));
                  (,bytes memory queriedSymbol) = tokenAddress.staticcall(abi.encodeWithSignature("symbol()"));
                  (,bytes memory queriedName) = tokenAddress.staticcall(abi.encodeWithSignature("name()"));
                  uint8 decimals = abi.decode(queriedDecimals, (uint8));
                  string memory symbolString = abi.decode(queriedSymbol, (string));
                  string memory nameString = abi.decode(queriedName, (string));
                  bytes32 symbol;
                  bytes32 name;
                  assembly {
                      // first 32 bytes hold string length
                      symbol := mload(add(symbolString, 32))
                      name := mload(add(nameString, 32))
                  }
                  BridgeStructs.AssetMeta memory meta = BridgeStructs.AssetMeta({
                  payloadID : 2,
                  tokenAddress : bytes32(uint256(uint160(tokenAddress))), // Address of the token. Left-zero-padded if shorter than 32 bytes
                  tokenChain : chainId(), // Chain ID of the token
                  decimals : decimals, // Number of decimals of the token (big-endian uint8)
                  symbol : symbol, // Symbol of the token (UTF-8)
                  name : name // Name of the token (UTF-8)
                  });
                  bytes memory encoded = encodeAssetMeta(meta);
                  sequence = wormhole().publishMessage{
                      value : msg.value
                  }(nonce, encoded, finality());
              }
              /*
               *  @notice Send eth through portal by first wrapping it to WETH.
               */
              function wrapAndTransferETH(
                  uint16 recipientChain,
                  bytes32 recipient,
                  uint256 arbiterFee,
                  uint32 nonce
              ) public payable returns (uint64 sequence) {
                  BridgeStructs.TransferResult
                      memory transferResult = _wrapAndTransferETH(arbiterFee);
                  sequence = logTransfer(
                      transferResult.tokenChain,
                      transferResult.tokenAddress,
                      transferResult.normalizedAmount,
                      recipientChain,
                      recipient,
                      transferResult.normalizedArbiterFee,
                      transferResult.wormholeFee,
                      nonce
                  );
              }
              /*
               *  @notice Send eth through portal by first wrapping it.
               *
               *  @dev This type of transfer is called a "contract-controlled transfer".
               *  There are three differences from a regular token transfer:
               *  1) Additional arbitrary payload can be attached to the message
               *  2) Only the recipient (typically a contract) can redeem the transaction
               *  3) The sender's address (msg.sender) is also included in the transaction payload
               *
               *  With these three additional components, xDapps can implement cross-chain
               *  composable interactions.
               */
              function wrapAndTransferETHWithPayload(
                  uint16 recipientChain,
                  bytes32 recipient,
                  uint32 nonce,
                  bytes memory payload
              ) public payable returns (uint64 sequence) {
                  BridgeStructs.TransferResult
                      memory transferResult = _wrapAndTransferETH(0);
                  sequence = logTransferWithPayload(
                      transferResult.tokenChain,
                      transferResult.tokenAddress,
                      transferResult.normalizedAmount,
                      recipientChain,
                      recipient,
                      transferResult.wormholeFee,
                      nonce,
                      payload
                  );
              }
              function _wrapAndTransferETH(uint256 arbiterFee) internal returns (BridgeStructs.TransferResult memory transferResult) {
                  uint wormholeFee = wormhole().messageFee();
                  require(wormholeFee < msg.value, "value is smaller than wormhole fee");
                  uint amount = msg.value - wormholeFee;
                  require(arbiterFee <= amount, "fee is bigger than amount minus wormhole fee");
                  uint normalizedAmount = normalizeAmount(amount, 18);
                  uint normalizedArbiterFee = normalizeAmount(arbiterFee, 18);
                  // refund dust
                  uint dust = amount - deNormalizeAmount(normalizedAmount, 18);
                  if (dust > 0) {
                      payable(msg.sender).transfer(dust);
                  }
                  // deposit into WETH
                  WETH().deposit{
                      value : amount - dust
                  }();
                  // track and check outstanding token amounts
                  bridgeOut(address(WETH()), normalizedAmount);
                  transferResult = BridgeStructs.TransferResult({
                      tokenChain : chainId(),
                      tokenAddress : bytes32(uint256(uint160(address(WETH())))),
                      normalizedAmount : normalizedAmount,
                      normalizedArbiterFee : normalizedArbiterFee,
                      wormholeFee : wormholeFee
                  });
              }
              /*
               *  @notice Send ERC20 token through portal.
               */
              function transferTokens(
                  address token,
                  uint256 amount,
                  uint16 recipientChain,
                  bytes32 recipient,
                  uint256 arbiterFee,
                  uint32 nonce
              ) public payable nonReentrant returns (uint64 sequence) {
                  BridgeStructs.TransferResult memory transferResult = _transferTokens(
                      token,
                      amount,
                      arbiterFee
                  );
                  sequence = logTransfer(
                      transferResult.tokenChain,
                      transferResult.tokenAddress,
                      transferResult.normalizedAmount,
                      recipientChain,
                      recipient,
                      transferResult.normalizedArbiterFee,
                      transferResult.wormholeFee,
                      nonce
                  );
              }
              /*
               *  @notice Send ERC20 token through portal.
               *
               *  @dev This type of transfer is called a "contract-controlled transfer".
               *  There are three differences from a regular token transfer:
               *  1) Additional arbitrary payload can be attached to the message
               *  2) Only the recipient (typically a contract) can redeem the transaction
               *  3) The sender's address (msg.sender) is also included in the transaction payload
               *
               *  With these three additional components, xDapps can implement cross-chain
               *  composable interactions.
               */
              function transferTokensWithPayload(
                  address token,
                  uint256 amount,
                  uint16 recipientChain,
                  bytes32 recipient,
                  uint32 nonce,
                  bytes memory payload
              ) public payable nonReentrant returns (uint64 sequence) {
                  BridgeStructs.TransferResult memory transferResult = _transferTokens(
                      token,
                      amount,
                      0
                  );
                  sequence = logTransferWithPayload(
                      transferResult.tokenChain,
                      transferResult.tokenAddress,
                      transferResult.normalizedAmount,
                      recipientChain,
                      recipient,
                      transferResult.wormholeFee,
                      nonce,
                      payload
                  );
              }
              /*
               *  @notice Initiate a transfer
               */
              function _transferTokens(address token, uint256 amount, uint256 arbiterFee) internal returns (BridgeStructs.TransferResult memory transferResult) {
                  // determine token parameters
                  uint16 tokenChain;
                  bytes32 tokenAddress;
                  if (isWrappedAsset(token)) {
                      tokenChain = TokenImplementation(token).chainId();
                      tokenAddress = TokenImplementation(token).nativeContract();
                  } else {
                      tokenChain = chainId();
                      tokenAddress = bytes32(uint256(uint160(token)));
                  }
                  // query tokens decimals
                  (,bytes memory queriedDecimals) = token.staticcall(abi.encodeWithSignature("decimals()"));
                  uint8 decimals = abi.decode(queriedDecimals, (uint8));
                  // don't deposit dust that can not be bridged due to the decimal shift
                  amount = deNormalizeAmount(normalizeAmount(amount, decimals), decimals);
                  if (tokenChain == chainId()) {
                      // query own token balance before transfer
                      (,bytes memory queriedBalanceBefore) = token.staticcall(abi.encodeWithSelector(IERC20.balanceOf.selector, address(this)));
                      uint256 balanceBefore = abi.decode(queriedBalanceBefore, (uint256));
                      // transfer tokens
                      SafeERC20.safeTransferFrom(IERC20(token), msg.sender, address(this), amount);
                      // query own token balance after transfer
                      (,bytes memory queriedBalanceAfter) = token.staticcall(abi.encodeWithSelector(IERC20.balanceOf.selector, address(this)));
                      uint256 balanceAfter = abi.decode(queriedBalanceAfter, (uint256));
                      // correct amount for potential transfer fees
                      amount = balanceAfter - balanceBefore;
                  } else {
                      SafeERC20.safeTransferFrom(IERC20(token), msg.sender, address(this), amount);
                      TokenImplementation(token).burn(address(this), amount);
                  }
                  // normalize amounts decimals
                  uint256 normalizedAmount = normalizeAmount(amount, decimals);
                  uint256 normalizedArbiterFee = normalizeAmount(arbiterFee, decimals);
                  // track and check outstanding token amounts
                  if (tokenChain == chainId()) {
                      bridgeOut(token, normalizedAmount);
                  }
                  transferResult = BridgeStructs.TransferResult({
                      tokenChain : tokenChain,
                      tokenAddress : tokenAddress,
                      normalizedAmount : normalizedAmount,
                      normalizedArbiterFee : normalizedArbiterFee,
                      wormholeFee : msg.value
                  });
              }
              function normalizeAmount(uint256 amount, uint8 decimals) internal pure returns(uint256){
                  if (decimals > 8) {
                      amount /= 10 ** (decimals - 8);
                  }
                  return amount;
              }
              function deNormalizeAmount(uint256 amount, uint8 decimals) internal pure returns(uint256){
                  if (decimals > 8) {
                      amount *= 10 ** (decimals - 8);
                  }
                  return amount;
              }
              function logTransfer(
                  uint16 tokenChain,
                  bytes32 tokenAddress,
                  uint256 amount,
                  uint16 recipientChain,
                  bytes32 recipient,
                  uint256 fee,
                  uint256 callValue,
                  uint32 nonce
              ) internal returns (uint64 sequence) {
                  require(fee <= amount, "fee exceeds amount");
                  BridgeStructs.Transfer memory transfer = BridgeStructs.Transfer({
                      payloadID: 1,
                      amount: amount,
                      tokenAddress: tokenAddress,
                      tokenChain: tokenChain,
                      to: recipient,
                      toChain: recipientChain,
                      fee: fee
                  });
                  sequence = wormhole().publishMessage{value: callValue}(
                      nonce,
                      encodeTransfer(transfer),
                      finality()
                  );
              }
              /*
               * @dev Publish a token transfer message with payload.
               *
               * @return The sequence number of the published message.
               */
              function logTransferWithPayload(
                  uint16 tokenChain,
                  bytes32 tokenAddress,
                  uint256 amount,
                  uint16 recipientChain,
                  bytes32 recipient,
                  uint256 callValue,
                  uint32 nonce,
                  bytes memory payload
              ) internal returns (uint64 sequence) {
                  BridgeStructs.TransferWithPayload memory transfer = BridgeStructs
                      .TransferWithPayload({
                          payloadID: 3,
                          amount: amount,
                          tokenAddress: tokenAddress,
                          tokenChain: tokenChain,
                          to: recipient,
                          toChain: recipientChain,
                          fromAddress : bytes32(uint256(uint160(msg.sender))),
                          payload: payload
                      });
                  sequence = wormhole().publishMessage{value: callValue}(
                      nonce,
                      encodeTransferWithPayload(transfer),
                      finality()
                  );
              }
              function updateWrapped(bytes memory encodedVm) external returns (address token) {
                  (IWormhole.VM memory vm, bool valid, string memory reason) = wormhole().parseAndVerifyVM(encodedVm);
                  require(valid, reason);
                  require(verifyBridgeVM(vm), "invalid emitter");
                  BridgeStructs.AssetMeta memory meta = parseAssetMeta(vm.payload);
                  return _updateWrapped(meta, vm.sequence);
              }
              function _updateWrapped(BridgeStructs.AssetMeta memory meta, uint64 sequence) internal returns (address token) {
                  address wrapped = wrappedAsset(meta.tokenChain, meta.tokenAddress);
                  require(wrapped != address(0), "wrapped asset does not exists");
                  // Update metadata
                  TokenImplementation(wrapped).updateDetails(bytes32ToString(meta.name), bytes32ToString(meta.symbol), sequence);
                  return wrapped;
              }
              function createWrapped(bytes memory encodedVm) external returns (address token) {
                  (IWormhole.VM memory vm, bool valid, string memory reason) = wormhole().parseAndVerifyVM(encodedVm);
                  require(valid, reason);
                  require(verifyBridgeVM(vm), "invalid emitter");
                  BridgeStructs.AssetMeta memory meta = parseAssetMeta(vm.payload);
                  return _createWrapped(meta, vm.sequence);
              }
              // Creates a wrapped asset using AssetMeta
              function _createWrapped(BridgeStructs.AssetMeta memory meta, uint64 sequence) internal returns (address token) {
                  require(meta.tokenChain != chainId(), "can only wrap tokens from foreign chains");
                  require(wrappedAsset(meta.tokenChain, meta.tokenAddress) == address(0), "wrapped asset already exists");
                  // initialize the TokenImplementation
                  bytes memory initialisationArgs = abi.encodeWithSelector(
                      TokenImplementation.initialize.selector,
                      bytes32ToString(meta.name),
                      bytes32ToString(meta.symbol),
                      meta.decimals,
                      sequence,
                      address(this),
                      meta.tokenChain,
                      meta.tokenAddress
                  );
                  // initialize the BeaconProxy
                  bytes memory constructorArgs = abi.encode(address(this), initialisationArgs);
                  // deployment code
                  bytes memory bytecode = abi.encodePacked(type(BridgeToken).creationCode, constructorArgs);
                  bytes32 salt = keccak256(abi.encodePacked(meta.tokenChain, meta.tokenAddress));
                  assembly {
                      token := create2(0, add(bytecode, 0x20), mload(bytecode), salt)
                      if iszero(extcodesize(token)) {
                          revert(0, 0)
                      }
                  }
                  setWrappedAsset(meta.tokenChain, meta.tokenAddress, token);
              }
              /*
               * @notice Complete a contract-controlled transfer of an ERC20 token.
               *
               * @dev The transaction can only be redeemed by the recipient, typically a
               * contract.
               *
               * @param encodedVm    A byte array containing a VAA signed by the guardians.
               *
               * @return The byte array representing a BridgeStructs.TransferWithPayload.
               */
              function completeTransferWithPayload(bytes memory encodedVm) public returns (bytes memory) {
                  return _completeTransfer(encodedVm, false);
              }
              /*
               * @notice Complete a contract-controlled transfer of WETH, and unwrap to ETH.
               *
               * @dev The transaction can only be redeemed by the recipient, typically a
               * contract.
               *
               * @param encodedVm    A byte array containing a VAA signed by the guardians.
               *
               * @return The byte array representing a BridgeStructs.TransferWithPayload.
               */
              function completeTransferAndUnwrapETHWithPayload(bytes memory encodedVm) public returns (bytes memory) {
                  return _completeTransfer(encodedVm, true);
              }
              /*
               * @notice Complete a transfer of an ERC20 token.
               *
               * @dev The msg.sender gets paid the associated fee.
               *
               * @param encodedVm A byte array containing a VAA signed by the guardians.
               */
              function completeTransfer(bytes memory encodedVm) public {
                  _completeTransfer(encodedVm, false);
              }
              /*
               * @notice Complete a transfer of WETH and unwrap to eth.
               *
               * @dev The msg.sender gets paid the associated fee.
               *
               * @param encodedVm A byte array containing a VAA signed by the guardians.
               */
              function completeTransferAndUnwrapETH(bytes memory encodedVm) public {
                  _completeTransfer(encodedVm, true);
              }
              /*
               * @dev Truncate a 32 byte array to a 20 byte address.
               *      Reverts if the array contains non-0 bytes in the first 12 bytes.
               *
               * @param bytes32 bytes The 32 byte array to be converted.
               */
              function _truncateAddress(bytes32 b) internal pure returns (address) {
                  require(bytes12(b) == 0, "invalid EVM address");
                  return address(uint160(uint256(b)));
              }
              // Execute a Transfer message
              function _completeTransfer(bytes memory encodedVm, bool unwrapWETH) internal returns (bytes memory) {
                  (IWormhole.VM memory vm, bool valid, string memory reason) = wormhole().parseAndVerifyVM(encodedVm);
                  require(valid, reason);
                  require(verifyBridgeVM(vm), "invalid emitter");
                  BridgeStructs.Transfer memory transfer = _parseTransferCommon(vm.payload);
                  // payload 3 must be redeemed by the designated proxy contract
                  address transferRecipient = _truncateAddress(transfer.to);
                  if (transfer.payloadID == 3) {
                      require(msg.sender == transferRecipient, "invalid sender");
                  }
                  require(!isTransferCompleted(vm.hash), "transfer already completed");
                  setTransferCompleted(vm.hash);
                  // emit `TransferRedeemed` event
                  emit TransferRedeemed(vm.emitterChainId, vm.emitterAddress, vm.sequence);
                  require(transfer.toChain == chainId(), "invalid target chain");
                  IERC20 transferToken;
                  if (transfer.tokenChain == chainId()) {
                      transferToken = IERC20(_truncateAddress(transfer.tokenAddress));
                      // track outstanding token amounts
                      bridgedIn(address(transferToken), transfer.amount);
                  } else {
                      address wrapped = wrappedAsset(transfer.tokenChain, transfer.tokenAddress);
                      require(wrapped != address(0), "no wrapper for this token created yet");
                      transferToken = IERC20(wrapped);
                  }
                  require(unwrapWETH == false || address(transferToken) == address(WETH()), "invalid token, can only unwrap WETH");
                  // query decimals
                  (,bytes memory queriedDecimals) = address(transferToken).staticcall(abi.encodeWithSignature("decimals()"));
                  uint8 decimals = abi.decode(queriedDecimals, (uint8));
                  // adjust decimals
                  uint256 nativeAmount = deNormalizeAmount(transfer.amount, decimals);
                  uint256 nativeFee = deNormalizeAmount(transfer.fee, decimals);
                  // transfer fee to arbiter
                  if (nativeFee > 0 && transferRecipient != msg.sender) {
                      require(nativeFee <= nativeAmount, "fee higher than transferred amount");
                      if (unwrapWETH) {
                          WETH().withdraw(nativeFee);
                          payable(msg.sender).transfer(nativeFee);
                      } else {
                          if (transfer.tokenChain != chainId()) {
                              // mint wrapped asset
                              TokenImplementation(address(transferToken)).mint(msg.sender, nativeFee);
                          } else {
                              SafeERC20.safeTransfer(transferToken, msg.sender, nativeFee);
                          }
                      }
                  } else {
                      // set fee to zero in case transferRecipient == feeRecipient
                      nativeFee = 0;
                  }
                  // transfer bridged amount to recipient
                  uint transferAmount = nativeAmount - nativeFee;
                  if (unwrapWETH) {
                      WETH().withdraw(transferAmount);
                      payable(transferRecipient).transfer(transferAmount);
                  } else {
                      if (transfer.tokenChain != chainId()) {
                          // mint wrapped asset
                          TokenImplementation(address(transferToken)).mint(transferRecipient, transferAmount);
                      } else {
                          SafeERC20.safeTransfer(transferToken, transferRecipient, transferAmount);
                      }
                  }
                  return vm.payload;
              }
              function bridgeOut(address token, uint normalizedAmount) internal {
                  uint outstanding = outstandingBridged(token);
                  require(outstanding + normalizedAmount <= type(uint64).max, "transfer exceeds max outstanding bridged token amount");
                  setOutstandingBridged(token, outstanding + normalizedAmount);
              }
              function bridgedIn(address token, uint normalizedAmount) internal {
                  setOutstandingBridged(token, outstandingBridged(token) - normalizedAmount);
              }
              function verifyBridgeVM(IWormhole.VM memory vm) internal view returns (bool){
                  require(!isFork(), "invalid fork");
                  return bridgeContracts(vm.emitterChainId) == vm.emitterAddress;
              }
              function encodeAssetMeta(BridgeStructs.AssetMeta memory meta) public pure returns (bytes memory encoded) {
                  encoded = abi.encodePacked(
                      meta.payloadID,
                      meta.tokenAddress,
                      meta.tokenChain,
                      meta.decimals,
                      meta.symbol,
                      meta.name
                  );
              }
              function encodeTransfer(BridgeStructs.Transfer memory transfer) public pure returns (bytes memory encoded) {
                  encoded = abi.encodePacked(
                      transfer.payloadID,
                      transfer.amount,
                      transfer.tokenAddress,
                      transfer.tokenChain,
                      transfer.to,
                      transfer.toChain,
                      transfer.fee
                  );
              }
              function encodeTransferWithPayload(BridgeStructs.TransferWithPayload memory transfer) public pure returns (bytes memory encoded) {
                  encoded = abi.encodePacked(
                      transfer.payloadID,
                      transfer.amount,
                      transfer.tokenAddress,
                      transfer.tokenChain,
                      transfer.to,
                      transfer.toChain,
                      transfer.fromAddress,
                      transfer.payload
                  );
              }
              function parsePayloadID(bytes memory encoded) public pure returns (uint8 payloadID) {
                  payloadID = encoded.toUint8(0);
              }
              /*
               * @dev Parse a token metadata attestation (payload id 2)
               */
              function parseAssetMeta(bytes memory encoded) public pure returns (BridgeStructs.AssetMeta memory meta) {
                  uint index = 0;
                  meta.payloadID = encoded.toUint8(index);
                  index += 1;
                  require(meta.payloadID == 2, "invalid AssetMeta");
                  meta.tokenAddress = encoded.toBytes32(index);
                  index += 32;
                  meta.tokenChain = encoded.toUint16(index);
                  index += 2;
                  meta.decimals = encoded.toUint8(index);
                  index += 1;
                  meta.symbol = encoded.toBytes32(index);
                  index += 32;
                  meta.name = encoded.toBytes32(index);
                  index += 32;
                  require(encoded.length == index, "invalid AssetMeta");
              }
              /*
               * @dev Parse a token transfer (payload id 1).
               *
               * @params encoded The byte array corresponding to the token transfer (not
               *                 the whole VAA, only the payload)
               */
              function parseTransfer(bytes memory encoded) public pure returns (BridgeStructs.Transfer memory transfer) {
                  uint index = 0;
                  transfer.payloadID = encoded.toUint8(index);
                  index += 1;
                  require(transfer.payloadID == 1, "invalid Transfer");
                  transfer.amount = encoded.toUint256(index);
                  index += 32;
                  transfer.tokenAddress = encoded.toBytes32(index);
                  index += 32;
                  transfer.tokenChain = encoded.toUint16(index);
                  index += 2;
                  transfer.to = encoded.toBytes32(index);
                  index += 32;
                  transfer.toChain = encoded.toUint16(index);
                  index += 2;
                  transfer.fee = encoded.toUint256(index);
                  index += 32;
                  require(encoded.length == index, "invalid Transfer");
              }
              /*
               * @dev Parse a token transfer with payload (payload id 3).
               *
               * @params encoded The byte array corresponding to the token transfer (not
               *                 the whole VAA, only the payload)
               */
              function parseTransferWithPayload(bytes memory encoded) public pure returns (BridgeStructs.TransferWithPayload memory transfer) {
                  uint index = 0;
                  transfer.payloadID = encoded.toUint8(index);
                  index += 1;
                  require(transfer.payloadID == 3, "invalid Transfer");
                  transfer.amount = encoded.toUint256(index);
                  index += 32;
                  transfer.tokenAddress = encoded.toBytes32(index);
                  index += 32;
                  transfer.tokenChain = encoded.toUint16(index);
                  index += 2;
                  transfer.to = encoded.toBytes32(index);
                  index += 32;
                  transfer.toChain = encoded.toUint16(index);
                  index += 2;
                  transfer.fromAddress = encoded.toBytes32(index);
                  index += 32;
                  transfer.payload = encoded.slice(index, encoded.length - index);
              }
              /*
               * @dev Parses either a type 1 transfer or a type 3 transfer ("transfer with
               *      payload") as a Transfer struct. The fee is set to 0 for type 3
               *      transfers, since they have no fees associated with them.
               *
               *      The sole purpose of this function is to get around the local
               *      variable count limitation in _completeTransfer.
               */
              function _parseTransferCommon(bytes memory encoded) public pure returns (BridgeStructs.Transfer memory transfer) {
                  uint8 payloadID = parsePayloadID(encoded);
                  if (payloadID == 1) {
                      transfer = parseTransfer(encoded);
                  } else if (payloadID == 3) {
                      BridgeStructs.TransferWithPayload memory t = parseTransferWithPayload(encoded);
                      transfer.payloadID = 3;
                      transfer.amount = t.amount;
                      transfer.tokenAddress = t.tokenAddress;
                      transfer.tokenChain = t.tokenChain;
                      transfer.to = t.to;
                      transfer.toChain = t.toChain;
                      // Type 3 payloads don't have fees.
                      transfer.fee = 0;
                  } else {
                      revert("Invalid payload id");
                  }
              }
              function bytes32ToString(bytes32 input) internal pure returns (string memory) {
                  uint256 i;
                  while (i < 32 && input[i] != 0) {
                      i++;
                  }
                  bytes memory array = new bytes(i);
                  for (uint c = 0; c < i; c++) {
                      array[c] = input[c];
                  }
                  return string(array);
              }
              // we need to accept ETH sends to unwrap WETH
              receive() external payable {}
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
           *
           * These functions can be used to verify that a message was signed by the holder
           * of the private keys of a given address.
           */
          library ECDSA {
              enum RecoverError {
                  NoError,
                  InvalidSignature,
                  InvalidSignatureLength,
                  InvalidSignatureS,
                  InvalidSignatureV
              }
              function _throwError(RecoverError error) private pure {
                  if (error == RecoverError.NoError) {
                      return; // no error: do nothing
                  } else if (error == RecoverError.InvalidSignature) {
                      revert("ECDSA: invalid signature");
                  } else if (error == RecoverError.InvalidSignatureLength) {
                      revert("ECDSA: invalid signature length");
                  } else if (error == RecoverError.InvalidSignatureS) {
                      revert("ECDSA: invalid signature 's' value");
                  } else if (error == RecoverError.InvalidSignatureV) {
                      revert("ECDSA: invalid signature 'v' value");
                  }
              }
              /**
               * @dev Returns the address that signed a hashed message (`hash`) with
               * `signature` or error string. This address can then be used for verification purposes.
               *
               * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
               * this function rejects them by requiring the `s` value to be in the lower
               * half order, and the `v` value to be either 27 or 28.
               *
               * IMPORTANT: `hash` _must_ be the result of a hash operation for the
               * verification to be secure: it is possible to craft signatures that
               * recover to arbitrary addresses for non-hashed data. A safe way to ensure
               * this is by receiving a hash of the original message (which may otherwise
               * be too long), and then calling {toEthSignedMessageHash} on it.
               *
               * Documentation for signature generation:
               * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
               * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
               *
               * _Available since v4.3._
               */
              function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
                  // Check the signature length
                  // - case 65: r,s,v signature (standard)
                  // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._
                  if (signature.length == 65) {
                      bytes32 r;
                      bytes32 s;
                      uint8 v;
                      // ecrecover takes the signature parameters, and the only way to get them
                      // currently is to use assembly.
                      assembly {
                          r := mload(add(signature, 0x20))
                          s := mload(add(signature, 0x40))
                          v := byte(0, mload(add(signature, 0x60)))
                      }
                      return tryRecover(hash, v, r, s);
                  } else if (signature.length == 64) {
                      bytes32 r;
                      bytes32 vs;
                      // ecrecover takes the signature parameters, and the only way to get them
                      // currently is to use assembly.
                      assembly {
                          r := mload(add(signature, 0x20))
                          vs := mload(add(signature, 0x40))
                      }
                      return tryRecover(hash, r, vs);
                  } else {
                      return (address(0), RecoverError.InvalidSignatureLength);
                  }
              }
              /**
               * @dev Returns the address that signed a hashed message (`hash`) with
               * `signature`. This address can then be used for verification purposes.
               *
               * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
               * this function rejects them by requiring the `s` value to be in the lower
               * half order, and the `v` value to be either 27 or 28.
               *
               * IMPORTANT: `hash` _must_ be the result of a hash operation for the
               * verification to be secure: it is possible to craft signatures that
               * recover to arbitrary addresses for non-hashed data. A safe way to ensure
               * this is by receiving a hash of the original message (which may otherwise
               * be too long), and then calling {toEthSignedMessageHash} on it.
               */
              function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
                  (address recovered, RecoverError error) = tryRecover(hash, signature);
                  _throwError(error);
                  return recovered;
              }
              /**
               * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
               *
               * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
               *
               * _Available since v4.3._
               */
              function tryRecover(
                  bytes32 hash,
                  bytes32 r,
                  bytes32 vs
              ) internal pure returns (address, RecoverError) {
                  bytes32 s;
                  uint8 v;
                  assembly {
                      s := and(vs, 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff)
                      v := add(shr(255, vs), 27)
                  }
                  return tryRecover(hash, v, r, s);
              }
              /**
               * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
               *
               * _Available since v4.2._
               */
              function recover(
                  bytes32 hash,
                  bytes32 r,
                  bytes32 vs
              ) internal pure returns (address) {
                  (address recovered, RecoverError error) = tryRecover(hash, r, vs);
                  _throwError(error);
                  return recovered;
              }
              /**
               * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
               * `r` and `s` signature fields separately.
               *
               * _Available since v4.3._
               */
              function tryRecover(
                  bytes32 hash,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) internal pure returns (address, RecoverError) {
                  // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
                  // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
                  // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
                  // signatures from current libraries generate a unique signature with an s-value in the lower half order.
                  //
                  // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
                  // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
                  // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
                  // these malleable signatures as well.
                  if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
                      return (address(0), RecoverError.InvalidSignatureS);
                  }
                  if (v != 27 && v != 28) {
                      return (address(0), RecoverError.InvalidSignatureV);
                  }
                  // If the signature is valid (and not malleable), return the signer address
                  address signer = ecrecover(hash, v, r, s);
                  if (signer == address(0)) {
                      return (address(0), RecoverError.InvalidSignature);
                  }
                  return (signer, RecoverError.NoError);
              }
              /**
               * @dev Overload of {ECDSA-recover} that receives the `v`,
               * `r` and `s` signature fields separately.
               */
              function recover(
                  bytes32 hash,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) internal pure returns (address) {
                  (address recovered, RecoverError error) = tryRecover(hash, v, r, s);
                  _throwError(error);
                  return recovered;
              }
              /**
               * @dev Returns an Ethereum Signed Message, created from a `hash`. This
               * produces hash corresponding to the one signed with the
               * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
               * JSON-RPC method as part of EIP-191.
               *
               * See {recover}.
               */
              function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) {
                  // 32 is the length in bytes of hash,
                  // enforced by the type signature above
                  return keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
          32", hash));
              }
              /**
               * @dev Returns an Ethereum Signed Typed Data, created from a
               * `domainSeparator` and a `structHash`. This produces hash corresponding
               * to the one signed with the
               * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
               * JSON-RPC method as part of EIP-712.
               *
               * See {recover}.
               */
              function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) {
                  return keccak256(abi.encodePacked("\\x19\\x01", domainSeparator, structHash));
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev Library for reading and writing primitive types to specific storage slots.
           *
           * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
           * This library helps with reading and writing to such slots without the need for inline assembly.
           *
           * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
           *
           * Example usage to set ERC1967 implementation slot:
           * ```
           * contract ERC1967 {
           *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
           *
           *     function _getImplementation() internal view returns (address) {
           *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
           *     }
           *
           *     function _setImplementation(address newImplementation) internal {
           *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
           *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
           *     }
           * }
           * ```
           *
           * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
           */
          library StorageSlot {
              struct AddressSlot {
                  address value;
              }
              struct BooleanSlot {
                  bool value;
              }
              struct Bytes32Slot {
                  bytes32 value;
              }
              struct Uint256Slot {
                  uint256 value;
              }
              /**
               * @dev Returns an `AddressSlot` with member `value` located at `slot`.
               */
              function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
               */
              function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
               */
              function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
               */
              function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @title Counters
           * @author Matt Condon (@shrugs)
           * @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
           * of elements in a mapping, issuing ERC721 ids, or counting request ids.
           *
           * Include with `using Counters for Counters.Counter;`
           */
          library Counters {
              struct Counter {
                  // This variable should never be directly accessed by users of the library: interactions must be restricted to
                  // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
                  // this feature: see https://github.com/ethereum/solidity/issues/4637
                  uint256 _value; // default: 0
              }
              function current(Counter storage counter) internal view returns (uint256) {
                  return counter._value;
              }
              function increment(Counter storage counter) internal {
                  unchecked {
                      counter._value += 1;
                  }
              }
              function decrement(Counter storage counter) internal {
                  uint256 value = counter._value;
                  require(value > 0, "Counter: decrement overflow");
                  unchecked {
                      counter._value = value - 1;
                  }
              }
              function reset(Counter storage counter) internal {
                  counter._value = 0;
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev Provides information about the current execution context, including the
           * sender of the transaction and its data. While these are generally available
           * via msg.sender and msg.data, they should not be accessed in such a direct
           * manner, since when dealing with meta-transactions the account sending and
           * paying for execution may not be the actual sender (as far as an application
           * is concerned).
           *
           * This contract is only required for intermediate, library-like contracts.
           */
          abstract contract Context {
              function _msgSender() internal view virtual returns (address) {
                  return msg.sender;
              }
              function _msgData() internal view virtual returns (bytes calldata) {
                  return msg.data;
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev Collection of functions related to the address type
           */
          library Address {
              /**
               * @dev Returns true if `account` is a contract.
               *
               * [IMPORTANT]
               * ====
               * It is unsafe to assume that an address for which this function returns
               * false is an externally-owned account (EOA) and not a contract.
               *
               * Among others, `isContract` will return false for the following
               * types of addresses:
               *
               *  - an externally-owned account
               *  - a contract in construction
               *  - an address where a contract will be created
               *  - an address where a contract lived, but was destroyed
               * ====
               */
              function isContract(address account) internal view returns (bool) {
                  // This method relies on extcodesize, which returns 0 for contracts in
                  // construction, since the code is only stored at the end of the
                  // constructor execution.
                  uint256 size;
                  assembly {
                      size := extcodesize(account)
                  }
                  return size > 0;
              }
              /**
               * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
               * `recipient`, forwarding all available gas and reverting on errors.
               *
               * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
               * of certain opcodes, possibly making contracts go over the 2300 gas limit
               * imposed by `transfer`, making them unable to receive funds via
               * `transfer`. {sendValue} removes this limitation.
               *
               * https://diligence.consensys.net/posts/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.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
               */
              function sendValue(address payable recipient, uint256 amount) internal {
                  require(address(this).balance >= amount, "Address: insufficient balance");
                  (bool success, ) = recipient.call{value: amount}("");
                  require(success, "Address: unable to send value, recipient may have reverted");
              }
              /**
               * @dev Performs a Solidity function call using a low level `call`. A
               * plain `call` is an unsafe replacement for a function call: use this
               * function instead.
               *
               * If `target` reverts with a revert reason, it is bubbled up by this
               * function (like regular Solidity function calls).
               *
               * Returns the raw returned data. To convert to the expected return value,
               * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
               *
               * Requirements:
               *
               * - `target` must be a contract.
               * - calling `target` with `data` must not revert.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionCall(target, data, "Address: low-level call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
               * `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but also transferring `value` wei to `target`.
               *
               * Requirements:
               *
               * - the calling contract must have an ETH balance of at least `value`.
               * - the called Solidity function must be `payable`.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value
              ) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
              }
              /**
               * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
               * with `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  require(address(this).balance >= value, "Address: insufficient balance for call");
                  require(isContract(target), "Address: call to non-contract");
                  (bool success, bytes memory returndata) = target.call{value: value}(data);
                  return verifyCallResult(success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                  return functionStaticCall(target, data, "Address: low-level static call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal view returns (bytes memory) {
                  require(isContract(target), "Address: static call to non-contract");
                  (bool success, bytes memory returndata) = target.staticcall(data);
                  return verifyCallResult(success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionDelegateCall(target, data, "Address: low-level delegate call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  require(isContract(target), "Address: delegate call to non-contract");
                  (bool success, bytes memory returndata) = target.delegatecall(data);
                  return verifyCallResult(success, returndata, errorMessage);
              }
              /**
               * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
               * revert reason using the provided one.
               *
               * _Available since v4.3._
               */
              function verifyCallResult(
                  bool success,
                  bytes memory returndata,
                  string memory errorMessage
              ) internal pure returns (bytes memory) {
                  if (success) {
                      return returndata;
                  } else {
                      // 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
                          assembly {
                              let returndata_size := mload(returndata)
                              revert(add(32, returndata), returndata_size)
                          }
                      } else {
                          revert(errorMessage);
                      }
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          import "../IERC20.sol";
          import "../../../utils/Address.sol";
          /**
           * @title SafeERC20
           * @dev Wrappers around ERC20 operations that throw on failure (when the token
           * contract returns false). Tokens that return no value (and instead revert or
           * throw on failure) are also supported, non-reverting calls are assumed to be
           * successful.
           * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
           * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
           */
          library SafeERC20 {
              using Address for address;
              function safeTransfer(
                  IERC20 token,
                  address to,
                  uint256 value
              ) internal {
                  _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
              }
              function safeTransferFrom(
                  IERC20 token,
                  address from,
                  address to,
                  uint256 value
              ) internal {
                  _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
              }
              /**
               * @dev Deprecated. This function has issues similar to the ones found in
               * {IERC20-approve}, and its usage is discouraged.
               *
               * Whenever possible, use {safeIncreaseAllowance} and
               * {safeDecreaseAllowance} instead.
               */
              function safeApprove(
                  IERC20 token,
                  address spender,
                  uint256 value
              ) internal {
                  // safeApprove should only be called when setting an initial allowance,
                  // or when resetting it to zero. To increase and decrease it, use
                  // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                  require(
                      (value == 0) || (token.allowance(address(this), spender) == 0),
                      "SafeERC20: approve from non-zero to non-zero allowance"
                  );
                  _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
              }
              function safeIncreaseAllowance(
                  IERC20 token,
                  address spender,
                  uint256 value
              ) internal {
                  uint256 newAllowance = token.allowance(address(this), spender) + value;
                  _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
              }
              function safeDecreaseAllowance(
                  IERC20 token,
                  address spender,
                  uint256 value
              ) internal {
                  unchecked {
                      uint256 oldAllowance = token.allowance(address(this), spender);
                      require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
                      uint256 newAllowance = oldAllowance - value;
                      _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                  }
              }
              /**
               * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
               * on the return value: the return value is optional (but if data is returned, it must not be false).
               * @param token The token targeted by the call.
               * @param data The call data (encoded using abi.encode or one of its variants).
               */
              function _callOptionalReturn(IERC20 token, bytes memory data) private {
                  // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                  // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
                  // the target address contains contract code and also asserts for success in the low-level call.
                  bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
                  if (returndata.length > 0) {
                      // Return data is optional
                      require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev Interface of the ERC20 standard as defined in the EIP.
           */
          interface IERC20 {
              /**
               * @dev Returns the amount of tokens in existence.
               */
              function totalSupply() external view returns (uint256);
              /**
               * @dev Returns the amount of tokens owned by `account`.
               */
              function balanceOf(address account) external view returns (uint256);
              /**
               * @dev Moves `amount` tokens from the caller's account to `recipient`.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * Emits a {Transfer} event.
               */
              function transfer(address recipient, uint256 amount) external returns (bool);
              /**
               * @dev Returns the remaining number of tokens that `spender` will be
               * allowed to spend on behalf of `owner` through {transferFrom}. This is
               * zero by default.
               *
               * This value changes when {approve} or {transferFrom} are called.
               */
              function allowance(address owner, address spender) external view returns (uint256);
              /**
               * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * IMPORTANT: Beware that changing an allowance with this method brings the risk
               * that someone may use both the old and the new allowance by unfortunate
               * transaction ordering. One possible solution to mitigate this race
               * condition is to first reduce the spender's allowance to 0 and set the
               * desired value afterwards:
               * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
               *
               * Emits an {Approval} event.
               */
              function approve(address spender, uint256 amount) external returns (bool);
              /**
               * @dev Moves `amount` tokens from `sender` to `recipient` using the
               * allowance mechanism. `amount` is then deducted from the caller's
               * allowance.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * Emits a {Transfer} event.
               */
              function transferFrom(
                  address sender,
                  address recipient,
                  uint256 amount
              ) external returns (bool);
              /**
               * @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);
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev Contract module that helps prevent reentrant calls to a function.
           *
           * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
           * available, which can be applied to functions to make sure there are no nested
           * (reentrant) calls to them.
           *
           * Note that because there is a single `nonReentrant` guard, functions marked as
           * `nonReentrant` may not call one another. This can be worked around by making
           * those functions `private`, and then adding `external` `nonReentrant` entry
           * points to them.
           *
           * TIP: If you would like to learn more about reentrancy and alternative ways
           * to protect against it, check out our blog post
           * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
           */
          abstract contract ReentrancyGuard {
              // Booleans are more expensive than uint256 or any type that takes up a full
              // word because each write operation emits an extra SLOAD to first read the
              // slot's contents, replace the bits taken up by the boolean, and then write
              // back. This is the compiler's defense against contract upgrades and
              // pointer aliasing, and it cannot be disabled.
              // The values being non-zero value makes deployment a bit more expensive,
              // but in exchange the refund on every call to nonReentrant will be lower in
              // amount. Since refunds are capped to a percentage of the total
              // transaction's gas, it is best to keep them low in cases like this one, to
              // increase the likelihood of the full refund coming into effect.
              uint256 private constant _NOT_ENTERED = 1;
              uint256 private constant _ENTERED = 2;
              uint256 private _status;
              constructor() {
                  _status = _NOT_ENTERED;
              }
              /**
               * @dev Prevents a contract from calling itself, directly or indirectly.
               * Calling a `nonReentrant` function from another `nonReentrant`
               * function is not supported. It is possible to prevent this from happening
               * by making the `nonReentrant` function external, and make it call a
               * `private` function that does the actual work.
               */
              modifier nonReentrant() {
                  // On the first call to nonReentrant, _notEntered will be true
                  require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
                  // Any calls to nonReentrant after this point will fail
                  _status = _ENTERED;
                  _;
                  // By storing the original value once again, a refund is triggered (see
                  // https://eips.ethereum.org/EIPS/eip-2200)
                  _status = _NOT_ENTERED;
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev This is the interface that {BeaconProxy} expects of its beacon.
           */
          interface IBeacon {
              /**
               * @dev Must return an address that can be used as a delegate call target.
               *
               * {BeaconProxy} will check that this address is a contract.
               */
              function implementation() external view returns (address);
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          import "./IBeacon.sol";
          import "../Proxy.sol";
          import "../ERC1967/ERC1967Upgrade.sol";
          /**
           * @dev This contract implements a proxy that gets the implementation address for each call from a {UpgradeableBeacon}.
           *
           * The beacon address is stored in storage slot `uint256(keccak256('eip1967.proxy.beacon')) - 1`, so that it doesn't
           * conflict with the storage layout of the implementation behind the proxy.
           *
           * _Available since v3.4._
           */
          contract BeaconProxy is Proxy, ERC1967Upgrade {
              /**
               * @dev Initializes the proxy with `beacon`.
               *
               * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon. This
               * will typically be an encoded function call, and allows initializating the storage of the proxy like a Solidity
               * constructor.
               *
               * Requirements:
               *
               * - `beacon` must be a contract with the interface {IBeacon}.
               */
              constructor(address beacon, bytes memory data) payable {
                  assert(_BEACON_SLOT == bytes32(uint256(keccak256("eip1967.proxy.beacon")) - 1));
                  _upgradeBeaconToAndCall(beacon, data, false);
              }
              /**
               * @dev Returns the current beacon address.
               */
              function _beacon() internal view virtual returns (address) {
                  return _getBeacon();
              }
              /**
               * @dev Returns the current implementation address of the associated beacon.
               */
              function _implementation() internal view virtual override returns (address) {
                  return IBeacon(_getBeacon()).implementation();
              }
              /**
               * @dev Changes the proxy to use a new beacon. Deprecated: see {_upgradeBeaconToAndCall}.
               *
               * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon.
               *
               * Requirements:
               *
               * - `beacon` must be a contract.
               * - The implementation returned by `beacon` must be a contract.
               */
              function _setBeacon(address beacon, bytes memory data) internal virtual {
                  _upgradeBeaconToAndCall(beacon, data, false);
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          /**
           * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
           * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
           * be specified by overriding the virtual {_implementation} function.
           *
           * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
           * different contract through the {_delegate} function.
           *
           * The success and return data of the delegated call will be returned back to the caller of the proxy.
           */
          abstract contract Proxy {
              /**
               * @dev Delegates the current call to `implementation`.
               *
               * This function does not return to its internall 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 overriden 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 internall call site, it will return directly to the external caller.
               */
              function _fallback() internal virtual {
                  _beforeFallback();
                  _delegate(_implementation());
              }
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
               * function in the contract matches the call data.
               */
              fallback() external payable virtual {
                  _fallback();
              }
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
               * is empty.
               */
              receive() external payable virtual {
                  _fallback();
              }
              /**
               * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
               * call, or as part of the Solidity `fallback` or `receive` functions.
               *
               * If overriden should call `super._beforeFallback()`.
               */
              function _beforeFallback() internal virtual {}
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.2;
          import "../beacon/IBeacon.sol";
          import "../../utils/Address.sol";
          import "../../utils/StorageSlot.sol";
          /**
           * @dev This abstract contract provides getters and event emitting update functions for
           * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
           *
           * _Available since v4.1._
           *
           * @custom:oz-upgrades-unsafe-allow delegatecall
           */
          abstract contract ERC1967Upgrade {
              // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
              bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
              /**
               * @dev Storage slot with the address of the current implementation.
               * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
              /**
               * @dev Emitted when the implementation is upgraded.
               */
              event Upgraded(address indexed implementation);
              /**
               * @dev Returns the current implementation address.
               */
              function _getImplementation() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
              }
              /**
               * @dev Stores a new address in the EIP1967 implementation slot.
               */
              function _setImplementation(address newImplementation) private {
                  require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                  StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
              }
              /**
               * @dev Perform implementation upgrade
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeTo(address newImplementation) internal {
                  _setImplementation(newImplementation);
                  emit Upgraded(newImplementation);
              }
              /**
               * @dev Perform implementation upgrade with additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCall(
                  address newImplementation,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  _upgradeTo(newImplementation);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(newImplementation, data);
                  }
              }
              /**
               * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCallSecure(
                  address newImplementation,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  address oldImplementation = _getImplementation();
                  // Initial upgrade and setup call
                  _setImplementation(newImplementation);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(newImplementation, data);
                  }
                  // Perform rollback test if not already in progress
                  StorageSlot.BooleanSlot storage rollbackTesting = StorageSlot.getBooleanSlot(_ROLLBACK_SLOT);
                  if (!rollbackTesting.value) {
                      // Trigger rollback using upgradeTo from the new implementation
                      rollbackTesting.value = true;
                      Address.functionDelegateCall(
                          newImplementation,
                          abi.encodeWithSignature("upgradeTo(address)", oldImplementation)
                      );
                      rollbackTesting.value = false;
                      // Check rollback was effective
                      require(oldImplementation == _getImplementation(), "ERC1967Upgrade: upgrade breaks further upgrades");
                      // Finally reset to the new implementation and log the upgrade
                      _upgradeTo(newImplementation);
                  }
              }
              /**
               * @dev Storage slot with the admin of the contract.
               * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
              /**
               * @dev Emitted when the admin account has changed.
               */
              event AdminChanged(address previousAdmin, address newAdmin);
              /**
               * @dev Returns the current admin.
               */
              function _getAdmin() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
              }
              /**
               * @dev Stores a new address in the EIP1967 admin slot.
               */
              function _setAdmin(address newAdmin) private {
                  require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                  StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
              }
              /**
               * @dev Changes the admin of the proxy.
               *
               * Emits an {AdminChanged} event.
               */
              function _changeAdmin(address newAdmin) internal {
                  emit AdminChanged(_getAdmin(), newAdmin);
                  _setAdmin(newAdmin);
              }
              /**
               * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
               * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
               */
              bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
              /**
               * @dev Emitted when the beacon is upgraded.
               */
              event BeaconUpgraded(address indexed beacon);
              /**
               * @dev Returns the current beacon.
               */
              function _getBeacon() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
              }
              /**
               * @dev Stores a new beacon in the EIP1967 beacon slot.
               */
              function _setBeacon(address newBeacon) private {
                  require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract");
                  require(
                      Address.isContract(IBeacon(newBeacon).implementation()),
                      "ERC1967: beacon implementation is not a contract"
                  );
                  StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
              }
              /**
               * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
               * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
               *
               * Emits a {BeaconUpgraded} event.
               */
              function _upgradeBeaconToAndCall(
                  address newBeacon,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  _setBeacon(newBeacon);
                  emit BeaconUpgraded(newBeacon);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          import "../utils/Context.sol";
          /**
           * @dev Contract module which provides a basic access control mechanism, where
           * there is an account (an owner) that can be granted exclusive access to
           * specific functions.
           *
           * By default, the owner account will be the one that deploys the contract. This
           * can later be changed with {transferOwnership}.
           *
           * This module is used through inheritance. It will make available the modifier
           * `onlyOwner`, which can be applied to your functions to restrict their use to
           * the owner.
           */
          abstract contract Ownable is Context {
              address private _owner;
              event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
              /**
               * @dev Initializes the contract setting the deployer as the initial owner.
               */
              constructor() {
                  _setOwner(_msgSender());
              }
              /**
               * @dev Returns the address of the current owner.
               */
              function owner() public view virtual returns (address) {
                  return _owner;
              }
              /**
               * @dev Throws if called by any account other than the owner.
               */
              modifier onlyOwner() {
                  require(owner() == _msgSender(), "Ownable: caller is not the owner");
                  _;
              }
              /**
               * @dev Leaves the contract without owner. It will not be possible to call
               * `onlyOwner` functions anymore. Can only be called by the current owner.
               *
               * NOTE: Renouncing ownership will leave the contract without an owner,
               * thereby removing any functionality that is only available to the owner.
               */
              function renounceOwnership() public virtual onlyOwner {
                  _setOwner(address(0));
              }
              /**
               * @dev Transfers ownership of the contract to a new account (`newOwner`).
               * Can only be called by the current owner.
               */
              function transferOwnership(address newOwner) public virtual onlyOwner {
                  require(newOwner != address(0), "Ownable: new owner is the zero address");
                  _setOwner(newOwner);
              }
              function _setOwner(address newOwner) private {
                  address oldOwner = _owner;
                  _owner = newOwner;
                  emit OwnershipTransferred(oldOwner, newOwner);
              }
          }
          

          File 6 of 6: TokenImplementation
          // SPDX-License-Identifier: Apache 2
          // File: @openzeppelin/contracts/utils/Counters.sol
          
          
          pragma solidity ^0.8.0;
          
          /**
           * @title Counters
           * @author Matt Condon (@shrugs)
           * @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
           * of elements in a mapping, issuing ERC721 ids, or counting request ids.
           *
           * Include with `using Counters for Counters.Counter;`
           */
          library Counters {
              struct Counter {
                  // This variable should never be directly accessed by users of the library: interactions must be restricted to
                  // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
                  // this feature: see https://github.com/ethereum/solidity/issues/4637
                  uint256 _value; // default: 0
              }
          
              function current(Counter storage counter) internal view returns (uint256) {
                  return counter._value;
              }
          
              function increment(Counter storage counter) internal {
                  unchecked {
                      counter._value += 1;
                  }
              }
          
              function decrement(Counter storage counter) internal {
                  uint256 value = counter._value;
                  require(value > 0, "Counter: decrement overflow");
                  unchecked {
                      counter._value = value - 1;
                  }
              }
          
              function reset(Counter storage counter) internal {
                  counter._value = 0;
              }
          }
          
          // File: contracts/bridge/token/TokenState.sol
          
          // contracts/State.sol
          
          pragma solidity ^0.8.0;
          
          contract TokenStorage {
              struct State {
                  string name;
                  string symbol;
          
                  uint64 metaLastUpdatedSequence;
          
                  uint256 totalSupply;
                  uint8 decimals;
          
                  mapping(address => uint256) balances;
          
                  mapping(address => mapping(address => uint256)) allowances;
          
                  address owner;
          
                  bool initialized;
          
                  uint16 chainId;
                  bytes32 nativeContract;
          
                  // EIP712
                  // Cache the domain separator and salt, but also store the chain id that 
                  // it corresponds to, in order to invalidate the cached domain separator
                  // if the chain id changes.
                  bytes32 cachedDomainSeparator;
                  uint256 cachedChainId;
                  address cachedThis;
                  bytes32 cachedSalt;
                  bytes32 cachedHashedName;
          
                  // ERC20Permit draft
                  mapping(address => Counters.Counter) nonces;
              }
          }
          
          contract TokenState {
              using Counters for Counters.Counter;
          
              TokenStorage.State _state;
          
              /**
               * @dev See {IERC20Permit-nonces}.
               */
              function nonces(address owner_) public view returns (uint256) {
                  return _state.nonces[owner_].current();
              }
          
              /**
               * @dev "Consume a nonce": return the current value and increment.
               */
              function _useNonce(address owner_) internal returns (uint256 current) {
                  Counters.Counter storage nonce = _state.nonces[owner_];
                  current = nonce.current();
                  nonce.increment();
              }
          }
          
          // File: @openzeppelin/contracts/utils/Context.sol
          
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev Provides information about the current execution context, including the
           * sender of the transaction and its data. While these are generally available
           * via msg.sender and msg.data, they should not be accessed in such a direct
           * manner, since when dealing with meta-transactions the account sending and
           * paying for execution may not be the actual sender (as far as an application
           * is concerned).
           *
           * This contract is only required for intermediate, library-like contracts.
           */
          abstract contract Context {
              function _msgSender() internal view virtual returns (address) {
                  return msg.sender;
              }
          
              function _msgData() internal view virtual returns (bytes calldata) {
                  return msg.data;
              }
          }
          
          // File: @openzeppelin/contracts/access/Ownable.sol
          
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev Contract module which provides a basic access control mechanism, where
           * there is an account (an owner) that can be granted exclusive access to
           * specific functions.
           *
           * By default, the owner account will be the one that deploys the contract. This
           * can later be changed with {transferOwnership}.
           *
           * This module is used through inheritance. It will make available the modifier
           * `onlyOwner`, which can be applied to your functions to restrict their use to
           * the owner.
           */
          abstract contract Ownable is Context {
              address private _owner;
          
              event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
          
              /**
               * @dev Initializes the contract setting the deployer as the initial owner.
               */
              constructor() {
                  _setOwner(_msgSender());
              }
          
              /**
               * @dev Returns the address of the current owner.
               */
              function owner() public view virtual returns (address) {
                  return _owner;
              }
          
              /**
               * @dev Throws if called by any account other than the owner.
               */
              modifier onlyOwner() {
                  require(owner() == _msgSender(), "Ownable: caller is not the owner");
                  _;
              }
          
              /**
               * @dev Leaves the contract without owner. It will not be possible to call
               * `onlyOwner` functions anymore. Can only be called by the current owner.
               *
               * NOTE: Renouncing ownership will leave the contract without an owner,
               * thereby removing any functionality that is only available to the owner.
               */
              function renounceOwnership() public virtual onlyOwner {
                  _setOwner(address(0));
              }
          
              /**
               * @dev Transfers ownership of the contract to a new account (`newOwner`).
               * Can only be called by the current owner.
               */
              function transferOwnership(address newOwner) public virtual onlyOwner {
                  require(newOwner != address(0), "Ownable: new owner is the zero address");
                  _setOwner(newOwner);
              }
          
              function _setOwner(address newOwner) private {
                  address oldOwner = _owner;
                  _owner = newOwner;
                  emit OwnershipTransferred(oldOwner, newOwner);
              }
          }
          
          // File: @openzeppelin/contracts/proxy/beacon/IBeacon.sol
          
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev This is the interface that {BeaconProxy} expects of its beacon.
           */
          interface IBeacon {
              /**
               * @dev Must return an address that can be used as a delegate call target.
               *
               * {BeaconProxy} will check that this address is a contract.
               */
              function implementation() external view returns (address);
          }
          
          // File: @openzeppelin/contracts/proxy/Proxy.sol
          
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
           * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
           * be specified by overriding the virtual {_implementation} function.
           *
           * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
           * different contract through the {_delegate} function.
           *
           * The success and return data of the delegated call will be returned back to the caller of the proxy.
           */
          abstract contract Proxy {
              /**
               * @dev Delegates the current call to `implementation`.
               *
               * This function does not return to its internall 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 overriden 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 internall call site, it will return directly to the external caller.
               */
              function _fallback() internal virtual {
                  _beforeFallback();
                  _delegate(_implementation());
              }
          
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
               * function in the contract matches the call data.
               */
              fallback() external payable virtual {
                  _fallback();
              }
          
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
               * is empty.
               */
              receive() external payable virtual {
                  _fallback();
              }
          
              /**
               * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
               * call, or as part of the Solidity `fallback` or `receive` functions.
               *
               * If overriden should call `super._beforeFallback()`.
               */
              function _beforeFallback() internal virtual {}
          }
          
          // File: @openzeppelin/contracts/utils/Address.sol
          
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev Collection of functions related to the address type
           */
          library Address {
              /**
               * @dev Returns true if `account` is a contract.
               *
               * [IMPORTANT]
               * ====
               * It is unsafe to assume that an address for which this function returns
               * false is an externally-owned account (EOA) and not a contract.
               *
               * Among others, `isContract` will return false for the following
               * types of addresses:
               *
               *  - an externally-owned account
               *  - a contract in construction
               *  - an address where a contract will be created
               *  - an address where a contract lived, but was destroyed
               * ====
               */
              function isContract(address account) internal view returns (bool) {
                  // This method relies on extcodesize, which returns 0 for contracts in
                  // construction, since the code is only stored at the end of the
                  // constructor execution.
          
                  uint256 size;
                  assembly {
                      size := extcodesize(account)
                  }
                  return size > 0;
              }
          
              /**
               * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
               * `recipient`, forwarding all available gas and reverting on errors.
               *
               * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
               * of certain opcodes, possibly making contracts go over the 2300 gas limit
               * imposed by `transfer`, making them unable to receive funds via
               * `transfer`. {sendValue} removes this limitation.
               *
               * https://diligence.consensys.net/posts/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.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
               */
              function sendValue(address payable recipient, uint256 amount) internal {
                  require(address(this).balance >= amount, "Address: insufficient balance");
          
                  (bool success, ) = recipient.call{value: amount}("");
                  require(success, "Address: unable to send value, recipient may have reverted");
              }
          
              /**
               * @dev Performs a Solidity function call using a low level `call`. A
               * plain `call` is an unsafe replacement for a function call: use this
               * function instead.
               *
               * If `target` reverts with a revert reason, it is bubbled up by this
               * function (like regular Solidity function calls).
               *
               * Returns the raw returned data. To convert to the expected return value,
               * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
               *
               * Requirements:
               *
               * - `target` must be a contract.
               * - calling `target` with `data` must not revert.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionCall(target, data, "Address: low-level call failed");
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
               * `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, errorMessage);
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but also transferring `value` wei to `target`.
               *
               * Requirements:
               *
               * - the calling contract must have an ETH balance of at least `value`.
               * - the called Solidity function must be `payable`.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value
              ) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
              }
          
              /**
               * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
               * with `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  require(address(this).balance >= value, "Address: insufficient balance for call");
                  require(isContract(target), "Address: call to non-contract");
          
                  (bool success, bytes memory returndata) = target.call{value: value}(data);
                  return verifyCallResult(success, returndata, errorMessage);
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                  return functionStaticCall(target, data, "Address: low-level static call failed");
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal view returns (bytes memory) {
                  require(isContract(target), "Address: static call to non-contract");
          
                  (bool success, bytes memory returndata) = target.staticcall(data);
                  return verifyCallResult(success, returndata, errorMessage);
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionDelegateCall(target, data, "Address: low-level delegate call failed");
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  require(isContract(target), "Address: delegate call to non-contract");
          
                  (bool success, bytes memory returndata) = target.delegatecall(data);
                  return verifyCallResult(success, returndata, errorMessage);
              }
          
              /**
               * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
               * revert reason using the provided one.
               *
               * _Available since v4.3._
               */
              function verifyCallResult(
                  bool success,
                  bytes memory returndata,
                  string memory errorMessage
              ) internal pure returns (bytes memory) {
                  if (success) {
                      return returndata;
                  } else {
                      // 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
          
                          assembly {
                              let returndata_size := mload(returndata)
                              revert(add(32, returndata), returndata_size)
                          }
                      } else {
                          revert(errorMessage);
                      }
                  }
              }
          }
          
          // File: @openzeppelin/contracts/utils/StorageSlot.sol
          
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev Library for reading and writing primitive types to specific storage slots.
           *
           * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
           * This library helps with reading and writing to such slots without the need for inline assembly.
           *
           * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
           *
           * Example usage to set ERC1967 implementation slot:
           * ```
           * contract ERC1967 {
           *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
           *
           *     function _getImplementation() internal view returns (address) {
           *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
           *     }
           *
           *     function _setImplementation(address newImplementation) internal {
           *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
           *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
           *     }
           * }
           * ```
           *
           * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
           */
          library StorageSlot {
              struct AddressSlot {
                  address value;
              }
          
              struct BooleanSlot {
                  bool value;
              }
          
              struct Bytes32Slot {
                  bytes32 value;
              }
          
              struct Uint256Slot {
                  uint256 value;
              }
          
              /**
               * @dev Returns an `AddressSlot` with member `value` located at `slot`.
               */
              function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
               */
              function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
               */
              function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
               */
              function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                  assembly {
                      r.slot := slot
                  }
              }
          }
          
          // File: @openzeppelin/contracts/proxy/ERC1967/ERC1967Upgrade.sol
          
          
          pragma solidity ^0.8.2;
          
          
          
          /**
           * @dev This abstract contract provides getters and event emitting update functions for
           * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
           *
           * _Available since v4.1._
           *
           * @custom:oz-upgrades-unsafe-allow delegatecall
           */
          abstract contract ERC1967Upgrade {
              // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
              bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
          
              /**
               * @dev Storage slot with the address of the current implementation.
               * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
          
              /**
               * @dev Emitted when the implementation is upgraded.
               */
              event Upgraded(address indexed implementation);
          
              /**
               * @dev Returns the current implementation address.
               */
              function _getImplementation() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
              }
          
              /**
               * @dev Stores a new address in the EIP1967 implementation slot.
               */
              function _setImplementation(address newImplementation) private {
                  require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                  StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
              }
          
              /**
               * @dev Perform implementation upgrade
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeTo(address newImplementation) internal {
                  _setImplementation(newImplementation);
                  emit Upgraded(newImplementation);
              }
          
              /**
               * @dev Perform implementation upgrade with additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCall(
                  address newImplementation,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  _upgradeTo(newImplementation);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(newImplementation, data);
                  }
              }
          
              /**
               * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCallSecure(
                  address newImplementation,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  address oldImplementation = _getImplementation();
          
                  // Initial upgrade and setup call
                  _setImplementation(newImplementation);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(newImplementation, data);
                  }
          
                  // Perform rollback test if not already in progress
                  StorageSlot.BooleanSlot storage rollbackTesting = StorageSlot.getBooleanSlot(_ROLLBACK_SLOT);
                  if (!rollbackTesting.value) {
                      // Trigger rollback using upgradeTo from the new implementation
                      rollbackTesting.value = true;
                      Address.functionDelegateCall(
                          newImplementation,
                          abi.encodeWithSignature("upgradeTo(address)", oldImplementation)
                      );
                      rollbackTesting.value = false;
                      // Check rollback was effective
                      require(oldImplementation == _getImplementation(), "ERC1967Upgrade: upgrade breaks further upgrades");
                      // Finally reset to the new implementation and log the upgrade
                      _upgradeTo(newImplementation);
                  }
              }
          
              /**
               * @dev Storage slot with the admin of the contract.
               * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
          
              /**
               * @dev Emitted when the admin account has changed.
               */
              event AdminChanged(address previousAdmin, address newAdmin);
          
              /**
               * @dev Returns the current admin.
               */
              function _getAdmin() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
              }
          
              /**
               * @dev Stores a new address in the EIP1967 admin slot.
               */
              function _setAdmin(address newAdmin) private {
                  require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                  StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
              }
          
              /**
               * @dev Changes the admin of the proxy.
               *
               * Emits an {AdminChanged} event.
               */
              function _changeAdmin(address newAdmin) internal {
                  emit AdminChanged(_getAdmin(), newAdmin);
                  _setAdmin(newAdmin);
              }
          
              /**
               * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
               * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
               */
              bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
          
              /**
               * @dev Emitted when the beacon is upgraded.
               */
              event BeaconUpgraded(address indexed beacon);
          
              /**
               * @dev Returns the current beacon.
               */
              function _getBeacon() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
              }
          
              /**
               * @dev Stores a new beacon in the EIP1967 beacon slot.
               */
              function _setBeacon(address newBeacon) private {
                  require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract");
                  require(
                      Address.isContract(IBeacon(newBeacon).implementation()),
                      "ERC1967: beacon implementation is not a contract"
                  );
                  StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
              }
          
              /**
               * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
               * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
               *
               * Emits a {BeaconUpgraded} event.
               */
              function _upgradeBeaconToAndCall(
                  address newBeacon,
                  bytes memory data,
                  bool forceCall
              ) internal {
                  _setBeacon(newBeacon);
                  emit BeaconUpgraded(newBeacon);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                  }
              }
          }
          
          // File: @openzeppelin/contracts/proxy/beacon/BeaconProxy.sol
          
          
          pragma solidity ^0.8.0;
          
          
          
          /**
           * @dev This contract implements a proxy that gets the implementation address for each call from a {UpgradeableBeacon}.
           *
           * The beacon address is stored in storage slot `uint256(keccak256('eip1967.proxy.beacon')) - 1`, so that it doesn't
           * conflict with the storage layout of the implementation behind the proxy.
           *
           * _Available since v3.4._
           */
          contract BeaconProxy is Proxy, ERC1967Upgrade {
              /**
               * @dev Initializes the proxy with `beacon`.
               *
               * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon. This
               * will typically be an encoded function call, and allows initializating the storage of the proxy like a Solidity
               * constructor.
               *
               * Requirements:
               *
               * - `beacon` must be a contract with the interface {IBeacon}.
               */
              constructor(address beacon, bytes memory data) payable {
                  assert(_BEACON_SLOT == bytes32(uint256(keccak256("eip1967.proxy.beacon")) - 1));
                  _upgradeBeaconToAndCall(beacon, data, false);
              }
          
              /**
               * @dev Returns the current beacon address.
               */
              function _beacon() internal view virtual returns (address) {
                  return _getBeacon();
              }
          
              /**
               * @dev Returns the current implementation address of the associated beacon.
               */
              function _implementation() internal view virtual override returns (address) {
                  return IBeacon(_getBeacon()).implementation();
              }
          
              /**
               * @dev Changes the proxy to use a new beacon. Deprecated: see {_upgradeBeaconToAndCall}.
               *
               * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon.
               *
               * Requirements:
               *
               * - `beacon` must be a contract.
               * - The implementation returned by `beacon` must be a contract.
               */
              function _setBeacon(address beacon, bytes memory data) internal virtual {
                  _upgradeBeaconToAndCall(beacon, data, false);
              }
          }
          
          // File: @openzeppelin/contracts/utils/cryptography/ECDSA.sol
          
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
           *
           * These functions can be used to verify that a message was signed by the holder
           * of the private keys of a given address.
           */
          library ECDSA {
              enum RecoverError {
                  NoError,
                  InvalidSignature,
                  InvalidSignatureLength,
                  InvalidSignatureS,
                  InvalidSignatureV
              }
          
              function _throwError(RecoverError error) private pure {
                  if (error == RecoverError.NoError) {
                      return; // no error: do nothing
                  } else if (error == RecoverError.InvalidSignature) {
                      revert("ECDSA: invalid signature");
                  } else if (error == RecoverError.InvalidSignatureLength) {
                      revert("ECDSA: invalid signature length");
                  } else if (error == RecoverError.InvalidSignatureS) {
                      revert("ECDSA: invalid signature 's' value");
                  } else if (error == RecoverError.InvalidSignatureV) {
                      revert("ECDSA: invalid signature 'v' value");
                  }
              }
          
              /**
               * @dev Returns the address that signed a hashed message (`hash`) with
               * `signature` or error string. This address can then be used for verification purposes.
               *
               * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
               * this function rejects them by requiring the `s` value to be in the lower
               * half order, and the `v` value to be either 27 or 28.
               *
               * IMPORTANT: `hash` _must_ be the result of a hash operation for the
               * verification to be secure: it is possible to craft signatures that
               * recover to arbitrary addresses for non-hashed data. A safe way to ensure
               * this is by receiving a hash of the original message (which may otherwise
               * be too long), and then calling {toEthSignedMessageHash} on it.
               *
               * Documentation for signature generation:
               * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
               * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
               *
               * _Available since v4.3._
               */
              function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
                  // Check the signature length
                  // - case 65: r,s,v signature (standard)
                  // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._
                  if (signature.length == 65) {
                      bytes32 r;
                      bytes32 s;
                      uint8 v;
                      // ecrecover takes the signature parameters, and the only way to get them
                      // currently is to use assembly.
                      assembly {
                          r := mload(add(signature, 0x20))
                          s := mload(add(signature, 0x40))
                          v := byte(0, mload(add(signature, 0x60)))
                      }
                      return tryRecover(hash, v, r, s);
                  } else if (signature.length == 64) {
                      bytes32 r;
                      bytes32 vs;
                      // ecrecover takes the signature parameters, and the only way to get them
                      // currently is to use assembly.
                      assembly {
                          r := mload(add(signature, 0x20))
                          vs := mload(add(signature, 0x40))
                      }
                      return tryRecover(hash, r, vs);
                  } else {
                      return (address(0), RecoverError.InvalidSignatureLength);
                  }
              }
          
              /**
               * @dev Returns the address that signed a hashed message (`hash`) with
               * `signature`. This address can then be used for verification purposes.
               *
               * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
               * this function rejects them by requiring the `s` value to be in the lower
               * half order, and the `v` value to be either 27 or 28.
               *
               * IMPORTANT: `hash` _must_ be the result of a hash operation for the
               * verification to be secure: it is possible to craft signatures that
               * recover to arbitrary addresses for non-hashed data. A safe way to ensure
               * this is by receiving a hash of the original message (which may otherwise
               * be too long), and then calling {toEthSignedMessageHash} on it.
               */
              function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
                  (address recovered, RecoverError error) = tryRecover(hash, signature);
                  _throwError(error);
                  return recovered;
              }
          
              /**
               * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
               *
               * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
               *
               * _Available since v4.3._
               */
              function tryRecover(
                  bytes32 hash,
                  bytes32 r,
                  bytes32 vs
              ) internal pure returns (address, RecoverError) {
                  bytes32 s;
                  uint8 v;
                  assembly {
                      s := and(vs, 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff)
                      v := add(shr(255, vs), 27)
                  }
                  return tryRecover(hash, v, r, s);
              }
          
              /**
               * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
               *
               * _Available since v4.2._
               */
              function recover(
                  bytes32 hash,
                  bytes32 r,
                  bytes32 vs
              ) internal pure returns (address) {
                  (address recovered, RecoverError error) = tryRecover(hash, r, vs);
                  _throwError(error);
                  return recovered;
              }
          
              /**
               * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
               * `r` and `s` signature fields separately.
               *
               * _Available since v4.3._
               */
              function tryRecover(
                  bytes32 hash,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) internal pure returns (address, RecoverError) {
                  // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
                  // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
                  // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
                  // signatures from current libraries generate a unique signature with an s-value in the lower half order.
                  //
                  // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
                  // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
                  // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
                  // these malleable signatures as well.
                  if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
                      return (address(0), RecoverError.InvalidSignatureS);
                  }
                  if (v != 27 && v != 28) {
                      return (address(0), RecoverError.InvalidSignatureV);
                  }
          
                  // If the signature is valid (and not malleable), return the signer address
                  address signer = ecrecover(hash, v, r, s);
                  if (signer == address(0)) {
                      return (address(0), RecoverError.InvalidSignature);
                  }
          
                  return (signer, RecoverError.NoError);
              }
          
              /**
               * @dev Overload of {ECDSA-recover} that receives the `v`,
               * `r` and `s` signature fields separately.
               */
              function recover(
                  bytes32 hash,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) internal pure returns (address) {
                  (address recovered, RecoverError error) = tryRecover(hash, v, r, s);
                  _throwError(error);
                  return recovered;
              }
          
              /**
               * @dev Returns an Ethereum Signed Message, created from a `hash`. This
               * produces hash corresponding to the one signed with the
               * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
               * JSON-RPC method as part of EIP-191.
               *
               * See {recover}.
               */
              function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) {
                  // 32 is the length in bytes of hash,
                  // enforced by the type signature above
                  return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", hash));
              }
          
              /**
               * @dev Returns an Ethereum Signed Typed Data, created from a
               * `domainSeparator` and a `structHash`. This produces hash corresponding
               * to the one signed with the
               * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
               * JSON-RPC method as part of EIP-712.
               *
               * See {recover}.
               */
              function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) {
                  return keccak256(abi.encodePacked("\x19\x01", domainSeparator, structHash));
              }
          }
          
          // File: contracts/bridge/token/TokenImplementation.sol
          
          // contracts/TokenImplementation.sol
          
          pragma solidity ^0.8.0;
          
          
          
          
          
          // Based on the OpenZepplin ERC20 implementation, licensed under MIT
          contract TokenImplementation is TokenState, Context {
              event Transfer(address indexed from, address indexed to, uint256 value);
              event Approval(address indexed owner, address indexed spender, uint256 value);
          
              function initialize(
                  string memory name_,
                  string memory symbol_,
                  uint8 decimals_,
                  uint64 sequence_,
                  address owner_,
                  uint16 chainId_,
                  bytes32 nativeContract_
              ) initializer public {
                  _initializeNativeToken(
                      name_,
                      symbol_,
                      decimals_,
                      sequence_,
                      owner_,
                      chainId_,
                      nativeContract_
                  );
          
                  // initialize w/ EIP712 state variables for domain separator
                  _initializePermitStateIfNeeded();
              }
          
              function _initializeNativeToken(
                  string memory name_,
                  string memory symbol_,
                  uint8 decimals_,
                  uint64 sequence_,
                  address owner_,
                  uint16 chainId_,
                  bytes32 nativeContract_
              ) internal {
                  _state.name = name_;
                  _state.symbol = symbol_;
                  _state.decimals = decimals_;
                  _state.metaLastUpdatedSequence = sequence_;
          
                  _state.owner = owner_;
          
                  _state.chainId = chainId_;
                  _state.nativeContract = nativeContract_;
              }
          
              function _initializePermitStateIfNeeded() internal {
                  // If someone were to change the implementation of name(), we
                  // need to make sure we recache.
                  bytes32 hashedName = _eip712DomainNameHashed();
          
                  // If for some reason the salt generation changes with newer
                  // token implementations, we need to make sure the state reflects
                  // the new salt.
                  bytes32 salt = _eip712DomainSalt();
          
                  // check cached values
                  if (_state.cachedHashedName != hashedName || _state.cachedSalt != salt) {
                      _state.cachedChainId = block.chainid;
                      _state.cachedThis = address(this);
                      _state.cachedDomainSeparator = _buildDomainSeparator(hashedName, salt);
                      _state.cachedSalt = salt;
                      _state.cachedHashedName = hashedName;
                  }
              }
          
              function name() public view returns (string memory) {
                  return _state.name;
              }
          
              function symbol() public view returns (string memory) {
                  return _state.symbol;
              }
          
              function owner() public view returns (address) {
                  return _state.owner;
              }
          
              function decimals() public view returns (uint8) {
                  return _state.decimals;
              }
          
              function totalSupply() public view returns (uint256) {
                  return _state.totalSupply;
              }
          
              function chainId() public view returns (uint16) {
                  return _state.chainId;
              }
          
              function nativeContract() public view returns (bytes32) {
                  return _state.nativeContract;
              }
          
              function balanceOf(address account_) public view returns (uint256) {
                  return _state.balances[account_];
              }
          
              function transfer(address recipient_, uint256 amount_) public returns (bool) {
                  _transfer(_msgSender(), recipient_, amount_);
                  return true;
              }
          
              function allowance(address owner_, address spender_) public view returns (uint256) {
                  return _state.allowances[owner_][spender_];
              }
          
              function approve(address spender_, uint256 amount_) public returns (bool) {
                  _approve(_msgSender(), spender_, amount_);
                  return true;
              }
          
              function transferFrom(address sender_, address recipient_, uint256 amount_) public returns (bool) {
                  _transfer(sender_, recipient_, amount_);
          
                  uint256 currentAllowance = _state.allowances[sender_][_msgSender()];
                  require(currentAllowance >= amount_, "ERC20: transfer amount exceeds allowance");
                  _approve(sender_, _msgSender(), currentAllowance - amount_);
          
                  return true;
              }
          
              function increaseAllowance(address spender_, uint256 addedValue_) public returns (bool) {
                  _approve(_msgSender(), spender_, _state.allowances[_msgSender()][spender_] + addedValue_);
                  return true;
              }
          
              function decreaseAllowance(address spender_, uint256 subtractedValue_) public returns (bool) {
                  uint256 currentAllowance = _state.allowances[_msgSender()][spender_];
                  require(currentAllowance >= subtractedValue_, "ERC20: decreased allowance below zero");
                  _approve(_msgSender(), spender_, currentAllowance - subtractedValue_);
          
                  return true;
              }
          
              function _transfer(address sender_, address recipient_, uint256 amount_) internal {
                  require(sender_ != address(0), "ERC20: transfer from the zero address");
                  require(recipient_ != address(0), "ERC20: transfer to the zero address");
          
                  uint256 senderBalance = _state.balances[sender_];
                  require(senderBalance >= amount_, "ERC20: transfer amount exceeds balance");
                  _state.balances[sender_] = senderBalance - amount_;
                  _state.balances[recipient_] += amount_;
          
                  emit Transfer(sender_, recipient_, amount_);
              }
          
              function mint(address account_, uint256 amount_) public onlyOwner {
                  _mint(account_, amount_);
              }
          
              function _mint(address account_, uint256 amount_) internal {
                  require(account_ != address(0), "ERC20: mint to the zero address");
          
                  _state.totalSupply += amount_;
                  _state.balances[account_] += amount_;
                  emit Transfer(address(0), account_, amount_);
              }
          
              function burn(address account_, uint256 amount_) public onlyOwner {
                  _burn(account_, amount_);
              }
          
              function _burn(address account_, uint256 amount_) internal {
                  require(account_ != address(0), "ERC20: burn from the zero address");
          
                  uint256 accountBalance = _state.balances[account_];
                  require(accountBalance >= amount_, "ERC20: burn amount exceeds balance");
                  _state.balances[account_] = accountBalance - amount_;
                  _state.totalSupply -= amount_;
          
                  emit Transfer(account_, address(0), amount_);
              }
          
              function _approve(address owner_, address spender_, uint256 amount_) internal virtual {
                  require(owner_ != address(0), "ERC20: approve from the zero address");
                  require(spender_ != address(0), "ERC20: approve to the zero address");
          
                  _state.allowances[owner_][spender_] = amount_;
                  emit Approval(owner_, spender_, amount_);
              }
          
              function updateDetails(string memory name_, string memory symbol_, uint64 sequence_) public onlyOwner {
                  require(_state.metaLastUpdatedSequence < sequence_, "current metadata is up to date");
          
                  _state.name = name_;
                  _state.symbol = symbol_;
                  _state.metaLastUpdatedSequence = sequence_;
          
                  // Because the name is updated, we need to recache the domain separator.
                  // For old implementations, none of the caches may have been written to yet.
                  _initializePermitStateIfNeeded();
              }
          
              modifier onlyOwner() {
                  require(owner() == _msgSender(), "caller is not the owner");
                  _;
              }
          
              modifier initializer() {
                  require(
                      !_state.initialized,
                      "Already initialized"
                  );
          
                  _state.initialized = true;
          
                  _;
              }
          
              /**
               * @dev Returns the domain separator for the current chain.
               */
              function _domainSeparatorV4() internal view returns (bytes32) {
                  if (address(this) == _state.cachedThis && block.chainid == _state.cachedChainId) {
                      return _state.cachedDomainSeparator;
                  } else {
                      return _buildDomainSeparator(
                          _eip712DomainNameHashed(), _eip712DomainSalt()
                      );
                  }
              }
          
              function _buildDomainSeparator(bytes32 hashedName, bytes32 salt) internal view returns (bytes32) {
                  return keccak256(
                      abi.encode(
                          keccak256(
                              "EIP712Domain(string name,string version,uint256 chainId,address verifyingContract,bytes32 salt)"
                          ),
                          hashedName,
                          keccak256(abi.encodePacked(_eip712DomainVersion())),
                          block.chainid,
                          address(this),
                          salt
                      )
                  );
              }
          
              /**
               * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this
               * function returns the hash of the fully encoded EIP712 message for this domain.
               *
               * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:
               *
               * ```solidity
               * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(
               *     keccak256("Mail(address to,string contents)"),
               *     mailTo,
               *     keccak256(bytes(mailContents))
               * )));
               * address signer = ECDSA.recover(digest, signature);
               * ```
               */
              function _hashTypedDataV4(bytes32 structHash) internal view returns (bytes32) {
                  return ECDSA.toTypedDataHash(_domainSeparatorV4(), structHash);
              }
          
              /**
               * @dev See {IERC20Permit-permit}.
               */
              function permit(
                  address owner_,
                  address spender_,
                  uint256 value_,
                  uint256 deadline_,
                  uint8 v_,
                  bytes32 r_,
                  bytes32 s_
              ) public {
                  // for those tokens that have been initialized before permit, we need to set
                  // the permit state variables if they have not been set before
                  _initializePermitStateIfNeeded();
          
                  // permit is only allowed before the signature's deadline
                  require(block.timestamp <= deadline_, "ERC20Permit: expired deadline");
          
                  bytes32 structHash = keccak256(
                      abi.encode(
                          keccak256(
                              "Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)"
                          ),
                          owner_,
                          spender_,
                          value_,
                          _useNonce(owner_),
                          deadline_
                      )
                  );
          
                  bytes32 message = _hashTypedDataV4(structHash);
                  address signer = ECDSA.recover(message, v_, r_, s_);
          
                  // if we cannot recover the token owner, signature is invalid
                  require(signer == owner_, "ERC20Permit: invalid signature");
          
                  _approve(owner_, spender_, value_);
              }
          
              /**
               * @dev See {IERC20Permit-DOMAIN_SEPARATOR}.
               */
              // solhint-disable-next-line func-name-mixedcase
              function DOMAIN_SEPARATOR() public view returns (bytes32) {
                  return _domainSeparatorV4();
              }
          
              function eip712Domain() public view returns (
                  bytes1 domainFields,
                  string memory domainName,
                  string memory domainVersion,
                  uint256 domainChainId,
                  address domainVerifyingContract,
                  bytes32 domainSalt,
                  uint256[] memory domainExtensions
              ) {
                  return (
                      hex"1F", // 11111
                      name(),
                      _eip712DomainVersion(),
                      block.chainid,
                      address(this),
                      _eip712DomainSalt(),
                      new uint256[](0)
                  );
              }
          
              function _eip712DomainVersion() internal pure returns (string memory) {
                  return "1";
              }
          
              function _eip712DomainNameHashed() internal view returns (bytes32) {
                  return keccak256(abi.encodePacked(name()));
              }
          
              function _eip712DomainSalt() internal view returns (bytes32) {
                  return keccak256(abi.encodePacked(_state.chainId, _state.nativeContract));
              }
          }