ETH Price: $3,876.54 (-11.57%)

Transaction Decoder

Block:
23547693 at Oct-10-2025 01:40:35 PM +UTC
Transaction Fee:
0.00014744137735683 ETH $0.57
Gas Used:
244,786 Gas / 0.602327655 Gwei

Emitted Events:

682 TetherToken.Transfer( from=[Sender] 0xb4caaff781251594911cc76aec61cef46ba00894, to=[Receiver] OriginalTokenBridge, value=20000000 )
683 OptimizedTransparentUpgradeableProxy.0xdf21c415b78ed2552cc9971249e32a053abce6087a0ae0fbf3f78db5174a3493( 0xdf21c415b78ed2552cc9971249e32a053abce6087a0ae0fbf3f78db5174a3493, 0000000000000000000000000000000000000000000000000000cbfcb5f9480f )
684 UltraLightNodeV2.RelayerParams( adapterParams=0x000200000000000000000000000000000000000000000000000000000000000186A0000000000000000000000000000000000000000000000000016345785D8A0000B4CAAFF781251594911CC76AEC61CEF46BA00894, outboundProofType=2 )
685 DVN.VerifierFeePaid( fee=15971398737 )
686 UltraLightNodeV2.Packet( payload=0x000000000000193600651F8E735F424B7A49A885571A2FA104E8C13C26C701241F8E735F424B7A49A885571A2FA104E8C13C26C70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000DAC17F958D2EE523A2206206994597C13D831EC7000000000000000000000000B4CAAFF781251594911CC76AEC61CEF46BA008940000000000000000000000000000000000000000000000000000000001312D00 )
687 OriginalTokenBridge.SendToken( token=TetherToken, from=[Sender] 0xb4caaff781251594911cc76aec61cef46ba00894, to=[Sender] 0xb4caaff781251594911cc76aec61cef46ba00894, amount=20000000 )

Account State Difference:

  Address   Before After State Difference Code
0x1f8E735f...8C13C26c7
0x4D73AdB7...401A178E2
(Layer Zero: Ultra Light Node v2)
2.091008493196273433 Eth2.091232795412882297 Eth0.000224302216608864
0x5B905fE0...FAbf76068
(LayerZero: Nonce)
0x66A71Dce...C225Cd675
(LayerZero: Ethereum Endpoint)
0xb4Caaff7...46BA00894
0.241574326206277327 Eth
Nonce: 541
0.241202582612311633 Eth
Nonce: 542
0.000371743593965694
0xdAC17F95...13D831ec7
(BuilderNet)
121.820596854402608573 Eth121.820596854474330871 Eth0.000000000071722298

Execution Trace

ETH 0.000224302216608864 OriginalTokenBridge.bridge( token=0xdAC17F958D2ee523a2206206994597C13D831ec7, amountLD=20000000, to=0xb4Caaff781251594911cc76aeC61cef46BA00894, callParams=[{name:refundAddress, type:address, order:1, indexed:false, value:0xb4Caaff781251594911cc76aeC61cef46BA00894, valueString:0xb4Caaff781251594911cc76aeC61cef46BA00894}, {name:zroPaymentAddress, type:address, order:2, indexed:false, value:0x0000000000000000000000000000000000000000, valueString:0x0000000000000000000000000000000000000000}], adapterParams=0x000200000000000000000000000000000000000000000000000000000000000186A0000000000000000000000000000000000000000000000000016345785D8A0000B4CAAFF781251594911CC76AEC61CEF46BA00894 )
  • TetherToken.balanceOf( who=0x1f8E735f424B7A49A885571A2fA104E8C13C26c7 ) => ( 912802672071 )
  • TetherToken.transferFrom( _from=0xb4Caaff781251594911cc76aeC61cef46BA00894, _to=0x1f8E735f424B7A49A885571A2fA104E8C13C26c7, _value=20000000 )
  • TetherToken.balanceOf( who=0x1f8E735f424B7A49A885571A2fA104E8C13C26c7 ) => ( 912822672071 )
  • ETH 0.000224302216608864 Endpoint.send( _dstChainId=292, _destination=0x1F8E735F424B7A49A885571A2FA104E8C13C26C71F8E735F424B7A49A885571A2FA104E8C13C26C7, _payload=0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000DAC17F958D2EE523A2206206994597C13D831EC7000000000000000000000000B4CAAFF781251594911CC76AEC61CEF46BA008940000000000000000000000000000000000000000000000000000000001312D00, _refundAddress=0xb4Caaff781251594911cc76aeC61cef46BA00894, _zroPaymentAddress=0x0000000000000000000000000000000000000000, _adapterParams=0x000200000000000000000000000000000000000000000000000000000000000186A0000000000000000000000000000000000000000000000000016345785D8A0000B4CAAFF781251594911CC76AEC61CEF46BA00894 )
    • ETH 0.000224302216608864 UltraLightNodeV2.send( _ua=0x1f8E735f424B7A49A885571A2fA104E8C13C26c7, 6454, _dstChainId=292, _path=0x1F8E735F424B7A49A885571A2FA104E8C13C26C71F8E735F424B7A49A885571A2FA104E8C13C26C7, _payload=0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000DAC17F958D2EE523A2206206994597C13D831EC7000000000000000000000000B4CAAFF781251594911CC76AEC61CEF46BA008940000000000000000000000000000000000000000000000000000000001312D00, _refundAddress=0xb4Caaff781251594911cc76aeC61cef46BA00894, _zroPaymentAddress=0x0000000000000000000000000000000000000000, _adapterParams=0x000200000000000000000000000000000000000000000000000000000000000186A0000000000000000000000000000000000000000000000000016345785D8A0000B4CAAFF781251594911CC76AEC61CEF46BA00894 )
      • NonceContract.increment( _chainId=292, _ua=0x1f8E735f424B7A49A885571A2fA104E8C13C26c7, _path=0x1F8E735F424B7A49A885571A2FA104E8C13C26C71F8E735F424B7A49A885571A2FA104E8C13C26C7 ) => ( 6454 )
        • Endpoint.getSendLibraryAddress( _userApplication=0x1f8E735f424B7A49A885571A2fA104E8C13C26c7 ) => ( sendLibraryAddress=0x4D73AdB72bC3DD368966edD0f0b2148401A178E2 )
        • OptimizedTransparentUpgradeableProxy.5886ea65( )
          • 0xb830a5afcbebb936c30c607a18bbba9f5b0a592f.5886ea65( )
            • OptimizedTransparentUpgradeableProxy.88a4124c( )
              • 0x319ae539b5ba554b09a46791cdb88b10e4d8f627.88a4124c( )
              • DVN.assignJob( _dstEid=292, 2, _confirmations=15, _sender=0x1f8E735f424B7A49A885571A2fA104E8C13C26c7 ) => ( totalFee=15971398737 )
                • 0xb2a059250a136bb01ecc49731167a2dc965d6cb8.df2b057e( )
                  • OptimizedTransparentUpgradeableProxy.88a4124c( )
                    • 0x319ae539b5ba554b09a46791cdb88b10e4d8f627.88a4124c( )
                    • TreasuryV2.getFees( payInZro=False, relayerFee=224286245210127, oracleFee=15971398737 ) => ( 0 )
                      File 1 of 9: OriginalTokenBridge
                      // SPDX-License-Identifier: MIT
                      pragma solidity ^0.8.17;
                      import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
                      import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
                      import {LzLib} from "@layerzerolabs/solidity-examples/contracts/libraries/LzLib.sol";
                      import {TokenBridgeBase} from "./TokenBridgeBase.sol";
                      import {IWETH} from "./interfaces/IWETH.sol";
                      /// @dev Locks an ERC20 on the source chain and sends LZ message to the remote chain to mint a wrapped token
                      contract OriginalTokenBridge is TokenBridgeBase {
                          using SafeERC20 for IERC20;
                          /// @notice Tokens that can be bridged to the remote chain
                          mapping(address => bool) public supportedTokens;
                          /// @notice Token conversion rates from local decimals (LD) to shared decimals (SD).
                          /// E.g., if local decimals is 18 and shared decimals is 6, the conversion rate is 10^12
                          mapping(address => uint) public LDtoSDConversionRate;
                          /// @notice Total value locked per each supported token in shared decimals
                          mapping(address => uint) public totalValueLockedSD;
                          /// @notice LayerZero id of the remote chain where wrapped tokens are minted
                          uint16 public remoteChainId;
                          /// @notice Address of the wrapped native gas token (e.g. WETH, WBNB, WMATIC)
                          address public immutable weth;
                          event SendToken(address token, address from, address to, uint amount);
                          event ReceiveToken(address token, address to, uint amount);
                          event SetRemoteChainId(uint16 remoteChainId);
                          event RegisterToken(address token);
                          event WithdrawFee(address indexed token, address to, uint amount);
                          constructor(address _endpoint, uint16 _remoteChainId, address _weth) TokenBridgeBase(_endpoint) {
                              require(_weth != address(0), "OriginalTokenBridge: invalid WETH address");
                              remoteChainId = _remoteChainId;
                              weth = _weth;
                          }
                          /// @notice Registers a token for bridging
                          /// @param token address of the token
                          /// @param sharedDecimals number of decimals used for all original tokens mapped to the same wrapped token.
                          /// E.g., 6 is shared decimals for USDC on Ethereum, BSC and Polygon
                          function registerToken(address token, uint8 sharedDecimals) external onlyOwner {
                              require(token != address(0), "OriginalTokenBridge: invalid token address");
                              require(!supportedTokens[token], "OriginalTokenBridge: token already registered");
                              uint8 localDecimals = _getTokenDecimals(token);
                              require(localDecimals >= sharedDecimals, "OriginalTokenBridge: shared decimals must be less than or equal to local decimals");
                              supportedTokens[token] = true;
                              LDtoSDConversionRate[token] = 10**(localDecimals - sharedDecimals);
                              emit RegisterToken(token);
                          }
                          function setRemoteChainId(uint16 _remoteChainId) external onlyOwner {
                              remoteChainId = _remoteChainId;
                              emit SetRemoteChainId(_remoteChainId);
                          }
                          function accruedFeeLD(address token) public view returns (uint) {
                              return IERC20(token).balanceOf(address(this)) - _amountSDtoLD(token, totalValueLockedSD[token]);
                          }
                          function estimateBridgeFee(bool useZro, bytes calldata adapterParams) public view returns (uint nativeFee, uint zroFee) {
                              // Only the payload format matters when estimating fee, not the actual data
                              bytes memory payload = abi.encode(PT_MINT, address(this), address(this), 0);
                              return lzEndpoint.estimateFees(remoteChainId, address(this), payload, useZro, adapterParams);
                          }
                          /// @notice Bridges ERC20 to the remote chain
                          /// @dev Locks an ERC20 on the source chain and sends LZ message to the remote chain to mint a wrapped token
                          function bridge(address token, uint amountLD, address to, LzLib.CallParams calldata callParams, bytes memory adapterParams) external payable nonReentrant {
                              require(supportedTokens[token], "OriginalTokenBridge: token is not supported");
                         
                              // Supports tokens with transfer fee
                              uint balanceBefore = IERC20(token).balanceOf(address(this));
                              IERC20(token).safeTransferFrom(msg.sender, address(this), amountLD);
                              uint balanceAfter = IERC20(token).balanceOf(address(this));
                              (uint amountWithoutDustLD, uint dust) = _removeDust(token, balanceAfter - balanceBefore);
                              // return dust to the sender
                              if (dust > 0) {
                                  IERC20(token).safeTransfer(msg.sender, dust);
                              }
                              _bridge(token, amountWithoutDustLD, to, msg.value, callParams, adapterParams);
                          }
                          /// @notice Bridges native gas token (e.g. ETH) to the remote chain
                          /// @dev Locks WETH on the source chain and sends LZ message to the remote chain to mint a wrapped token
                          function bridgeNative(uint amountLD, address to, LzLib.CallParams calldata callParams, bytes memory adapterParams) external payable nonReentrant {
                              require(supportedTokens[weth], "OriginalTokenBridge: token is not supported");
                              require(msg.value >= amountLD, "OriginalTokenBridge: not enough value sent");
                              (uint amountWithoutDustLD, ) = _removeDust(weth, amountLD);
                              IWETH(weth).deposit{value: amountWithoutDustLD}();
                              _bridge(weth, amountWithoutDustLD, to, msg.value - amountWithoutDustLD, callParams, adapterParams);
                          }
                          function _bridge(address token, uint amountLD, address to, uint nativeFee, LzLib.CallParams calldata callParams, bytes memory adapterParams) private {
                              require(to != address(0), "OriginalTokenBridge: invalid to");
                              _checkAdapterParams(remoteChainId, PT_MINT, adapterParams);
                              uint amountSD = _amountLDtoSD(token, amountLD);
                              require(amountSD > 0, "OriginalTokenBridge: invalid amount");
                              totalValueLockedSD[token] += amountSD;
                              bytes memory payload = abi.encode(PT_MINT, token, to, amountSD);
                              _lzSend(remoteChainId, payload, callParams.refundAddress, callParams.zroPaymentAddress, adapterParams, nativeFee);
                              emit SendToken(token, msg.sender, to, amountLD);
                          }
                          function withdrawFee(address token, address to, uint amountLD) public onlyOwner {
                              uint feeLD = accruedFeeLD(token);
                              require(amountLD <= feeLD, "OriginalTokenBridge: not enough fees collected");
                              IERC20(token).safeTransfer(to, amountLD);
                              emit WithdrawFee(token, to, amountLD);
                          }
                          /// @notice Receives ERC20 tokens or ETH from the remote chain
                          /// @dev Unlocks locked ERC20 tokens or ETH in response to LZ message from the remote chain
                          function _nonblockingLzReceive(uint16 srcChainId, bytes memory, uint64, bytes memory payload) internal virtual override {
                              require(srcChainId == remoteChainId, "OriginalTokenBridge: invalid source chain id");
                              (uint8 packetType, address token, address to, uint withdrawalAmountSD, uint totalAmountSD, bool unwrapWeth) = abi.decode(payload, (uint8, address, address, uint, uint, bool));
                              require(packetType == PT_UNLOCK, "OriginalTokenBridge: unknown packet type");
                              require(supportedTokens[token], "OriginalTokenBridge: token is not supported");
                              totalValueLockedSD[token] -= totalAmountSD;
                              uint withdrawalAmountLD = _amountSDtoLD(token, withdrawalAmountSD);
                              if (token == weth && unwrapWeth) {
                                  IWETH(weth).withdraw(withdrawalAmountLD);
                                  (bool success, ) = payable(to).call{value: withdrawalAmountLD}("");
                                  require(success, "OriginalTokenBridge: failed to send");
                                  emit ReceiveToken(address(0), to, withdrawalAmountLD);
                              } else {
                                  IERC20(token).safeTransfer(to, withdrawalAmountLD);
                                  emit ReceiveToken(token, to, withdrawalAmountLD);
                              }
                          }
                          function _getTokenDecimals(address token) internal view returns (uint8) {
                              (bool success, bytes memory data) = token.staticcall(abi.encodeWithSignature("decimals()"));
                              require(success, "OriginalTokenBridge: failed to get token decimals");
                              return abi.decode(data, (uint8));
                          }
                          function _amountSDtoLD(address token, uint amountSD) internal view returns (uint) {
                              return amountSD * LDtoSDConversionRate[token];
                          }
                          function _amountLDtoSD(address token, uint amountLD) internal view returns (uint) {
                              return amountLD / LDtoSDConversionRate[token];
                          }
                          function _removeDust(address token, uint amountLD) internal view returns (uint amountWithoutDustLD, uint dust) {
                              dust = amountLD % LDtoSDConversionRate[token];
                              amountWithoutDustLD = amountLD - dust;
                          }
                          /// @dev Allows receiving ETH when calling WETH.withdraw()
                          receive() external payable {}
                      }// SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol)
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Provides information about the current execution context, including the
                       * sender of the transaction and its data. While these are generally available
                       * via msg.sender and msg.data, they should not be accessed in such a direct
                       * manner, since when dealing with meta-transactions the account sending and
                       * paying for execution may not be the actual sender (as far as an application
                       * is concerned).
                       *
                       * This contract is only required for intermediate, library-like contracts.
                       */
                      abstract contract Context {
                          function _msgSender() internal view virtual returns (address) {
                              return msg.sender;
                          }
                          function _msgData() internal view virtual returns (bytes calldata) {
                              return msg.data;
                          }
                          function _contextSuffixLength() internal view virtual returns (uint256) {
                              return 0;
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)
                      pragma solidity ^0.8.0;
                      import "../utils/Context.sol";
                      /**
                       * @dev Contract module which provides a basic access control mechanism, where
                       * there is an account (an owner) that can be granted exclusive access to
                       * specific functions.
                       *
                       * By default, the owner account will be the one that deploys the contract. This
                       * can later be changed with {transferOwnership}.
                       *
                       * This module is used through inheritance. It will make available the modifier
                       * `onlyOwner`, which can be applied to your functions to restrict their use to
                       * the owner.
                       */
                      abstract contract Ownable is Context {
                          address private _owner;
                          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                          /**
                           * @dev Initializes the contract setting the deployer as the initial owner.
                           */
                          constructor() {
                              _transferOwnership(_msgSender());
                          }
                          /**
                           * @dev Throws if called by any account other than the owner.
                           */
                          modifier onlyOwner() {
                              _checkOwner();
                              _;
                          }
                          /**
                           * @dev Returns the address of the current owner.
                           */
                          function owner() public view virtual returns (address) {
                              return _owner;
                          }
                          /**
                           * @dev Throws if the sender is not the owner.
                           */
                          function _checkOwner() internal view virtual {
                              require(owner() == _msgSender(), "Ownable: caller is not the owner");
                          }
                          /**
                           * @dev Leaves the contract without owner. It will not be possible to call
                           * `onlyOwner` functions. Can only be called by the current owner.
                           *
                           * NOTE: Renouncing ownership will leave the contract without an owner,
                           * thereby disabling any functionality that is only available to the owner.
                           */
                          function renounceOwnership() public virtual onlyOwner {
                              _transferOwnership(address(0));
                          }
                          /**
                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                           * Can only be called by the current owner.
                           */
                          function transferOwnership(address newOwner) public virtual onlyOwner {
                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                              _transferOwnership(newOwner);
                          }
                          /**
                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                           * Internal function without access restriction.
                           */
                          function _transferOwnership(address newOwner) internal virtual {
                              address oldOwner = _owner;
                              _owner = newOwner;
                              emit OwnershipTransferred(oldOwner, newOwner);
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.5.0;
                      interface ILayerZeroReceiver {
                          // @notice LayerZero endpoint will invoke this function to deliver the message on the destination
                          // @param _srcChainId - the source endpoint identifier
                          // @param _srcAddress - the source sending contract address from the source chain
                          // @param _nonce - the ordered message nonce
                          // @param _payload - the signed payload is the UA bytes has encoded to be sent
                          function lzReceive(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes calldata _payload) external;
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.5.0;
                      interface ILayerZeroUserApplicationConfig {
                          // @notice set the configuration of the LayerZero messaging library of the specified version
                          // @param _version - messaging library version
                          // @param _chainId - the chainId for the pending config change
                          // @param _configType - type of configuration. every messaging library has its own convention.
                          // @param _config - configuration in the bytes. can encode arbitrary content.
                          function setConfig(uint16 _version, uint16 _chainId, uint _configType, bytes calldata _config) external;
                          // @notice set the send() LayerZero messaging library version to _version
                          // @param _version - new messaging library version
                          function setSendVersion(uint16 _version) external;
                          // @notice set the lzReceive() LayerZero messaging library version to _version
                          // @param _version - new messaging library version
                          function setReceiveVersion(uint16 _version) external;
                          // @notice Only when the UA needs to resume the message flow in blocking mode and clear the stored payload
                          // @param _srcChainId - the chainId of the source chain
                          // @param _srcAddress - the contract address of the source contract at the source chain
                          function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external;
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.5.0;
                      import "./ILayerZeroUserApplicationConfig.sol";
                      interface ILayerZeroEndpoint is ILayerZeroUserApplicationConfig {
                          // @notice send a LayerZero message to the specified address at a LayerZero endpoint.
                          // @param _dstChainId - the destination chain identifier
                          // @param _destination - the address on destination chain (in bytes). address length/format may vary by chains
                          // @param _payload - a custom bytes payload to send to the destination contract
                          // @param _refundAddress - if the source transaction is cheaper than the amount of value passed, refund the additional amount to this address
                          // @param _zroPaymentAddress - the address of the ZRO token holder who would pay for the transaction
                          // @param _adapterParams - parameters for custom functionality. e.g. receive airdropped native gas from the relayer on destination
                          function send(uint16 _dstChainId, bytes calldata _destination, bytes calldata _payload, address payable _refundAddress, address _zroPaymentAddress, bytes calldata _adapterParams) external payable;
                          // @notice used by the messaging library to publish verified payload
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source contract (as bytes) at the source chain
                          // @param _dstAddress - the address on destination chain
                          // @param _nonce - the unbound message ordering nonce
                          // @param _gasLimit - the gas limit for external contract execution
                          // @param _payload - verified payload to send to the destination contract
                          function receivePayload(uint16 _srcChainId, bytes calldata _srcAddress, address _dstAddress, uint64 _nonce, uint _gasLimit, bytes calldata _payload) external;
                          // @notice get the inboundNonce of a lzApp from a source chain which could be EVM or non-EVM chain
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source chain contract address
                          function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint64);
                          // @notice get the outboundNonce from this source chain which, consequently, is always an EVM
                          // @param _srcAddress - the source chain contract address
                          function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view returns (uint64);
                          // @notice gets a quote in source native gas, for the amount that send() requires to pay for message delivery
                          // @param _dstChainId - the destination chain identifier
                          // @param _userApplication - the user app address on this EVM chain
                          // @param _payload - the custom message to send over LayerZero
                          // @param _payInZRO - if false, user app pays the protocol fee in native token
                          // @param _adapterParam - parameters for the adapter service, e.g. send some dust native token to dstChain
                          function estimateFees(uint16 _dstChainId, address _userApplication, bytes calldata _payload, bool _payInZRO, bytes calldata _adapterParam) external view returns (uint nativeFee, uint zroFee);
                          // @notice get this Endpoint's immutable source identifier
                          function getChainId() external view returns (uint16);
                          // @notice the interface to retry failed message on this Endpoint destination
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source chain contract address
                          // @param _payload - the payload to be retried
                          function retryPayload(uint16 _srcChainId, bytes calldata _srcAddress, bytes calldata _payload) external;
                          // @notice query if any STORED payload (message blocking) at the endpoint.
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source chain contract address
                          function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool);
                          // @notice query if the _libraryAddress is valid for sending msgs.
                          // @param _userApplication - the user app address on this EVM chain
                          function getSendLibraryAddress(address _userApplication) external view returns (address);
                          // @notice query if the _libraryAddress is valid for receiving msgs.
                          // @param _userApplication - the user app address on this EVM chain
                          function getReceiveLibraryAddress(address _userApplication) external view returns (address);
                          // @notice query if the non-reentrancy guard for send() is on
                          // @return true if the guard is on. false otherwise
                          function isSendingPayload() external view returns (bool);
                          // @notice query if the non-reentrancy guard for receive() is on
                          // @return true if the guard is on. false otherwise
                          function isReceivingPayload() external view returns (bool);
                          // @notice get the configuration of the LayerZero messaging library of the specified version
                          // @param _version - messaging library version
                          // @param _chainId - the chainId for the pending config change
                          // @param _userApplication - the contract address of the user application
                          // @param _configType - type of configuration. every messaging library has its own convention.
                          function getConfig(uint16 _version, uint16 _chainId, address _userApplication, uint _configType) external view returns (bytes memory);
                          // @notice get the send() LayerZero messaging library version
                          // @param _userApplication - the contract address of the user application
                          function getSendVersion(address _userApplication) external view returns (uint16);
                          // @notice get the lzReceive() LayerZero messaging library version
                          // @param _userApplication - the contract address of the user application
                          function getReceiveVersion(address _userApplication) external view returns (uint16);
                      }
                      // 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;
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity ^0.8.0;
                      import "@openzeppelin/contracts/access/Ownable.sol";
                      import "../interfaces/ILayerZeroReceiver.sol";
                      import "../interfaces/ILayerZeroUserApplicationConfig.sol";
                      import "../interfaces/ILayerZeroEndpoint.sol";
                      import "../util/BytesLib.sol";
                      /*
                       * a generic LzReceiver implementation
                       */
                      abstract contract LzApp is Ownable, ILayerZeroReceiver, ILayerZeroUserApplicationConfig {
                          using BytesLib for bytes;
                          ILayerZeroEndpoint public immutable lzEndpoint;
                          mapping(uint16 => bytes) public trustedRemoteLookup;
                          mapping(uint16 => mapping(uint16 => uint)) public minDstGasLookup;
                          address public precrime;
                          event SetPrecrime(address precrime);
                          event SetTrustedRemote(uint16 _remoteChainId, bytes _path);
                          event SetTrustedRemoteAddress(uint16 _remoteChainId, bytes _remoteAddress);
                          event SetMinDstGas(uint16 _dstChainId, uint16 _type, uint _minDstGas);
                          constructor(address _endpoint) {
                              lzEndpoint = ILayerZeroEndpoint(_endpoint);
                          }
                          function lzReceive(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes calldata _payload) public virtual override {
                              // lzReceive must be called by the endpoint for security
                              require(_msgSender() == address(lzEndpoint), "LzApp: invalid endpoint caller");
                              bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];
                              // if will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.
                              require(_srcAddress.length == trustedRemote.length && trustedRemote.length > 0 && keccak256(_srcAddress) == keccak256(trustedRemote), "LzApp: invalid source sending contract");
                              _blockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);
                          }
                          // abstract function - the default behaviour of LayerZero is blocking. See: NonblockingLzApp if you dont need to enforce ordered messaging
                          function _blockingLzReceive(uint16 _srcChainId, bytes memory _srcAddress, uint64 _nonce, bytes memory _payload) internal virtual;
                          function _lzSend(uint16 _dstChainId, bytes memory _payload, address payable _refundAddress, address _zroPaymentAddress, bytes memory _adapterParams, uint _nativeFee) internal virtual {
                              bytes memory trustedRemote = trustedRemoteLookup[_dstChainId];
                              require(trustedRemote.length != 0, "LzApp: destination chain is not a trusted source");
                              lzEndpoint.send{value: _nativeFee}(_dstChainId, trustedRemote, _payload, _refundAddress, _zroPaymentAddress, _adapterParams);
                          }
                          function _checkGasLimit(uint16 _dstChainId, uint16 _type, bytes memory _adapterParams, uint _extraGas) internal view virtual {
                              uint providedGasLimit = _getGasLimit(_adapterParams);
                              uint minGasLimit = minDstGasLookup[_dstChainId][_type] + _extraGas;
                              require(minGasLimit > 0, "LzApp: minGasLimit not set");
                              require(providedGasLimit >= minGasLimit, "LzApp: gas limit is too low");
                          }
                          function _getGasLimit(bytes memory _adapterParams) internal pure virtual returns (uint gasLimit) {
                              require(_adapterParams.length >= 34, "LzApp: invalid adapterParams");
                              assembly {
                                  gasLimit := mload(add(_adapterParams, 34))
                              }
                          }
                          //---------------------------UserApplication config----------------------------------------
                          function getConfig(uint16 _version, uint16 _chainId, address, uint _configType) external view returns (bytes memory) {
                              return lzEndpoint.getConfig(_version, _chainId, address(this), _configType);
                          }
                          // generic config for LayerZero user Application
                          function setConfig(uint16 _version, uint16 _chainId, uint _configType, bytes calldata _config) external override onlyOwner {
                              lzEndpoint.setConfig(_version, _chainId, _configType, _config);
                          }
                          function setSendVersion(uint16 _version) external override onlyOwner {
                              lzEndpoint.setSendVersion(_version);
                          }
                          function setReceiveVersion(uint16 _version) external override onlyOwner {
                              lzEndpoint.setReceiveVersion(_version);
                          }
                          function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external override onlyOwner {
                              lzEndpoint.forceResumeReceive(_srcChainId, _srcAddress);
                          }
                          // _path = abi.encodePacked(remoteAddress, localAddress)
                          // this function set the trusted path for the cross-chain communication
                          function setTrustedRemote(uint16 _srcChainId, bytes calldata _path) external onlyOwner {
                              trustedRemoteLookup[_srcChainId] = _path;
                              emit SetTrustedRemote(_srcChainId, _path);
                          }
                          function setTrustedRemoteAddress(uint16 _remoteChainId, bytes calldata _remoteAddress) external onlyOwner {
                              trustedRemoteLookup[_remoteChainId] = abi.encodePacked(_remoteAddress, address(this));
                              emit SetTrustedRemoteAddress(_remoteChainId, _remoteAddress);
                          }
                          function getTrustedRemoteAddress(uint16 _remoteChainId) external view returns (bytes memory) {
                              bytes memory path = trustedRemoteLookup[_remoteChainId];
                              require(path.length != 0, "LzApp: no trusted path record");
                              return path.slice(0, path.length - 20); // the last 20 bytes should be address(this)
                          }
                          function setPrecrime(address _precrime) external onlyOwner {
                              precrime = _precrime;
                              emit SetPrecrime(_precrime);
                          }
                          function setMinDstGas(uint16 _dstChainId, uint16 _packetType, uint _minGas) external onlyOwner {
                              require(_minGas > 0, "LzApp: invalid minGas");
                              minDstGasLookup[_dstChainId][_packetType] = _minGas;
                              emit SetMinDstGas(_dstChainId, _packetType, _minGas);
                          }
                          //--------------------------- VIEW FUNCTION ----------------------------------------
                          function isTrustedRemote(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool) {
                              bytes memory trustedSource = trustedRemoteLookup[_srcChainId];
                              return keccak256(trustedSource) == keccak256(_srcAddress);
                          }
                      }
                      // SPDX-License-Identifier: MIT OR Apache-2.0
                      pragma solidity >=0.7.6;
                      library ExcessivelySafeCall {
                          uint256 constant LOW_28_MASK =
                          0x00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff;
                          /// @notice Use when you _really_ really _really_ don't trust the called
                          /// contract. This prevents the called contract from causing reversion of
                          /// the caller in as many ways as we can.
                          /// @dev The main difference between this and a solidity low-level call is
                          /// that we limit the number of bytes that the callee can cause to be
                          /// copied to caller memory. This prevents stupid things like malicious
                          /// contracts returning 10,000,000 bytes causing a local OOG when copying
                          /// to memory.
                          /// @param _target The address to call
                          /// @param _gas The amount of gas to forward to the remote contract
                          /// @param _maxCopy The maximum number of bytes of returndata to copy
                          /// to memory.
                          /// @param _calldata The data to send to the remote contract
                          /// @return success and returndata, as `.call()`. Returndata is capped to
                          /// `_maxCopy` bytes.
                          function excessivelySafeCall(
                              address _target,
                              uint256 _gas,
                              uint16 _maxCopy,
                              bytes memory _calldata
                          ) internal returns (bool, bytes memory) {
                              // set up for assembly call
                              uint256 _toCopy;
                              bool _success;
                              bytes memory _returnData = new bytes(_maxCopy);
                              // dispatch message to recipient
                              // by assembly calling "handle" function
                              // we call via assembly to avoid memcopying a very large returndata
                              // returned by a malicious contract
                              assembly {
                                  _success := call(
                                  _gas, // gas
                                  _target, // recipient
                                  0, // ether value
                                  add(_calldata, 0x20), // inloc
                                  mload(_calldata), // inlen
                                  0, // outloc
                                  0 // outlen
                                  )
                              // limit our copy to 256 bytes
                                  _toCopy := returndatasize()
                                  if gt(_toCopy, _maxCopy) {
                                      _toCopy := _maxCopy
                                  }
                              // Store the length of the copied bytes
                                  mstore(_returnData, _toCopy)
                              // copy the bytes from returndata[0:_toCopy]
                                  returndatacopy(add(_returnData, 0x20), 0, _toCopy)
                              }
                              return (_success, _returnData);
                          }
                          /// @notice Use when you _really_ really _really_ don't trust the called
                          /// contract. This prevents the called contract from causing reversion of
                          /// the caller in as many ways as we can.
                          /// @dev The main difference between this and a solidity low-level call is
                          /// that we limit the number of bytes that the callee can cause to be
                          /// copied to caller memory. This prevents stupid things like malicious
                          /// contracts returning 10,000,000 bytes causing a local OOG when copying
                          /// to memory.
                          /// @param _target The address to call
                          /// @param _gas The amount of gas to forward to the remote contract
                          /// @param _maxCopy The maximum number of bytes of returndata to copy
                          /// to memory.
                          /// @param _calldata The data to send to the remote contract
                          /// @return success and returndata, as `.call()`. Returndata is capped to
                          /// `_maxCopy` bytes.
                          function excessivelySafeStaticCall(
                              address _target,
                              uint256 _gas,
                              uint16 _maxCopy,
                              bytes memory _calldata
                          ) internal view returns (bool, bytes memory) {
                              // set up for assembly call
                              uint256 _toCopy;
                              bool _success;
                              bytes memory _returnData = new bytes(_maxCopy);
                              // dispatch message to recipient
                              // by assembly calling "handle" function
                              // we call via assembly to avoid memcopying a very large returndata
                              // returned by a malicious contract
                              assembly {
                                  _success := staticcall(
                                  _gas, // gas
                                  _target, // recipient
                                  add(_calldata, 0x20), // inloc
                                  mload(_calldata), // inlen
                                  0, // outloc
                                  0 // outlen
                                  )
                              // limit our copy to 256 bytes
                                  _toCopy := returndatasize()
                                  if gt(_toCopy, _maxCopy) {
                                      _toCopy := _maxCopy
                                  }
                              // Store the length of the copied bytes
                                  mstore(_returnData, _toCopy)
                              // copy the bytes from returndata[0:_toCopy]
                                  returndatacopy(add(_returnData, 0x20), 0, _toCopy)
                              }
                              return (_success, _returnData);
                          }
                          /**
                           * @notice Swaps function selectors in encoded contract calls
                           * @dev Allows reuse of encoded calldata for functions with identical
                           * argument types but different names. It simply swaps out the first 4 bytes
                           * for the new selector. This function modifies memory in place, and should
                           * only be used with caution.
                           * @param _newSelector The new 4-byte selector
                           * @param _buf The encoded contract args
                           */
                          function swapSelector(bytes4 _newSelector, bytes memory _buf)
                          internal
                          pure
                          {
                              require(_buf.length >= 4);
                              uint256 _mask = LOW_28_MASK;
                              assembly {
                              // load the first word of
                                  let _word := mload(add(_buf, 0x20))
                              // mask out the top 4 bytes
                              // /x
                                  _word := and(_word, _mask)
                                  _word := or(_newSelector, _word)
                                  mstore(add(_buf, 0x20), _word)
                              }
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)
                      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 making it call a
                           * `private` function that does the actual work.
                           */
                          modifier nonReentrant() {
                              _nonReentrantBefore();
                              _;
                              _nonReentrantAfter();
                          }
                          function _nonReentrantBefore() private {
                              // On the first call to nonReentrant, _status will be _NOT_ENTERED
                              require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
                              // Any calls to nonReentrant after this point will fail
                              _status = _ENTERED;
                          }
                          function _nonReentrantAfter() private {
                              // By storing the original value once again, a refund is triggered (see
                              // https://eips.ethereum.org/EIPS/eip-2200)
                              _status = _NOT_ENTERED;
                          }
                          /**
                           * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
                           * `nonReentrant` function in the call stack.
                           */
                          function _reentrancyGuardEntered() internal view returns (bool) {
                              return _status == _ENTERED;
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity ^0.8.0;
                      import "./LzApp.sol";
                      import "../util/ExcessivelySafeCall.sol";
                      /*
                       * the default LayerZero messaging behaviour is blocking, i.e. any failed message will block the channel
                       * this abstract class try-catch all fail messages and store locally for future retry. hence, non-blocking
                       * NOTE: if the srcAddress is not configured properly, it will still block the message pathway from (srcChainId, srcAddress)
                       */
                      abstract contract NonblockingLzApp is LzApp {
                          using ExcessivelySafeCall for address;
                          constructor(address _endpoint) LzApp(_endpoint) {}
                          mapping(uint16 => mapping(bytes => mapping(uint64 => bytes32))) public failedMessages;
                          event MessageFailed(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes _payload, bytes _reason);
                          event RetryMessageSuccess(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _payloadHash);
                          // overriding the virtual function in LzReceiver
                          function _blockingLzReceive(uint16 _srcChainId, bytes memory _srcAddress, uint64 _nonce, bytes memory _payload) internal virtual override {
                              (bool success, bytes memory reason) = address(this).excessivelySafeCall(gasleft(), 150, abi.encodeWithSelector(this.nonblockingLzReceive.selector, _srcChainId, _srcAddress, _nonce, _payload));
                              // try-catch all errors/exceptions
                              if (!success) {
                                  _storeFailedMessage(_srcChainId, _srcAddress, _nonce, _payload, reason);
                              }
                          }
                          function _storeFailedMessage(uint16 _srcChainId, bytes memory _srcAddress, uint64 _nonce, bytes memory _payload, bytes memory _reason) internal virtual {
                              failedMessages[_srcChainId][_srcAddress][_nonce] = keccak256(_payload);
                              emit MessageFailed(_srcChainId, _srcAddress, _nonce, _payload, _reason);
                          }
                          function nonblockingLzReceive(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes calldata _payload) public virtual {
                              // only internal transaction
                              require(_msgSender() == address(this), "NonblockingLzApp: caller must be LzApp");
                              _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);
                          }
                          //@notice override this function
                          function _nonblockingLzReceive(uint16 _srcChainId, bytes memory _srcAddress, uint64 _nonce, bytes memory _payload) internal virtual;
                          function retryMessage(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes calldata _payload) public payable virtual {
                              // assert there is message to retry
                              bytes32 payloadHash = failedMessages[_srcChainId][_srcAddress][_nonce];
                              require(payloadHash != bytes32(0), "NonblockingLzApp: no stored message");
                              require(keccak256(_payload) == payloadHash, "NonblockingLzApp: invalid payload");
                              // clear the stored message
                              failedMessages[_srcChainId][_srcAddress][_nonce] = bytes32(0);
                              // execute the message. revert if it fails again
                              _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);
                              emit RetryMessageSuccess(_srcChainId, _srcAddress, _nonce, payloadHash);
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
                       * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
                       *
                       * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
                       * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
                       * need to send a transaction, and thus is not required to hold Ether at all.
                       *
                       * ==== Security Considerations
                       *
                       * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature
                       * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be
                       * considered as an intention to spend the allowance in any specific way. The second is that because permits have
                       * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should
                       * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be
                       * generally recommended is:
                       *
                       * ```solidity
                       * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {
                       *     try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}
                       *     doThing(..., value);
                       * }
                       *
                       * function doThing(..., uint256 value) public {
                       *     token.safeTransferFrom(msg.sender, address(this), value);
                       *     ...
                       * }
                       * ```
                       *
                       * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of
                       * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also
                       * {SafeERC20-safeTransferFrom}).
                       *
                       * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so
                       * contracts should have entry points that don't rely on permit.
                       */
                      interface IERC20Permit {
                          /**
                           * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
                           * given ``owner``'s signed approval.
                           *
                           * IMPORTANT: The same issues {IERC20-approve} has related to transaction
                           * ordering also apply here.
                           *
                           * Emits an {Approval} event.
                           *
                           * Requirements:
                           *
                           * - `spender` cannot be the zero address.
                           * - `deadline` must be a timestamp in the future.
                           * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
                           * over the EIP712-formatted function arguments.
                           * - the signature must use ``owner``'s current nonce (see {nonces}).
                           *
                           * For more information on the signature format, see the
                           * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
                           * section].
                           *
                           * CAUTION: See Security Considerations above.
                           */
                          function permit(
                              address owner,
                              address spender,
                              uint256 value,
                              uint256 deadline,
                              uint8 v,
                              bytes32 r,
                              bytes32 s
                          ) external;
                          /**
                           * @dev Returns the current nonce for `owner`. This value must be
                           * included whenever a signature is generated for {permit}.
                           *
                           * Every successful call to {permit} increases ``owner``'s nonce by one. This
                           * prevents a signature from being used multiple times.
                           */
                          function nonces(address owner) external view returns (uint256);
                          /**
                           * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
                           */
                          // solhint-disable-next-line func-name-mixedcase
                          function DOMAIN_SEPARATOR() external view returns (bytes32);
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
                      pragma solidity ^0.8.1;
                      /**
                       * @dev Collection of functions related to the address type
                       */
                      library Address {
                          /**
                           * @dev Returns true if `account` is a contract.
                           *
                           * [IMPORTANT]
                           * ====
                           * It is unsafe to assume that an address for which this function returns
                           * false is an externally-owned account (EOA) and not a contract.
                           *
                           * Among others, `isContract` will return false for the following
                           * types of addresses:
                           *
                           *  - an externally-owned account
                           *  - a contract in construction
                           *  - an address where a contract will be created
                           *  - an address where a contract lived, but was destroyed
                           *
                           * Furthermore, `isContract` will also return true if the target contract within
                           * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
                           * which only has an effect at the end of a transaction.
                           * ====
                           *
                           * [IMPORTANT]
                           * ====
                           * You shouldn't rely on `isContract` to protect against flash loan attacks!
                           *
                           * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
                           * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
                           * constructor.
                           * ====
                           */
                          function isContract(address account) internal view returns (bool) {
                              // This method relies on extcodesize/address.code.length, which returns 0
                              // for contracts in construction, since the code is only stored at the end
                              // of the constructor execution.
                              return account.code.length > 0;
                          }
                          /**
                           * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                           * `recipient`, forwarding all available gas and reverting on errors.
                           *
                           * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                           * of certain opcodes, possibly making contracts go over the 2300 gas limit
                           * imposed by `transfer`, making them unable to receive funds via
                           * `transfer`. {sendValue} removes this limitation.
                           *
                           * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                           *
                           * IMPORTANT: because control is transferred to `recipient`, care must be
                           * taken to not create reentrancy vulnerabilities. Consider using
                           * {ReentrancyGuard} or the
                           * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                           */
                          function sendValue(address payable recipient, uint256 amount) internal {
                              require(address(this).balance >= amount, "Address: insufficient balance");
                              (bool success, ) = recipient.call{value: amount}("");
                              require(success, "Address: unable to send value, recipient may have reverted");
                          }
                          /**
                           * @dev Performs a Solidity function call using a low level `call`. A
                           * plain `call` is an unsafe replacement for a function call: use this
                           * function instead.
                           *
                           * If `target` reverts with a revert reason, it is bubbled up by this
                           * function (like regular Solidity function calls).
                           *
                           * Returns the raw returned data. To convert to the expected return value,
                           * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                           *
                           * Requirements:
                           *
                           * - `target` must be a contract.
                           * - calling `target` with `data` must not revert.
                           *
                           * _Available since v3.1._
                           */
                          function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                              return functionCallWithValue(target, data, 0, "Address: low-level call failed");
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                           * `errorMessage` as a fallback revert reason when `target` reverts.
                           *
                           * _Available since v3.1._
                           */
                          function functionCall(
                              address target,
                              bytes memory data,
                              string memory errorMessage
                          ) internal returns (bytes memory) {
                              return functionCallWithValue(target, data, 0, errorMessage);
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                           * but also transferring `value` wei to `target`.
                           *
                           * Requirements:
                           *
                           * - the calling contract must have an ETH balance of at least `value`.
                           * - the called Solidity function must be `payable`.
                           *
                           * _Available since v3.1._
                           */
                          function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                              return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                          }
                          /**
                           * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                           * with `errorMessage` as a fallback revert reason when `target` reverts.
                           *
                           * _Available since v3.1._
                           */
                          function functionCallWithValue(
                              address target,
                              bytes memory data,
                              uint256 value,
                              string memory errorMessage
                          ) internal returns (bytes memory) {
                              require(address(this).balance >= value, "Address: insufficient balance for call");
                              (bool success, bytes memory returndata) = target.call{value: value}(data);
                              return verifyCallResultFromTarget(target, success, returndata, errorMessage);
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                           * but performing a static call.
                           *
                           * _Available since v3.3._
                           */
                          function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                              return functionStaticCall(target, data, "Address: low-level static call failed");
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                           * but performing a static call.
                           *
                           * _Available since v3.3._
                           */
                          function functionStaticCall(
                              address target,
                              bytes memory data,
                              string memory errorMessage
                          ) internal view returns (bytes memory) {
                              (bool success, bytes memory returndata) = target.staticcall(data);
                              return verifyCallResultFromTarget(target, success, returndata, errorMessage);
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                           * but performing a delegate call.
                           *
                           * _Available since v3.4._
                           */
                          function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                              return functionDelegateCall(target, data, "Address: low-level delegate call failed");
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                           * but performing a delegate call.
                           *
                           * _Available since v3.4._
                           */
                          function functionDelegateCall(
                              address target,
                              bytes memory data,
                              string memory errorMessage
                          ) internal returns (bytes memory) {
                              (bool success, bytes memory returndata) = target.delegatecall(data);
                              return verifyCallResultFromTarget(target, success, returndata, errorMessage);
                          }
                          /**
                           * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
                           * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
                           *
                           * _Available since v4.8._
                           */
                          function verifyCallResultFromTarget(
                              address target,
                              bool success,
                              bytes memory returndata,
                              string memory errorMessage
                          ) internal view returns (bytes memory) {
                              if (success) {
                                  if (returndata.length == 0) {
                                      // only check isContract if the call was successful and the return data is empty
                                      // otherwise we already know that it was a contract
                                      require(isContract(target), "Address: call to non-contract");
                                  }
                                  return returndata;
                              } else {
                                  _revert(returndata, errorMessage);
                              }
                          }
                          /**
                           * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
                           * revert reason or using the provided one.
                           *
                           * _Available since v4.3._
                           */
                          function verifyCallResult(
                              bool success,
                              bytes memory returndata,
                              string memory errorMessage
                          ) internal pure returns (bytes memory) {
                              if (success) {
                                  return returndata;
                              } else {
                                  _revert(returndata, errorMessage);
                              }
                          }
                          function _revert(bytes memory returndata, string memory errorMessage) private pure {
                              // Look for revert reason and bubble it up if present
                              if (returndata.length > 0) {
                                  // The easiest way to bubble the revert reason is using memory via assembly
                                  /// @solidity memory-safe-assembly
                                  assembly {
                                      let returndata_size := mload(returndata)
                                      revert(add(32, returndata), returndata_size)
                                  }
                              } else {
                                  revert(errorMessage);
                              }
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Interface of the ERC20 standard as defined in the EIP.
                       */
                      interface IERC20 {
                          /**
                           * @dev Emitted when `value` tokens are moved from one account (`from`) to
                           * another (`to`).
                           *
                           * Note that `value` may be zero.
                           */
                          event Transfer(address indexed from, address indexed to, uint256 value);
                          /**
                           * @dev Emitted when the allowance of a `spender` for an `owner` is set by
                           * a call to {approve}. `value` is the new allowance.
                           */
                          event Approval(address indexed owner, address indexed spender, uint256 value);
                          /**
                           * @dev Returns the amount of tokens in existence.
                           */
                          function totalSupply() external view returns (uint256);
                          /**
                           * @dev Returns the amount of tokens owned by `account`.
                           */
                          function balanceOf(address account) external view returns (uint256);
                          /**
                           * @dev Moves `amount` tokens from the caller's account to `to`.
                           *
                           * Returns a boolean value indicating whether the operation succeeded.
                           *
                           * Emits a {Transfer} event.
                           */
                          function transfer(address to, uint256 amount) external returns (bool);
                          /**
                           * @dev Returns the remaining number of tokens that `spender` will be
                           * allowed to spend on behalf of `owner` through {transferFrom}. This is
                           * zero by default.
                           *
                           * This value changes when {approve} or {transferFrom} are called.
                           */
                          function allowance(address owner, address spender) external view returns (uint256);
                          /**
                           * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
                           *
                           * Returns a boolean value indicating whether the operation succeeded.
                           *
                           * IMPORTANT: Beware that changing an allowance with this method brings the risk
                           * that someone may use both the old and the new allowance by unfortunate
                           * transaction ordering. One possible solution to mitigate this race
                           * condition is to first reduce the spender's allowance to 0 and set the
                           * desired value afterwards:
                           * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                           *
                           * Emits an {Approval} event.
                           */
                          function approve(address spender, uint256 amount) external returns (bool);
                          /**
                           * @dev Moves `amount` tokens from `from` to `to` using the
                           * allowance mechanism. `amount` is then deducted from the caller's
                           * allowance.
                           *
                           * Returns a boolean value indicating whether the operation succeeded.
                           *
                           * Emits a {Transfer} event.
                           */
                          function transferFrom(address from, address to, uint256 amount) external returns (bool);
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)
                      pragma solidity ^0.8.0;
                      import "../IERC20.sol";
                      import "../extensions/IERC20Permit.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;
                          /**
                           * @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(IERC20 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(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));
                          }
                          /**
                           * @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(IERC20 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(IERC20 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(IERC20 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(
                              IERC20Permit 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(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");
                              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(IERC20 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))) && Address.isContract(address(token));
                          }
                      }
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity >=0.6.0;
                      pragma experimental ABIEncoderV2;
                      library LzLib {
                          // LayerZero communication
                          struct CallParams {
                              address payable refundAddress;
                              address zroPaymentAddress;
                          }
                          //---------------------------------------------------------------------------
                          // Address type handling
                          struct AirdropParams {
                              uint airdropAmount;
                              bytes32 airdropAddress;
                          }
                          function buildAdapterParams(LzLib.AirdropParams memory _airdropParams, uint _uaGasLimit) internal pure returns (bytes memory adapterParams) {
                              if (_airdropParams.airdropAmount == 0 && _airdropParams.airdropAddress == bytes32(0x0)) {
                                  adapterParams = buildDefaultAdapterParams(_uaGasLimit);
                              } else {
                                  adapterParams = buildAirdropAdapterParams(_uaGasLimit, _airdropParams);
                              }
                          }
                          // Build Adapter Params
                          function buildDefaultAdapterParams(uint _uaGas) internal pure returns (bytes memory) {
                              // txType 1
                              // bytes  [2       32      ]
                              // fields [txType  extraGas]
                              return abi.encodePacked(uint16(1), _uaGas);
                          }
                          function buildAirdropAdapterParams(uint _uaGas, AirdropParams memory _params) internal pure returns (bytes memory) {
                              require(_params.airdropAmount > 0, "Airdrop amount must be greater than 0");
                              require(_params.airdropAddress != bytes32(0x0), "Airdrop address must be set");
                              // txType 2
                              // bytes  [2       32        32            bytes[]         ]
                              // fields [txType  extraGas  dstNativeAmt  dstNativeAddress]
                              return abi.encodePacked(uint16(2), _uaGas, _params.airdropAmount, _params.airdropAddress);
                          }
                          function getGasLimit(bytes memory _adapterParams) internal pure returns (uint gasLimit) {
                              require(_adapterParams.length == 34 || _adapterParams.length > 66, "Invalid adapterParams");
                              assembly {
                                  gasLimit := mload(add(_adapterParams, 34))
                              }
                          }
                          // Decode Adapter Params
                          function decodeAdapterParams(bytes memory _adapterParams) internal pure returns (uint16 txType, uint uaGas, uint airdropAmount, address payable airdropAddress) {
                              require(_adapterParams.length == 34 || _adapterParams.length > 66, "Invalid adapterParams");
                              assembly {
                                  txType := mload(add(_adapterParams, 2))
                                  uaGas := mload(add(_adapterParams, 34))
                              }
                              require(txType == 1 || txType == 2, "Unsupported txType");
                              require(uaGas > 0, "Gas too low");
                              if (txType == 2) {
                                  assembly {
                                      airdropAmount := mload(add(_adapterParams, 66))
                                      airdropAddress := mload(add(_adapterParams, 86))
                                  }
                              }
                          }
                          //---------------------------------------------------------------------------
                          // Address type handling
                          function bytes32ToAddress(bytes32 _bytes32Address) internal pure returns (address _address) {
                              return address(uint160(uint(_bytes32Address)));
                          }
                          function addressToBytes32(address _address) internal pure returns (bytes32 _bytes32Address) {
                              return bytes32(uint(uint160(_address)));
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity ^0.8.17;
                      import {ReentrancyGuard} from "@openzeppelin/contracts/security/ReentrancyGuard.sol";
                      import {NonblockingLzApp} from "@layerzerolabs/solidity-examples/contracts/lzApp/NonblockingLzApp.sol";
                      /// @dev An abstract contract containing a common functionality used by OriginalTokenBridge and WrappedTokenBridge
                      abstract contract TokenBridgeBase is NonblockingLzApp, ReentrancyGuard {
                          /// @notice A packet type used to identify messages requesting minting of wrapped tokens
                          uint8 public constant PT_MINT = 0;
                          /// @notice A packet type used to identify messages requesting unlocking of original tokens
                          uint8 public constant PT_UNLOCK = 1;
                          bool public useCustomAdapterParams;
                          event SetUseCustomAdapterParams(bool useCustomAdapterParams);
                          constructor(address _endpoint) NonblockingLzApp(_endpoint) {}
                          /// @notice Sets the `useCustomAdapterParams` flag indicating whether the contract uses custom adapter parameters or the default ones
                          /// @dev Can be called only by the bridge owner
                          function setUseCustomAdapterParams(bool _useCustomAdapterParams) external onlyOwner {
                              useCustomAdapterParams = _useCustomAdapterParams;
                              emit SetUseCustomAdapterParams(_useCustomAdapterParams);
                          }
                          /// @dev Checks `adapterParams` for correctness
                          function _checkAdapterParams(uint16 dstChainId, uint16 pkType, bytes memory adapterParams) internal virtual {
                              if (useCustomAdapterParams) {
                                  _checkGasLimit(dstChainId, pkType, adapterParams, 0);
                              } else {
                                  require(adapterParams.length == 0, "TokenBridgeBase: adapterParams must be empty");
                              }
                          }
                          /// @dev Overrides the renounce ownership logic inherited from openZeppelin `Ownable`
                          function renounceOwnership() public override onlyOwner {}
                      }// SPDX-License-Identifier: MIT
                      pragma solidity ^0.8.17;
                      /// @title Interface for WETH and other wrapped native gas tokens (e.g., WBNB, WAVAX, etc.)
                      interface IWETH {
                          /// @notice Deposit ether to get wrapped ether
                          function deposit() external payable;
                          /// @notice Withdraw wrapped ether to get ether
                          function withdraw(uint) external;
                      }

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

                      File 3 of 9: OptimizedTransparentUpgradeableProxy
                      // SPDX-License-Identifier: MIT
                      pragma solidity ^0.7.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 {
                              // 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 virtual view 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 {
                              _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 () payable external {
                              _fallback();
                          }
                          /**
                           * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
                           * is empty.
                           */
                          receive () payable external {
                              _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.7.0;
                      import "./Proxy.sol";
                      import "../utils/Address.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.
                       * 
                       * Upgradeability is only provided internally through {_upgradeTo}. For an externally upgradeable proxy see
                       * {TransparentUpgradeableProxy}.
                       */
                      contract UpgradeableProxy is Proxy {
                          /**
                           * @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));
                              _setImplementation(_logic);
                              if(_data.length > 0) {
                                  // solhint-disable-next-line avoid-low-level-calls
                                  (bool success,) = _logic.delegatecall(_data);
                                  require(success);
                              }
                          }
                          /**
                           * @dev Emitted when the implementation is upgraded.
                           */
                          event Upgraded(address indexed implementation);
                          /**
                           * @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 private constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                          /**
                           * @dev Returns the current implementation address.
                           */
                          function _implementation() internal override view returns (address impl) {
                              bytes32 slot = _IMPLEMENTATION_SLOT;
                              // solhint-disable-next-line no-inline-assembly
                              assembly {
                                  impl := sload(slot)
                              }
                          }
                          /**
                           * @dev Upgrades the proxy to a new implementation.
                           * 
                           * Emits an {Upgraded} event.
                           */
                          function _upgradeTo(address newImplementation) internal {
                              _setImplementation(newImplementation);
                              emit Upgraded(newImplementation);
                          }
                          /**
                           * @dev Stores a new address in the EIP1967 implementation slot.
                           */
                          function _setImplementation(address newImplementation) private {
                              require(Address.isContract(newImplementation), "UpgradeableProxy: new implementation is not a contract");
                              bytes32 slot = _IMPLEMENTATION_SLOT;
                              // solhint-disable-next-line no-inline-assembly
                              assembly {
                                  sstore(slot, newImplementation)
                              }
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity ^0.7.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) {
                              // According to EIP-1052, 0x0 is the value returned for not-yet created accounts
                              // and 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470 is returned
                              // for accounts without code, i.e. `keccak256('')`
                              bytes32 codehash;
                              bytes32 accountHash = 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470;
                              // solhint-disable-next-line no-inline-assembly
                              assembly { codehash := extcodehash(account) }
                              return (codehash != accountHash && codehash != 0x0);
                          }
                          /**
                           * @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");
                              return _functionCallWithValue(target, data, value, errorMessage);
                          }
                          function _functionCallWithValue(address target, bytes memory data, uint256 weiValue, string memory errorMessage) private returns (bytes memory) {
                              require(isContract(target), "Address: call to non-contract");
                              // solhint-disable-next-line avoid-low-level-calls
                              (bool success, bytes memory returndata) = target.call{ value: weiValue }(data);
                              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.7.0;
                      import "../openzeppelin/proxy/UpgradeableProxy.sol";
                      /**
                       * @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 inerface of your proxy.
                       */
                      contract OptimizedTransparentUpgradeableProxy is UpgradeableProxy {
                          address internal immutable _ADMIN;
                          /**
                           * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and
                           * optionally initialized with `_data` as explained in {UpgradeableProxy-constructor}.
                           */
                          constructor(
                              address initialLogic,
                              address initialAdmin,
                              bytes memory _data
                          ) payable UpgradeableProxy(initialLogic, _data) {
                              assert(_ADMIN_SLOT == bytes32(uint256(keccak256("eip1967.proxy.admin")) - 1));
                              bytes32 slot = _ADMIN_SLOT;
                              _ADMIN = initialAdmin;
                              // still store it to work with EIP-1967
                              // solhint-disable-next-line no-inline-assembly
                              assembly {
                                  sstore(slot, initialAdmin)
                              }
                          }
                          /**
                           * @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 private constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                          /**
                           * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
                           */
                          modifier ifAdmin() {
                              if (msg.sender == _admin()) {
                                  _;
                              } else {
                                  _fallback();
                              }
                          }
                          /**
                           * @dev Returns the current admin.
                           *
                           * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.
                           *
                           * 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 admin() external ifAdmin returns (address) {
                              return _admin();
                          }
                          /**
                           * @dev Returns the current implementation.
                           *
                           * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.
                           *
                           * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
                           * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                           * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
                           */
                          function implementation() external ifAdmin returns (address) {
                              return _implementation();
                          }
                          /**
                           * @dev Upgrade the implementation of the proxy.
                           *
                           * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.
                           */
                          function upgradeTo(address newImplementation) external ifAdmin {
                              _upgradeTo(newImplementation);
                          }
                          /**
                           * @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.
                           *
                           * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.
                           */
                          function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {
                              _upgradeTo(newImplementation);
                              // solhint-disable-next-line avoid-low-level-calls
                              (bool success, ) = newImplementation.delegatecall(data);
                              require(success);
                          }
                          /**
                           * @dev Returns the current admin.
                           */
                          function _admin() internal view returns (address adm) {
                              return _ADMIN;
                          }
                          /**
                           * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.
                           */
                          function _beforeFallback() internal virtual override {
                              require(msg.sender != _admin(), "TransparentUpgradeableProxy: admin cannot fallback to proxy target");
                              super._beforeFallback();
                          }
                      }
                      

                      File 4 of 9: UltraLightNodeV2
                      {"Address.sol":{"content":"// SPDX-License-Identifier: MIT\n\npragma solidity ^0.7.0;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n    /**\n     * @dev Returns true if `account` is a contract.\n     *\n     * [IMPORTANT]\n     * ====\n     * It is unsafe to assume that an address for which this function returns\n     * false is an externally-owned account (EOA) and not a contract.\n     *\n     * Among others, `isContract` will return false for the following\n     * types of addresses:\n     *\n     *  - an externally-owned account\n     *  - a contract in construction\n     *  - an address where a contract will be created\n     *  - an address where a contract lived, but was destroyed\n     * ====\n     */\n    function isContract(address account) internal view returns (bool) {\n        // This method relies on extcodesize, which returns 0 for contracts in\n        // construction, since the code is only stored at the end of the\n        // constructor execution.\n\n        uint256 size;\n        // solhint-disable-next-line no-inline-assembly\n        assembly { size := extcodesize(account) }\n        return size \u003e 0;\n    }\n\n    /**\n     * @dev Replacement for Solidity\u0027s `transfer`: sends `amount` wei to\n     * `recipient`, forwarding all available gas and reverting on errors.\n     *\n     * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n     * of certain opcodes, possibly making contracts go over the 2300 gas limit\n     * imposed by `transfer`, making them unable to receive funds via\n     * `transfer`. {sendValue} removes this limitation.\n     *\n     * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n     *\n     * IMPORTANT: because control is transferred to `recipient`, care must be\n     * taken to not create reentrancy vulnerabilities. Consider using\n     * {ReentrancyGuard} or the\n     * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n     */\n    function sendValue(address payable recipient, uint256 amount) internal {\n        require(address(this).balance \u003e= amount, \"Address: insufficient balance\");\n\n        // solhint-disable-next-line avoid-low-level-calls, avoid-call-value\n        (bool success, ) = recipient.call{ value: amount }(\"\");\n        require(success, \"Address: unable to send value, recipient may have reverted\");\n    }\n\n    /**\n     * @dev Performs a Solidity function call using a low level `call`. A\n     * plain`call` is an unsafe replacement for a function call: use this\n     * function instead.\n     *\n     * If `target` reverts with a revert reason, it is bubbled up by this\n     * function (like regular Solidity function calls).\n     *\n     * Returns the raw returned data. To convert to the expected return value,\n     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n     *\n     * Requirements:\n     *\n     * - `target` must be a contract.\n     * - calling `target` with `data` must not revert.\n     *\n     * _Available since v3.1._\n     */\n    function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n      return functionCall(target, data, \"Address: low-level call failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n     * `errorMessage` as a fallback revert reason when `target` reverts.\n     *\n     * _Available since v3.1._\n     */\n    function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {\n        return functionCallWithValue(target, data, 0, errorMessage);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but also transferring `value` wei to `target`.\n     *\n     * Requirements:\n     *\n     * - the calling contract must have an ETH balance of at least `value`.\n     * - the called Solidity function must be `payable`.\n     *\n     * _Available since v3.1._\n     */\n    function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n        return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n     * with `errorMessage` as a fallback revert reason when `target` reverts.\n     *\n     * _Available since v3.1._\n     */\n    function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {\n        require(address(this).balance \u003e= value, \"Address: insufficient balance for call\");\n        require(isContract(target), \"Address: call to non-contract\");\n\n        // solhint-disable-next-line avoid-low-level-calls\n        (bool success, bytes memory returndata) = target.call{ value: value }(data);\n        return _verifyCallResult(success, returndata, errorMessage);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but performing a static call.\n     *\n     * _Available since v3.3._\n     */\n    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n        return functionStaticCall(target, data, \"Address: low-level static call failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n     * but performing a static call.\n     *\n     * _Available since v3.3._\n     */\n    function functionStaticCall(address target, bytes memory data, string memory errorMessage) internal view returns (bytes memory) {\n        require(isContract(target), \"Address: static call to non-contract\");\n\n        // solhint-disable-next-line avoid-low-level-calls\n        (bool success, bytes memory returndata) = target.staticcall(data);\n        return _verifyCallResult(success, returndata, errorMessage);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but performing a delegate call.\n     *\n     * _Available since v3.4._\n     */\n    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n        return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n     * but performing a delegate call.\n     *\n     * _Available since v3.4._\n     */\n    function functionDelegateCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {\n        require(isContract(target), \"Address: delegate call to non-contract\");\n\n        // solhint-disable-next-line avoid-low-level-calls\n        (bool success, bytes memory returndata) = target.delegatecall(data);\n        return _verifyCallResult(success, returndata, errorMessage);\n    }\n\n    function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {\n        if (success) {\n            return returndata;\n        } else {\n            // Look for revert reason and bubble it up if present\n            if (returndata.length \u003e 0) {\n                // The easiest way to bubble the revert reason is using memory via assembly\n\n                // solhint-disable-next-line no-inline-assembly\n                assembly {\n                    let returndata_size := mload(returndata)\n                    revert(add(32, returndata), returndata_size)\n                }\n            } else {\n                revert(errorMessage);\n            }\n        }\n    }\n}\n"},"Buffer.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\n// https://github.com/ensdomains/buffer\n\npragma solidity ^0.7.0;\n\n/**\n * @dev A library for working with mutable byte buffers in Solidity.\n *\n * Byte buffers are mutable and expandable, and provide a variety of primitives\n * for writing to them. At any time you can fetch a bytes object containing the\n * current contents of the buffer. The bytes object should not be stored between\n * operations, as it may change due to resizing of the buffer.\n */\nlibrary Buffer {\n    /**\n     * @dev Represents a mutable buffer. Buffers have a current value (buf) and\n     *      a capacity. The capacity may be longer than the current value, in\n     *      which case it can be extended without the need to allocate more memory.\n     */\n    struct buffer {\n        bytes buf;\n        uint capacity;\n    }\n\n    /**\n     * @dev Initializes a buffer with an initial capacity.a co\n     * @param buf The buffer to initialize.\n     * @param capacity The number of bytes of space to allocate the buffer.\n     * @return The buffer, for chaining.\n     */\n    function init(buffer memory buf, uint capacity) internal pure returns (buffer memory) {\n        if (capacity % 32 != 0) {\n            capacity += 32 - (capacity % 32);\n        }\n        // Allocate space for the buffer data\n        buf.capacity = capacity;\n        assembly {\n            let ptr := mload(0x40)\n            mstore(buf, ptr)\n            mstore(ptr, 0)\n            mstore(0x40, add(32, add(ptr, capacity)))\n        }\n        return buf;\n    }\n\n\n    /**\n     * @dev Writes a byte string to a buffer. Resizes if doing so would exceed\n     *      the capacity of the buffer.\n     * @param buf The buffer to append to.\n     * @param off The start offset to write to.\n     * @param rawData The data to append.\n     * @param len The number of bytes to copy.\n     * @return The original buffer, for chaining.\n     */\n    function writeRawBytes(\n        buffer memory buf,\n        uint off,\n        bytes memory rawData,\n        uint offData,\n        uint len\n    ) internal pure returns (buffer memory) {\n        if (off + len \u003e buf.capacity) {\n            resize(buf, max(buf.capacity, len + off) * 2);\n        }\n\n        uint dest;\n        uint src;\n        assembly {\n            // Memory address of the buffer data\n            let bufptr := mload(buf)\n            // Length of existing buffer data\n            let buflen := mload(bufptr)\n            // Start address = buffer address + offset + sizeof(buffer length)\n            dest := add(add(bufptr, 32), off)\n            // Update buffer length if we\u0027re extending it\n            if gt(add(len, off), buflen) {\n                mstore(bufptr, add(len, off))\n            }\n            src := add(rawData, offData)\n        }\n\n        // Copy word-length chunks while possible\n        for (; len \u003e= 32; len -= 32) {\n            assembly {\n                mstore(dest, mload(src))\n            }\n            dest += 32;\n            src += 32;\n        }\n\n        // Copy remaining bytes\n        uint mask = 256**(32 - len) - 1;\n        assembly {\n            let srcpart := and(mload(src), not(mask))\n            let destpart := and(mload(dest), mask)\n            mstore(dest, or(destpart, srcpart))\n        }\n\n        return buf;\n    }\n\n    /**\n     * @dev Writes a byte string to a buffer. Resizes if doing so would exceed\n     *      the capacity of the buffer.\n     * @param buf The buffer to append to.\n     * @param off The start offset to write to.\n     * @param data The data to append.\n     * @param len The number of bytes to copy.\n     * @return The original buffer, for chaining.\n     */\n    function write(buffer memory buf, uint off, bytes memory data, uint len) internal pure returns (buffer memory) {\n        require(len \u003c= data.length);\n\n        if (off + len \u003e buf.capacity) {\n            resize(buf, max(buf.capacity, len + off) * 2);\n        }\n\n        uint dest;\n        uint src;\n        assembly {\n        // Memory address of the buffer data\n            let bufptr := mload(buf)\n        // Length of existing buffer data\n            let buflen := mload(bufptr)\n        // Start address = buffer address + offset + sizeof(buffer length)\n            dest := add(add(bufptr, 32), off)\n        // Update buffer length if we\u0027re extending it\n            if gt(add(len, off), buflen) {\n                mstore(bufptr, add(len, off))\n            }\n            src := add(data, 32)\n        }\n\n        // Copy word-length chunks while possible\n        for (; len \u003e= 32; len -= 32) {\n            assembly {\n                mstore(dest, mload(src))\n            }\n            dest += 32;\n            src += 32;\n        }\n\n        // Copy remaining bytes\n        uint mask = 256**(32 - len) - 1;\n        assembly {\n            let srcpart := and(mload(src), not(mask))\n            let destpart := and(mload(dest), mask)\n            mstore(dest, or(destpart, srcpart))\n        }\n\n        return buf;\n    }\n\n    function append(buffer memory buf, bytes memory data) internal pure returns (buffer memory) {\n        return write(buf, buf.buf.length, data, data.length);\n    }\n\n    function resize(buffer memory buf, uint capacity) private pure {\n        bytes memory oldbuf = buf.buf;\n        init(buf, capacity);\n        append(buf, oldbuf);\n    }\n\n    function max(uint a, uint b) private pure returns (uint) {\n        if (a \u003e b) {\n            return a;\n        }\n        return b;\n    }\n}\n"},"Context.sol":{"content":"// SPDX-License-Identifier: MIT\n\npragma solidity \u003e=0.6.0 \u003c0.8.0;\n\n/*\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with GSN meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract Context {\n    function _msgSender() internal view virtual returns (address payable) {\n        return msg.sender;\n    }\n\n    function _msgData() internal view virtual returns (bytes memory) {\n        this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691\n        return msg.data;\n    }\n}\n"},"IERC20.sol":{"content":"// SPDX-License-Identifier: MIT\n\npragma solidity ^0.7.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20 {\n    /**\n     * @dev Returns the amount of tokens in existence.\n     */\n    function totalSupply() external view returns (uint256);\n\n    /**\n     * @dev Returns the amount of tokens owned by `account`.\n     */\n    function balanceOf(address account) external view returns (uint256);\n\n    /**\n     * @dev Moves `amount` tokens from the caller\u0027s account to `recipient`.\n     *\n     * Returns a boolean value indicating whether the operation succeeded.\n     *\n     * Emits a {Transfer} event.\n     */\n    function transfer(address recipient, uint256 amount) external returns (bool);\n\n    /**\n     * @dev Returns the remaining number of tokens that `spender` will be\n     * allowed to spend on behalf of `owner` through {transferFrom}. This is\n     * zero by default.\n     *\n     * This value changes when {approve} or {transferFrom} are called.\n     */\n    function allowance(address owner, address spender) external view returns (uint256);\n\n    /**\n     * @dev Sets `amount` as the allowance of `spender` over the caller\u0027s tokens.\n     *\n     * Returns a boolean value indicating whether the operation succeeded.\n     *\n     * IMPORTANT: Beware that changing an allowance with this method brings the risk\n     * that someone may use both the old and the new allowance by unfortunate\n     * transaction ordering. One possible solution to mitigate this race\n     * condition is to first reduce the spender\u0027s allowance to 0 and set the\n     * desired value afterwards:\n     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n     *\n     * Emits an {Approval} event.\n     */\n    function approve(address spender, uint256 amount) external returns (bool);\n\n    /**\n     * @dev Moves `amount` tokens from `sender` to `recipient` using the\n     * allowance mechanism. `amount` is then deducted from the caller\u0027s\n     * allowance.\n     *\n     * Returns a boolean value indicating whether the operation succeeded.\n     *\n     * Emits a {Transfer} event.\n     */\n    function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);\n\n    /**\n     * @dev Emitted when `value` tokens are moved from one account (`from`) to\n     * another (`to`).\n     *\n     * Note that `value` may be zero.\n     */\n    event Transfer(address indexed from, address indexed to, uint256 value);\n\n    /**\n     * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n     * a call to {approve}. `value` is the new allowance.\n     */\n    event Approval(address indexed owner, address indexed spender, uint256 value);\n}\n"},"ILayerZeroEndpoint.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity \u003e=0.5.0;\n\nimport \"./ILayerZeroUserApplicationConfig.sol\";\n\ninterface ILayerZeroEndpoint is ILayerZeroUserApplicationConfig {\n    // @notice send a LayerZero message to the specified address at a LayerZero endpoint.\n    // @param _dstChainId - the destination chain identifier\n    // @param _destination - the address on destination chain (in bytes). address length/format may vary by chains\n    // @param _payload - a custom bytes payload to send to the destination contract\n    // @param _refundAddress - if the source transaction is cheaper than the amount of value passed, refund the additional amount to this address\n    // @param _zroPaymentAddress - the address of the ZRO token holder who would pay for the transaction\n    // @param _adapterParams - parameters for custom functionality. e.g. receive airdropped native gas from the relayer on destination\n    function send(uint16 _dstChainId, bytes calldata _destination, bytes calldata _payload, address payable _refundAddress, address _zroPaymentAddress, bytes calldata _adapterParams) external payable;\n\n    // @notice used by the messaging library to publish verified payload\n    // @param _srcChainId - the source chain identifier\n    // @param _srcAddress - the source contract (as bytes) at the source chain\n    // @param _dstAddress - the address on destination chain\n    // @param _nonce - the unbound message ordering nonce\n    // @param _gasLimit - the gas limit for external contract execution\n    // @param _payload - verified payload to send to the destination contract\n    function receivePayload(uint16 _srcChainId, bytes calldata _srcAddress, address _dstAddress, uint64 _nonce, uint _gasLimit, bytes calldata _payload) external;\n\n    // @notice get the inboundNonce of a receiver from a source chain which could be EVM or non-EVM chain\n    // @param _srcChainId - the source chain identifier\n    // @param _srcAddress - the source chain contract address\n    function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint64);\n\n    // @notice get the outboundNonce from this source chain which, consequently, is always an EVM\n    // @param _srcAddress - the source chain contract address\n    function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view returns (uint64);\n\n    // @notice gets a quote in source native gas, for the amount that send() requires to pay for message delivery\n    // @param _dstChainId - the destination chain identifier\n    // @param _userApplication - the user app address on this EVM chain\n    // @param _payload - the custom message to send over LayerZero\n    // @param _payInZRO - if false, user app pays the protocol fee in native token\n    // @param _adapterParam - parameters for the adapter service, e.g. send some dust native token to dstChain\n    function estimateFees(uint16 _dstChainId, address _userApplication, bytes calldata _payload, bool _payInZRO, bytes calldata _adapterParam) external view returns (uint nativeFee, uint zroFee);\n\n    // @notice get this Endpoint\u0027s immutable source identifier\n    function getChainId() external view returns (uint16);\n\n    // @notice the interface to retry failed message on this Endpoint destination\n    // @param _srcChainId - the source chain identifier\n    // @param _srcAddress - the source chain contract address\n    // @param _payload - the payload to be retried\n    function retryPayload(uint16 _srcChainId, bytes calldata _srcAddress, bytes calldata _payload) external;\n\n    // @notice query if any STORED payload (message blocking) at the endpoint.\n    // @param _srcChainId - the source chain identifier\n    // @param _srcAddress - the source chain contract address\n    function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool);\n\n    // @notice query if the _libraryAddress is valid for sending msgs.\n    // @param _userApplication - the user app address on this EVM chain\n    function getSendLibraryAddress(address _userApplication) external view returns (address);\n\n    // @notice query if the _libraryAddress is valid for receiving msgs.\n    // @param _userApplication - the user app address on this EVM chain\n    function getReceiveLibraryAddress(address _userApplication) external view returns (address);\n\n    // @notice query if the non-reentrancy guard for send() is on\n    // @return true if the guard is on. false otherwise\n    function isSendingPayload() external view returns (bool);\n\n    // @notice query if the non-reentrancy guard for receive() is on\n    // @return true if the guard is on. false otherwise\n    function isReceivingPayload() external view returns (bool);\n\n    // @notice get the configuration of the LayerZero messaging library of the specified version\n    // @param _version - messaging library version\n    // @param _chainId - the chainId for the pending config change\n    // @param _userApplication - the contract address of the user application\n    // @param _configType - type of configuration. every messaging library has its own convention.\n    function getConfig(uint16 _version, uint16 _chainId, address _userApplication, uint _configType) external view returns (bytes memory);\n\n    // @notice get the send() LayerZero messaging library version\n    // @param _userApplication - the contract address of the user application\n    function getSendVersion(address _userApplication) external view returns (uint16);\n\n    // @notice get the lzReceive() LayerZero messaging library version\n    // @param _userApplication - the contract address of the user application\n    function getReceiveVersion(address _userApplication) external view returns (uint16);\n}\n"},"ILayerZeroMessagingLibrary.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity \u003e=0.7.0;\n\nimport \"./ILayerZeroUserApplicationConfig.sol\";\n\ninterface ILayerZeroMessagingLibrary {\n    // send(), messages will be inflight.\n    function send(address _userApplication, uint64 _lastNonce, uint16 _chainId, bytes calldata _destination, bytes calldata _payload, address payable refundAddress, address _zroPaymentAddress, bytes calldata _adapterParams) external payable;\n\n    // estimate native fee at the send side\n    function estimateFees(uint16 _chainId, address _userApplication, bytes calldata _payload, bool _payInZRO, bytes calldata _adapterParam) external view returns (uint nativeFee, uint zroFee);\n\n    //---------------------------------------------------------------------------\n    // setConfig / getConfig are User Application (UA) functions to specify Oracle, Relayer, blockConfirmations, libraryVersion\n    function setConfig(uint16 _chainId, address _userApplication, uint _configType, bytes calldata _config) external;\n\n    function getConfig(uint16 _chainId, address _userApplication, uint _configType) external view returns (bytes memory);\n}\n"},"ILayerZeroMessagingLibraryV2.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity \u003e=0.7.0;\n\nimport \"./ILayerZeroUserApplicationConfig.sol\";\nimport \"./ILayerZeroMessagingLibrary.sol\";\n\ninterface ILayerZeroMessagingLibraryV2 is ILayerZeroMessagingLibrary {\n    function getOutboundNonce(uint16 _chainId, bytes calldata _path) external view returns (uint64);\n}\n"},"ILayerZeroOracleV2.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity \u003e=0.7.0;\n\ninterface ILayerZeroOracleV2 {\n    // @notice query price and assign jobs at the same time\n    // @param _dstChainId - the destination endpoint identifier\n    // @param _outboundProofType - the proof type identifier to specify proof to be relayed\n    // @param _outboundBlockConfirmation - block confirmation delay before relaying blocks\n    // @param _userApplication - the source sending contract address\n    function assignJob(uint16 _dstChainId, uint16 _outboundProofType, uint64 _outboundBlockConfirmation, address _userApplication) external returns (uint price);\n\n    // @notice query the oracle price for relaying block information to the destination chain\n    // @param _dstChainId the destination endpoint identifier\n    // @param _outboundProofType the proof type identifier to specify the data to be relayed\n    // @param _outboundBlockConfirmation - block confirmation delay before relaying blocks\n    // @param _userApplication - the source sending contract address\n    function getFee(uint16 _dstChainId, uint16 _outboundProofType, uint64 _outboundBlockConfirmation, address _userApplication) external view returns (uint price);\n\n    // @notice withdraw the accrued fee in ultra light node\n    // @param _to - the fee receiver\n    // @param _amount - the withdrawal amount\n    function withdrawFee(address payable _to, uint _amount) external;\n}\n"},"ILayerZeroReceiver.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity \u003e=0.5.0;\n\ninterface ILayerZeroReceiver {\n    // @notice LayerZero endpoint will invoke this function to deliver the message on the destination\n    // @param _srcChainId - the source endpoint identifier\n    // @param _srcAddress - the source sending contract address from the source chain\n    // @param _nonce - the ordered message nonce\n    // @param _payload - the signed payload is the UA bytes has encoded to be sent\n    function lzReceive(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes calldata _payload) external;\n}\n"},"ILayerZeroRelayerV2.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity \u003e=0.7.0;\n\ninterface ILayerZeroRelayerV2 {\n    // @notice query price and assign jobs at the same time\n    // @param _dstChainId - the destination endpoint identifier\n    // @param _outboundProofType - the proof type identifier to specify proof to be relayed\n    // @param _userApplication - the source sending contract address. relayers may apply price discrimination to user apps\n    // @param _payloadSize - the length of the payload. it is an indicator of gas usage for relaying cross-chain messages\n    // @param _adapterParams - optional parameters for extra service plugins, e.g. sending dust tokens at the destination chain\n    function assignJob(uint16 _dstChainId, uint16 _outboundProofType, address _userApplication, uint _payloadSize, bytes calldata _adapterParams) external returns (uint price);\n\n    // @notice query the relayer price for relaying the payload and its proof to the destination chain\n    // @param _dstChainId - the destination endpoint identifier\n    // @param _outboundProofType - the proof type identifier to specify proof to be relayed\n    // @param _userApplication - the source sending contract address. relayers may apply price discrimination to user apps\n    // @param _payloadSize - the length of the payload. it is an indicator of gas usage for relaying cross-chain messages\n    // @param _adapterParams - optional parameters for extra service plugins, e.g. sending dust tokens at the destination chain\n    function getFee(uint16 _dstChainId, uint16 _outboundProofType, address _userApplication, uint _payloadSize, bytes calldata _adapterParams) external view returns (uint price);\n\n    // @notice withdraw the accrued fee in ultra light node\n    // @param _to - the fee receiver\n    // @param _amount - the withdrawal amount\n    function withdrawFee(address payable _to, uint _amount) external;\n}\n"},"ILayerZeroTreasury.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity \u003e=0.5.0;\n\ninterface ILayerZeroTreasury {\n    function getFees(bool payInZro, uint relayerFee, uint oracleFee) external view returns (uint);\n}\n"},"ILayerZeroUltraLightNodeV2.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity \u003e=0.7.0;\npragma abicoder v2;\n\ninterface ILayerZeroUltraLightNodeV2 {\n    // Relayer functions\n    function validateTransactionProof(uint16 _srcChainId, address _dstAddress, uint _gasLimit, bytes32 _lookupHash, bytes32 _blockData, bytes calldata _transactionProof) external;\n\n    // an Oracle delivers the block data using updateHash()\n    function updateHash(uint16 _srcChainId, bytes32 _lookupHash, uint _confirmations, bytes32 _blockData) external;\n\n    // can only withdraw the receivable of the msg.sender\n    function withdrawNative(address payable _to, uint _amount) external;\n\n    function withdrawZRO(address _to, uint _amount) external;\n\n    // view functions\n    function getAppConfig(uint16 _remoteChainId, address _userApplicationAddress) external view returns (ApplicationConfiguration memory);\n\n    function accruedNativeFee(address _address) external view returns (uint);\n\n    struct ApplicationConfiguration {\n        uint16 inboundProofLibraryVersion;\n        uint64 inboundBlockConfirmations;\n        address relayer;\n        uint16 outboundProofType;\n        uint64 outboundBlockConfirmations;\n        address oracle;\n    }\n\n    event HashReceived(uint16 indexed srcChainId, address indexed oracle, bytes32 lookupHash, bytes32 blockData, uint confirmations);\n    event RelayerParams(bytes adapterParams, uint16 outboundProofType);\n    event Packet(bytes payload);\n    event InvalidDst(uint16 indexed srcChainId, bytes srcAddress, address indexed dstAddress, uint64 nonce, bytes32 payloadHash);\n    event PacketReceived(uint16 indexed srcChainId, bytes srcAddress, address indexed dstAddress, uint64 nonce, bytes32 payloadHash);\n    event AppConfigUpdated(address indexed userApplication, uint indexed configType, bytes newConfig);\n    event AddInboundProofLibraryForChain(uint16 indexed chainId, address lib);\n    event EnableSupportedOutboundProof(uint16 indexed chainId, uint16 proofType);\n    event SetChainAddressSize(uint16 indexed chainId, uint size);\n    event SetDefaultConfigForChainId(uint16 indexed chainId, uint16 inboundProofLib, uint64 inboundBlockConfirm, address relayer, uint16 outboundProofType, uint64 outboundBlockConfirm, address oracle);\n    event SetDefaultAdapterParamsForChainId(uint16 indexed chainId, uint16 indexed proofType, bytes adapterParams);\n    event SetLayerZeroToken(address indexed tokenAddress);\n    event SetRemoteUln(uint16 indexed chainId, bytes32 uln);\n    event SetTreasury(address indexed treasuryAddress);\n    event WithdrawZRO(address indexed msgSender, address indexed to, uint amount);\n    event WithdrawNative(address indexed msgSender, address indexed to, uint amount);\n}\n"},"ILayerZeroUserApplicationConfig.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity \u003e=0.5.0;\n\ninterface ILayerZeroUserApplicationConfig {\n    // @notice set the configuration of the LayerZero messaging library of the specified version\n    // @param _version - messaging library version\n    // @param _chainId - the chainId for the pending config change\n    // @param _configType - type of configuration. every messaging library has its own convention.\n    // @param _config - configuration in the bytes. can encode arbitrary content.\n    function setConfig(uint16 _version, uint16 _chainId, uint _configType, bytes calldata _config) external;\n\n    // @notice set the send() LayerZero messaging library version to _version\n    // @param _version - new messaging library version\n    function setSendVersion(uint16 _version) external;\n\n    // @notice set the lzReceive() LayerZero messaging library version to _version\n    // @param _version - new messaging library version\n    function setReceiveVersion(uint16 _version) external;\n\n    // @notice Only when the UA needs to resume the message flow in blocking mode and clear the stored payload\n    // @param _srcChainId - the chainId of the source chain\n    // @param _srcAddress - the contract address of the source contract at the source chain\n    function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external;\n}\n"},"ILayerZeroValidationLibrary.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity \u003e=0.7.0;\npragma abicoder v2;\n\nimport \"./LayerZeroPacket.sol\";\n\ninterface ILayerZeroValidationLibrary {\n    function validateProof(bytes32 blockData, bytes calldata _data, uint _remoteAddressSize) external returns (LayerZeroPacket.Packet memory packet);\n}\n"},"LayerZeroPacket.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity 0.7.6;\n\nimport \"./Buffer.sol\";\nimport \"./SafeMath.sol\";\n\nlibrary LayerZeroPacket {\n    using Buffer for Buffer.buffer;\n    using SafeMath for uint;\n\n    struct Packet {\n        uint16 srcChainId;\n        uint16 dstChainId;\n        uint64 nonce;\n        address dstAddress;\n        bytes srcAddress;\n        bytes32 ulnAddress;\n        bytes payload;\n    }\n\n    function getPacket(\n        bytes memory data,\n        uint16 srcChain,\n        uint sizeOfSrcAddress,\n        bytes32 ulnAddress\n    ) internal pure returns (LayerZeroPacket.Packet memory) {\n        uint16 dstChainId;\n        address dstAddress;\n        uint size;\n        uint64 nonce;\n\n        // The log consists of the destination chain id and then a bytes payload\n        //      0--------------------------------------------31\n        // 0   |  total bytes size\n        // 32  |  destination chain id\n        // 64  |  bytes offset\n        // 96  |  bytes array size\n        // 128 |  payload\n        assembly {\n            dstChainId := mload(add(data, 32))\n            size := mload(add(data, 96)) /// size of the byte array\n            nonce := mload(add(data, 104)) // offset to convert to uint64  128  is index -24\n            dstAddress := mload(add(data, sub(add(128, sizeOfSrcAddress), 4))) // offset to convert to address 12 -8\n        }\n\n        Buffer.buffer memory srcAddressBuffer;\n        srcAddressBuffer.init(sizeOfSrcAddress);\n        srcAddressBuffer.writeRawBytes(0, data, 136, sizeOfSrcAddress); // 128 + 8\n\n        uint payloadSize = size.sub(28).sub(sizeOfSrcAddress);\n        Buffer.buffer memory payloadBuffer;\n        payloadBuffer.init(payloadSize);\n        payloadBuffer.writeRawBytes(0, data, sizeOfSrcAddress.add(156), payloadSize); // 148 + 8\n        return LayerZeroPacket.Packet(srcChain, dstChainId, nonce, dstAddress, srcAddressBuffer.buf, ulnAddress, payloadBuffer.buf);\n    }\n\n    function getPacketV2(\n        bytes memory data,\n        uint sizeOfSrcAddress,\n        bytes32 ulnAddress\n    ) internal pure returns (LayerZeroPacket.Packet memory) {\n        // packet def: abi.encodePacked(nonce, srcChain, srcAddress, dstChain, dstAddress, payload);\n        // data def: abi.encode(packet) = offset(32) + length(32) + packet\n        //              if from EVM\n        // 0 - 31       0 - 31          |  total bytes size\n        // 32 - 63      32 - 63         |  location\n        // 64 - 95      64 - 95         |  size of the packet\n        // 96 - 103     96 - 103        |  nonce\n        // 104 - 105    104 - 105       |  srcChainId\n        // 106 - P      106 - 125       |  srcAddress, where P = 106 + sizeOfSrcAddress - 1,\n        // P+1 - P+2    126 - 127       |  dstChainId\n        // P+3 - P+22   128 - 147       |  dstAddress\n        // P+23 - END   148 - END       |  payload\n\n        // decode the packet\n        uint256 realSize;\n        uint64 nonce;\n        uint16 srcChain;\n        uint16 dstChain;\n        address dstAddress;\n        assembly {\n            realSize := mload(add(data, 64))\n            nonce := mload(add(data, 72)) // 104 - 32\n            srcChain := mload(add(data, 74)) // 106 - 32\n            dstChain := mload(add(data, add(76, sizeOfSrcAddress))) // P + 3 - 32 = 105 + size + 3 - 32 = 76 + size\n            dstAddress := mload(add(data, add(96, sizeOfSrcAddress))) // P + 23 - 32 = 105 + size + 23 - 32 = 96 + size\n        }\n\n        require(srcChain != 0, \"LayerZeroPacket: invalid packet\");\n\n        Buffer.buffer memory srcAddressBuffer;\n        srcAddressBuffer.init(sizeOfSrcAddress);\n        srcAddressBuffer.writeRawBytes(0, data, 106, sizeOfSrcAddress);\n\n        uint nonPayloadSize = sizeOfSrcAddress.add(32);// 2 + 2 + 8 + 20, 32 + 20 = 52 if sizeOfSrcAddress == 20\n        uint payloadSize = realSize.sub(nonPayloadSize);\n        Buffer.buffer memory payloadBuffer;\n        payloadBuffer.init(payloadSize);\n        payloadBuffer.writeRawBytes(0, data, nonPayloadSize.add(96), payloadSize);\n\n        return LayerZeroPacket.Packet(srcChain, dstChain, nonce, dstAddress, srcAddressBuffer.buf, ulnAddress, payloadBuffer.buf);\n    }\n\n    function getPacketV3(\n        bytes memory data,\n        uint sizeOfSrcAddress,\n        bytes32 ulnAddress\n    ) internal pure returns (LayerZeroPacket.Packet memory) {\n        // data def: abi.encodePacked(nonce, srcChain, srcAddress, dstChain, dstAddress, payload);\n        //              if from EVM\n        // 0 - 31       0 - 31          |  total bytes size\n        // 32 - 39      32 - 39         |  nonce\n        // 40 - 41      40 - 41         |  srcChainId\n        // 42 - P       42 - 61         |  srcAddress, where P = 41 + sizeOfSrcAddress,\n        // P+1 - P+2    62 - 63         |  dstChainId\n        // P+3 - P+22   64 - 83         |  dstAddress\n        // P+23 - END   84 - END        |  payload\n\n        // decode the packet\n        uint256 realSize = data.length;\n        uint nonPayloadSize = sizeOfSrcAddress.add(32);// 2 + 2 + 8 + 20, 32 + 20 = 52 if sizeOfSrcAddress == 20\n        require(realSize \u003e= nonPayloadSize, \"LayerZeroPacket: invalid packet\");\n        uint payloadSize = realSize - nonPayloadSize;\n\n        uint64 nonce;\n        uint16 srcChain;\n        uint16 dstChain;\n        address dstAddress;\n        assembly {\n            nonce := mload(add(data, 8)) // 40 - 32\n            srcChain := mload(add(data, 10)) // 42 - 32\n            dstChain := mload(add(data, add(12, sizeOfSrcAddress))) // P + 3 - 32 = 41 + size + 3 - 32 = 12 + size\n            dstAddress := mload(add(data, add(32, sizeOfSrcAddress))) // P + 23 - 32 = 41 + size + 23 - 32 = 32 + size\n        }\n\n        require(srcChain != 0, \"LayerZeroPacket: invalid packet\");\n\n        Buffer.buffer memory srcAddressBuffer;\n        srcAddressBuffer.init(sizeOfSrcAddress);\n        srcAddressBuffer.writeRawBytes(0, data, 42, sizeOfSrcAddress);\n\n        Buffer.buffer memory payloadBuffer;\n        if (payloadSize \u003e 0) {\n            payloadBuffer.init(payloadSize);\n            payloadBuffer.writeRawBytes(0, data, nonPayloadSize.add(32), payloadSize);\n        }\n\n        return LayerZeroPacket.Packet(srcChain, dstChain, nonce, dstAddress, srcAddressBuffer.buf, ulnAddress, payloadBuffer.buf);\n    }\n}\n"},"NonceContract.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity 0.7.6;\n\nimport \"./ILayerZeroEndpoint.sol\";\n\ncontract NonceContract {\n    ILayerZeroEndpoint public immutable endpoint;\n    // outboundNonce = [dstChainId][remoteAddress + localAddress]\n    mapping(uint16 =\u003e mapping(bytes =\u003e uint64)) public outboundNonce;\n\n    constructor(address _endpoint) {\n        endpoint = ILayerZeroEndpoint(_endpoint);\n    }\n\n    function increment(uint16 _chainId, address _ua, bytes calldata _path) external returns (uint64) {\n        require(endpoint.getSendLibraryAddress(_ua) == msg.sender, \"NonceContract: msg.sender is not valid sendlibrary\");\n        return ++outboundNonce[_chainId][_path];\n    }\n}\n"},"Ownable.sol":{"content":"// SPDX-License-Identifier: MIT\n\npragma solidity ^0.7.0;\n\nimport \"./Context.sol\";\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract Ownable is Context {\n    address private _owner;\n\n    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n    /**\n     * @dev Initializes the contract setting the deployer as the initial owner.\n     */\n    constructor () {\n        address msgSender = _msgSender();\n        _owner = msgSender;\n        emit OwnershipTransferred(address(0), msgSender);\n    }\n\n    /**\n     * @dev Returns the address of the current owner.\n     */\n    function owner() public view virtual returns (address) {\n        return _owner;\n    }\n\n    /**\n     * @dev Throws if called by any account other than the owner.\n     */\n    modifier onlyOwner() {\n        require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n        _;\n    }\n\n    /**\n     * @dev Leaves the contract without owner. It will not be possible to call\n     * `onlyOwner` functions anymore. Can only be called by the current owner.\n     *\n     * NOTE: Renouncing ownership will leave the contract without an owner,\n     * thereby removing any functionality that is only available to the owner.\n     */\n    function renounceOwnership() public virtual onlyOwner {\n        emit OwnershipTransferred(_owner, address(0));\n        _owner = address(0);\n    }\n\n    /**\n     * @dev Transfers ownership of the contract to a new account (`newOwner`).\n     * Can only be called by the current owner.\n     */\n    function transferOwnership(address newOwner) public virtual onlyOwner {\n        require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n        emit OwnershipTransferred(_owner, newOwner);\n        _owner = newOwner;\n    }\n}\n"},"ReentrancyGuard.sol":{"content":"// SPDX-License-Identifier: MIT\n\npragma solidity ^0.7.0;\n\n/**\n * @dev Contract module that helps prevent reentrant calls to a function.\n *\n * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier\n * available, which can be applied to functions to make sure there are no nested\n * (reentrant) calls to them.\n *\n * Note that because there is a single `nonReentrant` guard, functions marked as\n * `nonReentrant` may not call one another. This can be worked around by making\n * those functions `private`, and then adding `external` `nonReentrant` entry\n * points to them.\n *\n * TIP: If you would like to learn more about reentrancy and alternative ways\n * to protect against it, check out our blog post\n * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].\n */\nabstract contract ReentrancyGuard {\n    // Booleans are more expensive than uint256 or any type that takes up a full\n    // word because each write operation emits an extra SLOAD to first read the\n    // slot\u0027s contents, replace the bits taken up by the boolean, and then write\n    // back. This is the compiler\u0027s defense against contract upgrades and\n    // pointer aliasing, and it cannot be disabled.\n\n    // The values being non-zero value makes deployment a bit more expensive,\n    // but in exchange the refund on every call to nonReentrant will be lower in\n    // amount. Since refunds are capped to a percentage of the total\n    // transaction\u0027s gas, it is best to keep them low in cases like this one, to\n    // increase the likelihood of the full refund coming into effect.\n    uint256 private constant _NOT_ENTERED = 1;\n    uint256 private constant _ENTERED = 2;\n\n    uint256 private _status;\n\n    constructor () {\n        _status = _NOT_ENTERED;\n    }\n\n    /**\n     * @dev Prevents a contract from calling itself, directly or indirectly.\n     * Calling a `nonReentrant` function from another `nonReentrant`\n     * function is not supported. It is possible to prevent this from happening\n     * by making the `nonReentrant` function external, and make it call a\n     * `private` function that does the actual work.\n     */\n    modifier nonReentrant() {\n        // On the first call to nonReentrant, _notEntered will be true\n        require(_status != _ENTERED, \"ReentrancyGuard: reentrant call\");\n\n        // Any calls to nonReentrant after this point will fail\n        _status = _ENTERED;\n\n        _;\n\n        // By storing the original value once again, a refund is triggered (see\n        // https://eips.ethereum.org/EIPS/eip-2200)\n        _status = _NOT_ENTERED;\n    }\n}\n"},"SafeERC20.sol":{"content":"// SPDX-License-Identifier: MIT\n\npragma solidity ^0.7.0;\n\nimport \"./IERC20.sol\";\nimport \"./SafeMath.sol\";\nimport \"./Address.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20 {\n    using SafeMath for uint256;\n    using Address for address;\n\n    function safeTransfer(IERC20 token, address to, uint256 value) internal {\n        _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n    }\n\n    function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\n        _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n    }\n\n    /**\n     * @dev Deprecated. This function has issues similar to the ones found in\n     * {IERC20-approve}, and its usage is discouraged.\n     *\n     * Whenever possible, use {safeIncreaseAllowance} and\n     * {safeDecreaseAllowance} instead.\n     */\n    function safeApprove(IERC20 token, address spender, uint256 value) internal {\n        // safeApprove should only be called when setting an initial allowance,\n        // or when resetting it to zero. To increase and decrease it, use\n        // \u0027safeIncreaseAllowance\u0027 and \u0027safeDecreaseAllowance\u0027\n        // solhint-disable-next-line max-line-length\n        require((value == 0) || (token.allowance(address(this), spender) == 0),\n            \"SafeERC20: approve from non-zero to non-zero allowance\"\n        );\n        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n    }\n\n    function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n        uint256 newAllowance = token.allowance(address(this), spender).add(value);\n        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\n    }\n\n    function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n        uint256 newAllowance = token.allowance(address(this), spender).sub(value, \"SafeERC20: decreased allowance below zero\");\n        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\n    }\n\n    /**\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\n     * @param token The token targeted by the call.\n     * @param data The call data (encoded using abi.encode or one of its variants).\n     */\n    function _callOptionalReturn(IERC20 token, bytes memory data) private {\n        // We need to perform a low level call here, to bypass Solidity\u0027s return data size checking mechanism, since\n        // we\u0027re implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that\n        // the target address contains contract code and also asserts for success in the low-level call.\n\n        bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n        if (returndata.length \u003e 0) { // Return data is optional\n            // solhint-disable-next-line max-line-length\n            require(abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n        }\n    }\n}\n"},"SafeMath.sol":{"content":"// SPDX-License-Identifier: MIT\n\npragma solidity ^0.7.0;\n\n/**\n * @dev Wrappers over Solidity\u0027s arithmetic operations with added overflow\n * checks.\n *\n * Arithmetic operations in Solidity wrap on overflow. This can easily result\n * in bugs, because programmers usually assume that an overflow raises an\n * error, which is the standard behavior in high level programming languages.\n * `SafeMath` restores this intuition by reverting the transaction when an\n * operation overflows.\n *\n * Using this library instead of the unchecked operations eliminates an entire\n * class of bugs, so it\u0027s recommended to use it always.\n */\nlibrary SafeMath {\n    /**\n     * @dev Returns the addition of two unsigned integers, with an overflow flag.\n     *\n     * _Available since v3.4._\n     */\n    function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n        uint256 c = a + b;\n        if (c \u003c a) return (false, 0);\n        return (true, c);\n    }\n\n    /**\n     * @dev Returns the substraction of two unsigned integers, with an overflow flag.\n     *\n     * _Available since v3.4._\n     */\n    function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n        if (b \u003e a) return (false, 0);\n        return (true, a - b);\n    }\n\n    /**\n     * @dev Returns the multiplication of two unsigned integers, with an overflow flag.\n     *\n     * _Available since v3.4._\n     */\n    function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n        // Gas optimization: this is cheaper than requiring \u0027a\u0027 not being zero, but the\n        // benefit is lost if \u0027b\u0027 is also tested.\n        // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\n        if (a == 0) return (true, 0);\n        uint256 c = a * b;\n        if (c / a != b) return (false, 0);\n        return (true, c);\n    }\n\n    /**\n     * @dev Returns the division of two unsigned integers, with a division by zero flag.\n     *\n     * _Available since v3.4._\n     */\n    function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n        if (b == 0) return (false, 0);\n        return (true, a / b);\n    }\n\n    /**\n     * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.\n     *\n     * _Available since v3.4._\n     */\n    function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n        if (b == 0) return (false, 0);\n        return (true, a % b);\n    }\n\n    /**\n     * @dev Returns the addition of two unsigned integers, reverting on\n     * overflow.\n     *\n     * Counterpart to Solidity\u0027s `+` operator.\n     *\n     * Requirements:\n     *\n     * - Addition cannot overflow.\n     */\n    function add(uint256 a, uint256 b) internal pure returns (uint256) {\n        uint256 c = a + b;\n        require(c \u003e= a, \"SafeMath: addition overflow\");\n        return c;\n    }\n\n    /**\n     * @dev Returns the subtraction of two unsigned integers, reverting on\n     * overflow (when the result is negative).\n     *\n     * Counterpart to Solidity\u0027s `-` operator.\n     *\n     * Requirements:\n     *\n     * - Subtraction cannot overflow.\n     */\n    function sub(uint256 a, uint256 b) internal pure returns (uint256) {\n        require(b \u003c= a, \"SafeMath: subtraction overflow\");\n        return a - b;\n    }\n\n    /**\n     * @dev Returns the multiplication of two unsigned integers, reverting on\n     * overflow.\n     *\n     * Counterpart to Solidity\u0027s `*` operator.\n     *\n     * Requirements:\n     *\n     * - Multiplication cannot overflow.\n     */\n    function mul(uint256 a, uint256 b) internal pure returns (uint256) {\n        if (a == 0) return 0;\n        uint256 c = a * b;\n        require(c / a == b, \"SafeMath: multiplication overflow\");\n        return c;\n    }\n\n    /**\n     * @dev Returns the integer division of two unsigned integers, reverting on\n     * division by zero. The result is rounded towards zero.\n     *\n     * Counterpart to Solidity\u0027s `/` operator. Note: this function uses a\n     * `revert` opcode (which leaves remaining gas untouched) while Solidity\n     * uses an invalid opcode to revert (consuming all remaining gas).\n     *\n     * Requirements:\n     *\n     * - The divisor cannot be zero.\n     */\n    function div(uint256 a, uint256 b) internal pure returns (uint256) {\n        require(b \u003e 0, \"SafeMath: division by zero\");\n        return a / b;\n    }\n\n    /**\n     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\n     * reverting when dividing by zero.\n     *\n     * Counterpart to Solidity\u0027s `%` operator. This function uses a `revert`\n     * opcode (which leaves remaining gas untouched) while Solidity uses an\n     * invalid opcode to revert (consuming all remaining gas).\n     *\n     * Requirements:\n     *\n     * - The divisor cannot be zero.\n     */\n    function mod(uint256 a, uint256 b) internal pure returns (uint256) {\n        require(b \u003e 0, \"SafeMath: modulo by zero\");\n        return a % b;\n    }\n\n    /**\n     * @dev Returns the subtraction of two unsigned integers, reverting with custom message on\n     * overflow (when the result is negative).\n     *\n     * CAUTION: This function is deprecated because it requires allocating memory for the error\n     * message unnecessarily. For custom revert reasons use {trySub}.\n     *\n     * Counterpart to Solidity\u0027s `-` operator.\n     *\n     * Requirements:\n     *\n     * - Subtraction cannot overflow.\n     */\n    function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {\n        require(b \u003c= a, errorMessage);\n        return a - b;\n    }\n\n    /**\n     * @dev Returns the integer division of two unsigned integers, reverting with custom message on\n     * division by zero. The result is rounded towards zero.\n     *\n     * CAUTION: This function is deprecated because it requires allocating memory for the error\n     * message unnecessarily. For custom revert reasons use {tryDiv}.\n     *\n     * Counterpart to Solidity\u0027s `/` operator. Note: this function uses a\n     * `revert` opcode (which leaves remaining gas untouched) while Solidity\n     * uses an invalid opcode to revert (consuming all remaining gas).\n     *\n     * Requirements:\n     *\n     * - The divisor cannot be zero.\n     */\n    function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {\n        require(b \u003e 0, errorMessage);\n        return a / b;\n    }\n\n    /**\n     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\n     * reverting with custom message when dividing by zero.\n     *\n     * CAUTION: This function is deprecated because it requires allocating memory for the error\n     * message unnecessarily. For custom revert reasons use {tryMod}.\n     *\n     * Counterpart to Solidity\u0027s `%` operator. This function uses a `revert`\n     * opcode (which leaves remaining gas untouched) while Solidity uses an\n     * invalid opcode to revert (consuming all remaining gas).\n     *\n     * Requirements:\n     *\n     * - The divisor cannot be zero.\n     */\n    function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {\n        require(b \u003e 0, errorMessage);\n        return a % b;\n    }\n}\n"},"UltraLightNodeV2.sol":{"content":"// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity 0.7.6;\npragma abicoder v2;\n\nimport \"./Ownable.sol\";\nimport \"./SafeMath.sol\";\nimport \"./ReentrancyGuard.sol\";\nimport \"./IERC20.sol\";\nimport \"./SafeERC20.sol\";\n\nimport \"./ILayerZeroValidationLibrary.sol\";\nimport \"./ILayerZeroReceiver.sol\";\nimport \"./ILayerZeroTreasury.sol\";\nimport \"./ILayerZeroEndpoint.sol\";\n// v2\nimport \"./ILayerZeroMessagingLibraryV2.sol\";\nimport \"./ILayerZeroOracleV2.sol\";\nimport \"./ILayerZeroUltraLightNodeV2.sol\";\nimport \"./ILayerZeroRelayerV2.sol\";\nimport \"./NonceContract.sol\";\n\ncontract UltraLightNodeV2 is ILayerZeroMessagingLibraryV2, ILayerZeroUltraLightNodeV2, ReentrancyGuard, Ownable {\n    using SafeERC20 for IERC20;\n    using SafeMath for uint;\n\n    // Application config\n    uint public constant CONFIG_TYPE_INBOUND_PROOF_LIBRARY_VERSION = 1;\n    uint public constant CONFIG_TYPE_INBOUND_BLOCK_CONFIRMATIONS = 2;\n    uint public constant CONFIG_TYPE_RELAYER = 3;\n    uint public constant CONFIG_TYPE_OUTBOUND_PROOF_TYPE = 4;\n    uint public constant CONFIG_TYPE_OUTBOUND_BLOCK_CONFIRMATIONS = 5;\n    uint public constant CONFIG_TYPE_ORACLE = 6;\n\n    // Token and Contracts\n    IERC20 public layerZeroToken;\n    ILayerZeroTreasury public treasuryContract;\n\n    mapping(address =\u003e uint) public nativeFees;\n    uint public treasuryZROFees;\n\n    // User Application\n    mapping(address =\u003e mapping(uint16 =\u003e ApplicationConfiguration)) public appConfig; // app address =\u003e chainId =\u003e config\n    mapping(uint16 =\u003e ApplicationConfiguration) public defaultAppConfig; // default UA settings if no version specified\n    mapping(uint16 =\u003e mapping(uint16 =\u003e bytes)) public defaultAdapterParams;\n\n    // Validation\n    mapping(uint16 =\u003e mapping(uint16 =\u003e address)) public inboundProofLibrary; // chainId =\u003e library Id =\u003e inboundProofLibrary contract\n    mapping(uint16 =\u003e uint16) public maxInboundProofLibrary; // chainId =\u003e inboundProofLibrary\n    mapping(uint16 =\u003e mapping(uint16 =\u003e bool)) public supportedOutboundProof; // chainId =\u003e outboundProofType =\u003e enabled\n    mapping(uint16 =\u003e uint) public chainAddressSizeMap;\n    mapping(address =\u003e mapping(uint16 =\u003e mapping(bytes32 =\u003e mapping(bytes32 =\u003e uint)))) public hashLookup; //[oracle][srcChainId][blockhash][datahash] -\u003e confirmation\n    mapping(uint16 =\u003e bytes32) public ulnLookup; // remote ulns\n\n    ILayerZeroEndpoint public immutable endpoint;\n    uint16 public immutable localChainId;\n    NonceContract public immutable nonceContract;\n\n    constructor(address _endpoint, address _nonceContract, uint16 _localChainId) {\n        require(_endpoint != address(0x0), \"LayerZero: endpoint cannot be zero address\");\n        require(_nonceContract != address(0x0), \"LayerZero: nonceContract cannot be zero address\");\n        ILayerZeroEndpoint lzEndpoint = ILayerZeroEndpoint(_endpoint);\n        localChainId = _localChainId;\n        endpoint = lzEndpoint;\n        nonceContract = NonceContract(_nonceContract);\n    }\n\n    // only the endpoint can call SEND() and setConfig()\n    modifier onlyEndpoint() {\n        require(address(endpoint) == msg.sender, \"LayerZero: only endpoint\");\n        _;\n    }\n\n    //----------------------------------------------------------------------------------\n    // PROTOCOL\n    function validateTransactionProof(uint16 _srcChainId, address _dstAddress, uint _gasLimit, bytes32 _lookupHash, bytes32 _blockData, bytes calldata _transactionProof) external override {\n        // retrieve UA\u0027s configuration using the _dstAddress from arguments.\n        ApplicationConfiguration memory uaConfig = _getAppConfig(_srcChainId, _dstAddress);\n\n        // assert that the caller == UA\u0027s relayer\n        require(uaConfig.relayer == msg.sender, \"LayerZero: invalid relayer\");\n\n        LayerZeroPacket.Packet memory _packet;\n        uint remoteAddressSize = chainAddressSizeMap[_srcChainId];\n        require(remoteAddressSize != 0, \"LayerZero: incorrect remote address size\");\n        {\n            // assert that the data submitted by UA\u0027s oracle have no fewer confirmations than UA\u0027s configuration\n            uint storedConfirmations = hashLookup[uaConfig.oracle][_srcChainId][_lookupHash][_blockData];\n            require(storedConfirmations \u003e 0 \u0026\u0026 storedConfirmations \u003e= uaConfig.inboundBlockConfirmations, \"LayerZero: not enough block confirmations\");\n\n            // decode\n            address inboundProofLib = inboundProofLibrary[_srcChainId][uaConfig.inboundProofLibraryVersion];\n            _packet = ILayerZeroValidationLibrary(inboundProofLib).validateProof(_blockData, _transactionProof, remoteAddressSize);\n        }\n\n        // packet content assertion\n        require(ulnLookup[_srcChainId] == _packet.ulnAddress \u0026\u0026 _packet.ulnAddress != bytes32(0), \"LayerZero: invalid _packet.ulnAddress\");\n        require(_packet.srcChainId == _srcChainId, \"LayerZero: invalid srcChain Id\");\n        // failsafe because the remoteAddress size being passed into validateProof trims the address this should not hit\n        require(_packet.srcAddress.length == remoteAddressSize, \"LayerZero: invalid srcAddress size\");\n        require(_packet.dstChainId == localChainId, \"LayerZero: invalid dstChain Id\");\n        require(_packet.dstAddress == _dstAddress, \"LayerZero: invalid dstAddress\");\n\n        // if the dst is not a contract, then emit and return early. This will break inbound nonces, but this particular\n        // path is already broken and wont ever be able to deliver anyways\n        if (!_isContract(_dstAddress)) {\n            emit InvalidDst(_packet.srcChainId, _packet.srcAddress, _packet.dstAddress, _packet.nonce, keccak256(_packet.payload));\n            return;\n        }\n\n        bytes memory pathData = abi.encodePacked(_packet.srcAddress, _packet.dstAddress);\n        emit PacketReceived(_packet.srcChainId, _packet.srcAddress, _packet.dstAddress, _packet.nonce, keccak256(_packet.payload));\n        endpoint.receivePayload(_srcChainId, pathData, _dstAddress, _packet.nonce, _gasLimit, _packet.payload);\n    }\n\n    function send(address _ua, uint64, uint16 _dstChainId, bytes calldata _path, bytes calldata _payload, address payable _refundAddress, address _zroPaymentAddress, bytes calldata _adapterParams) external payable override onlyEndpoint {\n        address ua = _ua;\n        uint16 dstChainId = _dstChainId;\n        require(ulnLookup[dstChainId] != bytes32(0), \"LayerZero: dstChainId does not exist\");\n\n        bytes memory dstAddress;\n        uint64 nonce;\n        // code block for solving \u0027Stack Too Deep\u0027\n        {\n            uint chainAddressSize = chainAddressSizeMap[dstChainId];\n            // path = remoteAddress + localAddress\n            require(chainAddressSize != 0 \u0026\u0026 _path.length == 20 + chainAddressSize, \"LayerZero: incorrect remote address size\");\n            address srcInPath;\n            bytes memory path = _path; // copy to memory\n            assembly {\n                srcInPath := mload(add(add(path, 20), chainAddressSize)) // chainAddressSize + 20\n            }\n            require(ua == srcInPath, \"LayerZero: wrong path data\");\n            dstAddress = _path[0:chainAddressSize];\n            nonce = nonceContract.increment(dstChainId, ua, path);\n        }\n\n        bytes memory payload = _payload;\n        ApplicationConfiguration memory uaConfig = _getAppConfig(dstChainId, ua);\n\n        // compute all the fees\n        uint relayerFee = _handleRelayer(dstChainId, uaConfig, ua, payload.length, _adapterParams);\n        uint oracleFee = _handleOracle(dstChainId, uaConfig, ua);\n        uint nativeProtocolFee = _handleProtocolFee(relayerFee, oracleFee, ua, _zroPaymentAddress);\n\n        // total native fee, does not include ZRO protocol fee\n        uint totalNativeFee = relayerFee.add(oracleFee).add(nativeProtocolFee);\n\n        // assert the user has attached enough native token for this address\n        require(totalNativeFee \u003c= msg.value, \"LayerZero: not enough native for fees\");\n        // refund if they send too much\n        uint amount = msg.value.sub(totalNativeFee);\n        if (amount \u003e 0) {\n            (bool success, ) = _refundAddress.call{value: amount}(\"\");\n            require(success, \"LayerZero: failed to refund\");\n        }\n\n        // emit the data packet\n        bytes memory encodedPayload = abi.encodePacked(nonce, localChainId, ua, dstChainId, dstAddress, payload);\n        emit Packet(encodedPayload);\n    }\n\n    function _handleRelayer(uint16 _dstChainId, ApplicationConfiguration memory _uaConfig, address _ua, uint _payloadSize, bytes memory _adapterParams) internal returns (uint relayerFee) {\n        if (_adapterParams.length == 0) {\n            _adapterParams = defaultAdapterParams[_dstChainId][_uaConfig.outboundProofType];\n        }\n        address relayerAddress = _uaConfig.relayer;\n        ILayerZeroRelayerV2 relayer = ILayerZeroRelayerV2(relayerAddress);\n        relayerFee = relayer.assignJob(_dstChainId, _uaConfig.outboundProofType, _ua, _payloadSize, _adapterParams);\n\n        _creditNativeFee(relayerAddress, relayerFee);\n\n        // emit the param events\n        emit RelayerParams(_adapterParams, _uaConfig.outboundProofType);\n    }\n\n    function _handleOracle(uint16 _dstChainId, ApplicationConfiguration memory _uaConfig, address _ua) internal returns (uint oracleFee) {\n        address oracleAddress = _uaConfig.oracle;\n        oracleFee = ILayerZeroOracleV2(oracleAddress).assignJob(_dstChainId, _uaConfig.outboundProofType, _uaConfig.outboundBlockConfirmations, _ua);\n\n        _creditNativeFee(oracleAddress, oracleFee);\n    }\n\n    function _handleProtocolFee(uint _relayerFee, uint _oracleFee, address _ua, address _zroPaymentAddress) internal returns (uint protocolNativeFee) {\n        // if no ZRO token or not specifying a payment address, pay in native token\n        bool payInNative = _zroPaymentAddress == address(0x0) || address(layerZeroToken) == address(0x0);\n        uint protocolFee = treasuryContract.getFees(!payInNative, _relayerFee, _oracleFee);\n\n        if (protocolFee \u003e 0) {\n            if (payInNative) {\n                address treasuryAddress = address(treasuryContract);\n                _creditNativeFee(treasuryAddress, protocolFee);\n                protocolNativeFee = protocolFee;\n            } else {\n                // zro payment address must equal the ua or the tx.origin otherwise the transaction reverts\n                require(_zroPaymentAddress == _ua || _zroPaymentAddress == tx.origin, \"LayerZero: must be paid by sender or origin\");\n\n                // transfer the LayerZero token to this contract from the payee\n                layerZeroToken.safeTransferFrom(_zroPaymentAddress, address(this), protocolFee);\n\n                treasuryZROFees = treasuryZROFees.add(protocolFee);\n            }\n        }\n    }\n\n    function _creditNativeFee(address _receiver, uint _amount) internal {\n        nativeFees[_receiver] = nativeFees[_receiver].add(_amount);\n    }\n\n    // Can be called by any address to update a block header\n    // can only upload new block data or the same block data with more confirmations\n    function updateHash(uint16 _srcChainId, bytes32 _lookupHash, uint _confirmations, bytes32 _blockData) external override {\n        uint storedConfirmations = hashLookup[msg.sender][_srcChainId][_lookupHash][_blockData];\n\n        // if it has a record, requires a larger confirmation.\n        require(storedConfirmations \u003c _confirmations, \"LayerZero: oracle data can only update if it has more confirmations\");\n\n        // set the new information into storage\n        hashLookup[msg.sender][_srcChainId][_lookupHash][_blockData] = _confirmations;\n\n        emit HashReceived(_srcChainId, msg.sender, _lookupHash, _blockData, _confirmations);\n    }\n\n    //----------------------------------------------------------------------------------\n    // Other Library Interfaces\n\n    // default to DEFAULT setting if ZERO value\n    function getAppConfig(uint16 _remoteChainId, address _ua) external view override returns (ApplicationConfiguration memory) {\n        return _getAppConfig(_remoteChainId, _ua);\n    }\n\n    function _getAppConfig(uint16 _remoteChainId, address _ua) internal view returns (ApplicationConfiguration memory) {\n        ApplicationConfiguration memory config = appConfig[_ua][_remoteChainId];\n        ApplicationConfiguration storage defaultConfig = defaultAppConfig[_remoteChainId];\n\n        if (config.inboundProofLibraryVersion == 0) {\n            config.inboundProofLibraryVersion = defaultConfig.inboundProofLibraryVersion;\n        }\n\n        if (config.inboundBlockConfirmations == 0) {\n            config.inboundBlockConfirmations = defaultConfig.inboundBlockConfirmations;\n        }\n\n        if (config.relayer == address(0x0)) {\n            config.relayer = defaultConfig.relayer;\n        }\n\n        if (config.outboundProofType == 0) {\n            config.outboundProofType = defaultConfig.outboundProofType;\n        }\n\n        if (config.outboundBlockConfirmations == 0) {\n            config.outboundBlockConfirmations = defaultConfig.outboundBlockConfirmations;\n        }\n\n        if (config.oracle == address(0x0)) {\n            config.oracle = defaultConfig.oracle;\n        }\n\n        return config;\n    }\n\n    function setConfig(uint16 _remoteChainId, address _ua, uint _configType, bytes calldata _config) external override onlyEndpoint {\n        ApplicationConfiguration storage uaConfig = appConfig[_ua][_remoteChainId];\n        if (_configType == CONFIG_TYPE_INBOUND_PROOF_LIBRARY_VERSION) {\n            uint16 inboundProofLibraryVersion = abi.decode(_config, (uint16));\n            require(inboundProofLibraryVersion \u003c= maxInboundProofLibrary[_remoteChainId], \"LayerZero: invalid inbound proof library version\");\n            uaConfig.inboundProofLibraryVersion = inboundProofLibraryVersion;\n        } else if (_configType == CONFIG_TYPE_INBOUND_BLOCK_CONFIRMATIONS) {\n            uint64 blockConfirmations = abi.decode(_config, (uint64));\n            uaConfig.inboundBlockConfirmations = blockConfirmations;\n        } else if (_configType == CONFIG_TYPE_RELAYER) {\n            address relayer = abi.decode(_config, (address));\n            uaConfig.relayer = relayer;\n        } else if (_configType == CONFIG_TYPE_OUTBOUND_PROOF_TYPE) {\n            uint16 outboundProofType = abi.decode(_config, (uint16));\n            require(supportedOutboundProof[_remoteChainId][outboundProofType] || outboundProofType == 0, \"LayerZero: invalid outbound proof type\");\n            uaConfig.outboundProofType = outboundProofType;\n        } else if (_configType == CONFIG_TYPE_OUTBOUND_BLOCK_CONFIRMATIONS) {\n            uint64 blockConfirmations = abi.decode(_config, (uint64));\n            uaConfig.outboundBlockConfirmations = blockConfirmations;\n        } else if (_configType == CONFIG_TYPE_ORACLE) {\n            address oracle = abi.decode(_config, (address));\n            uaConfig.oracle = oracle;\n        } else {\n            revert(\"LayerZero: Invalid config type\");\n        }\n\n        emit AppConfigUpdated(_ua, _configType, _config);\n    }\n\n    function getConfig(uint16 _remoteChainId, address _ua, uint _configType) external view override returns (bytes memory) {\n        ApplicationConfiguration storage uaConfig = appConfig[_ua][_remoteChainId];\n\n        if (_configType == CONFIG_TYPE_INBOUND_PROOF_LIBRARY_VERSION) {\n            if (uaConfig.inboundProofLibraryVersion == 0) {\n                return abi.encode(defaultAppConfig[_remoteChainId].inboundProofLibraryVersion);\n            }\n            return abi.encode(uaConfig.inboundProofLibraryVersion);\n        } else if (_configType == CONFIG_TYPE_INBOUND_BLOCK_CONFIRMATIONS) {\n            if (uaConfig.inboundBlockConfirmations == 0) {\n                return abi.encode(defaultAppConfig[_remoteChainId].inboundBlockConfirmations);\n            }\n            return abi.encode(uaConfig.inboundBlockConfirmations);\n        } else if (_configType == CONFIG_TYPE_RELAYER) {\n            if (uaConfig.relayer == address(0x0)) {\n                return abi.encode(defaultAppConfig[_remoteChainId].relayer);\n            }\n            return abi.encode(uaConfig.relayer);\n        } else if (_configType == CONFIG_TYPE_OUTBOUND_PROOF_TYPE) {\n            if (uaConfig.outboundProofType == 0) {\n                return abi.encode(defaultAppConfig[_remoteChainId].outboundProofType);\n            }\n            return abi.encode(uaConfig.outboundProofType);\n        } else if (_configType == CONFIG_TYPE_OUTBOUND_BLOCK_CONFIRMATIONS) {\n            if (uaConfig.outboundBlockConfirmations == 0) {\n                return abi.encode(defaultAppConfig[_remoteChainId].outboundBlockConfirmations);\n            }\n            return abi.encode(uaConfig.outboundBlockConfirmations);\n        } else if (_configType == CONFIG_TYPE_ORACLE) {\n            if (uaConfig.oracle == address(0x0)) {\n                return abi.encode(defaultAppConfig[_remoteChainId].oracle);\n            }\n            return abi.encode(uaConfig.oracle);\n        } else {\n            revert(\"LayerZero: Invalid config type\");\n        }\n    }\n\n    // returns the native fee the UA pays to cover fees\n    function estimateFees(uint16 _dstChainId, address _ua, bytes calldata _payload, bool _payInZRO, bytes calldata _adapterParams) external view override returns (uint nativeFee, uint zroFee) {\n        ApplicationConfiguration memory uaConfig = _getAppConfig(_dstChainId, _ua);\n\n        // Relayer Fee\n        bytes memory adapterParams;\n        if (_adapterParams.length \u003e 0) {\n            adapterParams = _adapterParams;\n        } else {\n            adapterParams = defaultAdapterParams[_dstChainId][uaConfig.outboundProofType];\n        }\n        uint relayerFee = ILayerZeroRelayerV2(uaConfig.relayer).getFee(_dstChainId, uaConfig.outboundProofType, _ua, _payload.length, adapterParams);\n\n        // Oracle Fee\n        address ua = _ua; // stack too deep\n        uint oracleFee = ILayerZeroOracleV2(uaConfig.oracle).getFee(_dstChainId, uaConfig.outboundProofType, uaConfig.outboundBlockConfirmations, ua);\n\n        // LayerZero Fee\n        uint protocolFee = treasuryContract.getFees(_payInZRO, relayerFee, oracleFee);\n        _payInZRO ? zroFee = protocolFee : nativeFee = protocolFee;\n\n        // return the sum of fees\n        nativeFee = nativeFee.add(relayerFee).add(oracleFee);\n    }\n\n    //---------------------------------------------------------------------------\n    // Claim Fees\n\n    // universal withdraw ZRO token function\n    function withdrawZRO(address _to, uint _amount) external override nonReentrant {\n        require(msg.sender == address(treasuryContract), \"LayerZero: only treasury\");\n        treasuryZROFees = treasuryZROFees.sub(_amount);\n        layerZeroToken.safeTransfer(_to, _amount);\n        emit WithdrawZRO(msg.sender, _to, _amount);\n    }\n\n    // universal withdraw native token function.\n    // the source contract should perform all the authentication control\n    function withdrawNative(address payable _to, uint _amount) external override nonReentrant {\n        require(_to != address(0x0), \"LayerZero: _to cannot be zero address\");\n        nativeFees[msg.sender] = nativeFees[msg.sender].sub(_amount);\n\n        (bool success, ) = _to.call{value: _amount}(\"\");\n        require(success, \"LayerZero: withdraw failed\");\n        emit WithdrawNative(msg.sender, _to, _amount);\n    }\n\n    //---------------------------------------------------------------------------\n    // Owner calls, configuration only.\n    function setLayerZeroToken(address _layerZeroToken) external onlyOwner {\n        require(_layerZeroToken != address(0x0), \"LayerZero: _layerZeroToken cannot be zero address\");\n        layerZeroToken = IERC20(_layerZeroToken);\n        emit SetLayerZeroToken(_layerZeroToken);\n    }\n\n    function setTreasury(address _treasury) external onlyOwner {\n        require(_treasury != address(0x0), \"LayerZero: treasury cannot be zero address\");\n        treasuryContract = ILayerZeroTreasury(_treasury);\n        emit SetTreasury(_treasury);\n    }\n\n    function addInboundProofLibraryForChain(uint16 _chainId, address _library) external onlyOwner {\n        require(_library != address(0x0), \"LayerZero: library cannot be zero address\");\n        uint16 libId = maxInboundProofLibrary[_chainId];\n        require(libId \u003c 65535, \"LayerZero: can not add new library\");\n        maxInboundProofLibrary[_chainId] = ++libId;\n        inboundProofLibrary[_chainId][libId] = _library;\n        emit AddInboundProofLibraryForChain(_chainId, _library);\n    }\n\n    function enableSupportedOutboundProof(uint16 _chainId, uint16 _proofType) external onlyOwner {\n        supportedOutboundProof[_chainId][_proofType] = true;\n        emit EnableSupportedOutboundProof(_chainId, _proofType);\n    }\n\n    function setDefaultConfigForChainId(uint16 _chainId, uint16 _inboundProofLibraryVersion, uint64 _inboundBlockConfirmations, address _relayer, uint16 _outboundProofType, uint64 _outboundBlockConfirmations, address _oracle) external onlyOwner {\n        require(_inboundProofLibraryVersion \u003c= maxInboundProofLibrary[_chainId] \u0026\u0026 _inboundProofLibraryVersion \u003e 0, \"LayerZero: invalid inbound proof library version\");\n        require(_inboundBlockConfirmations \u003e 0, \"LayerZero: invalid inbound block confirmation\");\n        require(_relayer != address(0x0), \"LayerZero: invalid relayer address\");\n        require(supportedOutboundProof[_chainId][_outboundProofType], \"LayerZero: invalid outbound proof type\");\n        require(_outboundBlockConfirmations \u003e 0, \"LayerZero: invalid outbound block confirmation\");\n        require(_oracle != address(0x0), \"LayerZero: invalid oracle address\");\n        defaultAppConfig[_chainId] = ApplicationConfiguration(_inboundProofLibraryVersion, _inboundBlockConfirmations, _relayer, _outboundProofType, _outboundBlockConfirmations, _oracle);\n        emit SetDefaultConfigForChainId(_chainId, _inboundProofLibraryVersion, _inboundBlockConfirmations, _relayer, _outboundProofType, _outboundBlockConfirmations, _oracle);\n    }\n\n    function setDefaultAdapterParamsForChainId(uint16 _chainId, uint16 _proofType, bytes calldata _adapterParams) external onlyOwner {\n        defaultAdapterParams[_chainId][_proofType] = _adapterParams;\n        emit SetDefaultAdapterParamsForChainId(_chainId, _proofType, _adapterParams);\n    }\n\n    function setRemoteUln(uint16 _remoteChainId, bytes32 _remoteUln) external onlyOwner {\n        require(ulnLookup[_remoteChainId] == bytes32(0), \"LayerZero: remote uln already set\");\n        ulnLookup[_remoteChainId] = _remoteUln;\n        emit SetRemoteUln(_remoteChainId, _remoteUln);\n    }\n\n    function setChainAddressSize(uint16 _chainId, uint _size) external onlyOwner {\n        require(chainAddressSizeMap[_chainId] == 0, \"LayerZero: remote chain address size already set\");\n        chainAddressSizeMap[_chainId] = _size;\n        emit SetChainAddressSize(_chainId, _size);\n    }\n\n    //----------------------------------------------------------------------------------\n    // view functions\n\n    function accruedNativeFee(address _address) external view override returns (uint) {\n        return nativeFees[_address];\n    }\n\n    function getOutboundNonce(uint16 _chainId, bytes calldata _path) external view override returns (uint64) {\n        return nonceContract.outboundNonce(_chainId, _path);\n    }\n\n    function _isContract(address addr) internal view returns (bool) {\n        uint size;\n        assembly {\n            size := extcodesize(addr)\n        }\n        return size != 0;\n    }\n}\n"}}

                      File 5 of 9: DVN
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      import { IMessageLibManager } from "./IMessageLibManager.sol";
                      import { IMessagingComposer } from "./IMessagingComposer.sol";
                      import { IMessagingChannel } from "./IMessagingChannel.sol";
                      import { IMessagingContext } from "./IMessagingContext.sol";
                      struct MessagingParams {
                          uint32 dstEid;
                          bytes32 receiver;
                          bytes message;
                          bytes options;
                          bool payInLzToken;
                      }
                      struct MessagingReceipt {
                          bytes32 guid;
                          uint64 nonce;
                          MessagingFee fee;
                      }
                      struct MessagingFee {
                          uint256 nativeFee;
                          uint256 lzTokenFee;
                      }
                      struct Origin {
                          uint32 srcEid;
                          bytes32 sender;
                          uint64 nonce;
                      }
                      interface ILayerZeroEndpointV2 is IMessageLibManager, IMessagingComposer, IMessagingChannel, IMessagingContext {
                          event PacketSent(bytes encodedPayload, bytes options, address sendLibrary);
                          event PacketVerified(Origin origin, address receiver, bytes32 payloadHash);
                          event PacketDelivered(Origin origin, address receiver);
                          event LzReceiveAlert(
                              address indexed receiver,
                              address indexed executor,
                              Origin origin,
                              bytes32 guid,
                              uint256 gas,
                              uint256 value,
                              bytes message,
                              bytes extraData,
                              bytes reason
                          );
                          event LzTokenSet(address token);
                          event DelegateSet(address sender, address delegate);
                          function quote(MessagingParams calldata _params, address _sender) external view returns (MessagingFee memory);
                          function send(
                              MessagingParams calldata _params,
                              address _refundAddress
                          ) external payable returns (MessagingReceipt memory);
                          function verify(Origin calldata _origin, address _receiver, bytes32 _payloadHash) external;
                          function verifiable(Origin calldata _origin, address _receiver) external view returns (bool);
                          function initializable(Origin calldata _origin, address _receiver) external view returns (bool);
                          function lzReceive(
                              Origin calldata _origin,
                              address _receiver,
                              bytes32 _guid,
                              bytes calldata _message,
                              bytes calldata _extraData
                          ) external payable;
                          // oapp can burn messages partially by calling this function with its own business logic if messages are verified in order
                          function clear(address _oapp, Origin calldata _origin, bytes32 _guid, bytes calldata _message) external;
                          function setLzToken(address _lzToken) external;
                          function lzToken() external view returns (address);
                          function nativeToken() external view returns (address);
                          function setDelegate(address _delegate) external;
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      import { IERC165 } from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
                      import { SetConfigParam } from "./IMessageLibManager.sol";
                      enum MessageLibType {
                          Send,
                          Receive,
                          SendAndReceive
                      }
                      interface IMessageLib is IERC165 {
                          function setConfig(address _oapp, SetConfigParam[] calldata _config) external;
                          function getConfig(uint32 _eid, address _oapp, uint32 _configType) external view returns (bytes memory config);
                          function isSupportedEid(uint32 _eid) external view returns (bool);
                          // message libs of same major version are compatible
                          function version() external view returns (uint64 major, uint8 minor, uint8 endpointVersion);
                          function messageLibType() external view returns (MessageLibType);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      struct SetConfigParam {
                          uint32 eid;
                          uint32 configType;
                          bytes config;
                      }
                      interface IMessageLibManager {
                          struct Timeout {
                              address lib;
                              uint256 expiry;
                          }
                          event LibraryRegistered(address newLib);
                          event DefaultSendLibrarySet(uint32 eid, address newLib);
                          event DefaultReceiveLibrarySet(uint32 eid, address newLib);
                          event DefaultReceiveLibraryTimeoutSet(uint32 eid, address oldLib, uint256 expiry);
                          event SendLibrarySet(address sender, uint32 eid, address newLib);
                          event ReceiveLibrarySet(address receiver, uint32 eid, address newLib);
                          event ReceiveLibraryTimeoutSet(address receiver, uint32 eid, address oldLib, uint256 timeout);
                          function registerLibrary(address _lib) external;
                          function isRegisteredLibrary(address _lib) external view returns (bool);
                          function getRegisteredLibraries() external view returns (address[] memory);
                          function setDefaultSendLibrary(uint32 _eid, address _newLib) external;
                          function defaultSendLibrary(uint32 _eid) external view returns (address);
                          function setDefaultReceiveLibrary(uint32 _eid, address _newLib, uint256 _gracePeriod) external;
                          function defaultReceiveLibrary(uint32 _eid) external view returns (address);
                          function setDefaultReceiveLibraryTimeout(uint32 _eid, address _lib, uint256 _expiry) external;
                          function defaultReceiveLibraryTimeout(uint32 _eid) external view returns (address lib, uint256 expiry);
                          function isSupportedEid(uint32 _eid) external view returns (bool);
                          function isValidReceiveLibrary(address _receiver, uint32 _eid, address _lib) external view returns (bool);
                          /// ------------------- OApp interfaces -------------------
                          function setSendLibrary(address _oapp, uint32 _eid, address _newLib) external;
                          function getSendLibrary(address _sender, uint32 _eid) external view returns (address lib);
                          function isDefaultSendLibrary(address _sender, uint32 _eid) external view returns (bool);
                          function setReceiveLibrary(address _oapp, uint32 _eid, address _newLib, uint256 _gracePeriod) external;
                          function getReceiveLibrary(address _receiver, uint32 _eid) external view returns (address lib, bool isDefault);
                          function setReceiveLibraryTimeout(address _oapp, uint32 _eid, address _lib, uint256 _expiry) external;
                          function receiveLibraryTimeout(address _receiver, uint32 _eid) external view returns (address lib, uint256 expiry);
                          function setConfig(address _oapp, address _lib, SetConfigParam[] calldata _params) external;
                          function getConfig(
                              address _oapp,
                              address _lib,
                              uint32 _eid,
                              uint32 _configType
                          ) external view returns (bytes memory config);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      interface IMessagingChannel {
                          event InboundNonceSkipped(uint32 srcEid, bytes32 sender, address receiver, uint64 nonce);
                          event PacketNilified(uint32 srcEid, bytes32 sender, address receiver, uint64 nonce, bytes32 payloadHash);
                          event PacketBurnt(uint32 srcEid, bytes32 sender, address receiver, uint64 nonce, bytes32 payloadHash);
                          function eid() external view returns (uint32);
                          // this is an emergency function if a message cannot be verified for some reasons
                          // required to provide _nextNonce to avoid race condition
                          function skip(address _oapp, uint32 _srcEid, bytes32 _sender, uint64 _nonce) external;
                          function nilify(address _oapp, uint32 _srcEid, bytes32 _sender, uint64 _nonce, bytes32 _payloadHash) external;
                          function burn(address _oapp, uint32 _srcEid, bytes32 _sender, uint64 _nonce, bytes32 _payloadHash) external;
                          function nextGuid(address _sender, uint32 _dstEid, bytes32 _receiver) external view returns (bytes32);
                          function inboundNonce(address _receiver, uint32 _srcEid, bytes32 _sender) external view returns (uint64);
                          function outboundNonce(address _sender, uint32 _dstEid, bytes32 _receiver) external view returns (uint64);
                          function inboundPayloadHash(
                              address _receiver,
                              uint32 _srcEid,
                              bytes32 _sender,
                              uint64 _nonce
                          ) external view returns (bytes32);
                          function lazyInboundNonce(address _receiver, uint32 _srcEid, bytes32 _sender) external view returns (uint64);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      interface IMessagingComposer {
                          event ComposeSent(address from, address to, bytes32 guid, uint16 index, bytes message);
                          event ComposeDelivered(address from, address to, bytes32 guid, uint16 index);
                          event LzComposeAlert(
                              address indexed from,
                              address indexed to,
                              address indexed executor,
                              bytes32 guid,
                              uint16 index,
                              uint256 gas,
                              uint256 value,
                              bytes message,
                              bytes extraData,
                              bytes reason
                          );
                          function composeQueue(
                              address _from,
                              address _to,
                              bytes32 _guid,
                              uint16 _index
                          ) external view returns (bytes32 messageHash);
                          function sendCompose(address _to, bytes32 _guid, uint16 _index, bytes calldata _message) external;
                          function lzCompose(
                              address _from,
                              address _to,
                              bytes32 _guid,
                              uint16 _index,
                              bytes calldata _message,
                              bytes calldata _extraData
                          ) external payable;
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      interface IMessagingContext {
                          function isSendingMessage() external view returns (bool);
                          function getSendContext() external view returns (uint32 dstEid, address sender);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      import { MessagingFee } from "./ILayerZeroEndpointV2.sol";
                      import { IMessageLib } from "./IMessageLib.sol";
                      struct Packet {
                          uint64 nonce;
                          uint32 srcEid;
                          address sender;
                          uint32 dstEid;
                          bytes32 receiver;
                          bytes32 guid;
                          bytes message;
                      }
                      interface ISendLib is IMessageLib {
                          function send(
                              Packet calldata _packet,
                              bytes calldata _options,
                              bool _payInLzToken
                          ) external returns (MessagingFee memory, bytes memory encodedPacket);
                          function quote(
                              Packet calldata _packet,
                              bytes calldata _options,
                              bool _payInLzToken
                          ) external view returns (MessagingFee memory);
                          function setTreasury(address _treasury) external;
                          function withdrawFee(address _to, uint256 _amount) external;
                          function withdrawLzTokenFee(address _lzToken, address _to, uint256 _amount) external;
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      library AddressCast {
                          error AddressCast_InvalidSizeForAddress();
                          error AddressCast_InvalidAddress();
                          function toBytes32(bytes calldata _addressBytes) internal pure returns (bytes32 result) {
                              if (_addressBytes.length > 32) revert AddressCast_InvalidAddress();
                              result = bytes32(_addressBytes);
                              unchecked {
                                  uint256 offset = 32 - _addressBytes.length;
                                  result = result >> (offset * 8);
                              }
                          }
                          function toBytes32(address _address) internal pure returns (bytes32 result) {
                              result = bytes32(uint256(uint160(_address)));
                          }
                          function toBytes(bytes32 _addressBytes32, uint256 _size) internal pure returns (bytes memory result) {
                              if (_size == 0 || _size > 32) revert AddressCast_InvalidSizeForAddress();
                              result = new bytes(_size);
                              unchecked {
                                  uint256 offset = 256 - _size * 8;
                                  assembly {
                                      mstore(add(result, 32), shl(offset, _addressBytes32))
                                  }
                              }
                          }
                          function toAddress(bytes32 _addressBytes32) internal pure returns (address result) {
                              result = address(uint160(uint256(_addressBytes32)));
                          }
                          function toAddress(bytes calldata _addressBytes) internal pure returns (address result) {
                              if (_addressBytes.length != 20) revert AddressCast_InvalidAddress();
                              result = address(bytes20(_addressBytes));
                          }
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      library CalldataBytesLib {
                          function toU8(bytes calldata _bytes, uint256 _start) internal pure returns (uint8) {
                              return uint8(_bytes[_start]);
                          }
                          function toU16(bytes calldata _bytes, uint256 _start) internal pure returns (uint16) {
                              unchecked {
                                  uint256 end = _start + 2;
                                  return uint16(bytes2(_bytes[_start:end]));
                              }
                          }
                          function toU32(bytes calldata _bytes, uint256 _start) internal pure returns (uint32) {
                              unchecked {
                                  uint256 end = _start + 4;
                                  return uint32(bytes4(_bytes[_start:end]));
                              }
                          }
                          function toU64(bytes calldata _bytes, uint256 _start) internal pure returns (uint64) {
                              unchecked {
                                  uint256 end = _start + 8;
                                  return uint64(bytes8(_bytes[_start:end]));
                              }
                          }
                          function toU128(bytes calldata _bytes, uint256 _start) internal pure returns (uint128) {
                              unchecked {
                                  uint256 end = _start + 16;
                                  return uint128(bytes16(_bytes[_start:end]));
                              }
                          }
                          function toU256(bytes calldata _bytes, uint256 _start) internal pure returns (uint256) {
                              unchecked {
                                  uint256 end = _start + 32;
                                  return uint256(bytes32(_bytes[_start:end]));
                              }
                          }
                          function toAddr(bytes calldata _bytes, uint256 _start) internal pure returns (address) {
                              unchecked {
                                  uint256 end = _start + 20;
                                  return address(bytes20(_bytes[_start:end]));
                              }
                          }
                          function toB32(bytes calldata _bytes, uint256 _start) internal pure returns (bytes32) {
                              unchecked {
                                  uint256 end = _start + 32;
                                  return bytes32(_bytes[_start:end]);
                              }
                          }
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      import { SafeERC20 } from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
                      import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
                      library Transfer {
                          using SafeERC20 for IERC20;
                          address internal constant ADDRESS_ZERO = address(0);
                          error Transfer_NativeFailed(address _to, uint256 _value);
                          error Transfer_ToAddressIsZero();
                          function native(address _to, uint256 _value) internal {
                              if (_to == ADDRESS_ZERO) revert Transfer_ToAddressIsZero();
                              (bool success, ) = _to.call{ value: _value }("");
                              if (!success) revert Transfer_NativeFailed(_to, _value);
                          }
                          function token(address _token, address _to, uint256 _value) internal {
                              if (_to == ADDRESS_ZERO) revert Transfer_ToAddressIsZero();
                              IERC20(_token).safeTransfer(_to, _value);
                          }
                          function nativeOrToken(address _token, address _to, uint256 _value) internal {
                              if (_token == ADDRESS_ZERO) {
                                  native(_to, _value);
                              } else {
                                  token(_token, _to, _value);
                              }
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // modified from https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/structs/BitMaps.sol
                      pragma solidity ^0.8.20;
                      type BitMap256 is uint256;
                      using BitMaps for BitMap256 global;
                      library BitMaps {
                          /**
                           * @dev Returns whether the bit at `index` is set.
                           */
                          function get(BitMap256 bitmap, uint8 index) internal pure returns (bool) {
                              uint256 mask = 1 << index;
                              return BitMap256.unwrap(bitmap) & mask != 0;
                          }
                          /**
                           * @dev Sets the bit at `index`.
                           */
                          function set(BitMap256 bitmap, uint8 index) internal pure returns (BitMap256) {
                              uint256 mask = 1 << index;
                              return BitMap256.wrap(BitMap256.unwrap(bitmap) | mask);
                          }
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      import { CalldataBytesLib } from "../../libs/CalldataBytesLib.sol";
                      library ExecutorOptions {
                          using CalldataBytesLib for bytes;
                          uint8 internal constant WORKER_ID = 1;
                          uint8 internal constant OPTION_TYPE_LZRECEIVE = 1;
                          uint8 internal constant OPTION_TYPE_NATIVE_DROP = 2;
                          uint8 internal constant OPTION_TYPE_LZCOMPOSE = 3;
                          uint8 internal constant OPTION_TYPE_ORDERED_EXECUTION = 4;
                          error Executor_InvalidLzReceiveOption();
                          error Executor_InvalidNativeDropOption();
                          error Executor_InvalidLzComposeOption();
                          /// @dev decode the next executor option from the options starting from the specified cursor
                          /// @param _options [executor_id][executor_option][executor_id][executor_option]...
                          ///        executor_option = [option_size][option_type][option]
                          ///        option_size = len(option_type) + len(option)
                          ///        executor_id: uint8, option_size: uint16, option_type: uint8, option: bytes
                          /// @param _cursor the cursor to start decoding from
                          /// @return optionType the type of the option
                          /// @return option the option of the executor
                          /// @return cursor the cursor to start decoding the next executor option
                          function nextExecutorOption(
                              bytes calldata _options,
                              uint256 _cursor
                          ) internal pure returns (uint8 optionType, bytes calldata option, uint256 cursor) {
                              unchecked {
                                  // skip worker id
                                  cursor = _cursor + 1;
                                  // read option size
                                  uint16 size = _options.toU16(cursor);
                                  cursor += 2;
                                  // read option type
                                  optionType = _options.toU8(cursor);
                                  // startCursor and endCursor are used to slice the option from _options
                                  uint256 startCursor = cursor + 1; // skip option type
                                  uint256 endCursor = cursor + size;
                                  option = _options[startCursor:endCursor];
                                  cursor += size;
                              }
                          }
                          function decodeLzReceiveOption(bytes calldata _option) internal pure returns (uint128 gas, uint128 value) {
                              if (_option.length != 16 && _option.length != 32) revert Executor_InvalidLzReceiveOption();
                              gas = _option.toU128(0);
                              value = _option.length == 32 ? _option.toU128(16) : 0;
                          }
                          function decodeNativeDropOption(bytes calldata _option) internal pure returns (uint128 amount, bytes32 receiver) {
                              if (_option.length != 48) revert Executor_InvalidNativeDropOption();
                              amount = _option.toU128(0);
                              receiver = _option.toB32(16);
                          }
                          function decodeLzComposeOption(
                              bytes calldata _option
                          ) internal pure returns (uint16 index, uint128 gas, uint128 value) {
                              if (_option.length != 18 && _option.length != 34) revert Executor_InvalidLzComposeOption();
                              index = _option.toU16(0);
                              gas = _option.toU128(2);
                              value = _option.length == 34 ? _option.toU128(18) : 0;
                          }
                          function encodeLzReceiveOption(uint128 _gas, uint128 _value) internal pure returns (bytes memory) {
                              return _value == 0 ? abi.encodePacked(_gas) : abi.encodePacked(_gas, _value);
                          }
                          function encodeNativeDropOption(uint128 _amount, bytes32 _receiver) internal pure returns (bytes memory) {
                              return abi.encodePacked(_amount, _receiver);
                          }
                          function encodeLzComposeOption(uint16 _index, uint128 _gas, uint128 _value) internal pure returns (bytes memory) {
                              return _value == 0 ? abi.encodePacked(_index, _gas) : abi.encodePacked(_index, _gas, _value);
                          }
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      import { Packet } from "../../interfaces/ISendLib.sol";
                      import { AddressCast } from "../../libs/AddressCast.sol";
                      library PacketV1Codec {
                          using AddressCast for address;
                          using AddressCast for bytes32;
                          uint8 internal constant PACKET_VERSION = 1;
                          // header (version + nonce + path)
                          // version
                          uint256 private constant PACKET_VERSION_OFFSET = 0;
                          //    nonce
                          uint256 private constant NONCE_OFFSET = 1;
                          //    path
                          uint256 private constant SRC_EID_OFFSET = 9;
                          uint256 private constant SENDER_OFFSET = 13;
                          uint256 private constant DST_EID_OFFSET = 45;
                          uint256 private constant RECEIVER_OFFSET = 49;
                          // payload (guid + message)
                          uint256 private constant GUID_OFFSET = 81; // keccak256(nonce + path)
                          uint256 private constant MESSAGE_OFFSET = 113;
                          function encode(Packet memory _packet) internal pure returns (bytes memory encodedPacket) {
                              encodedPacket = abi.encodePacked(
                                  PACKET_VERSION,
                                  _packet.nonce,
                                  _packet.srcEid,
                                  _packet.sender.toBytes32(),
                                  _packet.dstEid,
                                  _packet.receiver,
                                  _packet.guid,
                                  _packet.message
                              );
                          }
                          function encodePacketHeader(Packet memory _packet) internal pure returns (bytes memory) {
                              return
                                  abi.encodePacked(
                                      PACKET_VERSION,
                                      _packet.nonce,
                                      _packet.srcEid,
                                      _packet.sender.toBytes32(),
                                      _packet.dstEid,
                                      _packet.receiver
                                  );
                          }
                          function encodePayload(Packet memory _packet) internal pure returns (bytes memory) {
                              return abi.encodePacked(_packet.guid, _packet.message);
                          }
                          function header(bytes calldata _packet) internal pure returns (bytes calldata) {
                              return _packet[0:GUID_OFFSET];
                          }
                          function version(bytes calldata _packet) internal pure returns (uint8) {
                              return uint8(bytes1(_packet[PACKET_VERSION_OFFSET:NONCE_OFFSET]));
                          }
                          function nonce(bytes calldata _packet) internal pure returns (uint64) {
                              return uint64(bytes8(_packet[NONCE_OFFSET:SRC_EID_OFFSET]));
                          }
                          function srcEid(bytes calldata _packet) internal pure returns (uint32) {
                              return uint32(bytes4(_packet[SRC_EID_OFFSET:SENDER_OFFSET]));
                          }
                          function sender(bytes calldata _packet) internal pure returns (bytes32) {
                              return bytes32(_packet[SENDER_OFFSET:DST_EID_OFFSET]);
                          }
                          function senderAddressB20(bytes calldata _packet) internal pure returns (address) {
                              return sender(_packet).toAddress();
                          }
                          function dstEid(bytes calldata _packet) internal pure returns (uint32) {
                              return uint32(bytes4(_packet[DST_EID_OFFSET:RECEIVER_OFFSET]));
                          }
                          function receiver(bytes calldata _packet) internal pure returns (bytes32) {
                              return bytes32(_packet[RECEIVER_OFFSET:GUID_OFFSET]);
                          }
                          function receiverB20(bytes calldata _packet) internal pure returns (address) {
                              return receiver(_packet).toAddress();
                          }
                          function guid(bytes calldata _packet) internal pure returns (bytes32) {
                              return bytes32(_packet[GUID_OFFSET:MESSAGE_OFFSET]);
                          }
                          function message(bytes calldata _packet) internal pure returns (bytes calldata) {
                              return bytes(_packet[MESSAGE_OFFSET:]);
                          }
                          function payload(bytes calldata _packet) internal pure returns (bytes calldata) {
                              return bytes(_packet[GUID_OFFSET:]);
                          }
                          function payloadHash(bytes calldata _packet) internal pure returns (bytes32) {
                              return keccak256(payload(_packet));
                          }
                      }
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity >=0.7.0;
                      pragma abicoder v2;
                      interface ILayerZeroUltraLightNodeV2 {
                          // Relayer functions
                          function validateTransactionProof(
                              uint16 _srcChainId,
                              address _dstAddress,
                              uint _gasLimit,
                              bytes32 _lookupHash,
                              bytes32 _blockData,
                              bytes calldata _transactionProof
                          ) external;
                          // an Oracle delivers the block data using updateHash()
                          function updateHash(uint16 _srcChainId, bytes32 _lookupHash, uint _confirmations, bytes32 _blockData) external;
                          // can only withdraw the receivable of the msg.sender
                          function withdrawNative(address payable _to, uint _amount) external;
                          function withdrawZRO(address _to, uint _amount) external;
                          // view functions
                          function getAppConfig(
                              uint16 _remoteChainId,
                              address _userApplicationAddress
                          ) external view returns (ApplicationConfiguration memory);
                          function accruedNativeFee(address _address) external view returns (uint);
                          struct ApplicationConfiguration {
                              uint16 inboundProofLibraryVersion;
                              uint64 inboundBlockConfirmations;
                              address relayer;
                              uint16 outboundProofType;
                              uint64 outboundBlockConfirmations;
                              address oracle;
                          }
                          event HashReceived(
                              uint16 indexed srcChainId,
                              address indexed oracle,
                              bytes32 lookupHash,
                              bytes32 blockData,
                              uint confirmations
                          );
                          event RelayerParams(bytes adapterParams, uint16 outboundProofType);
                          event Packet(bytes payload);
                          event InvalidDst(
                              uint16 indexed srcChainId,
                              bytes srcAddress,
                              address indexed dstAddress,
                              uint64 nonce,
                              bytes32 payloadHash
                          );
                          event PacketReceived(
                              uint16 indexed srcChainId,
                              bytes srcAddress,
                              address indexed dstAddress,
                              uint64 nonce,
                              bytes32 payloadHash
                          );
                          event AppConfigUpdated(address indexed userApplication, uint indexed configType, bytes newConfig);
                          event AddInboundProofLibraryForChain(uint16 indexed chainId, address lib);
                          event EnableSupportedOutboundProof(uint16 indexed chainId, uint16 proofType);
                          event SetChainAddressSize(uint16 indexed chainId, uint size);
                          event SetDefaultConfigForChainId(
                              uint16 indexed chainId,
                              uint16 inboundProofLib,
                              uint64 inboundBlockConfirm,
                              address relayer,
                              uint16 outboundProofType,
                              uint64 outboundBlockConfirm,
                              address oracle
                          );
                          event SetDefaultAdapterParamsForChainId(uint16 indexed chainId, uint16 indexed proofType, bytes adapterParams);
                          event SetLayerZeroToken(address indexed tokenAddress);
                          event SetRemoteUln(uint16 indexed chainId, bytes32 uln);
                          event SetTreasury(address indexed treasuryAddress);
                          event WithdrawZRO(address indexed msgSender, address indexed to, uint amount);
                          event WithdrawNative(address indexed msgSender, address indexed to, uint amount);
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.0) (access/AccessControl.sol)
                      pragma solidity ^0.8.0;
                      import "./IAccessControl.sol";
                      import "../utils/Context.sol";
                      import "../utils/Strings.sol";
                      import "../utils/introspection/ERC165.sol";
                      /**
                       * @dev Contract module that allows children to implement role-based access
                       * control mechanisms. This is a lightweight version that doesn't allow enumerating role
                       * members except through off-chain means by accessing the contract event logs. Some
                       * applications may benefit from on-chain enumerability, for those cases see
                       * {AccessControlEnumerable}.
                       *
                       * Roles are referred to by their `bytes32` identifier. These should be exposed
                       * in the external API and be unique. The best way to achieve this is by
                       * using `public constant` hash digests:
                       *
                       * ```solidity
                       * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
                       * ```
                       *
                       * Roles can be used to represent a set of permissions. To restrict access to a
                       * function call, use {hasRole}:
                       *
                       * ```solidity
                       * function foo() public {
                       *     require(hasRole(MY_ROLE, msg.sender));
                       *     ...
                       * }
                       * ```
                       *
                       * Roles can be granted and revoked dynamically via the {grantRole} and
                       * {revokeRole} functions. Each role has an associated admin role, and only
                       * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
                       *
                       * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
                       * that only accounts with this role will be able to grant or revoke other
                       * roles. More complex role relationships can be created by using
                       * {_setRoleAdmin}.
                       *
                       * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
                       * grant and revoke this role. Extra precautions should be taken to secure
                       * accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules}
                       * to enforce additional security measures for this role.
                       */
                      abstract contract AccessControl is Context, IAccessControl, ERC165 {
                          struct RoleData {
                              mapping(address => bool) members;
                              bytes32 adminRole;
                          }
                          mapping(bytes32 => RoleData) private _roles;
                          bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
                          /**
                           * @dev Modifier that checks that an account has a specific role. Reverts
                           * with a standardized message including the required role.
                           *
                           * The format of the revert reason is given by the following regular expression:
                           *
                           *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
                           *
                           * _Available since v4.1._
                           */
                          modifier onlyRole(bytes32 role) {
                              _checkRole(role);
                              _;
                          }
                          /**
                           * @dev See {IERC165-supportsInterface}.
                           */
                          function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                              return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);
                          }
                          /**
                           * @dev Returns `true` if `account` has been granted `role`.
                           */
                          function hasRole(bytes32 role, address account) public view virtual override returns (bool) {
                              return _roles[role].members[account];
                          }
                          /**
                           * @dev Revert with a standard message if `_msgSender()` is missing `role`.
                           * Overriding this function changes the behavior of the {onlyRole} modifier.
                           *
                           * Format of the revert message is described in {_checkRole}.
                           *
                           * _Available since v4.6._
                           */
                          function _checkRole(bytes32 role) internal view virtual {
                              _checkRole(role, _msgSender());
                          }
                          /**
                           * @dev Revert with a standard message if `account` is missing `role`.
                           *
                           * The format of the revert reason is given by the following regular expression:
                           *
                           *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
                           */
                          function _checkRole(bytes32 role, address account) internal view virtual {
                              if (!hasRole(role, account)) {
                                  revert(
                                      string(
                                          abi.encodePacked(
                                              "AccessControl: account ",
                                              Strings.toHexString(account),
                                              " is missing role ",
                                              Strings.toHexString(uint256(role), 32)
                                          )
                                      )
                                  );
                              }
                          }
                          /**
                           * @dev Returns the admin role that controls `role`. See {grantRole} and
                           * {revokeRole}.
                           *
                           * To change a role's admin, use {_setRoleAdmin}.
                           */
                          function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) {
                              return _roles[role].adminRole;
                          }
                          /**
                           * @dev Grants `role` to `account`.
                           *
                           * If `account` had not been already granted `role`, emits a {RoleGranted}
                           * event.
                           *
                           * Requirements:
                           *
                           * - the caller must have ``role``'s admin role.
                           *
                           * May emit a {RoleGranted} event.
                           */
                          function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
                              _grantRole(role, account);
                          }
                          /**
                           * @dev Revokes `role` from `account`.
                           *
                           * If `account` had been granted `role`, emits a {RoleRevoked} event.
                           *
                           * Requirements:
                           *
                           * - the caller must have ``role``'s admin role.
                           *
                           * May emit a {RoleRevoked} event.
                           */
                          function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
                              _revokeRole(role, account);
                          }
                          /**
                           * @dev Revokes `role` from the calling account.
                           *
                           * Roles are often managed via {grantRole} and {revokeRole}: this function's
                           * purpose is to provide a mechanism for accounts to lose their privileges
                           * if they are compromised (such as when a trusted device is misplaced).
                           *
                           * If the calling account had been revoked `role`, emits a {RoleRevoked}
                           * event.
                           *
                           * Requirements:
                           *
                           * - the caller must be `account`.
                           *
                           * May emit a {RoleRevoked} event.
                           */
                          function renounceRole(bytes32 role, address account) public virtual override {
                              require(account == _msgSender(), "AccessControl: can only renounce roles for self");
                              _revokeRole(role, account);
                          }
                          /**
                           * @dev Grants `role` to `account`.
                           *
                           * If `account` had not been already granted `role`, emits a {RoleGranted}
                           * event. Note that unlike {grantRole}, this function doesn't perform any
                           * checks on the calling account.
                           *
                           * May emit a {RoleGranted} event.
                           *
                           * [WARNING]
                           * ====
                           * This function should only be called from the constructor when setting
                           * up the initial roles for the system.
                           *
                           * Using this function in any other way is effectively circumventing the admin
                           * system imposed by {AccessControl}.
                           * ====
                           *
                           * NOTE: This function is deprecated in favor of {_grantRole}.
                           */
                          function _setupRole(bytes32 role, address account) internal virtual {
                              _grantRole(role, account);
                          }
                          /**
                           * @dev Sets `adminRole` as ``role``'s admin role.
                           *
                           * Emits a {RoleAdminChanged} event.
                           */
                          function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
                              bytes32 previousAdminRole = getRoleAdmin(role);
                              _roles[role].adminRole = adminRole;
                              emit RoleAdminChanged(role, previousAdminRole, adminRole);
                          }
                          /**
                           * @dev Grants `role` to `account`.
                           *
                           * Internal function without access restriction.
                           *
                           * May emit a {RoleGranted} event.
                           */
                          function _grantRole(bytes32 role, address account) internal virtual {
                              if (!hasRole(role, account)) {
                                  _roles[role].members[account] = true;
                                  emit RoleGranted(role, account, _msgSender());
                              }
                          }
                          /**
                           * @dev Revokes `role` from `account`.
                           *
                           * Internal function without access restriction.
                           *
                           * May emit a {RoleRevoked} event.
                           */
                          function _revokeRole(bytes32 role, address account) internal virtual {
                              if (hasRole(role, account)) {
                                  _roles[role].members[account] = false;
                                  emit RoleRevoked(role, account, _msgSender());
                              }
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)
                      pragma solidity ^0.8.0;
                      /**
                       * @dev External interface of AccessControl declared to support ERC165 detection.
                       */
                      interface IAccessControl {
                          /**
                           * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
                           *
                           * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
                           * {RoleAdminChanged} not being emitted signaling this.
                           *
                           * _Available since v3.1._
                           */
                          event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
                          /**
                           * @dev Emitted when `account` is granted `role`.
                           *
                           * `sender` is the account that originated the contract call, an admin role
                           * bearer except when using {AccessControl-_setupRole}.
                           */
                          event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);
                          /**
                           * @dev Emitted when `account` is revoked `role`.
                           *
                           * `sender` is the account that originated the contract call:
                           *   - if using `revokeRole`, it is the admin role bearer
                           *   - if using `renounceRole`, it is the role bearer (i.e. `account`)
                           */
                          event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);
                          /**
                           * @dev Returns `true` if `account` has been granted `role`.
                           */
                          function hasRole(bytes32 role, address account) external view returns (bool);
                          /**
                           * @dev Returns the admin role that controls `role`. See {grantRole} and
                           * {revokeRole}.
                           *
                           * To change a role's admin, use {AccessControl-_setRoleAdmin}.
                           */
                          function getRoleAdmin(bytes32 role) external view returns (bytes32);
                          /**
                           * @dev Grants `role` to `account`.
                           *
                           * If `account` had not been already granted `role`, emits a {RoleGranted}
                           * event.
                           *
                           * Requirements:
                           *
                           * - the caller must have ``role``'s admin role.
                           */
                          function grantRole(bytes32 role, address account) external;
                          /**
                           * @dev Revokes `role` from `account`.
                           *
                           * If `account` had been granted `role`, emits a {RoleRevoked} event.
                           *
                           * Requirements:
                           *
                           * - the caller must have ``role``'s admin role.
                           */
                          function revokeRole(bytes32 role, address account) external;
                          /**
                           * @dev Revokes `role` from the calling account.
                           *
                           * Roles are often managed via {grantRole} and {revokeRole}: this function's
                           * purpose is to provide a mechanism for accounts to lose their privileges
                           * if they are compromised (such as when a trusted device is misplaced).
                           *
                           * If the calling account had been granted `role`, emits a {RoleRevoked}
                           * event.
                           *
                           * Requirements:
                           *
                           * - the caller must be `account`.
                           */
                          function renounceRole(bytes32 role, address account) external;
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)
                      pragma solidity ^0.8.0;
                      import "../utils/Context.sol";
                      /**
                       * @dev Contract module which provides a basic access control mechanism, where
                       * there is an account (an owner) that can be granted exclusive access to
                       * specific functions.
                       *
                       * By default, the owner account will be the one that deploys the contract. This
                       * can later be changed with {transferOwnership}.
                       *
                       * This module is used through inheritance. It will make available the modifier
                       * `onlyOwner`, which can be applied to your functions to restrict their use to
                       * the owner.
                       */
                      abstract contract Ownable is Context {
                          address private _owner;
                          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                          /**
                           * @dev Initializes the contract setting the deployer as the initial owner.
                           */
                          constructor() {
                              _transferOwnership(_msgSender());
                          }
                          /**
                           * @dev Throws if called by any account other than the owner.
                           */
                          modifier onlyOwner() {
                              _checkOwner();
                              _;
                          }
                          /**
                           * @dev Returns the address of the current owner.
                           */
                          function owner() public view virtual returns (address) {
                              return _owner;
                          }
                          /**
                           * @dev Throws if the sender is not the owner.
                           */
                          function _checkOwner() internal view virtual {
                              require(owner() == _msgSender(), "Ownable: caller is not the owner");
                          }
                          /**
                           * @dev Leaves the contract without owner. It will not be possible to call
                           * `onlyOwner` functions. Can only be called by the current owner.
                           *
                           * NOTE: Renouncing ownership will leave the contract without an owner,
                           * thereby disabling any functionality that is only available to the owner.
                           */
                          function renounceOwnership() public virtual onlyOwner {
                              _transferOwnership(address(0));
                          }
                          /**
                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                           * Can only be called by the current owner.
                           */
                          function transferOwnership(address newOwner) public virtual onlyOwner {
                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                              _transferOwnership(newOwner);
                          }
                          /**
                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                           * Internal function without access restriction.
                           */
                          function _transferOwnership(address newOwner) internal virtual {
                              address oldOwner = _owner;
                              _owner = newOwner;
                              emit OwnershipTransferred(oldOwner, newOwner);
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)
                      pragma solidity ^0.8.0;
                      import "../utils/Context.sol";
                      /**
                       * @dev Contract module which allows children to implement an emergency stop
                       * mechanism that can be triggered by an authorized account.
                       *
                       * This module is used through inheritance. It will make available the
                       * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
                       * the functions of your contract. Note that they will not be pausable by
                       * simply including this module, only once the modifiers are put in place.
                       */
                      abstract contract Pausable is Context {
                          /**
                           * @dev Emitted when the pause is triggered by `account`.
                           */
                          event Paused(address account);
                          /**
                           * @dev Emitted when the pause is lifted by `account`.
                           */
                          event Unpaused(address account);
                          bool private _paused;
                          /**
                           * @dev Initializes the contract in unpaused state.
                           */
                          constructor() {
                              _paused = false;
                          }
                          /**
                           * @dev Modifier to make a function callable only when the contract is not paused.
                           *
                           * Requirements:
                           *
                           * - The contract must not be paused.
                           */
                          modifier whenNotPaused() {
                              _requireNotPaused();
                              _;
                          }
                          /**
                           * @dev Modifier to make a function callable only when the contract is paused.
                           *
                           * Requirements:
                           *
                           * - The contract must be paused.
                           */
                          modifier whenPaused() {
                              _requirePaused();
                              _;
                          }
                          /**
                           * @dev Returns true if the contract is paused, and false otherwise.
                           */
                          function paused() public view virtual returns (bool) {
                              return _paused;
                          }
                          /**
                           * @dev Throws if the contract is paused.
                           */
                          function _requireNotPaused() internal view virtual {
                              require(!paused(), "Pausable: paused");
                          }
                          /**
                           * @dev Throws if the contract is not paused.
                           */
                          function _requirePaused() internal view virtual {
                              require(paused(), "Pausable: not paused");
                          }
                          /**
                           * @dev Triggers stopped state.
                           *
                           * Requirements:
                           *
                           * - The contract must not be paused.
                           */
                          function _pause() internal virtual whenNotPaused {
                              _paused = true;
                              emit Paused(_msgSender());
                          }
                          /**
                           * @dev Returns to normal state.
                           *
                           * Requirements:
                           *
                           * - The contract must be paused.
                           */
                          function _unpause() internal virtual whenPaused {
                              _paused = false;
                              emit Unpaused(_msgSender());
                          }
                      }
                      // 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 IERC20 {
                          /**
                           * @dev Emitted when `value` tokens are moved from one account (`from`) to
                           * another (`to`).
                           *
                           * Note that `value` may be zero.
                           */
                          event Transfer(address indexed from, address indexed to, uint256 value);
                          /**
                           * @dev Emitted when the allowance of a `spender` for an `owner` is set by
                           * a call to {approve}. `value` is the new allowance.
                           */
                          event Approval(address indexed owner, address indexed spender, uint256 value);
                          /**
                           * @dev Returns the amount of tokens in existence.
                           */
                          function totalSupply() external view returns (uint256);
                          /**
                           * @dev Returns the amount of tokens owned by `account`.
                           */
                          function balanceOf(address account) external view returns (uint256);
                          /**
                           * @dev Moves `amount` tokens from the caller's account to `to`.
                           *
                           * Returns a boolean value indicating whether the operation succeeded.
                           *
                           * Emits a {Transfer} event.
                           */
                          function transfer(address to, uint256 amount) external returns (bool);
                          /**
                           * @dev Returns the remaining number of tokens that `spender` will be
                           * allowed to spend on behalf of `owner` through {transferFrom}. This is
                           * zero by default.
                           *
                           * This value changes when {approve} or {transferFrom} are called.
                           */
                          function allowance(address owner, address spender) external view returns (uint256);
                          /**
                           * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
                           *
                           * Returns a boolean value indicating whether the operation succeeded.
                           *
                           * IMPORTANT: Beware that changing an allowance with this method brings the risk
                           * that someone may use both the old and the new allowance by unfortunate
                           * transaction ordering. One possible solution to mitigate this race
                           * condition is to first reduce the spender's allowance to 0 and set the
                           * desired value afterwards:
                           * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                           *
                           * Emits an {Approval} event.
                           */
                          function approve(address spender, uint256 amount) external returns (bool);
                          /**
                           * @dev Moves `amount` tokens from `from` to `to` using the
                           * allowance mechanism. `amount` is then deducted from the caller's
                           * allowance.
                           *
                           * Returns a boolean value indicating whether the operation succeeded.
                           *
                           * Emits a {Transfer} event.
                           */
                          function transferFrom(address from, address to, uint256 amount) external returns (bool);
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
                       * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
                       *
                       * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
                       * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
                       * need to send a transaction, and thus is not required to hold Ether at all.
                       *
                       * ==== Security Considerations
                       *
                       * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature
                       * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be
                       * considered as an intention to spend the allowance in any specific way. The second is that because permits have
                       * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should
                       * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be
                       * generally recommended is:
                       *
                       * ```solidity
                       * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {
                       *     try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}
                       *     doThing(..., value);
                       * }
                       *
                       * function doThing(..., uint256 value) public {
                       *     token.safeTransferFrom(msg.sender, address(this), value);
                       *     ...
                       * }
                       * ```
                       *
                       * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of
                       * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also
                       * {SafeERC20-safeTransferFrom}).
                       *
                       * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so
                       * contracts should have entry points that don't rely on permit.
                       */
                      interface IERC20Permit {
                          /**
                           * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
                           * given ``owner``'s signed approval.
                           *
                           * IMPORTANT: The same issues {IERC20-approve} has related to transaction
                           * ordering also apply here.
                           *
                           * Emits an {Approval} event.
                           *
                           * Requirements:
                           *
                           * - `spender` cannot be the zero address.
                           * - `deadline` must be a timestamp in the future.
                           * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
                           * over the EIP712-formatted function arguments.
                           * - the signature must use ``owner``'s current nonce (see {nonces}).
                           *
                           * For more information on the signature format, see the
                           * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
                           * section].
                           *
                           * CAUTION: See Security Considerations above.
                           */
                          function permit(
                              address owner,
                              address spender,
                              uint256 value,
                              uint256 deadline,
                              uint8 v,
                              bytes32 r,
                              bytes32 s
                          ) external;
                          /**
                           * @dev Returns the current nonce for `owner`. This value must be
                           * included whenever a signature is generated for {permit}.
                           *
                           * Every successful call to {permit} increases ``owner``'s nonce by one. This
                           * prevents a signature from being used multiple times.
                           */
                          function nonces(address owner) external view returns (uint256);
                          /**
                           * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
                           */
                          // solhint-disable-next-line func-name-mixedcase
                          function DOMAIN_SEPARATOR() external view returns (bytes32);
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)
                      pragma solidity ^0.8.0;
                      import "../IERC20.sol";
                      import "../extensions/IERC20Permit.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;
                          /**
                           * @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(IERC20 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(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));
                          }
                          /**
                           * @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(IERC20 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(IERC20 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(IERC20 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(
                              IERC20Permit 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(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");
                              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(IERC20 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))) && Address.isContract(address(token));
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
                      pragma solidity ^0.8.1;
                      /**
                       * @dev Collection of functions related to the address type
                       */
                      library Address {
                          /**
                           * @dev Returns true if `account` is a contract.
                           *
                           * [IMPORTANT]
                           * ====
                           * It is unsafe to assume that an address for which this function returns
                           * false is an externally-owned account (EOA) and not a contract.
                           *
                           * Among others, `isContract` will return false for the following
                           * types of addresses:
                           *
                           *  - an externally-owned account
                           *  - a contract in construction
                           *  - an address where a contract will be created
                           *  - an address where a contract lived, but was destroyed
                           *
                           * Furthermore, `isContract` will also return true if the target contract within
                           * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
                           * which only has an effect at the end of a transaction.
                           * ====
                           *
                           * [IMPORTANT]
                           * ====
                           * You shouldn't rely on `isContract` to protect against flash loan attacks!
                           *
                           * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
                           * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
                           * constructor.
                           * ====
                           */
                          function isContract(address account) internal view returns (bool) {
                              // This method relies on extcodesize/address.code.length, which returns 0
                              // for contracts in construction, since the code is only stored at the end
                              // of the constructor execution.
                              return account.code.length > 0;
                          }
                          /**
                           * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                           * `recipient`, forwarding all available gas and reverting on errors.
                           *
                           * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                           * of certain opcodes, possibly making contracts go over the 2300 gas limit
                           * imposed by `transfer`, making them unable to receive funds via
                           * `transfer`. {sendValue} removes this limitation.
                           *
                           * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                           *
                           * IMPORTANT: because control is transferred to `recipient`, care must be
                           * taken to not create reentrancy vulnerabilities. Consider using
                           * {ReentrancyGuard} or the
                           * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                           */
                          function sendValue(address payable recipient, uint256 amount) internal {
                              require(address(this).balance >= amount, "Address: insufficient balance");
                              (bool success, ) = recipient.call{value: amount}("");
                              require(success, "Address: unable to send value, recipient may have reverted");
                          }
                          /**
                           * @dev Performs a Solidity function call using a low level `call`. A
                           * plain `call` is an unsafe replacement for a function call: use this
                           * function instead.
                           *
                           * If `target` reverts with a revert reason, it is bubbled up by this
                           * function (like regular Solidity function calls).
                           *
                           * Returns the raw returned data. To convert to the expected return value,
                           * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                           *
                           * Requirements:
                           *
                           * - `target` must be a contract.
                           * - calling `target` with `data` must not revert.
                           *
                           * _Available since v3.1._
                           */
                          function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                              return functionCallWithValue(target, data, 0, "Address: low-level call failed");
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                           * `errorMessage` as a fallback revert reason when `target` reverts.
                           *
                           * _Available since v3.1._
                           */
                          function functionCall(
                              address target,
                              bytes memory data,
                              string memory errorMessage
                          ) internal returns (bytes memory) {
                              return functionCallWithValue(target, data, 0, errorMessage);
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                           * but also transferring `value` wei to `target`.
                           *
                           * Requirements:
                           *
                           * - the calling contract must have an ETH balance of at least `value`.
                           * - the called Solidity function must be `payable`.
                           *
                           * _Available since v3.1._
                           */
                          function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                              return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                          }
                          /**
                           * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                           * with `errorMessage` as a fallback revert reason when `target` reverts.
                           *
                           * _Available since v3.1._
                           */
                          function functionCallWithValue(
                              address target,
                              bytes memory data,
                              uint256 value,
                              string memory errorMessage
                          ) internal returns (bytes memory) {
                              require(address(this).balance >= value, "Address: insufficient balance for call");
                              (bool success, bytes memory returndata) = target.call{value: value}(data);
                              return verifyCallResultFromTarget(target, success, returndata, errorMessage);
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                           * but performing a static call.
                           *
                           * _Available since v3.3._
                           */
                          function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                              return functionStaticCall(target, data, "Address: low-level static call failed");
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                           * but performing a static call.
                           *
                           * _Available since v3.3._
                           */
                          function functionStaticCall(
                              address target,
                              bytes memory data,
                              string memory errorMessage
                          ) internal view returns (bytes memory) {
                              (bool success, bytes memory returndata) = target.staticcall(data);
                              return verifyCallResultFromTarget(target, success, returndata, errorMessage);
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                           * but performing a delegate call.
                           *
                           * _Available since v3.4._
                           */
                          function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                              return functionDelegateCall(target, data, "Address: low-level delegate call failed");
                          }
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                           * but performing a delegate call.
                           *
                           * _Available since v3.4._
                           */
                          function functionDelegateCall(
                              address target,
                              bytes memory data,
                              string memory errorMessage
                          ) internal returns (bytes memory) {
                              (bool success, bytes memory returndata) = target.delegatecall(data);
                              return verifyCallResultFromTarget(target, success, returndata, errorMessage);
                          }
                          /**
                           * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
                           * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
                           *
                           * _Available since v4.8._
                           */
                          function verifyCallResultFromTarget(
                              address target,
                              bool success,
                              bytes memory returndata,
                              string memory errorMessage
                          ) internal view returns (bytes memory) {
                              if (success) {
                                  if (returndata.length == 0) {
                                      // only check isContract if the call was successful and the return data is empty
                                      // otherwise we already know that it was a contract
                                      require(isContract(target), "Address: call to non-contract");
                                  }
                                  return returndata;
                              } else {
                                  _revert(returndata, errorMessage);
                              }
                          }
                          /**
                           * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
                           * revert reason or using the provided one.
                           *
                           * _Available since v4.3._
                           */
                          function verifyCallResult(
                              bool success,
                              bytes memory returndata,
                              string memory errorMessage
                          ) internal pure returns (bytes memory) {
                              if (success) {
                                  return returndata;
                              } else {
                                  _revert(returndata, errorMessage);
                              }
                          }
                          function _revert(bytes memory returndata, string memory errorMessage) private pure {
                              // Look for revert reason and bubble it up if present
                              if (returndata.length > 0) {
                                  // The easiest way to bubble the revert reason is using memory via assembly
                                  /// @solidity memory-safe-assembly
                                  assembly {
                                      let returndata_size := mload(returndata)
                                      revert(add(32, returndata), returndata_size)
                                  }
                              } else {
                                  revert(errorMessage);
                              }
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol)
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Provides information about the current execution context, including the
                       * sender of the transaction and its data. While these are generally available
                       * via msg.sender and msg.data, they should not be accessed in such a direct
                       * manner, since when dealing with meta-transactions the account sending and
                       * paying for execution may not be the actual sender (as far as an application
                       * is concerned).
                       *
                       * This contract is only required for intermediate, library-like contracts.
                       */
                      abstract contract Context {
                          function _msgSender() internal view virtual returns (address) {
                              return msg.sender;
                          }
                          function _msgData() internal view virtual returns (bytes calldata) {
                              return msg.data;
                          }
                          function _contextSuffixLength() internal view virtual returns (uint256) {
                              return 0;
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)
                      pragma solidity ^0.8.0;
                      import "./math/Math.sol";
                      import "./math/SignedMath.sol";
                      /**
                       * @dev String operations.
                       */
                      library Strings {
                          bytes16 private constant _SYMBOLS = "0123456789abcdef";
                          uint8 private constant _ADDRESS_LENGTH = 20;
                          /**
                           * @dev Converts a `uint256` to its ASCII `string` decimal representation.
                           */
                          function toString(uint256 value) internal pure returns (string memory) {
                              unchecked {
                                  uint256 length = Math.log10(value) + 1;
                                  string memory buffer = new string(length);
                                  uint256 ptr;
                                  /// @solidity memory-safe-assembly
                                  assembly {
                                      ptr := add(buffer, add(32, length))
                                  }
                                  while (true) {
                                      ptr--;
                                      /// @solidity memory-safe-assembly
                                      assembly {
                                          mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
                                      }
                                      value /= 10;
                                      if (value == 0) break;
                                  }
                                  return buffer;
                              }
                          }
                          /**
                           * @dev Converts a `int256` to its ASCII `string` decimal representation.
                           */
                          function toString(int256 value) internal pure returns (string memory) {
                              return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMath.abs(value))));
                          }
                          /**
                           * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
                           */
                          function toHexString(uint256 value) internal pure returns (string memory) {
                              unchecked {
                                  return toHexString(value, Math.log256(value) + 1);
                              }
                          }
                          /**
                           * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
                           */
                          function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
                              bytes memory buffer = new bytes(2 * length + 2);
                              buffer[0] = "0";
                              buffer[1] = "x";
                              for (uint256 i = 2 * length + 1; i > 1; --i) {
                                  buffer[i] = _SYMBOLS[value & 0xf];
                                  value >>= 4;
                              }
                              require(value == 0, "Strings: hex length insufficient");
                              return string(buffer);
                          }
                          /**
                           * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
                           */
                          function toHexString(address addr) internal pure returns (string memory) {
                              return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
                          }
                          /**
                           * @dev Returns true if the two strings are equal.
                           */
                          function equal(string memory a, string memory b) internal pure returns (bool) {
                              return keccak256(bytes(a)) == keccak256(bytes(b));
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)
                      pragma solidity ^0.8.0;
                      import "../Strings.sol";
                      /**
                       * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
                       *
                       * These functions can be used to verify that a message was signed by the holder
                       * of the private keys of a given address.
                       */
                      library ECDSA {
                          enum RecoverError {
                              NoError,
                              InvalidSignature,
                              InvalidSignatureLength,
                              InvalidSignatureS,
                              InvalidSignatureV // Deprecated in v4.8
                          }
                          function _throwError(RecoverError error) private pure {
                              if (error == RecoverError.NoError) {
                                  return; // no error: do nothing
                              } else if (error == RecoverError.InvalidSignature) {
                                  revert("ECDSA: invalid signature");
                              } else if (error == RecoverError.InvalidSignatureLength) {
                                  revert("ECDSA: invalid signature length");
                              } else if (error == RecoverError.InvalidSignatureS) {
                                  revert("ECDSA: invalid signature 's' value");
                              }
                          }
                          /**
                           * @dev Returns the address that signed a hashed message (`hash`) with
                           * `signature` or error string. This address can then be used for verification purposes.
                           *
                           * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
                           * this function rejects them by requiring the `s` value to be in the lower
                           * half order, and the `v` value to be either 27 or 28.
                           *
                           * IMPORTANT: `hash` _must_ be the result of a hash operation for the
                           * verification to be secure: it is possible to craft signatures that
                           * recover to arbitrary addresses for non-hashed data. A safe way to ensure
                           * this is by receiving a hash of the original message (which may otherwise
                           * be too long), and then calling {toEthSignedMessageHash} on it.
                           *
                           * Documentation for signature generation:
                           * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
                           * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
                           *
                           * _Available since v4.3._
                           */
                          function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
                              if (signature.length == 65) {
                                  bytes32 r;
                                  bytes32 s;
                                  uint8 v;
                                  // ecrecover takes the signature parameters, and the only way to get them
                                  // currently is to use assembly.
                                  /// @solidity memory-safe-assembly
                                  assembly {
                                      r := mload(add(signature, 0x20))
                                      s := mload(add(signature, 0x40))
                                      v := byte(0, mload(add(signature, 0x60)))
                                  }
                                  return tryRecover(hash, v, r, s);
                              } else {
                                  return (address(0), RecoverError.InvalidSignatureLength);
                              }
                          }
                          /**
                           * @dev Returns the address that signed a hashed message (`hash`) with
                           * `signature`. This address can then be used for verification purposes.
                           *
                           * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
                           * this function rejects them by requiring the `s` value to be in the lower
                           * half order, and the `v` value to be either 27 or 28.
                           *
                           * IMPORTANT: `hash` _must_ be the result of a hash operation for the
                           * verification to be secure: it is possible to craft signatures that
                           * recover to arbitrary addresses for non-hashed data. A safe way to ensure
                           * this is by receiving a hash of the original message (which may otherwise
                           * be too long), and then calling {toEthSignedMessageHash} on it.
                           */
                          function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
                              (address recovered, RecoverError error) = tryRecover(hash, signature);
                              _throwError(error);
                              return recovered;
                          }
                          /**
                           * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
                           *
                           * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
                           *
                           * _Available since v4.3._
                           */
                          function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {
                              bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);
                              uint8 v = uint8((uint256(vs) >> 255) + 27);
                              return tryRecover(hash, v, r, s);
                          }
                          /**
                           * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
                           *
                           * _Available since v4.2._
                           */
                          function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {
                              (address recovered, RecoverError error) = tryRecover(hash, r, vs);
                              _throwError(error);
                              return recovered;
                          }
                          /**
                           * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
                           * `r` and `s` signature fields separately.
                           *
                           * _Available since v4.3._
                           */
                          function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {
                              // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
                              // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
                              // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
                              // signatures from current libraries generate a unique signature with an s-value in the lower half order.
                              //
                              // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
                              // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
                              // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
                              // these malleable signatures as well.
                              if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
                                  return (address(0), RecoverError.InvalidSignatureS);
                              }
                              // If the signature is valid (and not malleable), return the signer address
                              address signer = ecrecover(hash, v, r, s);
                              if (signer == address(0)) {
                                  return (address(0), RecoverError.InvalidSignature);
                              }
                              return (signer, RecoverError.NoError);
                          }
                          /**
                           * @dev Overload of {ECDSA-recover} that receives the `v`,
                           * `r` and `s` signature fields separately.
                           */
                          function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {
                              (address recovered, RecoverError error) = tryRecover(hash, v, r, s);
                              _throwError(error);
                              return recovered;
                          }
                          /**
                           * @dev Returns an Ethereum Signed Message, created from a `hash`. This
                           * produces hash corresponding to the one signed with the
                           * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
                           * JSON-RPC method as part of EIP-191.
                           *
                           * See {recover}.
                           */
                          function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {
                              // 32 is the length in bytes of hash,
                              // enforced by the type signature above
                              /// @solidity memory-safe-assembly
                              assembly {
                                  mstore(0x00, "\\x19Ethereum Signed Message:\
                      32")
                                  mstore(0x1c, hash)
                                  message := keccak256(0x00, 0x3c)
                              }
                          }
                          /**
                           * @dev Returns an Ethereum Signed Message, created from `s`. This
                           * produces hash corresponding to the one signed with the
                           * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
                           * JSON-RPC method as part of EIP-191.
                           *
                           * See {recover}.
                           */
                          function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
                              return keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
                      ", Strings.toString(s.length), s));
                          }
                          /**
                           * @dev Returns an Ethereum Signed Typed Data, created from a
                           * `domainSeparator` and a `structHash`. This produces hash corresponding
                           * to the one signed with the
                           * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
                           * JSON-RPC method as part of EIP-712.
                           *
                           * See {recover}.
                           */
                          function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {
                              /// @solidity memory-safe-assembly
                              assembly {
                                  let ptr := mload(0x40)
                                  mstore(ptr, "\\x19\\x01")
                                  mstore(add(ptr, 0x02), domainSeparator)
                                  mstore(add(ptr, 0x22), structHash)
                                  data := keccak256(ptr, 0x42)
                              }
                          }
                          /**
                           * @dev Returns an Ethereum Signed Data with intended validator, created from a
                           * `validator` and `data` according to the version 0 of EIP-191.
                           *
                           * See {recover}.
                           */
                          function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {
                              return keccak256(abi.encodePacked("\\x19\\x00", validator, data));
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
                      pragma solidity ^0.8.0;
                      import "./IERC165.sol";
                      /**
                       * @dev Implementation of the {IERC165} interface.
                       *
                       * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
                       * for the additional interface id that will be supported. For example:
                       *
                       * ```solidity
                       * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                       *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
                       * }
                       * ```
                       *
                       * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
                       */
                      abstract contract ERC165 is IERC165 {
                          /**
                           * @dev See {IERC165-supportsInterface}.
                           */
                          function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                              return interfaceId == type(IERC165).interfaceId;
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Interface of the ERC165 standard, as defined in the
                       * https://eips.ethereum.org/EIPS/eip-165[EIP].
                       *
                       * Implementers can declare support of contract interfaces, which can then be
                       * queried by others ({ERC165Checker}).
                       *
                       * For an implementation, see {ERC165}.
                       */
                      interface IERC165 {
                          /**
                           * @dev Returns true if this contract implements the interface defined by
                           * `interfaceId`. See the corresponding
                           * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
                           * to learn more about how these ids are created.
                           *
                           * This function call must use less than 30 000 gas.
                           */
                          function supportsInterface(bytes4 interfaceId) external view returns (bool);
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Standard math utilities missing in the Solidity language.
                       */
                      library Math {
                          enum Rounding {
                              Down, // Toward negative infinity
                              Up, // Toward infinity
                              Zero // Toward zero
                          }
                          /**
                           * @dev Returns the largest of two numbers.
                           */
                          function max(uint256 a, uint256 b) internal pure returns (uint256) {
                              return a > b ? a : b;
                          }
                          /**
                           * @dev Returns the smallest of two numbers.
                           */
                          function min(uint256 a, uint256 b) internal pure returns (uint256) {
                              return a < b ? a : b;
                          }
                          /**
                           * @dev Returns the average of two numbers. The result is rounded towards
                           * zero.
                           */
                          function average(uint256 a, uint256 b) internal pure returns (uint256) {
                              // (a + b) / 2 can overflow.
                              return (a & b) + (a ^ b) / 2;
                          }
                          /**
                           * @dev Returns the ceiling of the division of two numbers.
                           *
                           * This differs from standard division with `/` in that it rounds up instead
                           * of rounding down.
                           */
                          function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
                              // (a + b - 1) / b can overflow on addition, so we distribute.
                              return a == 0 ? 0 : (a - 1) / b + 1;
                          }
                          /**
                           * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
                           * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
                           * with further edits by Uniswap Labs also under MIT license.
                           */
                          function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {
                              unchecked {
                                  // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
                                  // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
                                  // variables such that product = prod1 * 2^256 + prod0.
                                  uint256 prod0; // Least significant 256 bits of the product
                                  uint256 prod1; // Most significant 256 bits of the product
                                  assembly {
                                      let mm := mulmod(x, y, not(0))
                                      prod0 := mul(x, y)
                                      prod1 := sub(sub(mm, prod0), lt(mm, prod0))
                                  }
                                  // Handle non-overflow cases, 256 by 256 division.
                                  if (prod1 == 0) {
                                      // Solidity will revert if denominator == 0, unlike the div opcode on its own.
                                      // The surrounding unchecked block does not change this fact.
                                      // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
                                      return prod0 / denominator;
                                  }
                                  // Make sure the result is less than 2^256. Also prevents denominator == 0.
                                  require(denominator > prod1, "Math: mulDiv overflow");
                                  ///////////////////////////////////////////////
                                  // 512 by 256 division.
                                  ///////////////////////////////////////////////
                                  // Make division exact by subtracting the remainder from [prod1 prod0].
                                  uint256 remainder;
                                  assembly {
                                      // Compute remainder using mulmod.
                                      remainder := mulmod(x, y, denominator)
                                      // Subtract 256 bit number from 512 bit number.
                                      prod1 := sub(prod1, gt(remainder, prod0))
                                      prod0 := sub(prod0, remainder)
                                  }
                                  // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
                                  // See https://cs.stackexchange.com/q/138556/92363.
                                  // Does not overflow because the denominator cannot be zero at this stage in the function.
                                  uint256 twos = denominator & (~denominator + 1);
                                  assembly {
                                      // Divide denominator by twos.
                                      denominator := div(denominator, twos)
                                      // Divide [prod1 prod0] by twos.
                                      prod0 := div(prod0, twos)
                                      // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
                                      twos := add(div(sub(0, twos), twos), 1)
                                  }
                                  // Shift in bits from prod1 into prod0.
                                  prod0 |= prod1 * twos;
                                  // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
                                  // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
                                  // four bits. That is, denominator * inv = 1 mod 2^4.
                                  uint256 inverse = (3 * denominator) ^ 2;
                                  // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
                                  // in modular arithmetic, doubling the correct bits in each step.
                                  inverse *= 2 - denominator * inverse; // inverse mod 2^8
                                  inverse *= 2 - denominator * inverse; // inverse mod 2^16
                                  inverse *= 2 - denominator * inverse; // inverse mod 2^32
                                  inverse *= 2 - denominator * inverse; // inverse mod 2^64
                                  inverse *= 2 - denominator * inverse; // inverse mod 2^128
                                  inverse *= 2 - denominator * inverse; // inverse mod 2^256
                                  // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
                                  // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
                                  // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
                                  // is no longer required.
                                  result = prod0 * inverse;
                                  return result;
                              }
                          }
                          /**
                           * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
                           */
                          function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {
                              uint256 result = mulDiv(x, y, denominator);
                              if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
                                  result += 1;
                              }
                              return result;
                          }
                          /**
                           * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
                           *
                           * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
                           */
                          function sqrt(uint256 a) internal pure returns (uint256) {
                              if (a == 0) {
                                  return 0;
                              }
                              // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
                              //
                              // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
                              // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
                              //
                              // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
                              // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
                              // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
                              //
                              // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
                              uint256 result = 1 << (log2(a) >> 1);
                              // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
                              // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
                              // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
                              // into the expected uint128 result.
                              unchecked {
                                  result = (result + a / result) >> 1;
                                  result = (result + a / result) >> 1;
                                  result = (result + a / result) >> 1;
                                  result = (result + a / result) >> 1;
                                  result = (result + a / result) >> 1;
                                  result = (result + a / result) >> 1;
                                  result = (result + a / result) >> 1;
                                  return min(result, a / result);
                              }
                          }
                          /**
                           * @notice Calculates sqrt(a), following the selected rounding direction.
                           */
                          function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
                              unchecked {
                                  uint256 result = sqrt(a);
                                  return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
                              }
                          }
                          /**
                           * @dev Return the log in base 2, rounded down, of a positive value.
                           * Returns 0 if given 0.
                           */
                          function log2(uint256 value) internal pure returns (uint256) {
                              uint256 result = 0;
                              unchecked {
                                  if (value >> 128 > 0) {
                                      value >>= 128;
                                      result += 128;
                                  }
                                  if (value >> 64 > 0) {
                                      value >>= 64;
                                      result += 64;
                                  }
                                  if (value >> 32 > 0) {
                                      value >>= 32;
                                      result += 32;
                                  }
                                  if (value >> 16 > 0) {
                                      value >>= 16;
                                      result += 16;
                                  }
                                  if (value >> 8 > 0) {
                                      value >>= 8;
                                      result += 8;
                                  }
                                  if (value >> 4 > 0) {
                                      value >>= 4;
                                      result += 4;
                                  }
                                  if (value >> 2 > 0) {
                                      value >>= 2;
                                      result += 2;
                                  }
                                  if (value >> 1 > 0) {
                                      result += 1;
                                  }
                              }
                              return result;
                          }
                          /**
                           * @dev Return the log in base 2, following the selected rounding direction, of a positive value.
                           * Returns 0 if given 0.
                           */
                          function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
                              unchecked {
                                  uint256 result = log2(value);
                                  return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
                              }
                          }
                          /**
                           * @dev Return the log in base 10, rounded down, of a positive value.
                           * Returns 0 if given 0.
                           */
                          function log10(uint256 value) internal pure returns (uint256) {
                              uint256 result = 0;
                              unchecked {
                                  if (value >= 10 ** 64) {
                                      value /= 10 ** 64;
                                      result += 64;
                                  }
                                  if (value >= 10 ** 32) {
                                      value /= 10 ** 32;
                                      result += 32;
                                  }
                                  if (value >= 10 ** 16) {
                                      value /= 10 ** 16;
                                      result += 16;
                                  }
                                  if (value >= 10 ** 8) {
                                      value /= 10 ** 8;
                                      result += 8;
                                  }
                                  if (value >= 10 ** 4) {
                                      value /= 10 ** 4;
                                      result += 4;
                                  }
                                  if (value >= 10 ** 2) {
                                      value /= 10 ** 2;
                                      result += 2;
                                  }
                                  if (value >= 10 ** 1) {
                                      result += 1;
                                  }
                              }
                              return result;
                          }
                          /**
                           * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
                           * Returns 0 if given 0.
                           */
                          function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
                              unchecked {
                                  uint256 result = log10(value);
                                  return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);
                              }
                          }
                          /**
                           * @dev Return the log in base 256, rounded down, of a positive value.
                           * Returns 0 if given 0.
                           *
                           * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
                           */
                          function log256(uint256 value) internal pure returns (uint256) {
                              uint256 result = 0;
                              unchecked {
                                  if (value >> 128 > 0) {
                                      value >>= 128;
                                      result += 16;
                                  }
                                  if (value >> 64 > 0) {
                                      value >>= 64;
                                      result += 8;
                                  }
                                  if (value >> 32 > 0) {
                                      value >>= 32;
                                      result += 4;
                                  }
                                  if (value >> 16 > 0) {
                                      value >>= 16;
                                      result += 2;
                                  }
                                  if (value >> 8 > 0) {
                                      result += 1;
                                  }
                              }
                              return result;
                          }
                          /**
                           * @dev Return the log in base 256, following the selected rounding direction, of a positive value.
                           * Returns 0 if given 0.
                           */
                          function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
                              unchecked {
                                  uint256 result = log256(value);
                                  return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);
                              }
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SafeCast.sol)
                      // This file was procedurally generated from scripts/generate/templates/SafeCast.js.
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Wrappers over Solidity's uintXX/intXX casting operators with added overflow
                       * checks.
                       *
                       * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can
                       * easily result in undesired exploitation or bugs, since developers usually
                       * assume that overflows raise errors. `SafeCast` restores this intuition by
                       * reverting the transaction when such an operation overflows.
                       *
                       * Using this library instead of the unchecked operations eliminates an entire
                       * class of bugs, so it's recommended to use it always.
                       *
                       * Can be combined with {SafeMath} and {SignedSafeMath} to extend it to smaller types, by performing
                       * all math on `uint256` and `int256` and then downcasting.
                       */
                      library SafeCast {
                          /**
                           * @dev Returns the downcasted uint248 from uint256, reverting on
                           * overflow (when the input is greater than largest uint248).
                           *
                           * Counterpart to Solidity's `uint248` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 248 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint248(uint256 value) internal pure returns (uint248) {
                              require(value <= type(uint248).max, "SafeCast: value doesn't fit in 248 bits");
                              return uint248(value);
                          }
                          /**
                           * @dev Returns the downcasted uint240 from uint256, reverting on
                           * overflow (when the input is greater than largest uint240).
                           *
                           * Counterpart to Solidity's `uint240` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 240 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint240(uint256 value) internal pure returns (uint240) {
                              require(value <= type(uint240).max, "SafeCast: value doesn't fit in 240 bits");
                              return uint240(value);
                          }
                          /**
                           * @dev Returns the downcasted uint232 from uint256, reverting on
                           * overflow (when the input is greater than largest uint232).
                           *
                           * Counterpart to Solidity's `uint232` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 232 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint232(uint256 value) internal pure returns (uint232) {
                              require(value <= type(uint232).max, "SafeCast: value doesn't fit in 232 bits");
                              return uint232(value);
                          }
                          /**
                           * @dev Returns the downcasted uint224 from uint256, reverting on
                           * overflow (when the input is greater than largest uint224).
                           *
                           * Counterpart to Solidity's `uint224` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 224 bits
                           *
                           * _Available since v4.2._
                           */
                          function toUint224(uint256 value) internal pure returns (uint224) {
                              require(value <= type(uint224).max, "SafeCast: value doesn't fit in 224 bits");
                              return uint224(value);
                          }
                          /**
                           * @dev Returns the downcasted uint216 from uint256, reverting on
                           * overflow (when the input is greater than largest uint216).
                           *
                           * Counterpart to Solidity's `uint216` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 216 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint216(uint256 value) internal pure returns (uint216) {
                              require(value <= type(uint216).max, "SafeCast: value doesn't fit in 216 bits");
                              return uint216(value);
                          }
                          /**
                           * @dev Returns the downcasted uint208 from uint256, reverting on
                           * overflow (when the input is greater than largest uint208).
                           *
                           * Counterpart to Solidity's `uint208` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 208 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint208(uint256 value) internal pure returns (uint208) {
                              require(value <= type(uint208).max, "SafeCast: value doesn't fit in 208 bits");
                              return uint208(value);
                          }
                          /**
                           * @dev Returns the downcasted uint200 from uint256, reverting on
                           * overflow (when the input is greater than largest uint200).
                           *
                           * Counterpart to Solidity's `uint200` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 200 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint200(uint256 value) internal pure returns (uint200) {
                              require(value <= type(uint200).max, "SafeCast: value doesn't fit in 200 bits");
                              return uint200(value);
                          }
                          /**
                           * @dev Returns the downcasted uint192 from uint256, reverting on
                           * overflow (when the input is greater than largest uint192).
                           *
                           * Counterpart to Solidity's `uint192` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 192 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint192(uint256 value) internal pure returns (uint192) {
                              require(value <= type(uint192).max, "SafeCast: value doesn't fit in 192 bits");
                              return uint192(value);
                          }
                          /**
                           * @dev Returns the downcasted uint184 from uint256, reverting on
                           * overflow (when the input is greater than largest uint184).
                           *
                           * Counterpart to Solidity's `uint184` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 184 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint184(uint256 value) internal pure returns (uint184) {
                              require(value <= type(uint184).max, "SafeCast: value doesn't fit in 184 bits");
                              return uint184(value);
                          }
                          /**
                           * @dev Returns the downcasted uint176 from uint256, reverting on
                           * overflow (when the input is greater than largest uint176).
                           *
                           * Counterpart to Solidity's `uint176` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 176 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint176(uint256 value) internal pure returns (uint176) {
                              require(value <= type(uint176).max, "SafeCast: value doesn't fit in 176 bits");
                              return uint176(value);
                          }
                          /**
                           * @dev Returns the downcasted uint168 from uint256, reverting on
                           * overflow (when the input is greater than largest uint168).
                           *
                           * Counterpart to Solidity's `uint168` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 168 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint168(uint256 value) internal pure returns (uint168) {
                              require(value <= type(uint168).max, "SafeCast: value doesn't fit in 168 bits");
                              return uint168(value);
                          }
                          /**
                           * @dev Returns the downcasted uint160 from uint256, reverting on
                           * overflow (when the input is greater than largest uint160).
                           *
                           * Counterpart to Solidity's `uint160` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 160 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint160(uint256 value) internal pure returns (uint160) {
                              require(value <= type(uint160).max, "SafeCast: value doesn't fit in 160 bits");
                              return uint160(value);
                          }
                          /**
                           * @dev Returns the downcasted uint152 from uint256, reverting on
                           * overflow (when the input is greater than largest uint152).
                           *
                           * Counterpart to Solidity's `uint152` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 152 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint152(uint256 value) internal pure returns (uint152) {
                              require(value <= type(uint152).max, "SafeCast: value doesn't fit in 152 bits");
                              return uint152(value);
                          }
                          /**
                           * @dev Returns the downcasted uint144 from uint256, reverting on
                           * overflow (when the input is greater than largest uint144).
                           *
                           * Counterpart to Solidity's `uint144` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 144 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint144(uint256 value) internal pure returns (uint144) {
                              require(value <= type(uint144).max, "SafeCast: value doesn't fit in 144 bits");
                              return uint144(value);
                          }
                          /**
                           * @dev Returns the downcasted uint136 from uint256, reverting on
                           * overflow (when the input is greater than largest uint136).
                           *
                           * Counterpart to Solidity's `uint136` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 136 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint136(uint256 value) internal pure returns (uint136) {
                              require(value <= type(uint136).max, "SafeCast: value doesn't fit in 136 bits");
                              return uint136(value);
                          }
                          /**
                           * @dev Returns the downcasted uint128 from uint256, reverting on
                           * overflow (when the input is greater than largest uint128).
                           *
                           * Counterpart to Solidity's `uint128` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 128 bits
                           *
                           * _Available since v2.5._
                           */
                          function toUint128(uint256 value) internal pure returns (uint128) {
                              require(value <= type(uint128).max, "SafeCast: value doesn't fit in 128 bits");
                              return uint128(value);
                          }
                          /**
                           * @dev Returns the downcasted uint120 from uint256, reverting on
                           * overflow (when the input is greater than largest uint120).
                           *
                           * Counterpart to Solidity's `uint120` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 120 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint120(uint256 value) internal pure returns (uint120) {
                              require(value <= type(uint120).max, "SafeCast: value doesn't fit in 120 bits");
                              return uint120(value);
                          }
                          /**
                           * @dev Returns the downcasted uint112 from uint256, reverting on
                           * overflow (when the input is greater than largest uint112).
                           *
                           * Counterpart to Solidity's `uint112` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 112 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint112(uint256 value) internal pure returns (uint112) {
                              require(value <= type(uint112).max, "SafeCast: value doesn't fit in 112 bits");
                              return uint112(value);
                          }
                          /**
                           * @dev Returns the downcasted uint104 from uint256, reverting on
                           * overflow (when the input is greater than largest uint104).
                           *
                           * Counterpart to Solidity's `uint104` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 104 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint104(uint256 value) internal pure returns (uint104) {
                              require(value <= type(uint104).max, "SafeCast: value doesn't fit in 104 bits");
                              return uint104(value);
                          }
                          /**
                           * @dev Returns the downcasted uint96 from uint256, reverting on
                           * overflow (when the input is greater than largest uint96).
                           *
                           * Counterpart to Solidity's `uint96` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 96 bits
                           *
                           * _Available since v4.2._
                           */
                          function toUint96(uint256 value) internal pure returns (uint96) {
                              require(value <= type(uint96).max, "SafeCast: value doesn't fit in 96 bits");
                              return uint96(value);
                          }
                          /**
                           * @dev Returns the downcasted uint88 from uint256, reverting on
                           * overflow (when the input is greater than largest uint88).
                           *
                           * Counterpart to Solidity's `uint88` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 88 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint88(uint256 value) internal pure returns (uint88) {
                              require(value <= type(uint88).max, "SafeCast: value doesn't fit in 88 bits");
                              return uint88(value);
                          }
                          /**
                           * @dev Returns the downcasted uint80 from uint256, reverting on
                           * overflow (when the input is greater than largest uint80).
                           *
                           * Counterpart to Solidity's `uint80` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 80 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint80(uint256 value) internal pure returns (uint80) {
                              require(value <= type(uint80).max, "SafeCast: value doesn't fit in 80 bits");
                              return uint80(value);
                          }
                          /**
                           * @dev Returns the downcasted uint72 from uint256, reverting on
                           * overflow (when the input is greater than largest uint72).
                           *
                           * Counterpart to Solidity's `uint72` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 72 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint72(uint256 value) internal pure returns (uint72) {
                              require(value <= type(uint72).max, "SafeCast: value doesn't fit in 72 bits");
                              return uint72(value);
                          }
                          /**
                           * @dev Returns the downcasted uint64 from uint256, reverting on
                           * overflow (when the input is greater than largest uint64).
                           *
                           * Counterpart to Solidity's `uint64` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 64 bits
                           *
                           * _Available since v2.5._
                           */
                          function toUint64(uint256 value) internal pure returns (uint64) {
                              require(value <= type(uint64).max, "SafeCast: value doesn't fit in 64 bits");
                              return uint64(value);
                          }
                          /**
                           * @dev Returns the downcasted uint56 from uint256, reverting on
                           * overflow (when the input is greater than largest uint56).
                           *
                           * Counterpart to Solidity's `uint56` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 56 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint56(uint256 value) internal pure returns (uint56) {
                              require(value <= type(uint56).max, "SafeCast: value doesn't fit in 56 bits");
                              return uint56(value);
                          }
                          /**
                           * @dev Returns the downcasted uint48 from uint256, reverting on
                           * overflow (when the input is greater than largest uint48).
                           *
                           * Counterpart to Solidity's `uint48` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 48 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint48(uint256 value) internal pure returns (uint48) {
                              require(value <= type(uint48).max, "SafeCast: value doesn't fit in 48 bits");
                              return uint48(value);
                          }
                          /**
                           * @dev Returns the downcasted uint40 from uint256, reverting on
                           * overflow (when the input is greater than largest uint40).
                           *
                           * Counterpart to Solidity's `uint40` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 40 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint40(uint256 value) internal pure returns (uint40) {
                              require(value <= type(uint40).max, "SafeCast: value doesn't fit in 40 bits");
                              return uint40(value);
                          }
                          /**
                           * @dev Returns the downcasted uint32 from uint256, reverting on
                           * overflow (when the input is greater than largest uint32).
                           *
                           * Counterpart to Solidity's `uint32` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 32 bits
                           *
                           * _Available since v2.5._
                           */
                          function toUint32(uint256 value) internal pure returns (uint32) {
                              require(value <= type(uint32).max, "SafeCast: value doesn't fit in 32 bits");
                              return uint32(value);
                          }
                          /**
                           * @dev Returns the downcasted uint24 from uint256, reverting on
                           * overflow (when the input is greater than largest uint24).
                           *
                           * Counterpart to Solidity's `uint24` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 24 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint24(uint256 value) internal pure returns (uint24) {
                              require(value <= type(uint24).max, "SafeCast: value doesn't fit in 24 bits");
                              return uint24(value);
                          }
                          /**
                           * @dev Returns the downcasted uint16 from uint256, reverting on
                           * overflow (when the input is greater than largest uint16).
                           *
                           * Counterpart to Solidity's `uint16` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 16 bits
                           *
                           * _Available since v2.5._
                           */
                          function toUint16(uint256 value) internal pure returns (uint16) {
                              require(value <= type(uint16).max, "SafeCast: value doesn't fit in 16 bits");
                              return uint16(value);
                          }
                          /**
                           * @dev Returns the downcasted uint8 from uint256, reverting on
                           * overflow (when the input is greater than largest uint8).
                           *
                           * Counterpart to Solidity's `uint8` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 8 bits
                           *
                           * _Available since v2.5._
                           */
                          function toUint8(uint256 value) internal pure returns (uint8) {
                              require(value <= type(uint8).max, "SafeCast: value doesn't fit in 8 bits");
                              return uint8(value);
                          }
                          /**
                           * @dev Converts a signed int256 into an unsigned uint256.
                           *
                           * Requirements:
                           *
                           * - input must be greater than or equal to 0.
                           *
                           * _Available since v3.0._
                           */
                          function toUint256(int256 value) internal pure returns (uint256) {
                              require(value >= 0, "SafeCast: value must be positive");
                              return uint256(value);
                          }
                          /**
                           * @dev Returns the downcasted int248 from int256, reverting on
                           * overflow (when the input is less than smallest int248 or
                           * greater than largest int248).
                           *
                           * Counterpart to Solidity's `int248` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 248 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt248(int256 value) internal pure returns (int248 downcasted) {
                              downcasted = int248(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 248 bits");
                          }
                          /**
                           * @dev Returns the downcasted int240 from int256, reverting on
                           * overflow (when the input is less than smallest int240 or
                           * greater than largest int240).
                           *
                           * Counterpart to Solidity's `int240` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 240 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt240(int256 value) internal pure returns (int240 downcasted) {
                              downcasted = int240(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 240 bits");
                          }
                          /**
                           * @dev Returns the downcasted int232 from int256, reverting on
                           * overflow (when the input is less than smallest int232 or
                           * greater than largest int232).
                           *
                           * Counterpart to Solidity's `int232` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 232 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt232(int256 value) internal pure returns (int232 downcasted) {
                              downcasted = int232(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 232 bits");
                          }
                          /**
                           * @dev Returns the downcasted int224 from int256, reverting on
                           * overflow (when the input is less than smallest int224 or
                           * greater than largest int224).
                           *
                           * Counterpart to Solidity's `int224` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 224 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt224(int256 value) internal pure returns (int224 downcasted) {
                              downcasted = int224(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 224 bits");
                          }
                          /**
                           * @dev Returns the downcasted int216 from int256, reverting on
                           * overflow (when the input is less than smallest int216 or
                           * greater than largest int216).
                           *
                           * Counterpart to Solidity's `int216` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 216 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt216(int256 value) internal pure returns (int216 downcasted) {
                              downcasted = int216(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 216 bits");
                          }
                          /**
                           * @dev Returns the downcasted int208 from int256, reverting on
                           * overflow (when the input is less than smallest int208 or
                           * greater than largest int208).
                           *
                           * Counterpart to Solidity's `int208` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 208 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt208(int256 value) internal pure returns (int208 downcasted) {
                              downcasted = int208(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 208 bits");
                          }
                          /**
                           * @dev Returns the downcasted int200 from int256, reverting on
                           * overflow (when the input is less than smallest int200 or
                           * greater than largest int200).
                           *
                           * Counterpart to Solidity's `int200` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 200 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt200(int256 value) internal pure returns (int200 downcasted) {
                              downcasted = int200(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 200 bits");
                          }
                          /**
                           * @dev Returns the downcasted int192 from int256, reverting on
                           * overflow (when the input is less than smallest int192 or
                           * greater than largest int192).
                           *
                           * Counterpart to Solidity's `int192` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 192 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt192(int256 value) internal pure returns (int192 downcasted) {
                              downcasted = int192(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 192 bits");
                          }
                          /**
                           * @dev Returns the downcasted int184 from int256, reverting on
                           * overflow (when the input is less than smallest int184 or
                           * greater than largest int184).
                           *
                           * Counterpart to Solidity's `int184` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 184 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt184(int256 value) internal pure returns (int184 downcasted) {
                              downcasted = int184(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 184 bits");
                          }
                          /**
                           * @dev Returns the downcasted int176 from int256, reverting on
                           * overflow (when the input is less than smallest int176 or
                           * greater than largest int176).
                           *
                           * Counterpart to Solidity's `int176` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 176 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt176(int256 value) internal pure returns (int176 downcasted) {
                              downcasted = int176(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 176 bits");
                          }
                          /**
                           * @dev Returns the downcasted int168 from int256, reverting on
                           * overflow (when the input is less than smallest int168 or
                           * greater than largest int168).
                           *
                           * Counterpart to Solidity's `int168` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 168 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt168(int256 value) internal pure returns (int168 downcasted) {
                              downcasted = int168(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 168 bits");
                          }
                          /**
                           * @dev Returns the downcasted int160 from int256, reverting on
                           * overflow (when the input is less than smallest int160 or
                           * greater than largest int160).
                           *
                           * Counterpart to Solidity's `int160` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 160 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt160(int256 value) internal pure returns (int160 downcasted) {
                              downcasted = int160(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 160 bits");
                          }
                          /**
                           * @dev Returns the downcasted int152 from int256, reverting on
                           * overflow (when the input is less than smallest int152 or
                           * greater than largest int152).
                           *
                           * Counterpart to Solidity's `int152` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 152 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt152(int256 value) internal pure returns (int152 downcasted) {
                              downcasted = int152(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 152 bits");
                          }
                          /**
                           * @dev Returns the downcasted int144 from int256, reverting on
                           * overflow (when the input is less than smallest int144 or
                           * greater than largest int144).
                           *
                           * Counterpart to Solidity's `int144` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 144 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt144(int256 value) internal pure returns (int144 downcasted) {
                              downcasted = int144(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 144 bits");
                          }
                          /**
                           * @dev Returns the downcasted int136 from int256, reverting on
                           * overflow (when the input is less than smallest int136 or
                           * greater than largest int136).
                           *
                           * Counterpart to Solidity's `int136` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 136 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt136(int256 value) internal pure returns (int136 downcasted) {
                              downcasted = int136(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 136 bits");
                          }
                          /**
                           * @dev Returns the downcasted int128 from int256, reverting on
                           * overflow (when the input is less than smallest int128 or
                           * greater than largest int128).
                           *
                           * Counterpart to Solidity's `int128` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 128 bits
                           *
                           * _Available since v3.1._
                           */
                          function toInt128(int256 value) internal pure returns (int128 downcasted) {
                              downcasted = int128(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 128 bits");
                          }
                          /**
                           * @dev Returns the downcasted int120 from int256, reverting on
                           * overflow (when the input is less than smallest int120 or
                           * greater than largest int120).
                           *
                           * Counterpart to Solidity's `int120` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 120 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt120(int256 value) internal pure returns (int120 downcasted) {
                              downcasted = int120(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 120 bits");
                          }
                          /**
                           * @dev Returns the downcasted int112 from int256, reverting on
                           * overflow (when the input is less than smallest int112 or
                           * greater than largest int112).
                           *
                           * Counterpart to Solidity's `int112` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 112 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt112(int256 value) internal pure returns (int112 downcasted) {
                              downcasted = int112(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 112 bits");
                          }
                          /**
                           * @dev Returns the downcasted int104 from int256, reverting on
                           * overflow (when the input is less than smallest int104 or
                           * greater than largest int104).
                           *
                           * Counterpart to Solidity's `int104` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 104 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt104(int256 value) internal pure returns (int104 downcasted) {
                              downcasted = int104(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 104 bits");
                          }
                          /**
                           * @dev Returns the downcasted int96 from int256, reverting on
                           * overflow (when the input is less than smallest int96 or
                           * greater than largest int96).
                           *
                           * Counterpart to Solidity's `int96` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 96 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt96(int256 value) internal pure returns (int96 downcasted) {
                              downcasted = int96(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 96 bits");
                          }
                          /**
                           * @dev Returns the downcasted int88 from int256, reverting on
                           * overflow (when the input is less than smallest int88 or
                           * greater than largest int88).
                           *
                           * Counterpart to Solidity's `int88` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 88 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt88(int256 value) internal pure returns (int88 downcasted) {
                              downcasted = int88(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 88 bits");
                          }
                          /**
                           * @dev Returns the downcasted int80 from int256, reverting on
                           * overflow (when the input is less than smallest int80 or
                           * greater than largest int80).
                           *
                           * Counterpart to Solidity's `int80` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 80 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt80(int256 value) internal pure returns (int80 downcasted) {
                              downcasted = int80(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 80 bits");
                          }
                          /**
                           * @dev Returns the downcasted int72 from int256, reverting on
                           * overflow (when the input is less than smallest int72 or
                           * greater than largest int72).
                           *
                           * Counterpart to Solidity's `int72` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 72 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt72(int256 value) internal pure returns (int72 downcasted) {
                              downcasted = int72(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 72 bits");
                          }
                          /**
                           * @dev Returns the downcasted int64 from int256, reverting on
                           * overflow (when the input is less than smallest int64 or
                           * greater than largest int64).
                           *
                           * Counterpart to Solidity's `int64` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 64 bits
                           *
                           * _Available since v3.1._
                           */
                          function toInt64(int256 value) internal pure returns (int64 downcasted) {
                              downcasted = int64(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 64 bits");
                          }
                          /**
                           * @dev Returns the downcasted int56 from int256, reverting on
                           * overflow (when the input is less than smallest int56 or
                           * greater than largest int56).
                           *
                           * Counterpart to Solidity's `int56` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 56 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt56(int256 value) internal pure returns (int56 downcasted) {
                              downcasted = int56(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 56 bits");
                          }
                          /**
                           * @dev Returns the downcasted int48 from int256, reverting on
                           * overflow (when the input is less than smallest int48 or
                           * greater than largest int48).
                           *
                           * Counterpart to Solidity's `int48` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 48 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt48(int256 value) internal pure returns (int48 downcasted) {
                              downcasted = int48(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 48 bits");
                          }
                          /**
                           * @dev Returns the downcasted int40 from int256, reverting on
                           * overflow (when the input is less than smallest int40 or
                           * greater than largest int40).
                           *
                           * Counterpart to Solidity's `int40` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 40 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt40(int256 value) internal pure returns (int40 downcasted) {
                              downcasted = int40(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 40 bits");
                          }
                          /**
                           * @dev Returns the downcasted int32 from int256, reverting on
                           * overflow (when the input is less than smallest int32 or
                           * greater than largest int32).
                           *
                           * Counterpart to Solidity's `int32` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 32 bits
                           *
                           * _Available since v3.1._
                           */
                          function toInt32(int256 value) internal pure returns (int32 downcasted) {
                              downcasted = int32(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 32 bits");
                          }
                          /**
                           * @dev Returns the downcasted int24 from int256, reverting on
                           * overflow (when the input is less than smallest int24 or
                           * greater than largest int24).
                           *
                           * Counterpart to Solidity's `int24` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 24 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt24(int256 value) internal pure returns (int24 downcasted) {
                              downcasted = int24(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 24 bits");
                          }
                          /**
                           * @dev Returns the downcasted int16 from int256, reverting on
                           * overflow (when the input is less than smallest int16 or
                           * greater than largest int16).
                           *
                           * Counterpart to Solidity's `int16` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 16 bits
                           *
                           * _Available since v3.1._
                           */
                          function toInt16(int256 value) internal pure returns (int16 downcasted) {
                              downcasted = int16(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 16 bits");
                          }
                          /**
                           * @dev Returns the downcasted int8 from int256, reverting on
                           * overflow (when the input is less than smallest int8 or
                           * greater than largest int8).
                           *
                           * Counterpart to Solidity's `int8` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 8 bits
                           *
                           * _Available since v3.1._
                           */
                          function toInt8(int256 value) internal pure returns (int8 downcasted) {
                              downcasted = int8(value);
                              require(downcasted == value, "SafeCast: value doesn't fit in 8 bits");
                          }
                          /**
                           * @dev Converts an unsigned uint256 into a signed int256.
                           *
                           * Requirements:
                           *
                           * - input must be less than or equal to maxInt256.
                           *
                           * _Available since v3.0._
                           */
                          function toInt256(uint256 value) internal pure returns (int256) {
                              // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive
                              require(value <= uint256(type(int256).max), "SafeCast: value doesn't fit in an int256");
                              return int256(value);
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Standard signed math utilities missing in the Solidity language.
                       */
                      library SignedMath {
                          /**
                           * @dev Returns the largest of two signed numbers.
                           */
                          function max(int256 a, int256 b) internal pure returns (int256) {
                              return a > b ? a : b;
                          }
                          /**
                           * @dev Returns the smallest of two signed numbers.
                           */
                          function min(int256 a, int256 b) internal pure returns (int256) {
                              return a < b ? a : b;
                          }
                          /**
                           * @dev Returns the average of two signed numbers without overflow.
                           * The result is rounded towards zero.
                           */
                          function average(int256 a, int256 b) internal pure returns (int256) {
                              // Formula from the book "Hacker's Delight"
                              int256 x = (a & b) + ((a ^ b) >> 1);
                              return x + (int256(uint256(x) >> 255) & (a ^ b));
                          }
                          /**
                           * @dev Returns the absolute unsigned value of a signed value.
                           */
                          function abs(int256 n) internal pure returns (uint256) {
                              unchecked {
                                  // must be unchecked in order to support `n = type(int256).min`
                                  return uint256(n >= 0 ? n : -n);
                              }
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.9.0) (utils/structs/EnumerableSet.sol)
                      // This file was procedurally generated from scripts/generate/templates/EnumerableSet.js.
                      pragma solidity ^0.8.0;
                      /**
                       * @dev Library for managing
                       * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
                       * types.
                       *
                       * Sets have the following properties:
                       *
                       * - Elements are added, removed, and checked for existence in constant time
                       * (O(1)).
                       * - Elements are enumerated in O(n). No guarantees are made on the ordering.
                       *
                       * ```solidity
                       * contract Example {
                       *     // Add the library methods
                       *     using EnumerableSet for EnumerableSet.AddressSet;
                       *
                       *     // Declare a set state variable
                       *     EnumerableSet.AddressSet private mySet;
                       * }
                       * ```
                       *
                       * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
                       * and `uint256` (`UintSet`) are supported.
                       *
                       * [WARNING]
                       * ====
                       * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure
                       * unusable.
                       * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.
                       *
                       * In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an
                       * array of EnumerableSet.
                       * ====
                       */
                      library EnumerableSet {
                          // To implement this library for multiple types with as little code
                          // repetition as possible, we write it in terms of a generic Set type with
                          // bytes32 values.
                          // The Set implementation uses private functions, and user-facing
                          // implementations (such as AddressSet) are just wrappers around the
                          // underlying Set.
                          // This means that we can only create new EnumerableSets for types that fit
                          // in bytes32.
                          struct Set {
                              // Storage of set values
                              bytes32[] _values;
                              // Position of the value in the `values` array, plus 1 because index 0
                              // means a value is not in the set.
                              mapping(bytes32 => uint256) _indexes;
                          }
                          /**
                           * @dev Add a value to a set. O(1).
                           *
                           * Returns true if the value was added to the set, that is if it was not
                           * already present.
                           */
                          function _add(Set storage set, bytes32 value) private returns (bool) {
                              if (!_contains(set, value)) {
                                  set._values.push(value);
                                  // The value is stored at length-1, but we add 1 to all indexes
                                  // and use 0 as a sentinel value
                                  set._indexes[value] = set._values.length;
                                  return true;
                              } else {
                                  return false;
                              }
                          }
                          /**
                           * @dev Removes a value from a set. O(1).
                           *
                           * Returns true if the value was removed from the set, that is if it was
                           * present.
                           */
                          function _remove(Set storage set, bytes32 value) private returns (bool) {
                              // We read and store the value's index to prevent multiple reads from the same storage slot
                              uint256 valueIndex = set._indexes[value];
                              if (valueIndex != 0) {
                                  // Equivalent to contains(set, value)
                                  // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
                                  // the array, and then remove the last element (sometimes called as 'swap and pop').
                                  // This modifies the order of the array, as noted in {at}.
                                  uint256 toDeleteIndex = valueIndex - 1;
                                  uint256 lastIndex = set._values.length - 1;
                                  if (lastIndex != toDeleteIndex) {
                                      bytes32 lastValue = set._values[lastIndex];
                                      // Move the last value to the index where the value to delete is
                                      set._values[toDeleteIndex] = lastValue;
                                      // Update the index for the moved value
                                      set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex
                                  }
                                  // Delete the slot where the moved value was stored
                                  set._values.pop();
                                  // Delete the index for the deleted slot
                                  delete set._indexes[value];
                                  return true;
                              } else {
                                  return false;
                              }
                          }
                          /**
                           * @dev Returns true if the value is in the set. O(1).
                           */
                          function _contains(Set storage set, bytes32 value) private view returns (bool) {
                              return set._indexes[value] != 0;
                          }
                          /**
                           * @dev Returns the number of values on the set. O(1).
                           */
                          function _length(Set storage set) private view returns (uint256) {
                              return set._values.length;
                          }
                          /**
                           * @dev Returns the value stored at position `index` in the set. O(1).
                           *
                           * Note that there are no guarantees on the ordering of values inside the
                           * array, and it may change when more values are added or removed.
                           *
                           * Requirements:
                           *
                           * - `index` must be strictly less than {length}.
                           */
                          function _at(Set storage set, uint256 index) private view returns (bytes32) {
                              return set._values[index];
                          }
                          /**
                           * @dev Return the entire set in an array
                           *
                           * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
                           * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
                           * this function has an unbounded cost, and using it as part of a state-changing function may render the function
                           * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
                           */
                          function _values(Set storage set) private view returns (bytes32[] memory) {
                              return set._values;
                          }
                          // Bytes32Set
                          struct Bytes32Set {
                              Set _inner;
                          }
                          /**
                           * @dev Add a value to a set. O(1).
                           *
                           * Returns true if the value was added to the set, that is if it was not
                           * already present.
                           */
                          function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
                              return _add(set._inner, value);
                          }
                          /**
                           * @dev Removes a value from a set. O(1).
                           *
                           * Returns true if the value was removed from the set, that is if it was
                           * present.
                           */
                          function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
                              return _remove(set._inner, value);
                          }
                          /**
                           * @dev Returns true if the value is in the set. O(1).
                           */
                          function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
                              return _contains(set._inner, value);
                          }
                          /**
                           * @dev Returns the number of values in the set. O(1).
                           */
                          function length(Bytes32Set storage set) internal view returns (uint256) {
                              return _length(set._inner);
                          }
                          /**
                           * @dev Returns the value stored at position `index` in the set. O(1).
                           *
                           * Note that there are no guarantees on the ordering of values inside the
                           * array, and it may change when more values are added or removed.
                           *
                           * Requirements:
                           *
                           * - `index` must be strictly less than {length}.
                           */
                          function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
                              return _at(set._inner, index);
                          }
                          /**
                           * @dev Return the entire set in an array
                           *
                           * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
                           * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
                           * this function has an unbounded cost, and using it as part of a state-changing function may render the function
                           * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
                           */
                          function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
                              bytes32[] memory store = _values(set._inner);
                              bytes32[] memory result;
                              /// @solidity memory-safe-assembly
                              assembly {
                                  result := store
                              }
                              return result;
                          }
                          // AddressSet
                          struct AddressSet {
                              Set _inner;
                          }
                          /**
                           * @dev Add a value to a set. O(1).
                           *
                           * Returns true if the value was added to the set, that is if it was not
                           * already present.
                           */
                          function add(AddressSet storage set, address value) internal returns (bool) {
                              return _add(set._inner, bytes32(uint256(uint160(value))));
                          }
                          /**
                           * @dev Removes a value from a set. O(1).
                           *
                           * Returns true if the value was removed from the set, that is if it was
                           * present.
                           */
                          function remove(AddressSet storage set, address value) internal returns (bool) {
                              return _remove(set._inner, bytes32(uint256(uint160(value))));
                          }
                          /**
                           * @dev Returns true if the value is in the set. O(1).
                           */
                          function contains(AddressSet storage set, address value) internal view returns (bool) {
                              return _contains(set._inner, bytes32(uint256(uint160(value))));
                          }
                          /**
                           * @dev Returns the number of values in the set. O(1).
                           */
                          function length(AddressSet storage set) internal view returns (uint256) {
                              return _length(set._inner);
                          }
                          /**
                           * @dev Returns the value stored at position `index` in the set. O(1).
                           *
                           * Note that there are no guarantees on the ordering of values inside the
                           * array, and it may change when more values are added or removed.
                           *
                           * Requirements:
                           *
                           * - `index` must be strictly less than {length}.
                           */
                          function at(AddressSet storage set, uint256 index) internal view returns (address) {
                              return address(uint160(uint256(_at(set._inner, index))));
                          }
                          /**
                           * @dev Return the entire set in an array
                           *
                           * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
                           * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
                           * this function has an unbounded cost, and using it as part of a state-changing function may render the function
                           * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
                           */
                          function values(AddressSet storage set) internal view returns (address[] memory) {
                              bytes32[] memory store = _values(set._inner);
                              address[] memory result;
                              /// @solidity memory-safe-assembly
                              assembly {
                                  result := store
                              }
                              return result;
                          }
                          // UintSet
                          struct UintSet {
                              Set _inner;
                          }
                          /**
                           * @dev Add a value to a set. O(1).
                           *
                           * Returns true if the value was added to the set, that is if it was not
                           * already present.
                           */
                          function add(UintSet storage set, uint256 value) internal returns (bool) {
                              return _add(set._inner, bytes32(value));
                          }
                          /**
                           * @dev Removes a value from a set. O(1).
                           *
                           * Returns true if the value was removed from the set, that is if it was
                           * present.
                           */
                          function remove(UintSet storage set, uint256 value) internal returns (bool) {
                              return _remove(set._inner, bytes32(value));
                          }
                          /**
                           * @dev Returns true if the value is in the set. O(1).
                           */
                          function contains(UintSet storage set, uint256 value) internal view returns (bool) {
                              return _contains(set._inner, bytes32(value));
                          }
                          /**
                           * @dev Returns the number of values in the set. O(1).
                           */
                          function length(UintSet storage set) internal view returns (uint256) {
                              return _length(set._inner);
                          }
                          /**
                           * @dev Returns the value stored at position `index` in the set. O(1).
                           *
                           * Note that there are no guarantees on the ordering of values inside the
                           * array, and it may change when more values are added or removed.
                           *
                           * Requirements:
                           *
                           * - `index` must be strictly less than {length}.
                           */
                          function at(UintSet storage set, uint256 index) internal view returns (uint256) {
                              return uint256(_at(set._inner, index));
                          }
                          /**
                           * @dev Return the entire set in an array
                           *
                           * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
                           * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
                           * this function has an unbounded cost, and using it as part of a state-changing function may render the function
                           * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
                           */
                          function values(UintSet storage set) internal view returns (uint256[] memory) {
                              bytes32[] memory store = _values(set._inner);
                              uint256[] memory result;
                              /// @solidity memory-safe-assembly
                              assembly {
                                  result := store
                              }
                              return result;
                          }
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      /// @dev simply a container of endpoint address and local eid
                      abstract contract MessageLibBase {
                          address internal immutable endpoint;
                          uint32 internal immutable localEid;
                          error LZ_MessageLib_OnlyEndpoint();
                          modifier onlyEndpoint() {
                              if (endpoint != msg.sender) revert LZ_MessageLib_OnlyEndpoint();
                              _;
                          }
                          constructor(address _endpoint, uint32 _localEid) {
                              endpoint = _endpoint;
                              localEid = _localEid;
                          }
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      import { Pausable } from "@openzeppelin/contracts/security/Pausable.sol";
                      import { AccessControl } from "@openzeppelin/contracts/access/AccessControl.sol";
                      import { ISendLib } from "@layerzerolabs/lz-evm-protocol-v2/contracts/interfaces/ISendLib.sol";
                      import { Transfer } from "@layerzerolabs/lz-evm-protocol-v2/contracts/libs/Transfer.sol";
                      import { IWorker } from "./interfaces/IWorker.sol";
                      abstract contract Worker is AccessControl, Pausable, IWorker {
                          bytes32 internal constant MESSAGE_LIB_ROLE = keccak256("MESSAGE_LIB_ROLE");
                          bytes32 internal constant ALLOWLIST = keccak256("ALLOWLIST");
                          bytes32 internal constant DENYLIST = keccak256("DENYLIST");
                          bytes32 internal constant ADMIN_ROLE = keccak256("ADMIN_ROLE");
                          address public workerFeeLib;
                          uint64 public allowlistSize;
                          uint16 public defaultMultiplierBps;
                          address public priceFeed;
                          mapping(uint32 eid => uint8[] optionTypes) internal supportedOptionTypes;
                          // ========================= Constructor =========================
                          /// @param _messageLibs array of message lib addresses that are granted the MESSAGE_LIB_ROLE
                          /// @param _priceFeed price feed address
                          /// @param _defaultMultiplierBps default multiplier for worker fee
                          /// @param _roleAdmin address that is granted the DEFAULT_ADMIN_ROLE (can grant and revoke all roles)
                          /// @param _admins array of admin addresses that are granted the ADMIN_ROLE
                          constructor(
                              address[] memory _messageLibs,
                              address _priceFeed,
                              uint16 _defaultMultiplierBps,
                              address _roleAdmin,
                              address[] memory _admins
                          ) {
                              defaultMultiplierBps = _defaultMultiplierBps;
                              priceFeed = _priceFeed;
                              if (_roleAdmin != address(0x0)) {
                                  _grantRole(DEFAULT_ADMIN_ROLE, _roleAdmin); // _roleAdmin can grant and revoke all roles
                              }
                              for (uint256 i = 0; i < _messageLibs.length; ++i) {
                                  _grantRole(MESSAGE_LIB_ROLE, _messageLibs[i]);
                              }
                              for (uint256 i = 0; i < _admins.length; ++i) {
                                  _grantRole(ADMIN_ROLE, _admins[i]);
                              }
                          }
                          // ========================= Modifier =========================
                          modifier onlyAcl(address _sender) {
                              if (!hasAcl(_sender)) {
                                  revert Worker_NotAllowed();
                              }
                              _;
                          }
                          /// @dev Access control list using allowlist and denylist
                          /// @dev 1) if one address is in the denylist -> deny
                          /// @dev 2) else if address in the allowlist OR allowlist is empty (allows everyone)-> allow
                          /// @dev 3) else deny
                          /// @param _sender address to check
                          function hasAcl(address _sender) public view returns (bool) {
                              if (hasRole(DENYLIST, _sender)) {
                                  return false;
                              } else if (allowlistSize == 0 || hasRole(ALLOWLIST, _sender)) {
                                  return true;
                              } else {
                                  return false;
                              }
                          }
                          // ========================= OnyDefaultAdmin =========================
                          /// @dev flag to pause execution of workers (if used with whenNotPaused modifier)
                          /// @param _paused true to pause, false to unpause
                          function setPaused(bool _paused) external onlyRole(DEFAULT_ADMIN_ROLE) {
                              if (_paused) {
                                  _pause();
                              } else {
                                  _unpause();
                              }
                          }
                          // ========================= OnlyAdmin =========================
                          /// @param _priceFeed price feed address
                          function setPriceFeed(address _priceFeed) external onlyRole(ADMIN_ROLE) {
                              priceFeed = _priceFeed;
                              emit SetPriceFeed(_priceFeed);
                          }
                          /// @param _workerFeeLib worker fee lib address
                          function setWorkerFeeLib(address _workerFeeLib) external onlyRole(ADMIN_ROLE) {
                              workerFeeLib = _workerFeeLib;
                              emit SetWorkerLib(_workerFeeLib);
                          }
                          /// @param _multiplierBps default multiplier for worker fee
                          function setDefaultMultiplierBps(uint16 _multiplierBps) external onlyRole(ADMIN_ROLE) {
                              defaultMultiplierBps = _multiplierBps;
                              emit SetDefaultMultiplierBps(_multiplierBps);
                          }
                          /// @dev supports withdrawing fee from ULN301, ULN302 and more
                          /// @param _lib message lib address
                          /// @param _to address to withdraw fee to
                          /// @param _amount amount to withdraw
                          function withdrawFee(address _lib, address _to, uint256 _amount) external onlyRole(ADMIN_ROLE) {
                              if (!hasRole(MESSAGE_LIB_ROLE, _lib)) revert Worker_OnlyMessageLib();
                              ISendLib(_lib).withdrawFee(_to, _amount);
                              emit Withdraw(_lib, _to, _amount);
                          }
                          /// @dev supports withdrawing token from the contract
                          /// @param _token token address
                          /// @param _to address to withdraw token to
                          /// @param _amount amount to withdraw
                          function withdrawToken(address _token, address _to, uint256 _amount) external onlyRole(ADMIN_ROLE) {
                              // transfers native if _token is address(0x0)
                              Transfer.nativeOrToken(_token, _to, _amount);
                          }
                          function setSupportedOptionTypes(uint32 _eid, uint8[] calldata _optionTypes) external onlyRole(ADMIN_ROLE) {
                              supportedOptionTypes[_eid] = _optionTypes;
                          }
                          // ========================= View Functions =========================
                          function getSupportedOptionTypes(uint32 _eid) external view returns (uint8[] memory) {
                              return supportedOptionTypes[_eid];
                          }
                          // ========================= Internal Functions =========================
                          /// @dev overrides AccessControl to allow for counting of allowlistSize
                          /// @param _role role to grant
                          /// @param _account address to grant role to
                          function _grantRole(bytes32 _role, address _account) internal override {
                              if (_role == ALLOWLIST && !hasRole(_role, _account)) {
                                  ++allowlistSize;
                              }
                              super._grantRole(_role, _account);
                          }
                          /// @dev overrides AccessControl to allow for counting of allowlistSize
                          /// @param _role role to revoke
                          /// @param _account address to revoke role from
                          function _revokeRole(bytes32 _role, address _account) internal override {
                              if (_role == ALLOWLIST && hasRole(_role, _account)) {
                                  --allowlistSize;
                              }
                              super._revokeRole(_role, _account);
                          }
                          /// @dev overrides AccessControl to disable renouncing of roles
                          function renounceRole(bytes32 /*role*/, address /*account*/) public pure override {
                              revert Worker_RoleRenouncingDisabled();
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      interface ILayerZeroReadExecutor {
                          // @notice query price and assign jobs at the same time
                          // @param _sender - the source sending contract address. executors may apply price discrimination to senders
                          // @param _options - optional parameters for extra service plugins, e.g. sending dust tokens at the destination chain
                          function assignJob(address _sender, bytes calldata _options) external returns (uint256 fee);
                          // @notice query the executor price for executing the payload on this chain
                          // @param _sender - the source sending contract address. executors may apply price discrimination to senders
                          // @param _options - optional parameters for extra service plugins, e.g. sending dust tokens
                          function getFee(address _sender, bytes calldata _options) external view returns (uint256 fee);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      interface ILayerZeroTreasury {
                          function getFee(
                              address _sender,
                              uint32 _dstEid,
                              uint256 _totalNativeFee,
                              bool _payInLzToken
                          ) external view returns (uint256 fee);
                          function payFee(
                              address _sender,
                              uint32 _dstEid,
                              uint256 _totalNativeFee,
                              bool _payInLzToken
                          ) external payable returns (uint256 fee);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      interface IWorker {
                          event SetWorkerLib(address workerLib);
                          event SetPriceFeed(address priceFeed);
                          event SetDefaultMultiplierBps(uint16 multiplierBps);
                          event SetSupportedOptionTypes(uint32 dstEid, uint8[] optionTypes);
                          event Withdraw(address lib, address to, uint256 amount);
                          error Worker_NotAllowed();
                          error Worker_OnlyMessageLib();
                          error Worker_RoleRenouncingDisabled();
                          function setPriceFeed(address _priceFeed) external;
                          function priceFeed() external view returns (address);
                          function setDefaultMultiplierBps(uint16 _multiplierBps) external;
                          function defaultMultiplierBps() external view returns (uint16);
                          function withdrawFee(address _lib, address _to, uint256 _amount) external;
                          function setSupportedOptionTypes(uint32 _eid, uint8[] calldata _optionTypes) external;
                          function getSupportedOptionTypes(uint32 _eid) external view returns (uint8[] memory);
                      }
                      // SPDX-License-Identifier: MIT OR Apache-2.0
                      pragma solidity ^0.8.20;
                      /// @dev copied from https://github.com/nomad-xyz/ExcessivelySafeCall/blob/main/src/ExcessivelySafeCall.sol.
                      library SafeCall {
                          /// @notice calls a contract with a specified gas limit and value and captures the return data
                          /// @param _target The address to call
                          /// @param _gas The amount of gas to forward to the remote contract
                          /// @param _value The value in wei to send to the remote contract
                          /// to memory.
                          /// @param _maxCopy The maximum number of bytes of returndata to copy
                          /// to memory.
                          /// @param _calldata The data to send to the remote contract
                          /// @return success and returndata, as `.call()`. Returndata is capped to
                          /// `_maxCopy` bytes.
                          function safeCall(
                              address _target,
                              uint256 _gas,
                              uint256 _value,
                              uint16 _maxCopy,
                              bytes memory _calldata
                          ) internal returns (bool, bytes memory) {
                              // check that target has code
                              uint size;
                              assembly {
                                  size := extcodesize(_target)
                              }
                              if (size == 0) {
                                  return (false, new bytes(0));
                              }
                              // set up for assembly call
                              uint256 _toCopy;
                              bool _success;
                              bytes memory _returnData = new bytes(_maxCopy);
                              // dispatch message to recipient
                              // by assembly calling "handle" function
                              // we call via assembly to avoid memcopying a very large returndata
                              // returned by a malicious contract
                              assembly {
                                  _success := call(
                                      _gas, // gas
                                      _target, // recipient
                                      _value, // ether value
                                      add(_calldata, 0x20), // inloc
                                      mload(_calldata), // inlen
                                      0, // outloc
                                      0 // outlen
                                  )
                                  // limit our copy to 100 bytes
                                  _toCopy := returndatasize()
                                  if gt(_toCopy, _maxCopy) {
                                      _toCopy := _maxCopy
                                  }
                                  // Store the length of the copied bytes
                                  mstore(_returnData, _toCopy)
                                  // copy the bytes from returndata[0:_toCopy]
                                  returndatacopy(add(_returnData, 0x20), 0, _toCopy)
                              }
                              return (_success, _returnData);
                          }
                          /// @notice Use when you _really_ really _really_ don't trust the called
                          /// contract. This prevents the called contract from causing reversion of
                          /// the caller in as many ways as we can.
                          /// @dev The main difference between this and a solidity low-level call is
                          /// that we limit the number of bytes that the callee can cause to be
                          /// copied to caller memory. This prevents stupid things like malicious
                          /// contracts returning 10,000,000 bytes causing a local OOG when copying
                          /// to memory.
                          /// @param _target The address to call
                          /// @param _gas The amount of gas to forward to the remote contract
                          /// @param _maxCopy The maximum number of bytes of returndata to copy
                          /// to memory.
                          /// @param _calldata The data to send to the remote contract
                          /// @return success and returndata, as `.call()`. Returndata is capped to
                          /// `_maxCopy` bytes.
                          function safeStaticCall(
                              address _target,
                              uint256 _gas,
                              uint16 _maxCopy,
                              bytes memory _calldata
                          ) internal view returns (bool, bytes memory) {
                              // check that target has code
                              uint size;
                              assembly {
                                  size := extcodesize(_target)
                              }
                              if (size == 0) {
                                  return (false, new bytes(0));
                              }
                              // set up for assembly call
                              uint256 _toCopy;
                              bool _success;
                              bytes memory _returnData = new bytes(_maxCopy);
                              // dispatch message to recipient
                              // by assembly calling "handle" function
                              // we call via assembly to avoid memcopying a very large returndata
                              // returned by a malicious contract
                              assembly {
                                  _success := staticcall(
                                      _gas, // gas
                                      _target, // recipient
                                      add(_calldata, 0x20), // inloc
                                      mload(_calldata), // inlen
                                      0, // outloc
                                      0 // outlen
                                  )
                                  // limit our copy to 256 bytes
                                  _toCopy := returndatasize()
                                  if gt(_toCopy, _maxCopy) {
                                      _toCopy := _maxCopy
                                  }
                                  // Store the length of the copied bytes
                                  mstore(_returnData, _toCopy)
                                  // copy the bytes from returndata[0:_toCopy]
                                  returndatacopy(add(_returnData, 0x20), 0, _toCopy)
                              }
                              return (_success, _returnData);
                          }
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      import { ILayerZeroUltraLightNodeV2 } from "@layerzerolabs/lz-evm-v1-0.7/contracts/interfaces/ILayerZeroUltraLightNodeV2.sol";
                      import { Worker } from "../../Worker.sol";
                      import { MultiSig } from "./MultiSig.sol";
                      import { ReadLib1002 } from "../readlib/ReadLib1002.sol";
                      import { IDVN } from "../interfaces/IDVN.sol";
                      import { IDVNFeeLib } from "../interfaces/IDVNFeeLib.sol";
                      import { IReceiveUlnE2 } from "../interfaces/IReceiveUlnE2.sol";
                      struct ExecuteParam {
                          uint32 vid;
                          address target;
                          bytes callData;
                          uint256 expiration;
                          bytes signatures;
                      }
                      contract DVN is Worker, MultiSig, IDVN {
                          // to uniquely identify this DVN instance
                          // set to endpoint v1 eid if available OR endpoint v2 eid % 30_000
                          uint32 public immutable vid;
                          uint32 public immutable localEidV2; // endpoint-v2 only, for read call
                          mapping(uint32 dstEid => DstConfig) public dstConfig;
                          mapping(bytes32 executableHash => bool used) public usedHashes;
                          error DVN_OnlySelf();
                          error DVN_InvalidRole(bytes32 role);
                          error DVN_InstructionExpired();
                          error DVN_InvalidTarget(address target);
                          error DVN_InvalidVid(uint32 vid);
                          error DVN_InvalidSignatures();
                          error DVN_DuplicatedHash(bytes32 executableHash);
                          event VerifySignaturesFailed(uint256 idx);
                          event ExecuteFailed(uint256 _index, bytes _data);
                          event HashAlreadyUsed(ExecuteParam param, bytes32 _hash);
                          // same as DVNFeePaid, but for ULNv2
                          event VerifierFeePaid(uint256 fee);
                          // ========================= Constructor =========================
                          /// @dev DVN doesn't have a roleAdmin (address(0x0))
                          /// @dev Supports all of ULNv2, ULN301, ULN302 and more
                          /// @param _localEidV2 local endpoint-v2 eid
                          /// @param _vid unique identifier for this DVN instance
                          /// @param _messageLibs array of message lib addresses that are granted the MESSAGE_LIB_ROLE
                          /// @param _priceFeed price feed address
                          /// @param _signers array of signer addresses for multisig
                          /// @param _quorum quorum for multisig
                          /// @param _admins array of admin addresses that are granted the ADMIN_ROLE
                          constructor(
                              uint32 _localEidV2,
                              uint32 _vid,
                              address[] memory _messageLibs,
                              address _priceFeed,
                              address[] memory _signers,
                              uint64 _quorum,
                              address[] memory _admins
                          ) Worker(_messageLibs, _priceFeed, 12000, address(0x0), _admins) MultiSig(_signers, _quorum) {
                              vid = _vid;
                              localEidV2 = _localEidV2;
                          }
                          // ========================= Modifier =========================
                          /// @dev depending on role, restrict access to only self or admin
                          /// @dev ALLOWLIST, DENYLIST, MESSAGE_LIB_ROLE can only be granted/revoked by self
                          /// @dev ADMIN_ROLE can only be granted/revoked by admin
                          /// @dev reverts if not one of the above roles
                          /// @param _role role to check
                          modifier onlySelfOrAdmin(bytes32 _role) {
                              if (_role == ALLOWLIST || _role == DENYLIST || _role == MESSAGE_LIB_ROLE) {
                                  // self required
                                  if (address(this) != msg.sender) {
                                      revert DVN_OnlySelf();
                                  }
                              } else if (_role == ADMIN_ROLE) {
                                  // admin required
                                  _checkRole(ADMIN_ROLE);
                              } else {
                                  revert DVN_InvalidRole(_role);
                              }
                              _;
                          }
                          modifier onlySelf() {
                              if (address(this) != msg.sender) {
                                  revert DVN_OnlySelf();
                              }
                              _;
                          }
                          // ========================= OnlySelf =========================
                          /// @dev set signers for multisig
                          /// @dev function sig 0x31cb6105
                          /// @param _signer signer address
                          /// @param _active true to add, false to remove
                          function setSigner(address _signer, bool _active) external onlySelf {
                              _setSigner(_signer, _active);
                          }
                          /// @dev set quorum for multisig
                          /// @dev function sig 0x8585c945
                          /// @param _quorum to set
                          function setQuorum(uint64 _quorum) external onlySelf {
                              _setQuorum(_quorum);
                          }
                          // ========================= OnlySelf / OnlyAdmin =========================
                          /// @dev overrides AccessControl to allow self/admin to grant role'
                          /// @dev function sig 0x2f2ff15d
                          /// @param _role role to grant
                          /// @param _account account to grant role to
                          function grantRole(bytes32 _role, address _account) public override onlySelfOrAdmin(_role) {
                              _grantRole(_role, _account);
                          }
                          /// @dev overrides AccessControl to allow self/admin to revoke role
                          /// @dev function sig 0xd547741f
                          /// @param _role role to revoke
                          /// @param _account account to revoke role from
                          function revokeRole(bytes32 _role, address _account) public override onlySelfOrAdmin(_role) {
                              _revokeRole(_role, _account);
                          }
                          // ========================= OnlyQuorum =========================
                          /// @notice function for quorum to change admin without going through execute function
                          /// @dev calldata in the case is abi.encode new admin address
                          function quorumChangeAdmin(ExecuteParam calldata _param) external {
                              if (_param.expiration <= block.timestamp) {
                                  revert DVN_InstructionExpired();
                              }
                              if (_param.target != address(this)) {
                                  revert DVN_InvalidTarget(_param.target);
                              }
                              if (_param.vid != vid) {
                                  revert DVN_InvalidVid(_param.vid);
                              }
                              // generate and validate hash
                              bytes32 hash = hashCallData(_param.vid, _param.target, _param.callData, _param.expiration);
                              (bool sigsValid, ) = verifySignatures(hash, _param.signatures);
                              if (!sigsValid) {
                                  revert DVN_InvalidSignatures();
                              }
                              if (usedHashes[hash]) {
                                  revert DVN_DuplicatedHash(hash);
                              }
                              usedHashes[hash] = true;
                              _grantRole(ADMIN_ROLE, abi.decode(_param.callData, (address)));
                          }
                          // ========================= OnlyAdmin =========================
                          /// @param _params array of DstConfigParam
                          function setDstConfig(DstConfigParam[] calldata _params) external onlyRole(ADMIN_ROLE) {
                              for (uint256 i = 0; i < _params.length; ++i) {
                                  DstConfigParam calldata param = _params[i];
                                  dstConfig[param.dstEid] = DstConfig(param.gas, param.multiplierBps, param.floorMarginUSD);
                              }
                              emit SetDstConfig(_params);
                          }
                          /// @dev takes a list of instructions and executes them in order
                          /// @dev if any of the instructions fail, it will emit an error event and continue to execute the rest of the instructions
                          /// @param _params array of ExecuteParam, includes target, callData, expiration, signatures
                          function execute(ExecuteParam[] calldata _params) external onlyRole(ADMIN_ROLE) {
                              for (uint256 i = 0; i < _params.length; ++i) {
                                  ExecuteParam calldata param = _params[i];
                                  // 1. skip if invalid vid
                                  if (param.vid != vid) {
                                      continue;
                                  }
                                  // 2. skip if expired
                                  if (param.expiration <= block.timestamp) {
                                      continue;
                                  }
                                  // generate and validate hash
                                  bytes32 hash = hashCallData(param.vid, param.target, param.callData, param.expiration);
                                  // 3. check signatures
                                  (bool sigsValid, ) = verifySignatures(hash, param.signatures);
                                  if (!sigsValid) {
                                      emit VerifySignaturesFailed(i);
                                      continue;
                                  }
                                  // 4. should check hash
                                  bool shouldCheckHash = _shouldCheckHash(bytes4(param.callData));
                                  if (shouldCheckHash) {
                                      if (usedHashes[hash]) {
                                          emit HashAlreadyUsed(param, hash);
                                          continue;
                                      } else {
                                          usedHashes[hash] = true; // prevent reentry and replay attack
                                      }
                                  }
                                  (bool success, bytes memory rtnData) = param.target.call(param.callData);
                                  if (!success) {
                                      if (shouldCheckHash) {
                                          // need to unset the usedHash otherwise it cant be used
                                          usedHashes[hash] = false;
                                      }
                                      // emit an event in any case
                                      emit ExecuteFailed(i, rtnData);
                                  }
                              }
                          }
                          /// @dev to support ULNv2
                          /// @dev the withdrawFee function for ULN30X is built in the Worker contract
                          /// @param _lib message lib address
                          /// @param _to address to withdraw to
                          /// @param _amount amount to withdraw
                          function withdrawFeeFromUlnV2(address _lib, address payable _to, uint256 _amount) external onlyRole(ADMIN_ROLE) {
                              if (!hasRole(MESSAGE_LIB_ROLE, _lib)) {
                                  revert Worker_OnlyMessageLib();
                              }
                              ILayerZeroUltraLightNodeV2(_lib).withdrawNative(_to, _amount);
                          }
                          // ========================= OnlyMessageLib =========================
                          /// @dev for ULN301, ULN302 and more to assign job
                          /// @dev dvn network can reject job from _sender by adding/removing them from allowlist/denylist
                          /// @param _param assign job param
                          /// @param _options dvn options
                          function assignJob(
                              AssignJobParam calldata _param,
                              bytes calldata _options
                          ) external payable onlyRole(MESSAGE_LIB_ROLE) onlyAcl(_param.sender) returns (uint256 totalFee) {
                              IDVNFeeLib.FeeParams memory feeParams = IDVNFeeLib.FeeParams(
                                  priceFeed,
                                  _param.dstEid,
                                  _param.confirmations,
                                  _param.sender,
                                  quorum,
                                  defaultMultiplierBps
                              );
                              totalFee = IDVNFeeLib(workerFeeLib).getFeeOnSend(feeParams, dstConfig[_param.dstEid], _options);
                          }
                          /// @dev to support ULNv2
                          /// @dev dvn network can reject job from _sender by adding/removing them from allowlist/denylist
                          /// @param _dstEid destination EndpointId
                          /// @param //_outboundProofType outbound proof type
                          /// @param _confirmations block confirmations
                          /// @param _sender message sender address
                          function assignJob(
                              uint16 _dstEid,
                              uint16 /*_outboundProofType*/,
                              uint64 _confirmations,
                              address _sender
                          ) external onlyRole(MESSAGE_LIB_ROLE) onlyAcl(_sender) returns (uint256 totalFee) {
                              IDVNFeeLib.FeeParams memory params = IDVNFeeLib.FeeParams(
                                  priceFeed,
                                  _dstEid,
                                  _confirmations,
                                  _sender,
                                  quorum,
                                  defaultMultiplierBps
                              );
                              // ULNV2 does not have dvn options
                              totalFee = IDVNFeeLib(workerFeeLib).getFeeOnSend(params, dstConfig[_dstEid], bytes(""));
                              emit VerifierFeePaid(totalFee);
                          }
                          /// @dev to support ReadLib
                          // @param _packetHeader - version + nonce + path
                          // @param _cmd - the command to be executed to obtain the payload
                          // @param _options - options
                          function assignJob(
                              address _sender,
                              bytes calldata /*_packetHeader*/,
                              bytes calldata _cmd,
                              bytes calldata _options
                          ) external payable onlyRole(MESSAGE_LIB_ROLE) onlyAcl(_sender) returns (uint256 fee) {
                              IDVNFeeLib.FeeParamsForRead memory feeParams = IDVNFeeLib.FeeParamsForRead(
                                  priceFeed,
                                  _sender,
                                  quorum,
                                  defaultMultiplierBps
                              );
                              fee = IDVNFeeLib(workerFeeLib).getFeeOnSend(feeParams, dstConfig[localEidV2], _cmd, _options);
                          }
                          // ========================= View =========================
                          /// @dev getFee can revert if _sender doesn't pass ACL
                          /// @param _dstEid destination EndpointId
                          /// @param _confirmations block confirmations
                          /// @param _sender message sender address
                          /// @param _options dvn options
                          /// @return fee fee in native amount
                          function getFee(
                              uint32 _dstEid,
                              uint64 _confirmations,
                              address _sender,
                              bytes calldata _options
                          ) external view onlyAcl(_sender) returns (uint256 fee) {
                              IDVNFeeLib.FeeParams memory params = IDVNFeeLib.FeeParams(
                                  priceFeed,
                                  _dstEid,
                                  _confirmations,
                                  _sender,
                                  quorum,
                                  defaultMultiplierBps
                              );
                              fee = IDVNFeeLib(workerFeeLib).getFee(params, dstConfig[_dstEid], _options);
                          }
                          /// @dev to support ULNv2
                          /// @dev getFee can revert if _sender doesn't pass ACL
                          /// @param _dstEid destination EndpointId
                          /// @param //_outboundProofType outbound proof type
                          /// @param _confirmations block confirmations
                          /// @param _sender message sender address
                          function getFee(
                              uint16 _dstEid,
                              uint16 /*_outboundProofType*/,
                              uint64 _confirmations,
                              address _sender
                          ) public view onlyAcl(_sender) returns (uint256 fee) {
                              IDVNFeeLib.FeeParams memory params = IDVNFeeLib.FeeParams(
                                  priceFeed,
                                  _dstEid,
                                  _confirmations,
                                  _sender,
                                  quorum,
                                  defaultMultiplierBps
                              );
                              fee = IDVNFeeLib(workerFeeLib).getFee(params, dstConfig[_dstEid], bytes(""));
                          }
                          /// @dev to support ReadLib
                          // @param _packetHeader - version + nonce + path
                          // @param _cmd - the command to be executed to obtain the payload
                          // @param _options - options
                          function getFee(
                              address _sender,
                              bytes calldata /*_packetHeader*/,
                              bytes calldata _cmd,
                              bytes calldata _options
                          ) external view onlyAcl(_sender) returns (uint256 fee) {
                              IDVNFeeLib.FeeParamsForRead memory feeParams = IDVNFeeLib.FeeParamsForRead(
                                  priceFeed,
                                  _sender,
                                  quorum,
                                  defaultMultiplierBps
                              );
                              fee = IDVNFeeLib(workerFeeLib).getFee(feeParams, dstConfig[localEidV2], _cmd, _options);
                          }
                          /// @param _target target address
                          /// @param _callData call data
                          /// @param _expiration expiration timestamp
                          /// @return hash of above
                          function hashCallData(
                              uint32 _vid,
                              address _target,
                              bytes calldata _callData,
                              uint256 _expiration
                          ) public pure returns (bytes32) {
                              return keccak256(abi.encodePacked(_vid, _target, _expiration, _callData));
                          }
                          // ========================= Internal =========================
                          /// @dev to save gas, we don't check hash for some functions (where replaying won't change the state)
                          /// @dev for example, some administrative functions like changing signers, the contract should check hash to double spending
                          /// @dev should ensure that all onlySelf functions have unique functionSig
                          /// @param _functionSig function signature
                          /// @return true if should check hash
                          function _shouldCheckHash(bytes4 _functionSig) internal pure returns (bool) {
                              // never check for these selectors to save gas
                              return
                                  _functionSig != IReceiveUlnE2.verify.selector && // 0x0223536e, replaying won't change the state
                                  _functionSig != ReadLib1002.verify.selector && // 0xab750e75, replaying won't change the state
                                  _functionSig != ILayerZeroUltraLightNodeV2.updateHash.selector; // 0x704316e5, replaying will be revert at uln
                          }
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      import { ECDSA } from "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
                      import { EnumerableSet } from "@openzeppelin/contracts/utils/structs/EnumerableSet.sol";
                      abstract contract MultiSig {
                          using EnumerableSet for EnumerableSet.AddressSet;
                          enum Errors {
                              NoError,
                              SignatureError,
                              DuplicatedSigner,
                              SignerNotInCommittee
                          }
                          EnumerableSet.AddressSet internal signerSet;
                          uint64 public quorum;
                          error MultiSig_OnlySigner();
                          error MultiSig_QuorumIsZero();
                          error MultiSig_SignersSizeIsLessThanQuorum(uint64 signersSize, uint64 quorum);
                          error MultiSig_UnorderedSigners();
                          error MultiSig_StateAlreadySet(address signer, bool active);
                          error MultiSig_StateNotSet(address signer, bool active);
                          error MultiSig_InvalidSigner();
                          event UpdateSigner(address _signer, bool _active);
                          event UpdateQuorum(uint64 _quorum);
                          modifier onlySigner() {
                              if (!isSigner(msg.sender)) {
                                  revert MultiSig_OnlySigner();
                              }
                              _;
                          }
                          constructor(address[] memory _signers, uint64 _quorum) {
                              if (_quorum == 0) {
                                  revert MultiSig_QuorumIsZero();
                              }
                              for (uint256 i = 0; i < _signers.length; i++) {
                                  address signer = _signers[i];
                                  if (signer == address(0)) {
                                      revert MultiSig_InvalidSigner();
                                  }
                                  signerSet.add(signer);
                              }
                              uint64 _signerSize = uint64(signerSet.length());
                              if (_signerSize < _quorum) {
                                  revert MultiSig_SignersSizeIsLessThanQuorum(_signerSize, _quorum);
                              }
                              quorum = _quorum;
                          }
                          function _setSigner(address _signer, bool _active) internal {
                              if (_active) {
                                  if (_signer == address(0)) {
                                      revert MultiSig_InvalidSigner();
                                  }
                                  if (!signerSet.add(_signer)) {
                                      revert MultiSig_StateAlreadySet(_signer, _active);
                                  }
                              } else {
                                  if (!signerSet.remove(_signer)) {
                                      revert MultiSig_StateNotSet(_signer, _active);
                                  }
                              }
                              uint64 _signerSize = uint64(signerSet.length());
                              uint64 _quorum = quorum;
                              if (_signerSize < _quorum) {
                                  revert MultiSig_SignersSizeIsLessThanQuorum(_signerSize, _quorum);
                              }
                              emit UpdateSigner(_signer, _active);
                          }
                          function _setQuorum(uint64 _quorum) internal {
                              if (_quorum == 0) {
                                  revert MultiSig_QuorumIsZero();
                              }
                              uint64 _signerSize = uint64(signerSet.length());
                              if (_signerSize < _quorum) {
                                  revert MultiSig_SignersSizeIsLessThanQuorum(_signerSize, _quorum);
                              }
                              quorum = _quorum;
                              emit UpdateQuorum(_quorum);
                          }
                          function verifySignatures(bytes32 _hash, bytes calldata _signatures) public view returns (bool, Errors) {
                              if (_signatures.length != uint256(quorum) * 65) {
                                  return (false, Errors.SignatureError);
                              }
                              bytes32 messageDigest = _getEthSignedMessageHash(_hash);
                              address lastSigner = address(0); // There cannot be a signer with address 0.
                              for (uint256 i = 0; i < quorum; i++) {
                                  // the quorum is guaranteed not to be zero in the constructor and setter
                                  bytes calldata signature = _signatures[i * 65:(i + 1) * 65];
                                  (address currentSigner, ECDSA.RecoverError error) = ECDSA.tryRecover(messageDigest, signature);
                                  if (error != ECDSA.RecoverError.NoError) return (false, Errors.SignatureError);
                                  if (currentSigner <= lastSigner) return (false, Errors.DuplicatedSigner); // prevent duplicate signatures, the signers must be ordered to sign the digest
                                  if (!isSigner(currentSigner)) return (false, Errors.SignerNotInCommittee); // signature is not in committee
                                  lastSigner = currentSigner;
                              }
                              return (true, Errors.NoError);
                          }
                          function _getEthSignedMessageHash(bytes32 _messageHash) internal pure returns (bytes32) {
                              return keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
                      32", _messageHash));
                          }
                          // ============================================== View ==============================================
                          function getSigners() public view returns (address[] memory) {
                              return signerSet.values();
                          }
                          // compatibility with the previous version
                          function signers(address _signer) public view returns (bool) {
                              return isSigner(_signer);
                          }
                          function isSigner(address _signer) public view returns (bool) {
                              return signerSet.contains(_signer);
                          }
                          function signerSize() public view returns (uint256) {
                              return signerSet.length();
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      import { IWorker } from "../../interfaces/IWorker.sol";
                      import { ILayerZeroDVN } from "./ILayerZeroDVN.sol";
                      import { ILayerZeroReadDVN } from "./ILayerZeroReadDVN.sol";
                      interface IDVN is IWorker, ILayerZeroDVN, ILayerZeroReadDVN {
                          struct DstConfigParam {
                              uint32 dstEid;
                              uint64 gas;
                              uint16 multiplierBps;
                              uint128 floorMarginUSD;
                          }
                          struct DstConfig {
                              uint64 gas;
                              uint16 multiplierBps;
                              uint128 floorMarginUSD; // uses priceFeed PRICE_RATIO_DENOMINATOR
                          }
                          event SetDstConfig(DstConfigParam[] params);
                          function dstConfig(uint32 _dstEid) external view returns (uint64, uint16, uint128);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      import { IDVN } from "./IDVN.sol";
                      interface IDVNFeeLib {
                          struct FeeParams {
                              address priceFeed;
                              uint32 dstEid;
                              uint64 confirmations;
                              address sender;
                              uint64 quorum;
                              uint16 defaultMultiplierBps;
                          }
                          struct FeeParamsForRead {
                              address priceFeed;
                              address sender;
                              uint64 quorum;
                              uint16 defaultMultiplierBps;
                          }
                          error DVN_UnsupportedOptionType(uint8 optionType);
                          error DVN_EidNotSupported(uint32 eid);
                          error DVN_TimestampOutOfRange(uint32 eid, uint64 timestamp);
                          error DVN_INVALID_INPUT_LENGTH();
                          function getFeeOnSend(
                              FeeParams calldata _params,
                              IDVN.DstConfig calldata _dstConfig,
                              bytes calldata _options
                          ) external payable returns (uint256 fee);
                          function getFee(
                              FeeParams calldata _params,
                              IDVN.DstConfig calldata _dstConfig,
                              bytes calldata _options
                          ) external view returns (uint256 fee);
                          function getFeeOnSend(
                              FeeParamsForRead calldata _params,
                              IDVN.DstConfig calldata _dstConfig,
                              bytes calldata _cmd,
                              bytes calldata _options
                          ) external payable returns (uint256 fee);
                          function getFee(
                              FeeParamsForRead calldata _params,
                              IDVN.DstConfig calldata _dstConfig,
                              bytes calldata _cmd,
                              bytes calldata _options
                          ) external view returns (uint256 fee);
                          function version() external view returns (uint64 major, uint8 minor);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      interface ILayerZeroDVN {
                          struct AssignJobParam {
                              uint32 dstEid;
                              bytes packetHeader;
                              bytes32 payloadHash;
                              uint64 confirmations;
                              address sender;
                          }
                          // @notice query price and assign jobs at the same time
                          // @param _dstEid - the destination endpoint identifier
                          // @param _packetHeader - version + nonce + path
                          // @param _payloadHash - hash of guid + message
                          // @param _confirmations - block confirmation delay before relaying blocks
                          // @param _sender - the source sending contract address
                          // @param _options - options
                          function assignJob(AssignJobParam calldata _param, bytes calldata _options) external payable returns (uint256 fee);
                          // @notice query the dvn fee for relaying block information to the destination chain
                          // @param _dstEid the destination endpoint identifier
                          // @param _confirmations - block confirmation delay before relaying blocks
                          // @param _sender - the source sending contract address
                          // @param _options - options
                          function getFee(
                              uint32 _dstEid,
                              uint64 _confirmations,
                              address _sender,
                              bytes calldata _options
                          ) external view returns (uint256 fee);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      interface ILayerZeroReadDVN {
                          // @notice query price and assign jobs at the same time
                          // @param _packetHeader - version + nonce + path
                          // @param _cmd - the command to be executed to obtain the payload
                          // @param _options - options
                          function assignJob(
                              address _sender,
                              bytes calldata _packetHeader,
                              bytes calldata _cmd,
                              bytes calldata _options
                          ) external payable returns (uint256 fee);
                          // @notice query the dvn fee for relaying block information to the destination chain
                          // @param _packetHeader - version + nonce + path
                          // @param _cmd - the command to be executed to obtain the payload
                          // @param _options - options
                          function getFee(
                              address _sender,
                              bytes calldata _packetHeader,
                              bytes calldata _cmd,
                              bytes calldata _options
                          ) external view returns (uint256 fee);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.8.0;
                      /// @dev should be implemented by the ReceiveUln302 contract and future ReceiveUln contracts on EndpointV2
                      interface IReceiveUlnE2 {
                          /// @notice for each dvn to verify the payload
                          /// @dev this function signature 0x0223536e
                          function verify(bytes calldata _packetHeader, bytes32 _payloadHash, uint64 _confirmations) external;
                          /// @notice verify the payload at endpoint, will check if all DVNs verified
                          function commitVerification(bytes calldata _packetHeader, bytes32 _payloadHash) external;
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      import { BytesLib } from "solidity-bytes-utils/contracts/BytesLib.sol";
                      import { BitMap256 } from "@layerzerolabs/lz-evm-protocol-v2/contracts/messagelib/libs/BitMaps.sol";
                      import { CalldataBytesLib } from "@layerzerolabs/lz-evm-protocol-v2/contracts/libs/CalldataBytesLib.sol";
                      library DVNOptions {
                          using CalldataBytesLib for bytes;
                          using BytesLib for bytes;
                          uint8 internal constant WORKER_ID = 2;
                          uint8 internal constant OPTION_TYPE_PRECRIME = 1;
                          error DVN_InvalidDVNIdx();
                          error DVN_InvalidDVNOptions(uint256 cursor);
                          /// @dev group dvn options by its idx
                          /// @param _options [dvn_id][dvn_option][dvn_id][dvn_option]...
                          ///        dvn_option = [option_size][dvn_idx][option_type][option]
                          ///        option_size = len(dvn_idx) + len(option_type) + len(option)
                          ///        dvn_id: uint8, dvn_idx: uint8, option_size: uint16, option_type: uint8, option: bytes
                          /// @return dvnOptions the grouped options, still share the same format of _options
                          /// @return dvnIndices the dvn indices
                          function groupDVNOptionsByIdx(
                              bytes memory _options
                          ) internal pure returns (bytes[] memory dvnOptions, uint8[] memory dvnIndices) {
                              if (_options.length == 0) return (dvnOptions, dvnIndices);
                              uint8 numDVNs = getNumDVNs(_options);
                              // if there is only 1 dvn, we can just return the whole options
                              if (numDVNs == 1) {
                                  dvnOptions = new bytes[](1);
                                  dvnOptions[0] = _options;
                                  dvnIndices = new uint8[](1);
                                  dvnIndices[0] = _options.toUint8(3); // dvn idx
                                  return (dvnOptions, dvnIndices);
                              }
                              // otherwise, we need to group the options by dvn_idx
                              dvnIndices = new uint8[](numDVNs);
                              dvnOptions = new bytes[](numDVNs);
                              unchecked {
                                  uint256 cursor = 0;
                                  uint256 start = 0;
                                  uint8 lastDVNIdx = 255; // 255 is an invalid dvn_idx
                                  while (cursor < _options.length) {
                                      ++cursor; // skip worker_id
                                      // optionLength asserted in getNumDVNs (skip check)
                                      uint16 optionLength = _options.toUint16(cursor);
                                      cursor += 2;
                                      // dvnIdx asserted in getNumDVNs (skip check)
                                      uint8 dvnIdx = _options.toUint8(cursor);
                                      // dvnIdx must equal to the lastDVNIdx for the first option
                                      // so it is always skipped in the first option
                                      // this operation slices out options whenever the scan finds a different lastDVNIdx
                                      if (lastDVNIdx == 255) {
                                          lastDVNIdx = dvnIdx;
                                      } else if (dvnIdx != lastDVNIdx) {
                                          uint256 len = cursor - start - 3; // 3 is for worker_id and option_length
                                          bytes memory opt = _options.slice(start, len);
                                          _insertDVNOptions(dvnOptions, dvnIndices, lastDVNIdx, opt);
                                          // reset the start and lastDVNIdx
                                          start += len;
                                          lastDVNIdx = dvnIdx;
                                      }
                                      cursor += optionLength;
                                  }
                                  // skip check the cursor here because the cursor is asserted in getNumDVNs
                                  // if we have reached the end of the options, we need to process the last dvn
                                  uint256 size = cursor - start;
                                  bytes memory op = _options.slice(start, size);
                                  _insertDVNOptions(dvnOptions, dvnIndices, lastDVNIdx, op);
                                  // revert dvnIndices to start from 0
                                  for (uint8 i = 0; i < numDVNs; ++i) {
                                      --dvnIndices[i];
                                  }
                              }
                          }
                          function _insertDVNOptions(
                              bytes[] memory _dvnOptions,
                              uint8[] memory _dvnIndices,
                              uint8 _dvnIdx,
                              bytes memory _newOptions
                          ) internal pure {
                              // dvnIdx starts from 0 but default value of dvnIndices is 0,
                              // so we tell if the slot is empty by adding 1 to dvnIdx
                              if (_dvnIdx == 255) revert DVN_InvalidDVNIdx();
                              uint8 dvnIdxAdj = _dvnIdx + 1;
                              for (uint256 j = 0; j < _dvnIndices.length; ++j) {
                                  uint8 index = _dvnIndices[j];
                                  if (dvnIdxAdj == index) {
                                      _dvnOptions[j] = abi.encodePacked(_dvnOptions[j], _newOptions);
                                      break;
                                  } else if (index == 0) {
                                      // empty slot, that means it is the first time we see this dvn
                                      _dvnIndices[j] = dvnIdxAdj;
                                      _dvnOptions[j] = _newOptions;
                                      break;
                                  }
                              }
                          }
                          /// @dev get the number of unique dvns
                          /// @param _options the format is the same as groupDVNOptionsByIdx
                          function getNumDVNs(bytes memory _options) internal pure returns (uint8 numDVNs) {
                              uint256 cursor = 0;
                              BitMap256 bitmap;
                              // find number of unique dvn_idx
                              unchecked {
                                  while (cursor < _options.length) {
                                      ++cursor; // skip worker_id
                                      uint16 optionLength = _options.toUint16(cursor);
                                      cursor += 2;
                                      if (optionLength < 2) revert DVN_InvalidDVNOptions(cursor); // at least 1 byte for dvn_idx and 1 byte for option_type
                                      uint8 dvnIdx = _options.toUint8(cursor);
                                      // if dvnIdx is not set, increment numDVNs
                                      // max num of dvns is 255, 255 is an invalid dvn_idx
                                      // The order of the dvnIdx is not required to be sequential, as enforcing the order may weaken
                                      // the composability of the options. e.g. if we refrain from enforcing the order, an OApp that has
                                      // already enforced certain options can append additional options to the end of the enforced
                                      // ones without restrictions.
                                      if (dvnIdx == 255) revert DVN_InvalidDVNIdx();
                                      if (!bitmap.get(dvnIdx)) {
                                          ++numDVNs;
                                          bitmap = bitmap.set(dvnIdx);
                                      }
                                      cursor += optionLength;
                                  }
                              }
                              if (cursor != _options.length) revert DVN_InvalidDVNOptions(cursor);
                          }
                          /// @dev decode the next dvn option from _options starting from the specified cursor
                          /// @param _options the format is the same as groupDVNOptionsByIdx
                          /// @param _cursor the cursor to start decoding
                          /// @return optionType the type of the option
                          /// @return option the option
                          /// @return cursor the cursor to start decoding the next option
                          function nextDVNOption(
                              bytes calldata _options,
                              uint256 _cursor
                          ) internal pure returns (uint8 optionType, bytes calldata option, uint256 cursor) {
                              unchecked {
                                  // skip worker id
                                  cursor = _cursor + 1;
                                  // read option size
                                  uint16 size = _options.toU16(cursor);
                                  cursor += 2;
                                  // read option type
                                  optionType = _options.toU8(cursor + 1); // skip dvn_idx
                                  // startCursor and endCursor are used to slice the option from _options
                                  uint256 startCursor = cursor + 2; // skip option type and dvn_idx
                                  uint256 endCursor = cursor + size;
                                  option = _options[startCursor:endCursor];
                                  cursor += size;
                              }
                          }
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      import { SafeCast } from "@openzeppelin/contracts/utils/math/SafeCast.sol";
                      import { ExecutorOptions } from "@layerzerolabs/lz-evm-protocol-v2/contracts/messagelib/libs/ExecutorOptions.sol";
                      import { DVNOptions } from "./DVNOptions.sol";
                      library UlnOptions {
                          using SafeCast for uint256;
                          uint16 internal constant TYPE_1 = 1; // legacy options type 1
                          uint16 internal constant TYPE_2 = 2; // legacy options type 2
                          uint16 internal constant TYPE_3 = 3;
                          error LZ_ULN_InvalidWorkerOptions(uint256 cursor);
                          error LZ_ULN_InvalidWorkerId(uint8 workerId);
                          error LZ_ULN_InvalidLegacyType1Option();
                          error LZ_ULN_InvalidLegacyType2Option();
                          error LZ_ULN_UnsupportedOptionType(uint16 optionType);
                          /// @dev decode the options into executorOptions and dvnOptions
                          /// @param _options the options can be either legacy options (type 1 or 2) or type 3 options
                          /// @return executorOptions the executor options, share the same format of type 3 options
                          /// @return dvnOptions the dvn options, share the same format of type 3 options
                          function decode(
                              bytes calldata _options
                          ) internal pure returns (bytes memory executorOptions, bytes memory dvnOptions) {
                              // at least 2 bytes for the option type, but can have no options
                              if (_options.length < 2) revert LZ_ULN_InvalidWorkerOptions(0);
                              uint16 optionsType = uint16(bytes2(_options[0:2]));
                              uint256 cursor = 2;
                              // type3 options: [worker_option][worker_option]...
                              // worker_option: [worker_id][option_size][option]
                              // worker_id: uint8, option_size: uint16, option: bytes
                              if (optionsType == TYPE_3) {
                                  unchecked {
                                      uint256 start = cursor;
                                      uint8 lastWorkerId; // worker_id starts from 1, so 0 is an invalid worker_id
                                      // heuristic: we assume that the options are mostly EXECUTOR options only
                                      // checking the workerID can reduce gas usage for most cases
                                      while (cursor < _options.length) {
                                          uint8 workerId = uint8(bytes1(_options[cursor:cursor + 1]));
                                          if (workerId == 0) revert LZ_ULN_InvalidWorkerId(0);
                                          // workerId must equal to the lastWorkerId for the first option
                                          // so it is always skipped in the first option
                                          // this operation slices out options whenever the the scan finds a different workerId
                                          if (lastWorkerId == 0) {
                                              lastWorkerId = workerId;
                                          } else if (workerId != lastWorkerId) {
                                              bytes calldata op = _options[start:cursor]; // slice out the last worker's options
                                              (executorOptions, dvnOptions) = _insertWorkerOptions(
                                                  executorOptions,
                                                  dvnOptions,
                                                  lastWorkerId,
                                                  op
                                              );
                                              // reset the start cursor and lastWorkerId
                                              start = cursor;
                                              lastWorkerId = workerId;
                                          }
                                          ++cursor; // for workerId
                                          uint16 size = uint16(bytes2(_options[cursor:cursor + 2]));
                                          if (size == 0) revert LZ_ULN_InvalidWorkerOptions(cursor);
                                          cursor += size + 2;
                                      }
                                      // the options length must be the same as the cursor at the end
                                      if (cursor != _options.length) revert LZ_ULN_InvalidWorkerOptions(cursor);
                                      // if we have reached the end of the options and the options are not empty
                                      // we need to process the last worker's options
                                      if (_options.length > 2) {
                                          bytes calldata op = _options[start:cursor];
                                          (executorOptions, dvnOptions) = _insertWorkerOptions(executorOptions, dvnOptions, lastWorkerId, op);
                                      }
                                  }
                              } else {
                                  executorOptions = decodeLegacyOptions(optionsType, _options);
                              }
                          }
                          function _insertWorkerOptions(
                              bytes memory _executorOptions,
                              bytes memory _dvnOptions,
                              uint8 _workerId,
                              bytes calldata _newOptions
                          ) private pure returns (bytes memory, bytes memory) {
                              if (_workerId == ExecutorOptions.WORKER_ID) {
                                  _executorOptions = _executorOptions.length == 0
                                      ? _newOptions
                                      : abi.encodePacked(_executorOptions, _newOptions);
                              } else if (_workerId == DVNOptions.WORKER_ID) {
                                  _dvnOptions = _dvnOptions.length == 0 ? _newOptions : abi.encodePacked(_dvnOptions, _newOptions);
                              } else {
                                  revert LZ_ULN_InvalidWorkerId(_workerId);
                              }
                              return (_executorOptions, _dvnOptions);
                          }
                          /// @dev decode the legacy options (type 1 or 2) into executorOptions
                          /// @param _optionType the legacy option type
                          /// @param _options the legacy options, which still has the option type in the first 2 bytes
                          /// @return executorOptions the executor options, share the same format of type 3 options
                          /// Data format:
                          /// legacy type 1: [extraGas]
                          /// legacy type 2: [extraGas][dstNativeAmt][dstNativeAddress]
                          /// extraGas: uint256, dstNativeAmt: uint256, dstNativeAddress: bytes
                          function decodeLegacyOptions(
                              uint16 _optionType,
                              bytes calldata _options
                          ) internal pure returns (bytes memory executorOptions) {
                              if (_optionType == TYPE_1) {
                                  if (_options.length != 34) revert LZ_ULN_InvalidLegacyType1Option();
                                  // execution gas
                                  uint128 executionGas = uint256(bytes32(_options[2:2 + 32])).toUint128();
                                  // dont use the encode function in the ExecutorOptions lib for saving gas by calling abi.encodePacked once
                                  // the result is a lzReceive option: [executor_id][option_size][option_type][execution_gas]
                                  // option_type: uint8, execution_gas: uint128
                                  // option_size = len(option_type) + len(execution_gas) = 1 + 16 = 17
                                  executorOptions = abi.encodePacked(
                                      ExecutorOptions.WORKER_ID,
                                      uint16(17), // 16 + 1, 16 for option_length, + 1 for option_type
                                      ExecutorOptions.OPTION_TYPE_LZRECEIVE,
                                      executionGas
                                  );
                              } else if (_optionType == TYPE_2) {
                                  // receiver size <= 32
                                  if (_options.length <= 66 || _options.length > 98) revert LZ_ULN_InvalidLegacyType2Option();
                                  // execution gas
                                  uint128 executionGas = uint256(bytes32(_options[2:2 + 32])).toUint128();
                                  // nativeDrop (amount + receiver)
                                  uint128 amount = uint256(bytes32(_options[34:34 + 32])).toUint128(); // offset 2 + 32
                                  bytes32 receiver;
                                  unchecked {
                                      uint256 receiverLen = _options.length - 66; // offset 2 + 32 + 32
                                      receiver = bytes32(_options[66:]);
                                      receiver = receiver >> (8 * (32 - receiverLen)); // padding 0 to the left
                                  }
                                  // dont use the encode function in the ExecutorOptions lib for saving gas by calling abi.encodePacked once
                                  // the result has one lzReceive option and one nativeDrop option:
                                  //      [executor_id][lzReceive_option_size][option_type][execution_gas] +
                                  //      [executor_id][nativeDrop_option_size][option_type][nativeDrop_amount][receiver]
                                  // option_type: uint8, execution_gas: uint128, nativeDrop_amount: uint128, receiver: bytes32
                                  // lzReceive_option_size = len(option_type) + len(execution_gas) = 1 + 16 = 17
                                  // nativeDrop_option_size = len(option_type) + len(nativeDrop_amount) + len(receiver) = 1 + 16 + 32 = 49
                                  executorOptions = abi.encodePacked(
                                      ExecutorOptions.WORKER_ID,
                                      uint16(17), // 16 + 1, 16 for option_length, + 1 for option_type
                                      ExecutorOptions.OPTION_TYPE_LZRECEIVE,
                                      executionGas,
                                      ExecutorOptions.WORKER_ID,
                                      uint16(49), // 48 + 1, 32 + 16 for option_length, + 1 for option_type
                                      ExecutorOptions.OPTION_TYPE_NATIVE_DROP,
                                      amount,
                                      receiver
                                  );
                              } else {
                                  revert LZ_ULN_UnsupportedOptionType(_optionType);
                              }
                          }
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      import { ERC165, IERC165 } from "@openzeppelin/contracts/utils/introspection/ERC165.sol";
                      import { ILayerZeroEndpointV2, MessagingFee, Origin } from "@layerzerolabs/lz-evm-protocol-v2/contracts/interfaces/ILayerZeroEndpointV2.sol";
                      import { IMessageLib, MessageLibType, SetConfigParam } from "@layerzerolabs/lz-evm-protocol-v2/contracts/interfaces/IMessageLib.sol";
                      import { ISendLib, Packet } from "@layerzerolabs/lz-evm-protocol-v2/contracts/interfaces/ISendLib.sol";
                      import { PacketV1Codec } from "@layerzerolabs/lz-evm-protocol-v2/contracts/messagelib/libs/PacketV1Codec.sol";
                      import { Transfer } from "@layerzerolabs/lz-evm-protocol-v2/contracts/libs/Transfer.sol";
                      import { AddressCast } from "@layerzerolabs/lz-evm-protocol-v2/contracts/libs/AddressCast.sol";
                      import { ILayerZeroReadExecutor } from "../../interfaces/ILayerZeroReadExecutor.sol";
                      import { ILayerZeroReadDVN } from "../interfaces/ILayerZeroReadDVN.sol";
                      import { ILayerZeroTreasury } from "../../interfaces/ILayerZeroTreasury.sol";
                      import { UlnOptions } from "../libs/UlnOptions.sol";
                      import { DVNOptions } from "../libs/DVNOptions.sol";
                      import { SafeCall } from "../../libs/SafeCall.sol";
                      import { MessageLibBase } from "../../MessageLibBase.sol";
                      import { ReadLibBase, ReadLibConfig } from "./ReadLibBase.sol";
                      contract ReadLib1002 is ISendLib, ERC165, ReadLibBase, MessageLibBase {
                          using PacketV1Codec for bytes;
                          using SafeCall for address;
                          uint32 internal constant CONFIG_TYPE_READ_LID_CONFIG = 1;
                          uint16 internal constant TREASURY_MAX_COPY = 32;
                          uint256 internal immutable treasuryGasLimit;
                          mapping(address oapp => mapping(uint32 eid => mapping(uint64 nonce => bytes32 cmdHash))) public cmdHashLookup;
                          mapping(bytes32 headerHash => mapping(bytes32 cmdHash => mapping(address dvn => bytes32 payloadHash)))
                              public hashLookup;
                          // accumulated fees for workers and treasury
                          mapping(address worker => uint256 fee) public fees;
                          uint256 internal treasuryNativeFeeCap;
                          address internal treasury;
                          event PayloadVerified(address dvn, bytes header, bytes32 cmdHash, bytes32 payloadHash);
                          event ExecutorFeePaid(address executor, uint256 fee);
                          event DVNFeePaid(address[] requiredDVNs, address[] optionalDVNs, uint256[] fees);
                          event NativeFeeWithdrawn(address worker, address receiver, uint256 amount);
                          event LzTokenFeeWithdrawn(address lzToken, address receiver, uint256 amount);
                          event TreasurySet(address treasury);
                          event TreasuryNativeFeeCapSet(uint256 newTreasuryNativeFeeCap);
                          error LZ_RL_InvalidReceiver();
                          error LZ_RL_InvalidPacketHeader();
                          error LZ_RL_InvalidCmdHash();
                          error LZ_RL_InvalidPacketVersion();
                          error LZ_RL_InvalidEid();
                          error LZ_RL_Verifying();
                          error LZ_RL_InvalidConfigType(uint32 configType);
                          error LZ_RL_InvalidAmount(uint256 requested, uint256 available);
                          error LZ_RL_NotTreasury();
                          error LZ_RL_CannotWithdrawAltToken();
                          constructor(
                              address _endpoint,
                              uint256 _treasuryGasLimit,
                              uint256 _treasuryGasForFeeCap
                          ) MessageLibBase(_endpoint, ILayerZeroEndpointV2(_endpoint).eid()) {
                              treasuryGasLimit = _treasuryGasLimit;
                              treasuryNativeFeeCap = _treasuryGasForFeeCap;
                          }
                          function supportsInterface(bytes4 _interfaceId) public view override(ERC165, IERC165) returns (bool) {
                              return
                                  _interfaceId == type(IMessageLib).interfaceId ||
                                  _interfaceId == type(ISendLib).interfaceId ||
                                  super.supportsInterface(_interfaceId);
                          }
                          // ============================ OnlyOwner ===================================
                          function setTreasury(address _treasury) external onlyOwner {
                              treasury = _treasury;
                              emit TreasurySet(_treasury);
                          }
                          /// @dev the new value can not be greater than the old value, i.e. down only
                          function setTreasuryNativeFeeCap(uint256 _newTreasuryNativeFeeCap) external onlyOwner {
                              // assert the new value is no greater than the old value
                              if (_newTreasuryNativeFeeCap > treasuryNativeFeeCap)
                                  revert LZ_RL_InvalidAmount(_newTreasuryNativeFeeCap, treasuryNativeFeeCap);
                              treasuryNativeFeeCap = _newTreasuryNativeFeeCap;
                              emit TreasuryNativeFeeCapSet(_newTreasuryNativeFeeCap);
                          }
                          // ============================ OnlyEndpoint ===================================
                          function send(
                              Packet calldata _packet,
                              bytes calldata _options,
                              bool _payInLzToken
                          ) external onlyEndpoint returns (MessagingFee memory, bytes memory) {
                              // the receiver must be the same as the sender
                              if (AddressCast.toBytes32(_packet.sender) != _packet.receiver) revert LZ_RL_InvalidReceiver();
                              // pay worker and treasury
                              (bytes memory encodedPacket, uint256 totalNativeFee) = _payWorkers(_packet, _options);
                              (uint256 treasuryNativeFee, uint256 lzTokenFee) = _payTreasury(
                                  _packet.sender,
                                  _packet.dstEid,
                                  totalNativeFee,
                                  _payInLzToken
                              );
                              totalNativeFee += treasuryNativeFee;
                              // store the cmdHash for verification in order to prevent reorg attack
                              cmdHashLookup[_packet.sender][_packet.dstEid][_packet.nonce] = keccak256(_packet.message);
                              return (MessagingFee(totalNativeFee, lzTokenFee), encodedPacket);
                          }
                          function setConfig(address _oapp, SetConfigParam[] calldata _params) external onlyEndpoint {
                              for (uint256 i = 0; i < _params.length; i++) {
                                  SetConfigParam calldata param = _params[i];
                                  _assertSupportedEid(param.eid);
                                  if (param.configType == CONFIG_TYPE_READ_LID_CONFIG) {
                                      _setReadLibConfig(param.eid, _oapp, abi.decode(param.config, (ReadLibConfig)));
                                  } else {
                                      revert LZ_RL_InvalidConfigType(param.configType);
                                  }
                              }
                          }
                          // ============================ External ===================================
                          /// @dev The verification will be done in the same chain where the packet is sent.
                          /// @dev dont need to check endpoint verifiable here to save gas, as it will reverts if not verifiable.
                          /// @param _packetHeader - the srcEid should be the localEid and the dstEid should be the channel id.
                          ///        The original packet header in PacketSent event should be processed to flip the srcEid and dstEid.
                          function commitVerification(bytes calldata _packetHeader, bytes32 _cmdHash, bytes32 _payloadHash) external {
                              // assert packet header is of right size 81
                              if (_packetHeader.length != 81) revert LZ_RL_InvalidPacketHeader();
                              // assert packet header version is the same
                              if (_packetHeader.version() != PacketV1Codec.PACKET_VERSION) revert LZ_RL_InvalidPacketVersion();
                              // assert the packet is for this endpoint
                              if (_packetHeader.dstEid() != localEid) revert LZ_RL_InvalidEid();
                              // cache these values to save gas
                              address receiver = _packetHeader.receiverB20();
                              uint32 srcEid = _packetHeader.srcEid(); // channel id
                              uint64 nonce = _packetHeader.nonce();
                              // reorg protection. to allow reverification, the cmdHash cant be removed
                              if (cmdHashLookup[receiver][srcEid][nonce] != _cmdHash) revert LZ_RL_InvalidCmdHash();
                              ReadLibConfig memory config = getReadLibConfig(receiver, srcEid);
                              _verifyAndReclaimStorage(config, keccak256(_packetHeader), _cmdHash, _payloadHash);
                              // endpoint will revert if nonce <= lazyInboundNonce
                              Origin memory origin = Origin(srcEid, _packetHeader.sender(), nonce);
                              ILayerZeroEndpointV2(endpoint).verify(origin, receiver, _payloadHash);
                          }
                          /// @dev DVN verifies the payload with the packet header and command hash
                          /// @param _packetHeader - the packet header is needed for event only, which can be conveniently for off-chain to track the packet state.
                          function verify(bytes calldata _packetHeader, bytes32 _cmdHash, bytes32 _payloadHash) external {
                              hashLookup[keccak256(_packetHeader)][_cmdHash][msg.sender] = _payloadHash;
                              emit PayloadVerified(msg.sender, _packetHeader, _cmdHash, _payloadHash);
                          }
                          function withdrawFee(address _to, uint256 _amount) external {
                              uint256 fee = fees[msg.sender];
                              if (_amount > fee) revert LZ_RL_InvalidAmount(_amount, fee);
                              unchecked {
                                  fees[msg.sender] = fee - _amount;
                              }
                              // transfers native if nativeToken == address(0x0)
                              address nativeToken = ILayerZeroEndpointV2(endpoint).nativeToken();
                              Transfer.nativeOrToken(nativeToken, _to, _amount);
                              emit NativeFeeWithdrawn(msg.sender, _to, _amount);
                          }
                          // ============================ Treasury ===================================
                          /// @dev _lzToken is a user-supplied value because lzToken might change in the endpoint before all lzToken can be taken out
                          function withdrawLzTokenFee(address _lzToken, address _to, uint256 _amount) external {
                              if (msg.sender != treasury) revert LZ_RL_NotTreasury();
                              // lz token cannot be the same as the native token
                              if (ILayerZeroEndpointV2(endpoint).nativeToken() == _lzToken) revert LZ_RL_CannotWithdrawAltToken();
                              Transfer.token(_lzToken, _to, _amount);
                              emit LzTokenFeeWithdrawn(_lzToken, _to, _amount);
                          }
                          // ============================ View ===================================
                          function quote(
                              Packet calldata _packet,
                              bytes calldata _options,
                              bool _payInLzToken
                          ) external view returns (MessagingFee memory) {
                              // split workers options
                              (bytes memory executorOptions, bytes memory dvnOptions) = UlnOptions.decode(_options);
                              address sender = _packet.sender;
                              uint32 dstEid = _packet.dstEid;
                              // quote the executor and dvns
                              ReadLibConfig memory config = getReadLibConfig(sender, dstEid);
                              uint256 nativeFee = _quoteDVNs(
                                  config,
                                  sender,
                                  PacketV1Codec.encodePacketHeader(_packet),
                                  _packet.message,
                                  dvnOptions
                              );
                              nativeFee += ILayerZeroReadExecutor(config.executor).getFee(sender, executorOptions);
                              // quote treasury
                              (uint256 treasuryNativeFee, uint256 lzTokenFee) = _quoteTreasury(sender, dstEid, nativeFee, _payInLzToken);
                              nativeFee += treasuryNativeFee;
                              return MessagingFee(nativeFee, lzTokenFee);
                          }
                          function verifiable(
                              ReadLibConfig calldata _config,
                              bytes32 _headerHash,
                              bytes32 _cmdHash,
                              bytes32 _payloadHash
                          ) external view returns (bool) {
                              return _checkVerifiable(_config, _headerHash, _cmdHash, _payloadHash);
                          }
                          function getConfig(uint32 _eid, address _oapp, uint32 _configType) external view returns (bytes memory) {
                              if (_configType == CONFIG_TYPE_READ_LID_CONFIG) {
                                  return abi.encode(getReadLibConfig(_oapp, _eid));
                              } else {
                                  revert LZ_RL_InvalidConfigType(_configType);
                              }
                          }
                          function getTreasuryAndNativeFeeCap() external view returns (address, uint256) {
                              return (treasury, treasuryNativeFeeCap);
                          }
                          function isSupportedEid(uint32 _eid) external view returns (bool) {
                              return _isSupportedEid(_eid);
                          }
                          function messageLibType() external pure returns (MessageLibType) {
                              return MessageLibType.SendAndReceive;
                          }
                          function version() external pure returns (uint64 major, uint8 minor, uint8 endpointVersion) {
                              return (10, 0, 2);
                          }
                          // ============================ Internal ===================================
                          /// 1/ handle executor
                          /// 2/ handle other workers
                          function _payWorkers(
                              Packet calldata _packet,
                              bytes calldata _options
                          ) internal returns (bytes memory encodedPacket, uint256 totalNativeFee) {
                              // split workers options
                              (bytes memory executorOptions, bytes memory dvnOptions) = UlnOptions.decode(_options);
                              // handle executor
                              ReadLibConfig memory config = getReadLibConfig(_packet.sender, _packet.dstEid);
                              totalNativeFee = _payExecutor(config.executor, _packet.sender, executorOptions);
                              // handle dvns
                              (uint256 dvnFee, bytes memory packetBytes) = _payDVNs(config, _packet, dvnOptions);
                              totalNativeFee += dvnFee;
                              encodedPacket = packetBytes;
                          }
                          function _payDVNs(
                              ReadLibConfig memory _config,
                              Packet calldata _packet,
                              bytes memory _options
                          ) internal returns (uint256 totalFee, bytes memory encodedPacket) {
                              bytes memory packetHeader = PacketV1Codec.encodePacketHeader(_packet);
                              bytes memory payload = PacketV1Codec.encodePayload(_packet);
                              uint256[] memory dvnFees;
                              (totalFee, dvnFees) = _assignDVNJobs(_config, _packet.sender, packetHeader, _packet.message, _options);
                              encodedPacket = abi.encodePacked(packetHeader, payload);
                              emit DVNFeePaid(_config.requiredDVNs, _config.optionalDVNs, dvnFees);
                          }
                          function _assignDVNJobs(
                              ReadLibConfig memory _config,
                              address _sender,
                              bytes memory _packetHeader,
                              bytes calldata _cmd,
                              bytes memory _options
                          ) internal returns (uint256 totalFee, uint256[] memory dvnFees) {
                              (bytes[] memory optionsArray, uint8[] memory dvnIds) = DVNOptions.groupDVNOptionsByIdx(_options);
                              uint8 dvnsLength = _config.requiredDVNCount + _config.optionalDVNCount;
                              dvnFees = new uint256[](dvnsLength);
                              for (uint8 i = 0; i < dvnsLength; ++i) {
                                  address dvn = i < _config.requiredDVNCount
                                      ? _config.requiredDVNs[i]
                                      : _config.optionalDVNs[i - _config.requiredDVNCount];
                                  bytes memory options = "";
                                  for (uint256 j = 0; j < dvnIds.length; ++j) {
                                      if (dvnIds[j] == i) {
                                          options = optionsArray[j];
                                          break;
                                      }
                                  }
                                  dvnFees[i] = ILayerZeroReadDVN(dvn).assignJob(_sender, _packetHeader, _cmd, options);
                                  if (dvnFees[i] > 0) {
                                      fees[dvn] += dvnFees[i];
                                      totalFee += dvnFees[i];
                                  }
                              }
                          }
                          function _quoteDVNs(
                              ReadLibConfig memory _config,
                              address _sender,
                              bytes memory _packetHeader,
                              bytes calldata _cmd,
                              bytes memory _options
                          ) internal view returns (uint256 totalFee) {
                              (bytes[] memory optionsArray, uint8[] memory dvnIndices) = DVNOptions.groupDVNOptionsByIdx(_options);
                              // here we merge 2 list of dvns into 1 to allocate the indexed dvn options to the right dvn
                              uint8 dvnsLength = _config.requiredDVNCount + _config.optionalDVNCount;
                              for (uint8 i = 0; i < dvnsLength; ++i) {
                                  address dvn = i < _config.requiredDVNCount
                                      ? _config.requiredDVNs[i]
                                      : _config.optionalDVNs[i - _config.requiredDVNCount];
                                  bytes memory options = "";
                                  // it is a double loop here. however, if the list is short, the cost is very acceptable.
                                  for (uint256 j = 0; j < dvnIndices.length; ++j) {
                                      if (dvnIndices[j] == i) {
                                          options = optionsArray[j];
                                          break;
                                      }
                                  }
                                  totalFee += ILayerZeroReadDVN(dvn).getFee(_sender, _packetHeader, _cmd, options);
                              }
                          }
                          function _payTreasury(
                              address _sender,
                              uint32 _dstEid,
                              uint256 _totalNativeFee,
                              bool _payInLzToken
                          ) internal returns (uint256 treasuryNativeFee, uint256 lzTokenFee) {
                              if (treasury != address(0x0)) {
                                  bytes memory callData = abi.encodeCall(
                                      ILayerZeroTreasury.payFee,
                                      (_sender, _dstEid, _totalNativeFee, _payInLzToken)
                                  );
                                  (bool success, bytes memory result) = treasury.safeCall(treasuryGasLimit, 0, TREASURY_MAX_COPY, callData);
                                  (treasuryNativeFee, lzTokenFee) = _parseTreasuryResult(_totalNativeFee, _payInLzToken, success, result);
                                  // fee should be in lzTokenFee if payInLzToken, otherwise in native
                                  if (treasuryNativeFee > 0) {
                                      fees[treasury] += treasuryNativeFee;
                                  }
                              }
                          }
                          /// @dev this interface should be DoS-free if the user is paying with native. properties
                          /// 1/ treasury can return an overly high lzToken fee
                          /// 2/ if treasury returns an overly high native fee, it will be capped by maxNativeFee,
                          ///    which can be reasoned with the configurations
                          /// 3/ the owner can not configure the treasury in a way that force this function to revert
                          function _quoteTreasury(
                              address _sender,
                              uint32 _dstEid,
                              uint256 _totalNativeFee,
                              bool _payInLzToken
                          ) internal view returns (uint256 nativeFee, uint256 lzTokenFee) {
                              // treasury must be set, and it has to be a contract
                              if (treasury != address(0x0)) {
                                  bytes memory callData = abi.encodeCall(
                                      ILayerZeroTreasury.getFee,
                                      (_sender, _dstEid, _totalNativeFee, _payInLzToken)
                                  );
                                  (bool success, bytes memory result) = treasury.safeStaticCall(
                                      treasuryGasLimit,
                                      TREASURY_MAX_COPY,
                                      callData
                                  );
                                  return _parseTreasuryResult(_totalNativeFee, _payInLzToken, success, result);
                              }
                          }
                          function _parseTreasuryResult(
                              uint256 _totalNativeFee,
                              bool _payInLzToken,
                              bool _success,
                              bytes memory _result
                          ) internal view returns (uint256 nativeFee, uint256 lzTokenFee) {
                              // failure, charges nothing
                              if (!_success || _result.length < TREASURY_MAX_COPY) return (0, 0);
                              // parse the result
                              uint256 treasureFeeQuote = abi.decode(_result, (uint256));
                              if (_payInLzToken) {
                                  lzTokenFee = treasureFeeQuote;
                              } else {
                                  // pay in native
                                  // we must prevent high-treasuryFee Dos attack
                                  // nativeFee = min(treasureFeeQuote, maxNativeFee)
                                  // opportunistically raise the maxNativeFee to be the same as _totalNativeFee
                                  // can't use the _totalNativeFee alone because the oapp can use custom workers to force the fee to 0.
                                  // maxNativeFee = max (_totalNativeFee, treasuryNativeFeeCap)
                                  uint256 maxNativeFee = _totalNativeFee > treasuryNativeFeeCap ? _totalNativeFee : treasuryNativeFeeCap;
                                  // min (treasureFeeQuote, nativeFeeCap)
                                  nativeFee = treasureFeeQuote > maxNativeFee ? maxNativeFee : treasureFeeQuote;
                              }
                          }
                          function _verifyAndReclaimStorage(
                              ReadLibConfig memory _config,
                              bytes32 _headerHash,
                              bytes32 _cmdHash,
                              bytes32 _payloadHash
                          ) internal {
                              if (!_checkVerifiable(_config, _headerHash, _cmdHash, _payloadHash)) {
                                  revert LZ_RL_Verifying();
                              }
                              // iterate the required DVNs
                              if (_config.requiredDVNCount > 0) {
                                  for (uint8 i = 0; i < _config.requiredDVNCount; ++i) {
                                      delete hashLookup[_headerHash][_cmdHash][_config.requiredDVNs[i]];
                                  }
                              }
                              // iterate the optional DVNs
                              if (_config.optionalDVNCount > 0) {
                                  for (uint8 i = 0; i < _config.optionalDVNCount; ++i) {
                                      delete hashLookup[_headerHash][_cmdHash][_config.optionalDVNs[i]];
                                  }
                              }
                          }
                          /// @dev for verifiable view function
                          /// @dev checks if this verification is ready to be committed to the endpoint
                          function _checkVerifiable(
                              ReadLibConfig memory _config,
                              bytes32 _headerHash,
                              bytes32 _cmdHash,
                              bytes32 _payloadHash
                          ) internal view returns (bool) {
                              // iterate the required DVNs
                              if (_config.requiredDVNCount > 0) {
                                  for (uint8 i = 0; i < _config.requiredDVNCount; ++i) {
                                      if (!_verified(_config.requiredDVNs[i], _headerHash, _cmdHash, _payloadHash)) {
                                          // return if any of the required DVNs haven't signed
                                          return false;
                                      }
                                  }
                                  if (_config.optionalDVNCount == 0) {
                                      // returns early if all required DVNs have signed and there are no optional DVNs
                                      return true;
                                  }
                              }
                              // then it must require optional validations
                              uint8 threshold = _config.optionalDVNThreshold;
                              for (uint8 i = 0; i < _config.optionalDVNCount; ++i) {
                                  if (_verified(_config.optionalDVNs[i], _headerHash, _cmdHash, _payloadHash)) {
                                      // increment the optional count if the optional DVN has signed
                                      threshold--;
                                      if (threshold == 0) {
                                          // early return if the optional threshold has hit
                                          return true;
                                      }
                                  }
                              }
                              // return false as a catch-all
                              return false;
                          }
                          function _verified(
                              address _dvn,
                              bytes32 _headerHash,
                              bytes32 _cmdHash,
                              bytes32 _expectedPayloadHash
                          ) internal view returns (bool verified) {
                              verified = hashLookup[_headerHash][_cmdHash][_dvn] == _expectedPayloadHash;
                          }
                          function _payExecutor(
                              address _executor,
                              address _sender,
                              bytes memory _executorOptions
                          ) internal returns (uint256 executorFee) {
                              executorFee = ILayerZeroReadExecutor(_executor).assignJob(_sender, _executorOptions);
                              if (executorFee > 0) {
                                  fees[_executor] += executorFee;
                              }
                              emit ExecutorFeePaid(_executor, executorFee);
                          }
                          receive() external payable {}
                      }
                      // SPDX-License-Identifier: LZBL-1.2
                      pragma solidity ^0.8.20;
                      import { Ownable } from "@openzeppelin/contracts/access/Ownable.sol";
                      struct ReadLibConfig {
                          address executor;
                          // we store the length of required DVNs and optional DVNs instead of using DVN.length directly to save gas
                          uint8 requiredDVNCount; // 0 indicate DEFAULT, NIL_DVN_COUNT indicate NONE (to override the value of default)
                          uint8 optionalDVNCount; // 0 indicate DEFAULT, NIL_DVN_COUNT indicate NONE (to override the value of default)
                          uint8 optionalDVNThreshold; // (0, optionalDVNCount]
                          address[] requiredDVNs; // no duplicates. sorted an an ascending order. allowed overlap with optionalDVNs
                          address[] optionalDVNs; // no duplicates. sorted an an ascending order. allowed overlap with requiredDVNs
                      }
                      struct SetDefaultReadLibConfigParam {
                          uint32 eid;
                          ReadLibConfig config;
                      }
                      /// @dev includes the utility functions for checking ReadLib states and logics
                      abstract contract ReadLibBase is Ownable {
                          address internal constant DEFAULT_CONFIG = address(0);
                          // reserved values for
                          uint8 internal constant DEFAULT = 0;
                          uint8 internal constant NIL_DVN_COUNT = type(uint8).max;
                          // 127 to prevent total number of DVNs (127 * 2) exceeding uint8.max (255)
                          // by limiting the total size, it would help constraint the design of DVNOptions
                          uint8 private constant MAX_COUNT = (type(uint8).max - 1) / 2;
                          mapping(address oapp => mapping(uint32 eid => ReadLibConfig config)) internal readLibConfigs;
                          error LZ_RL_Unsorted();
                          error LZ_RL_InvalidRequiredDVNCount();
                          error LZ_RL_InvalidOptionalDVNCount();
                          error LZ_RL_AtLeastOneDVN();
                          error LZ_RL_InvalidOptionalDVNThreshold();
                          error LZ_RL_UnsupportedEid(uint32 eid);
                          error LZ_RL_InvalidExecutor();
                          event DefaultReadLibConfigsSet(SetDefaultReadLibConfigParam[] params);
                          event ReadLibConfigSet(address oapp, uint32 eid, ReadLibConfig config);
                          // ============================ OnlyOwner ===================================
                          /// @dev about the DEFAULT ReadLib config
                          /// 1) its values are all LITERAL (e.g. 0 is 0). whereas in the oapp ReadLib config, 0 (default value) points to the default ReadLib config
                          ///     this design enables the oapp to point to DEFAULT config without explicitly setting the config
                          /// 2) its configuration is more restrictive than the oapp ReadLib config that
                          ///     a) it must not use NIL value, where NIL is used only by oapps to indicate the LITERAL 0
                          ///     b) it must have at least one DVN and executor
                          function setDefaultReadLibConfigs(SetDefaultReadLibConfigParam[] calldata _params) external onlyOwner {
                              for (uint256 i = 0; i < _params.length; ++i) {
                                  SetDefaultReadLibConfigParam calldata param = _params[i];
                                  // 2.a must not use NIL
                                  if (param.config.requiredDVNCount == NIL_DVN_COUNT) revert LZ_RL_InvalidRequiredDVNCount();
                                  if (param.config.optionalDVNCount == NIL_DVN_COUNT) revert LZ_RL_InvalidOptionalDVNCount();
                                  // 2.b must have at least one dvn and executor
                                  _assertAtLeastOneDVN(param.config);
                                  if (param.config.executor == address(0x0)) revert LZ_RL_InvalidExecutor();
                                  _setConfig(DEFAULT_CONFIG, param.eid, param.config);
                              }
                              emit DefaultReadLibConfigsSet(_params);
                          }
                          // ============================ View ===================================
                          // @dev assuming most oapps use default, we get default as memory and custom as storage to save gas
                          function getReadLibConfig(address _oapp, uint32 _remoteEid) public view returns (ReadLibConfig memory rtnConfig) {
                              ReadLibConfig storage defaultConfig = readLibConfigs[DEFAULT_CONFIG][_remoteEid];
                              ReadLibConfig storage customConfig = readLibConfigs[_oapp][_remoteEid];
                              address executor = customConfig.executor;
                              rtnConfig.executor = executor != address(0x0) ? executor : defaultConfig.executor;
                              if (customConfig.requiredDVNCount == DEFAULT) {
                                  if (defaultConfig.requiredDVNCount > 0) {
                                      // copy only if count > 0. save gas
                                      rtnConfig.requiredDVNs = defaultConfig.requiredDVNs;
                                      rtnConfig.requiredDVNCount = defaultConfig.requiredDVNCount;
                                  } // else, do nothing
                              } else {
                                  if (customConfig.requiredDVNCount != NIL_DVN_COUNT) {
                                      rtnConfig.requiredDVNs = customConfig.requiredDVNs;
                                      rtnConfig.requiredDVNCount = customConfig.requiredDVNCount;
                                  } // else, do nothing
                              }
                              if (customConfig.optionalDVNCount == DEFAULT) {
                                  if (defaultConfig.optionalDVNCount > 0) {
                                      // copy only if count > 0. save gas
                                      rtnConfig.optionalDVNs = defaultConfig.optionalDVNs;
                                      rtnConfig.optionalDVNCount = defaultConfig.optionalDVNCount;
                                      rtnConfig.optionalDVNThreshold = defaultConfig.optionalDVNThreshold;
                                  }
                              } else {
                                  if (customConfig.optionalDVNCount != NIL_DVN_COUNT) {
                                      rtnConfig.optionalDVNs = customConfig.optionalDVNs;
                                      rtnConfig.optionalDVNCount = customConfig.optionalDVNCount;
                                      rtnConfig.optionalDVNThreshold = customConfig.optionalDVNThreshold;
                                  }
                              }
                              // the final value must have at least one dvn
                              // it is possible that some default config result into 0 dvns
                              _assertAtLeastOneDVN(rtnConfig);
                          }
                          /// @dev Get the readLib config without the default config for the given remoteEid.
                          function getAppReadLibConfig(address _oapp, uint32 _remoteEid) external view returns (ReadLibConfig memory) {
                              return readLibConfigs[_oapp][_remoteEid];
                          }
                          // ============================ Internal ===================================
                          function _setReadLibConfig(uint32 _remoteEid, address _oapp, ReadLibConfig memory _param) internal {
                              _setConfig(_oapp, _remoteEid, _param);
                              // get ReadLib config again as a catch all to ensure the config is valid
                              getReadLibConfig(_oapp, _remoteEid);
                              emit ReadLibConfigSet(_oapp, _remoteEid, _param);
                          }
                          /// @dev a supported Eid must have a valid default readLib config, which has at least one dvn
                          function _isSupportedEid(uint32 _remoteEid) internal view returns (bool) {
                              ReadLibConfig storage defaultConfig = readLibConfigs[DEFAULT_CONFIG][_remoteEid];
                              return defaultConfig.requiredDVNCount > 0 || defaultConfig.optionalDVNThreshold > 0;
                          }
                          function _assertSupportedEid(uint32 _remoteEid) internal view {
                              if (!_isSupportedEid(_remoteEid)) revert LZ_RL_UnsupportedEid(_remoteEid);
                          }
                          // ============================ Private ===================================
                          function _assertAtLeastOneDVN(ReadLibConfig memory _config) private pure {
                              if (_config.requiredDVNCount == 0 && _config.optionalDVNThreshold == 0) revert LZ_RL_AtLeastOneDVN();
                          }
                          /// @dev this private function is used in both setDefaultReadLibConfigs and setReadLibConfig
                          function _setConfig(address _oapp, uint32 _eid, ReadLibConfig memory _param) private {
                              // @dev required dvns
                              // if dvnCount == NONE, dvns list must be empty
                              // if dvnCount == DEFAULT, dvn list must be empty
                              // otherwise, dvnList.length == dvnCount and assert the list is valid
                              if (_param.requiredDVNCount == NIL_DVN_COUNT || _param.requiredDVNCount == DEFAULT) {
                                  if (_param.requiredDVNs.length != 0) revert LZ_RL_InvalidRequiredDVNCount();
                              } else {
                                  if (_param.requiredDVNs.length != _param.requiredDVNCount || _param.requiredDVNCount > MAX_COUNT)
                                      revert LZ_RL_InvalidRequiredDVNCount();
                                  _assertNoDuplicates(_param.requiredDVNs);
                              }
                              // @dev optional dvns
                              // if optionalDVNCount == NONE, optionalDVNs list must be empty and threshold must be 0
                              // if optionalDVNCount == DEFAULT, optionalDVNs list must be empty and threshold must be 0
                              // otherwise, optionalDVNs.length == optionalDVNCount, threshold > 0 && threshold <= optionalDVNCount and assert the list is valid
                              // example use case: an oapp uses the DEFAULT 'required' but
                              //     a) use a custom 1/1 dvn (practically a required dvn), or
                              //     b) use a custom 2/3 dvn
                              if (_param.optionalDVNCount == NIL_DVN_COUNT || _param.optionalDVNCount == DEFAULT) {
                                  if (_param.optionalDVNs.length != 0) revert LZ_RL_InvalidOptionalDVNCount();
                                  if (_param.optionalDVNThreshold != 0) revert LZ_RL_InvalidOptionalDVNThreshold();
                              } else {
                                  if (_param.optionalDVNs.length != _param.optionalDVNCount || _param.optionalDVNCount > MAX_COUNT)
                                      revert LZ_RL_InvalidOptionalDVNCount();
                                  if (_param.optionalDVNThreshold == 0 || _param.optionalDVNThreshold > _param.optionalDVNCount)
                                      revert LZ_RL_InvalidOptionalDVNThreshold();
                                  _assertNoDuplicates(_param.optionalDVNs);
                              }
                              // don't assert valid count here, as it needs to be validated along side default config
                              readLibConfigs[_oapp][_eid] = _param;
                          }
                          function _assertNoDuplicates(address[] memory _dvns) private pure {
                              address lastDVN = address(0);
                              for (uint256 i = 0; i < _dvns.length; i++) {
                                  address dvn = _dvns[i];
                                  if (dvn <= lastDVN) revert LZ_RL_Unsorted(); // to ensure no duplicates
                                  lastDVN = dvn;
                              }
                          }
                      }
                      // 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;
                          }
                      }
                      

                      File 6 of 9: Endpoint
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity 0.7.6;
                      import "./interfaces/ILayerZeroReceiver.sol";
                      import "./interfaces/ILayerZeroEndpoint.sol";
                      import "./interfaces/ILayerZeroMessagingLibrary.sol";
                      import "@openzeppelin/contracts/access/Ownable.sol";
                      contract Endpoint is Ownable, ILayerZeroEndpoint {
                          uint16 public immutable chainId;
                          // installed libraries and reserved versions
                          uint16 public constant BLOCK_VERSION = 65535;
                          uint16 public constant DEFAULT_VERSION = 0;
                          uint16 public latestVersion;
                          mapping(uint16 => ILayerZeroMessagingLibrary) public libraryLookup; // version -> ILayerZeroEndpointLibrary
                          // default send/receive libraries
                          uint16 public defaultSendVersion;
                          uint16 public defaultReceiveVersion;
                          ILayerZeroMessagingLibrary public defaultSendLibrary;
                          address public defaultReceiveLibraryAddress;
                          struct LibraryConfig {
                              uint16 sendVersion;
                              uint16 receiveVersion;
                              address receiveLibraryAddress;
                              ILayerZeroMessagingLibrary sendLibrary;
                          }
                          struct StoredPayload {
                              uint64 payloadLength;
                              address dstAddress;
                              bytes32 payloadHash;
                          }
                          // user app config = [uaAddress]
                          mapping(address => LibraryConfig) public uaConfigLookup;
                          // inboundNonce = [srcChainId][srcAddress].
                          mapping(uint16 => mapping(bytes => uint64)) public inboundNonce;
                          // outboundNonce = [dstChainId][srcAddress].
                          mapping(uint16 => mapping(address => uint64)) public outboundNonce;
                          // storedPayload = [srcChainId][srcAddress]
                          mapping(uint16 => mapping(bytes => StoredPayload)) public storedPayload;
                          // library versioning events
                          event NewLibraryVersionAdded(uint16 version);
                          event DefaultSendVersionSet(uint16 version);
                          event DefaultReceiveVersionSet(uint16 version);
                          event UaSendVersionSet(address ua, uint16 version);
                          event UaReceiveVersionSet(address ua, uint16 version);
                          event UaForceResumeReceive(uint16 chainId, bytes srcAddress);
                          // payload events
                          event PayloadCleared(uint16 srcChainId, bytes srcAddress, uint64 nonce, address dstAddress);
                          event PayloadStored(uint16 srcChainId, bytes srcAddress, address dstAddress, uint64 nonce, bytes payload, bytes reason);
                          constructor(uint16 _chainId) {
                              chainId = _chainId;
                          }
                          //---------------------------------------------------------------------------
                          // send and receive nonreentrant lock
                          uint8 internal constant _NOT_ENTERED = 1;
                          uint8 internal constant _ENTERED = 2;
                          uint8 internal _send_entered_state = 1;
                          uint8 internal _receive_entered_state = 1;
                          modifier sendNonReentrant() {
                              require(_send_entered_state == _NOT_ENTERED, "LayerZero: no send reentrancy");
                              _send_entered_state = _ENTERED;
                              _;
                              _send_entered_state = _NOT_ENTERED;
                          }
                          modifier receiveNonReentrant() {
                              require(_receive_entered_state == _NOT_ENTERED, "LayerZero: no receive reentrancy");
                              _receive_entered_state = _ENTERED;
                              _;
                              _receive_entered_state = _NOT_ENTERED;
                          }
                          // BLOCK_VERSION is also a valid version
                          modifier validVersion(uint16 _version) {
                              require(_version <= latestVersion || _version == BLOCK_VERSION, "LayerZero: invalid messaging library version");
                              _;
                          }
                          //---------------------------------------------------------------------------
                          // User Application Calls - Endpoint Interface
                          function send(uint16 _dstChainId, bytes calldata _destination, bytes calldata _payload, address payable _refundAddress, address _zroPaymentAddress, bytes calldata _adapterParams) external payable override sendNonReentrant {
                              LibraryConfig storage uaConfig = uaConfigLookup[msg.sender];
                              uint64 nonce = ++outboundNonce[_dstChainId][msg.sender];
                              _getSendLibrary(uaConfig).send{value: msg.value}(msg.sender, nonce, _dstChainId, _destination, _payload, _refundAddress, _zroPaymentAddress, _adapterParams);
                          }
                          //---------------------------------------------------------------------------
                          // authenticated Library (msg.sender) Calls to pass through Endpoint to UA (dstAddress)
                          function receivePayload(uint16 _srcChainId, bytes calldata _srcAddress, address _dstAddress, uint64 _nonce, uint _gasLimit, bytes calldata _payload) external override receiveNonReentrant {
                              // assert and increment the nonce. no message shuffling
                              require(_nonce == ++inboundNonce[_srcChainId][_srcAddress], "LayerZero: wrong nonce");
                              LibraryConfig storage uaConfig = uaConfigLookup[_dstAddress];
                              // authentication to prevent cross-version message validation
                              // protects against a malicious library from passing arbitrary data
                              if (uaConfig.receiveVersion == DEFAULT_VERSION) {
                                  require(defaultReceiveLibraryAddress == msg.sender, "LayerZero: invalid default library");
                              } else {
                                  require(uaConfig.receiveLibraryAddress == msg.sender, "LayerZero: invalid library");
                              }
                              // block if any message blocking
                              StoredPayload storage sp = storedPayload[_srcChainId][_srcAddress];
                              require(sp.payloadHash == bytes32(0), "LayerZero: in message blocking");
                              try ILayerZeroReceiver(_dstAddress).lzReceive{gas: _gasLimit}(_srcChainId, _srcAddress, _nonce, _payload) {
                                  // success, do nothing, end of the message delivery
                              } catch (bytes memory reason) {
                                  // revert nonce if any uncaught errors/exceptions if the ua chooses the blocking mode
                                  storedPayload[_srcChainId][_srcAddress] = StoredPayload(uint64(_payload.length), _dstAddress, keccak256(_payload));
                                  emit PayloadStored(_srcChainId, _srcAddress, _dstAddress, _nonce, _payload, reason);
                              }
                          }
                          function retryPayload(uint16 _srcChainId, bytes calldata _srcAddress, bytes calldata _payload) external override receiveNonReentrant {
                              StoredPayload storage sp = storedPayload[_srcChainId][_srcAddress];
                              require(sp.payloadHash != bytes32(0), "LayerZero: no stored payload");
                              require(_payload.length == sp.payloadLength && keccak256(_payload) == sp.payloadHash, "LayerZero: invalid payload");
                              address dstAddress = sp.dstAddress;
                              // empty the storedPayload
                              sp.payloadLength = 0;
                              sp.dstAddress = address(0);
                              sp.payloadHash = bytes32(0);
                              uint64 nonce = inboundNonce[_srcChainId][_srcAddress];
                              ILayerZeroReceiver(dstAddress).lzReceive(_srcChainId, _srcAddress, nonce, _payload);
                              emit PayloadCleared(_srcChainId, _srcAddress, nonce, dstAddress);
                          }
                          //---------------------------------------------------------------------------
                          // Owner Calls, only new library version upgrade (3 steps)
                          // note libraryLookup[0] = 0x0, no library implementation
                          // LIBRARY UPGRADE step 1: set _newLayerZeroLibraryAddress be the new version
                          function newVersion(address _newLayerZeroLibraryAddress) external onlyOwner {
                              require(_newLayerZeroLibraryAddress != address(0x0), "LayerZero: new version cannot be zero address");
                              require(latestVersion < 65535, "LayerZero: can not add new messaging library");
                              latestVersion++;
                              libraryLookup[latestVersion] = ILayerZeroMessagingLibrary(_newLayerZeroLibraryAddress);
                              emit NewLibraryVersionAdded(latestVersion);
                          }
                          // LIBRARY UPGRADE step 2: stop sending messages from the old version
                          function setDefaultSendVersion(uint16 _newDefaultSendVersion) external onlyOwner validVersion(_newDefaultSendVersion) {
                              require(_newDefaultSendVersion != DEFAULT_VERSION, "LayerZero: default send version must > 0");
                              defaultSendVersion = _newDefaultSendVersion;
                              defaultSendLibrary = libraryLookup[defaultSendVersion];
                              emit DefaultSendVersionSet(_newDefaultSendVersion);
                          }
                          // LIBRARY UPGRADE step 3: stop receiving messages from the old version
                          function setDefaultReceiveVersion(uint16 _newDefaultReceiveVersion) external onlyOwner validVersion(_newDefaultReceiveVersion) {
                              require(_newDefaultReceiveVersion != DEFAULT_VERSION, "LayerZero: default receive version must > 0");
                              defaultReceiveVersion = _newDefaultReceiveVersion;
                              defaultReceiveLibraryAddress = address(libraryLookup[defaultReceiveVersion]);
                              emit DefaultReceiveVersionSet(_newDefaultReceiveVersion);
                          }
                          //---------------------------------------------------------------------------
                          // User Application Calls - UA set/get Interface
                          function setConfig(uint16 _version, uint16 _chainId, uint _configType, bytes calldata _config) external override validVersion(_version) {
                              if (_version == DEFAULT_VERSION) {
                                  require(defaultSendVersion == defaultReceiveVersion, "LayerZero: can not set Config during DEFAULT migration");
                                  _version = defaultSendVersion;
                              }
                              require(_version != BLOCK_VERSION, "LayerZero: can not set config for BLOCK_VERSION");
                              libraryLookup[_version].setConfig(_chainId, msg.sender, _configType, _config);
                          }
                          // Migration step 1: set the send version
                          // Define what library the UA points too
                          function setSendVersion(uint16 _newVersion) external override validVersion(_newVersion) {
                              // write into config
                              LibraryConfig storage uaConfig = uaConfigLookup[msg.sender];
                              uaConfig.sendVersion = _newVersion;
                              // the libraryLookup[BLOCK_VERSION || DEFAULT_VERSION] = 0x0
                              uaConfig.sendLibrary = libraryLookup[_newVersion];
                              emit UaSendVersionSet(msg.sender, _newVersion);
                          }
                          // Migration step 2: set the receive version
                          // after all messages sent from the old version are received
                          // the UA can now safely switch to the new receive version
                          // it is the UA's responsibility make sure all messages from the old version are processed
                          function setReceiveVersion(uint16 _newVersion) external override validVersion(_newVersion) {
                              // write into config
                              LibraryConfig storage uaConfig = uaConfigLookup[msg.sender];
                              uaConfig.receiveVersion = _newVersion;
                              // the libraryLookup[BLOCK_VERSION || DEFAULT_VERSION] = 0x0
                              uaConfig.receiveLibraryAddress = address(libraryLookup[_newVersion]);
                              emit UaReceiveVersionSet(msg.sender, _newVersion);
                          }
                          function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external override {
                              StoredPayload storage sp = storedPayload[_srcChainId][_srcAddress];
                              // revert if no messages are cached. safeguard malicious UA behaviour
                              require(sp.payloadHash != bytes32(0), "LayerZero: no stored payload");
                              require(sp.dstAddress == msg.sender, "LayerZero: invalid caller");
                              // empty the storedPayload
                              sp.payloadLength = 0;
                              sp.dstAddress = address(0);
                              sp.payloadHash = bytes32(0);
                              // emit the event with the new nonce
                              emit UaForceResumeReceive(_srcChainId, _srcAddress);
                          }
                          //---------------------------------------------------------------------------
                          // view helper function
                          function estimateFees(uint16 _dstChainId, address _userApplication, bytes calldata _payload, bool _payInZRO, bytes calldata _adapterParams) external view override returns (uint nativeFee, uint zroFee) {
                              LibraryConfig storage uaConfig = uaConfigLookup[_userApplication];
                              ILayerZeroMessagingLibrary lib = uaConfig.sendVersion == DEFAULT_VERSION ? defaultSendLibrary : uaConfig.sendLibrary;
                              return lib.estimateFees(_dstChainId, _userApplication, _payload, _payInZRO, _adapterParams);
                          }
                          function _getSendLibrary(LibraryConfig storage uaConfig) internal view returns (ILayerZeroMessagingLibrary) {
                              if (uaConfig.sendVersion == DEFAULT_VERSION) {
                                  // check if the in send-blocking upgrade
                                  require(defaultSendVersion != BLOCK_VERSION, "LayerZero: default in BLOCK_VERSION");
                                  return defaultSendLibrary;
                              } else {
                                  // check if the in send-blocking upgrade
                                  require(uaConfig.sendVersion != BLOCK_VERSION, "LayerZero: in BLOCK_VERSION");
                                  return uaConfig.sendLibrary;
                              }
                          }
                          function getSendLibraryAddress(address _userApplication) external view override returns (address sendLibraryAddress) {
                              LibraryConfig storage uaConfig = uaConfigLookup[_userApplication];
                              uint16 sendVersion = uaConfig.sendVersion;
                              require(sendVersion != BLOCK_VERSION, "LayerZero: send version is BLOCK_VERSION");
                              if (sendVersion == DEFAULT_VERSION) {
                                  require(defaultSendVersion != BLOCK_VERSION, "LayerZero: send version (default) is BLOCK_VERSION");
                                  sendLibraryAddress = address(defaultSendLibrary);
                              } else {
                                  sendLibraryAddress = address(uaConfig.sendLibrary);
                              }
                          }
                          function getReceiveLibraryAddress(address _userApplication) external view override returns (address receiveLibraryAddress) {
                              LibraryConfig storage uaConfig = uaConfigLookup[_userApplication];
                              uint16 receiveVersion = uaConfig.receiveVersion;
                              require(receiveVersion != BLOCK_VERSION, "LayerZero: receive version is BLOCK_VERSION");
                              if (receiveVersion == DEFAULT_VERSION) {
                                  require(defaultReceiveVersion != BLOCK_VERSION, "LayerZero: receive version (default) is BLOCK_VERSION");
                                  receiveLibraryAddress = defaultReceiveLibraryAddress;
                              } else {
                                  receiveLibraryAddress = uaConfig.receiveLibraryAddress;
                              }
                          }
                          function isSendingPayload() external view override returns (bool) {
                              return _send_entered_state == _ENTERED;
                          }
                          function isReceivingPayload() external view override returns (bool) {
                              return _receive_entered_state == _ENTERED;
                          }
                          function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view override returns (uint64) {
                              return inboundNonce[_srcChainId][_srcAddress];
                          }
                          function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view override returns (uint64) {
                              return outboundNonce[_dstChainId][_srcAddress];
                          }
                          function getChainId() external view override returns (uint16) {
                              return chainId;
                          }
                          function getSendVersion(address _userApplication) external view override returns (uint16) {
                              LibraryConfig storage uaConfig = uaConfigLookup[_userApplication];
                              return uaConfig.sendVersion == DEFAULT_VERSION ? defaultSendVersion : uaConfig.sendVersion;
                          }
                          function getReceiveVersion(address _userApplication) external view override returns (uint16) {
                              LibraryConfig storage uaConfig = uaConfigLookup[_userApplication];
                              return uaConfig.receiveVersion == DEFAULT_VERSION ? defaultReceiveVersion : uaConfig.receiveVersion;
                          }
                          function getConfig(uint16 _version, uint16 _chainId, address _userApplication, uint _configType) external view override validVersion(_version) returns (bytes memory) {
                              if (_version == DEFAULT_VERSION) {
                                  require(defaultSendVersion == defaultReceiveVersion, "LayerZero: no DEFAULT config while migration");
                                  _version = defaultSendVersion;
                              }
                              require(_version != BLOCK_VERSION, "LayerZero: can not get config for BLOCK_VERSION");
                              return libraryLookup[_version].getConfig(_chainId, _userApplication, _configType);
                          }
                          function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view override returns (bool) {
                              StoredPayload storage sp = storedPayload[_srcChainId][_srcAddress];
                              return sp.payloadHash != bytes32(0);
                          }
                      }
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity >=0.5.0;
                      interface ILayerZeroReceiver {
                          // @notice LayerZero endpoint will invoke this function to deliver the message on the destination
                          // @param _srcChainId - the source endpoint identifier
                          // @param _srcAddress - the source sending contract address from the source chain
                          // @param _nonce - the ordered message nonce
                          // @param _payload - the signed payload is the UA bytes has encoded to be sent
                          function lzReceive(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes calldata _payload) external;
                      }
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity >=0.5.0;
                      import "./ILayerZeroUserApplicationConfig.sol";
                      interface ILayerZeroEndpoint is ILayerZeroUserApplicationConfig {
                          // @notice send a LayerZero message to the specified address at a LayerZero endpoint.
                          // @param _dstChainId - the destination chain identifier
                          // @param _destination - the address on destination chain (in bytes). address length/format may vary by chains
                          // @param _payload - a custom bytes payload to send to the destination contract
                          // @param _refundAddress - if the source transaction is cheaper than the amount of value passed, refund the additional amount to this address
                          // @param _zroPaymentAddress - the address of the ZRO token holder who would pay for the transaction
                          // @param _adapterParams - parameters for custom functionality. e.g. receive airdropped native gas from the relayer on destination
                          function send(uint16 _dstChainId, bytes calldata _destination, bytes calldata _payload, address payable _refundAddress, address _zroPaymentAddress, bytes calldata _adapterParams) external payable;
                          // @notice used by the messaging library to publish verified payload
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source contract (as bytes) at the source chain
                          // @param _dstAddress - the address on destination chain
                          // @param _nonce - the unbound message ordering nonce
                          // @param _gasLimit - the gas limit for external contract execution
                          // @param _payload - verified payload to send to the destination contract
                          function receivePayload(uint16 _srcChainId, bytes calldata _srcAddress, address _dstAddress, uint64 _nonce, uint _gasLimit, bytes calldata _payload) external;
                          // @notice get the inboundNonce of a receiver from a source chain which could be EVM or non-EVM chain
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source chain contract address
                          function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint64);
                          // @notice get the outboundNonce from this source chain which, consequently, is always an EVM
                          // @param _srcAddress - the source chain contract address
                          function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view returns (uint64);
                          // @notice gets a quote in source native gas, for the amount that send() requires to pay for message delivery
                          // @param _dstChainId - the destination chain identifier
                          // @param _userApplication - the user app address on this EVM chain
                          // @param _payload - the custom message to send over LayerZero
                          // @param _payInZRO - if false, user app pays the protocol fee in native token
                          // @param _adapterParam - parameters for the adapter service, e.g. send some dust native token to dstChain
                          function estimateFees(uint16 _dstChainId, address _userApplication, bytes calldata _payload, bool _payInZRO, bytes calldata _adapterParam) external view returns (uint nativeFee, uint zroFee);
                          // @notice get this Endpoint's immutable source identifier
                          function getChainId() external view returns (uint16);
                          // @notice the interface to retry failed message on this Endpoint destination
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source chain contract address
                          // @param _payload - the payload to be retried
                          function retryPayload(uint16 _srcChainId, bytes calldata _srcAddress, bytes calldata _payload) external;
                          // @notice query if any STORED payload (message blocking) at the endpoint.
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source chain contract address
                          function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool);
                          // @notice query if the _libraryAddress is valid for sending msgs.
                          // @param _userApplication - the user app address on this EVM chain
                          function getSendLibraryAddress(address _userApplication) external view returns (address);
                          // @notice query if the _libraryAddress is valid for receiving msgs.
                          // @param _userApplication - the user app address on this EVM chain
                          function getReceiveLibraryAddress(address _userApplication) external view returns (address);
                          // @notice query if the non-reentrancy guard for send() is on
                          // @return true if the guard is on. false otherwise
                          function isSendingPayload() external view returns (bool);
                          // @notice query if the non-reentrancy guard for receive() is on
                          // @return true if the guard is on. false otherwise
                          function isReceivingPayload() external view returns (bool);
                          // @notice get the configuration of the LayerZero messaging library of the specified version
                          // @param _version - messaging library version
                          // @param _chainId - the chainId for the pending config change
                          // @param _userApplication - the contract address of the user application
                          // @param _configType - type of configuration. every messaging library has its own convention.
                          function getConfig(uint16 _version, uint16 _chainId, address _userApplication, uint _configType) external view returns (bytes memory);
                          // @notice get the send() LayerZero messaging library version
                          // @param _userApplication - the contract address of the user application
                          function getSendVersion(address _userApplication) external view returns (uint16);
                          // @notice get the lzReceive() LayerZero messaging library version
                          // @param _userApplication - the contract address of the user application
                          function getReceiveVersion(address _userApplication) external view returns (uint16);
                      }
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity >=0.7.0;
                      import "./ILayerZeroUserApplicationConfig.sol";
                      interface ILayerZeroMessagingLibrary {
                          // send(), messages will be inflight.
                          function send(address _userApplication, uint64 _lastNonce, uint16 _chainId, bytes calldata _destination, bytes calldata _payload, address payable refundAddress, address _zroPaymentAddress, bytes calldata _adapterParams) external payable;
                          // estimate native fee at the send side
                          function estimateFees(uint16 _chainId, address _userApplication, bytes calldata _payload, bool _payInZRO, bytes calldata _adapterParam) external view returns (uint nativeFee, uint zroFee);
                          //---------------------------------------------------------------------------
                          // setConfig / getConfig are User Application (UA) functions to specify Oracle, Relayer, blockConfirmations, libraryVersion
                          function setConfig(uint16 _chainId, address _userApplication, uint _configType, bytes calldata _config) external;
                          function getConfig(uint16 _chainId, address _userApplication, uint _configType) external view returns (bytes memory);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity ^0.7.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 () {
                              address msgSender = _msgSender();
                              _owner = msgSender;
                              emit OwnershipTransferred(address(0), 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 {
                              emit OwnershipTransferred(_owner, address(0));
                              _owner = 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");
                              emit OwnershipTransferred(_owner, newOwner);
                              _owner = newOwner;
                          }
                      }
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity >=0.5.0;
                      interface ILayerZeroUserApplicationConfig {
                          // @notice set the configuration of the LayerZero messaging library of the specified version
                          // @param _version - messaging library version
                          // @param _chainId - the chainId for the pending config change
                          // @param _configType - type of configuration. every messaging library has its own convention.
                          // @param _config - configuration in the bytes. can encode arbitrary content.
                          function setConfig(uint16 _version, uint16 _chainId, uint _configType, bytes calldata _config) external;
                          // @notice set the send() LayerZero messaging library version to _version
                          // @param _version - new messaging library version
                          function setSendVersion(uint16 _version) external;
                          // @notice set the lzReceive() LayerZero messaging library version to _version
                          // @param _version - new messaging library version
                          function setReceiveVersion(uint16 _version) external;
                          // @notice Only when the UA needs to resume the message flow in blocking mode and clear the stored payload
                          // @param _srcChainId - the chainId of the source chain
                          // @param _srcAddress - the contract address of the source contract at the source chain
                          function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external;
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.6.0 <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 GSN 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 payable) {
                              return msg.sender;
                          }
                          function _msgData() internal view virtual returns (bytes memory) {
                              this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                              return msg.data;
                          }
                      }
                      

                      File 7 of 9: NonceContract
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity 0.7.6;
                      import "./interfaces/ILayerZeroEndpoint.sol";
                      contract NonceContract {
                          ILayerZeroEndpoint public immutable endpoint;
                          // outboundNonce = [dstChainId][remoteAddress + localAddress]
                          mapping(uint16 => mapping(bytes => uint64)) public outboundNonce;
                          constructor(address _endpoint) {
                              endpoint = ILayerZeroEndpoint(_endpoint);
                          }
                          function increment(uint16 _chainId, address _ua, bytes calldata _path) external returns (uint64) {
                              require(endpoint.getSendLibraryAddress(_ua) == msg.sender, "NonceContract: msg.sender is not valid sendlibrary");
                              return ++outboundNonce[_chainId][_path];
                          }
                      }
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity >=0.5.0;
                      import "./ILayerZeroUserApplicationConfig.sol";
                      interface ILayerZeroEndpoint is ILayerZeroUserApplicationConfig {
                          // @notice send a LayerZero message to the specified address at a LayerZero endpoint.
                          // @param _dstChainId - the destination chain identifier
                          // @param _destination - the address on destination chain (in bytes). address length/format may vary by chains
                          // @param _payload - a custom bytes payload to send to the destination contract
                          // @param _refundAddress - if the source transaction is cheaper than the amount of value passed, refund the additional amount to this address
                          // @param _zroPaymentAddress - the address of the ZRO token holder who would pay for the transaction
                          // @param _adapterParams - parameters for custom functionality. e.g. receive airdropped native gas from the relayer on destination
                          function send(uint16 _dstChainId, bytes calldata _destination, bytes calldata _payload, address payable _refundAddress, address _zroPaymentAddress, bytes calldata _adapterParams) external payable;
                          // @notice used by the messaging library to publish verified payload
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source contract (as bytes) at the source chain
                          // @param _dstAddress - the address on destination chain
                          // @param _nonce - the unbound message ordering nonce
                          // @param _gasLimit - the gas limit for external contract execution
                          // @param _payload - verified payload to send to the destination contract
                          function receivePayload(uint16 _srcChainId, bytes calldata _srcAddress, address _dstAddress, uint64 _nonce, uint _gasLimit, bytes calldata _payload) external;
                          // @notice get the inboundNonce of a receiver from a source chain which could be EVM or non-EVM chain
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source chain contract address
                          function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint64);
                          // @notice get the outboundNonce from this source chain which, consequently, is always an EVM
                          // @param _srcAddress - the source chain contract address
                          function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view returns (uint64);
                          // @notice gets a quote in source native gas, for the amount that send() requires to pay for message delivery
                          // @param _dstChainId - the destination chain identifier
                          // @param _userApplication - the user app address on this EVM chain
                          // @param _payload - the custom message to send over LayerZero
                          // @param _payInZRO - if false, user app pays the protocol fee in native token
                          // @param _adapterParam - parameters for the adapter service, e.g. send some dust native token to dstChain
                          function estimateFees(uint16 _dstChainId, address _userApplication, bytes calldata _payload, bool _payInZRO, bytes calldata _adapterParam) external view returns (uint nativeFee, uint zroFee);
                          // @notice get this Endpoint's immutable source identifier
                          function getChainId() external view returns (uint16);
                          // @notice the interface to retry failed message on this Endpoint destination
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source chain contract address
                          // @param _payload - the payload to be retried
                          function retryPayload(uint16 _srcChainId, bytes calldata _srcAddress, bytes calldata _payload) external;
                          // @notice query if any STORED payload (message blocking) at the endpoint.
                          // @param _srcChainId - the source chain identifier
                          // @param _srcAddress - the source chain contract address
                          function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool);
                          // @notice query if the _libraryAddress is valid for sending msgs.
                          // @param _userApplication - the user app address on this EVM chain
                          function getSendLibraryAddress(address _userApplication) external view returns (address);
                          // @notice query if the _libraryAddress is valid for receiving msgs.
                          // @param _userApplication - the user app address on this EVM chain
                          function getReceiveLibraryAddress(address _userApplication) external view returns (address);
                          // @notice query if the non-reentrancy guard for send() is on
                          // @return true if the guard is on. false otherwise
                          function isSendingPayload() external view returns (bool);
                          // @notice query if the non-reentrancy guard for receive() is on
                          // @return true if the guard is on. false otherwise
                          function isReceivingPayload() external view returns (bool);
                          // @notice get the configuration of the LayerZero messaging library of the specified version
                          // @param _version - messaging library version
                          // @param _chainId - the chainId for the pending config change
                          // @param _userApplication - the contract address of the user application
                          // @param _configType - type of configuration. every messaging library has its own convention.
                          function getConfig(uint16 _version, uint16 _chainId, address _userApplication, uint _configType) external view returns (bytes memory);
                          // @notice get the send() LayerZero messaging library version
                          // @param _userApplication - the contract address of the user application
                          function getSendVersion(address _userApplication) external view returns (uint16);
                          // @notice get the lzReceive() LayerZero messaging library version
                          // @param _userApplication - the contract address of the user application
                          function getReceiveVersion(address _userApplication) external view returns (uint16);
                      }
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity >=0.5.0;
                      interface ILayerZeroUserApplicationConfig {
                          // @notice set the configuration of the LayerZero messaging library of the specified version
                          // @param _version - messaging library version
                          // @param _chainId - the chainId for the pending config change
                          // @param _configType - type of configuration. every messaging library has its own convention.
                          // @param _config - configuration in the bytes. can encode arbitrary content.
                          function setConfig(uint16 _version, uint16 _chainId, uint _configType, bytes calldata _config) external;
                          // @notice set the send() LayerZero messaging library version to _version
                          // @param _version - new messaging library version
                          function setSendVersion(uint16 _version) external;
                          // @notice set the lzReceive() LayerZero messaging library version to _version
                          // @param _version - new messaging library version
                          function setReceiveVersion(uint16 _version) external;
                          // @notice Only when the UA needs to resume the message flow in blocking mode and clear the stored payload
                          // @param _srcChainId - the chainId of the source chain
                          // @param _srcAddress - the contract address of the source contract at the source chain
                          function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external;
                      }
                      

                      File 8 of 9: OptimizedTransparentUpgradeableProxy
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.5.0-rc.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 v4.4.1 (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 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
                      // OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/ERC1967/ERC1967Upgrade.sol)
                      pragma solidity ^0.8.2;
                      import "../beacon/IBeacon.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 {
                          // 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 _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 Emitted when the admin account has changed.
                           */
                          event AdminChanged(address previousAdmin, address newAdmin);
                          /**
                           * @dev Returns the current admin.
                           */
                          function _getAdmin() internal view virtual 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
                      // OpenZeppelin Contracts (last updated v4.5.0-rc.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 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
                      // OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)
                      pragma solidity ^0.8.0;
                      /**
                       * @dev This is the interface that {BeaconProxy} expects of its beacon.
                       */
                      interface IBeacon {
                          /**
                           * @dev Must return an address that can be used as a delegate call target.
                           *
                           * {BeaconProxy} will check that this address is a contract.
                           */
                          function implementation() external view returns (address);
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts (last updated v4.5.0-rc.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 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
                      // OpenZeppelin Contracts v4.4.1 (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
                              }
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      // OpenZeppelin Contracts v4.4.1 (proxy/transparent/TransparentUpgradeableProxy.sol)
                      pragma solidity ^0.8.0;
                      import "../openzeppelin/proxy/ERC1967/ERC1967Proxy.sol";
                      /**
                       * @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.
                       */
                      contract OptimizedTransparentUpgradeableProxy is ERC1967Proxy {
                          address internal immutable _ADMIN;
                          /**
                           * @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) {
                              assert(_ADMIN_SLOT == bytes32(uint256(keccak256("eip1967.proxy.admin")) - 1));
                              _ADMIN = admin_;
                              // still store it to work with EIP-1967
                              bytes32 slot = _ADMIN_SLOT;
                              // solhint-disable-next-line no-inline-assembly
                              assembly {
                                  sstore(slot, admin_)
                              }
                              emit AdminChanged(address(0), admin_);
                          }
                          /**
                           * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
                           */
                          modifier ifAdmin() {
                              if (msg.sender == _getAdmin()) {
                                  _;
                              } else {
                                  _fallback();
                              }
                          }
                          /**
                           * @dev Returns the current admin.
                           *
                           * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.
                           *
                           * 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 admin() external ifAdmin returns (address admin_) {
                              admin_ = _getAdmin();
                          }
                          /**
                           * @dev Returns the current implementation.
                           *
                           * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.
                           *
                           * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
                           * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                           * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
                           */
                          function implementation() external ifAdmin returns (address implementation_) {
                              implementation_ = _implementation();
                          }
                          /**
                           * @dev Upgrade the implementation of the proxy.
                           *
                           * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.
                           */
                          function upgradeTo(address newImplementation) external ifAdmin {
                              _upgradeToAndCall(newImplementation, bytes(""), false);
                          }
                          /**
                           * @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.
                           *
                           * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.
                           */
                          function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {
                              _upgradeToAndCall(newImplementation, data, true);
                          }
                          /**
                           * @dev Returns the current admin.
                           */
                          function _admin() internal view virtual returns (address) {
                              return _getAdmin();
                          }
                          /**
                           * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.
                           */
                          function _beforeFallback() internal virtual override {
                              require(msg.sender != _getAdmin(), "TransparentUpgradeableProxy: admin cannot fallback to proxy target");
                              super._beforeFallback();
                          }
                          function _getAdmin() internal view virtual override returns (address) {
                              return _ADMIN;
                          }
                      }
                      

                      File 9 of 9: TreasuryV2
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity 0.7.6;
                      import "./interfaces/ILayerZeroTreasury.sol";
                      import "@openzeppelin/contracts/access/Ownable.sol";
                      import "@openzeppelin/contracts/math/SafeMath.sol";
                      import "./interfaces/ILayerZeroUltraLightNodeV2.sol";
                      contract TreasuryV2 is ILayerZeroTreasury, Ownable {
                          using SafeMath for uint;
                          uint public nativeBP;
                          uint public zroFee;
                          bool public feeEnabled;
                          bool public zroEnabled;
                          ILayerZeroUltraLightNodeV2 public uln;
                          event NativeBP(uint bp);
                          event ZroFee(uint zroFee);
                          event FeeEnabled(bool feeEnabled);
                          event ZroEnabled(bool zroEnabled);
                          constructor(address _ulnv2) {
                              uln = ILayerZeroUltraLightNodeV2(_ulnv2);
                          }
                          function getFees(bool payInZro, uint relayerFee, uint oracleFee) external view override returns (uint) {
                              if (feeEnabled) {
                                  if (payInZro) {
                                      require(zroEnabled, "LayerZero: ZRO is not enabled");
                                      return zroFee;
                                  } else {
                                      return relayerFee.add(oracleFee).mul(nativeBP).div(10000);
                                  }
                              }
                              return 0;
                          }
                          function setFeeEnabled(bool _feeEnabled) external onlyOwner {
                              feeEnabled = _feeEnabled;
                              emit FeeEnabled(_feeEnabled);
                          }
                          function setZroEnabled(bool _zroEnabled) external onlyOwner {
                              zroEnabled = _zroEnabled;
                              emit ZroEnabled(_zroEnabled);
                          }
                          function setNativeBP(uint _nativeBP) external onlyOwner {
                              nativeBP = _nativeBP;
                              emit NativeBP(_nativeBP);
                          }
                          function setZroFee(uint _zroFee) external onlyOwner {
                              zroFee = _zroFee;
                              emit ZroFee(_zroFee);
                          }
                          function withdrawZROFromULN(address _to, uint _amount) external onlyOwner {
                              uln.withdrawZRO(_to, _amount);
                          }
                          function withdrawNativeFromULN(address payable _to, uint _amount) external onlyOwner {
                              uln.withdrawNative(_to, _amount);
                          }
                      }
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity >=0.5.0;
                      interface ILayerZeroTreasury {
                          function getFees(bool payInZro, uint relayerFee, uint oracleFee) external view returns (uint);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity ^0.7.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 () {
                              address msgSender = _msgSender();
                              _owner = msgSender;
                              emit OwnershipTransferred(address(0), 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 {
                              emit OwnershipTransferred(_owner, address(0));
                              _owner = 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");
                              emit OwnershipTransferred(_owner, newOwner);
                              _owner = newOwner;
                          }
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity ^0.7.0;
                      /**
                       * @dev Wrappers over Solidity's arithmetic operations with added overflow
                       * checks.
                       *
                       * Arithmetic operations in Solidity wrap on overflow. This can easily result
                       * in bugs, because programmers usually assume that an overflow raises an
                       * error, which is the standard behavior in high level programming languages.
                       * `SafeMath` restores this intuition by reverting the transaction when an
                       * operation overflows.
                       *
                       * Using this library instead of the unchecked operations eliminates an entire
                       * class of bugs, so it's recommended to use it always.
                       */
                      library SafeMath {
                          /**
                           * @dev Returns the addition of two unsigned integers, with an overflow flag.
                           *
                           * _Available since v3.4._
                           */
                          function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                              uint256 c = a + b;
                              if (c < a) return (false, 0);
                              return (true, c);
                          }
                          /**
                           * @dev Returns the substraction of two unsigned integers, with an overflow flag.
                           *
                           * _Available since v3.4._
                           */
                          function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                              if (b > a) return (false, 0);
                              return (true, a - b);
                          }
                          /**
                           * @dev Returns the multiplication of two unsigned integers, with an overflow flag.
                           *
                           * _Available since v3.4._
                           */
                          function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                              // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                              // benefit is lost if 'b' is also tested.
                              // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
                              if (a == 0) return (true, 0);
                              uint256 c = a * b;
                              if (c / a != b) return (false, 0);
                              return (true, c);
                          }
                          /**
                           * @dev Returns the division of two unsigned integers, with a division by zero flag.
                           *
                           * _Available since v3.4._
                           */
                          function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                              if (b == 0) return (false, 0);
                              return (true, a / b);
                          }
                          /**
                           * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
                           *
                           * _Available since v3.4._
                           */
                          function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                              if (b == 0) return (false, 0);
                              return (true, a % b);
                          }
                          /**
                           * @dev Returns the addition of two unsigned integers, reverting on
                           * overflow.
                           *
                           * Counterpart to Solidity's `+` operator.
                           *
                           * Requirements:
                           *
                           * - Addition cannot overflow.
                           */
                          function add(uint256 a, uint256 b) internal pure returns (uint256) {
                              uint256 c = a + b;
                              require(c >= a, "SafeMath: addition overflow");
                              return c;
                          }
                          /**
                           * @dev Returns the subtraction of two unsigned integers, reverting on
                           * overflow (when the result is negative).
                           *
                           * Counterpart to Solidity's `-` operator.
                           *
                           * Requirements:
                           *
                           * - Subtraction cannot overflow.
                           */
                          function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                              require(b <= a, "SafeMath: subtraction overflow");
                              return a - b;
                          }
                          /**
                           * @dev Returns the multiplication of two unsigned integers, reverting on
                           * overflow.
                           *
                           * Counterpart to Solidity's `*` operator.
                           *
                           * Requirements:
                           *
                           * - Multiplication cannot overflow.
                           */
                          function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                              if (a == 0) return 0;
                              uint256 c = a * b;
                              require(c / a == b, "SafeMath: multiplication overflow");
                              return c;
                          }
                          /**
                           * @dev Returns the integer division of two unsigned integers, reverting on
                           * division by zero. The result is rounded towards zero.
                           *
                           * Counterpart to Solidity's `/` operator. Note: this function uses a
                           * `revert` opcode (which leaves remaining gas untouched) while Solidity
                           * uses an invalid opcode to revert (consuming all remaining gas).
                           *
                           * Requirements:
                           *
                           * - The divisor cannot be zero.
                           */
                          function div(uint256 a, uint256 b) internal pure returns (uint256) {
                              require(b > 0, "SafeMath: division by zero");
                              return a / b;
                          }
                          /**
                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                           * reverting when dividing by zero.
                           *
                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                           * invalid opcode to revert (consuming all remaining gas).
                           *
                           * Requirements:
                           *
                           * - The divisor cannot be zero.
                           */
                          function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                              require(b > 0, "SafeMath: modulo by zero");
                              return a % b;
                          }
                          /**
                           * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
                           * overflow (when the result is negative).
                           *
                           * CAUTION: This function is deprecated because it requires allocating memory for the error
                           * message unnecessarily. For custom revert reasons use {trySub}.
                           *
                           * Counterpart to Solidity's `-` operator.
                           *
                           * Requirements:
                           *
                           * - Subtraction cannot overflow.
                           */
                          function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                              require(b <= a, errorMessage);
                              return a - b;
                          }
                          /**
                           * @dev Returns the integer division of two unsigned integers, reverting with custom message on
                           * division by zero. The result is rounded towards zero.
                           *
                           * CAUTION: This function is deprecated because it requires allocating memory for the error
                           * message unnecessarily. For custom revert reasons use {tryDiv}.
                           *
                           * Counterpart to Solidity's `/` operator. Note: this function uses a
                           * `revert` opcode (which leaves remaining gas untouched) while Solidity
                           * uses an invalid opcode to revert (consuming all remaining gas).
                           *
                           * Requirements:
                           *
                           * - The divisor cannot be zero.
                           */
                          function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                              require(b > 0, errorMessage);
                              return a / b;
                          }
                          /**
                           * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                           * reverting with custom message when dividing by zero.
                           *
                           * CAUTION: This function is deprecated because it requires allocating memory for the error
                           * message unnecessarily. For custom revert reasons use {tryMod}.
                           *
                           * Counterpart to Solidity's `%` operator. This function uses a `revert`
                           * opcode (which leaves remaining gas untouched) while Solidity uses an
                           * invalid opcode to revert (consuming all remaining gas).
                           *
                           * Requirements:
                           *
                           * - The divisor cannot be zero.
                           */
                          function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                              require(b > 0, errorMessage);
                              return a % b;
                          }
                      }
                      // SPDX-License-Identifier: BUSL-1.1
                      pragma solidity >=0.7.0;
                      pragma abicoder v2;
                      interface ILayerZeroUltraLightNodeV2 {
                          // Relayer functions
                          function validateTransactionProof(uint16 _srcChainId, address _dstAddress, uint _gasLimit, bytes32 _lookupHash, bytes32 _blockData, bytes calldata _transactionProof) external;
                          // an Oracle delivers the block data using updateHash()
                          function updateHash(uint16 _srcChainId, bytes32 _lookupHash, uint _confirmations, bytes32 _blockData) external;
                          // can only withdraw the receivable of the msg.sender
                          function withdrawNative(address payable _to, uint _amount) external;
                          function withdrawZRO(address _to, uint _amount) external;
                          // view functions
                          function getAppConfig(uint16 _remoteChainId, address _userApplicationAddress) external view returns (ApplicationConfiguration memory);
                          function accruedNativeFee(address _address) external view returns (uint);
                          struct ApplicationConfiguration {
                              uint16 inboundProofLibraryVersion;
                              uint64 inboundBlockConfirmations;
                              address relayer;
                              uint16 outboundProofType;
                              uint64 outboundBlockConfirmations;
                              address oracle;
                          }
                          event HashReceived(uint16 indexed srcChainId, address indexed oracle, bytes32 lookupHash, bytes32 blockData, uint confirmations);
                          event RelayerParams(bytes adapterParams, uint16 outboundProofType);
                          event Packet(bytes payload);
                          event InvalidDst(uint16 indexed srcChainId, bytes srcAddress, address indexed dstAddress, uint64 nonce, bytes32 payloadHash);
                          event PacketReceived(uint16 indexed srcChainId, bytes srcAddress, address indexed dstAddress, uint64 nonce, bytes32 payloadHash);
                          event AppConfigUpdated(address indexed userApplication, uint indexed configType, bytes newConfig);
                          event AddInboundProofLibraryForChain(uint16 indexed chainId, address lib);
                          event EnableSupportedOutboundProof(uint16 indexed chainId, uint16 proofType);
                          event SetChainAddressSize(uint16 indexed chainId, uint size);
                          event SetDefaultConfigForChainId(uint16 indexed chainId, uint16 inboundProofLib, uint64 inboundBlockConfirm, address relayer, uint16 outboundProofType, uint64 outboundBlockConfirm, address oracle);
                          event SetDefaultAdapterParamsForChainId(uint16 indexed chainId, uint16 indexed proofType, bytes adapterParams);
                          event SetLayerZeroToken(address indexed tokenAddress);
                          event SetRemoteUln(uint16 indexed chainId, bytes32 uln);
                          event SetTreasury(address indexed treasuryAddress);
                          event WithdrawZRO(address indexed msgSender, address indexed to, uint amount);
                          event WithdrawNative(address indexed msgSender, address indexed to, uint amount);
                      }
                      // SPDX-License-Identifier: MIT
                      pragma solidity >=0.6.0 <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 GSN 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 payable) {
                              return msg.sender;
                          }
                          function _msgData() internal view virtual returns (bytes memory) {
                              this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                              return msg.data;
                          }
                      }