ETH Price: $2,293.19 (-5.46%)

Transaction Decoder

Block:
19288097 at Feb-23-2024 05:06:23 AM +UTC
Transaction Fee:
0.008633754675480096 ETH $19.80
Gas Used:
263,304 Gas / 32.790062724 Gwei

Emitted Events:

316 TransparentUpgradeableProxy.0x302b3ebcd58d43753be6657117391b4a3b8dc310ae7054a9905486dd23241676( 0x302b3ebcd58d43753be6657117391b4a3b8dc310ae7054a9905486dd23241676, 0x00000000000000000000000000000000000000000000000000000000000000bd, 0x0000000000000000000000000000000000000000000000000000000000000007, 0x0000000000000000000000000000000000000000000000000000000000000001, 0000000000000000000000000e43c7a950406273b05066108edc15cea53e6289, 00000000000000000000000000000000000000000000000000f8b0a10e470000 )
317 OptimizedTransparentUpgradeableProxy.0x4a008ac830958ba6fe8a6e667e2ab53a530eb6cdf93e55b27fc42d7a54cf25b7( 0x4a008ac830958ba6fe8a6e667e2ab53a530eb6cdf93e55b27fc42d7a54cf25b7, 0x00000000000000000000000024bbc063def30ae81aecc659b97a8b2562b2afcd, 0x0000000000000000000000000000000000000000000000000000000000000007, 0x00000000000000000000000000000000000000000000000000000000000000bd, 00000000000000000000000089a56ff41a4be1360f780c5abfba8fd7eced2c7a, 0000000000000000000000000000000000000000000000000000000000000040, 0000000000000000000000000000000000000000000000000000000000000060, 0000000000000000000000000000000000000000000000000000000000000001, 00000000000000000000000000000000000000000000000000f8b0a10e470000, 0000000000000000000000000e43c7a950406273b05066108edc15cea53e6289 )

Account State Difference:

  Address   Before After State Difference Code
(MEV Builder: 0x0Aa...667)
7.225039938814071784 Eth7.225040202118071784 Eth0.000000263304
0x0E43C7A9...ea53E6289 0.001016173554354246 Eth0.071016173554354246 Eth0.07
0x1D0AD4b6...0BC4Bd7e7
(Fake_Phishing1195477)
0.698495833134396687 Eth
Nonce: 1640
0.689862078458916591 Eth
Nonce: 1641
0.008633754675480096
0x89a56FF4...7EceD2c7A 39.679600546732220137 Eth39.609600546732220137 Eth0.07
0xb20F0105...341106dDC

Execution Trace

OptimizedTransparentUpgradeableProxy.4f64ca19( )
  • ZKBridge.validateTransactionProof( _srcChainId=7, _srcBlockHash=CA8296B6423D72B83FDA09662F490577617A1A6CB93F12A01062F86D6393F639, _logIndex=0, _mptProof=0xF90501A035750C3B7428FA78E649E2EA633FCEF62692ECD9B4E5B84A0E182007933F811C04F904DCF851A069894FC614A0B2CD0EF65A3E4B2DCF42DB4288E2BDF0A1EAF62DF6244AD2392680808080808080A027E0E9070A15D192AA881244B0BC815B6A8DF959399374794AE81D5B0880DBA58080808080808080F9011180A058A17CE6066734DD4B063BDA402A38737C91D7ABBD1BEF665C1C50BD7C1D65BAA078633B54817911BA2FF6C08F0CF41E3366850E7CA041BF5894AC56EDD2EA4749A05D31EBDCC75D776E52404E8FB119D945A4917AFEC8DC11D46E4053AE4F6A597DA06E7A8F0D8AD48AE821362DB8867340A8BFB8B43130EE799E1CCC980EBBB5DC20A0E73D0457BBCE74FCA4C55151D4103136A4A91C9524E71B324D0F7A4DEE445099A0885CE1D84FBB85DFB53A513F9968DC0E0E0E6D5D68635AF5ECFC900B21547B02A0CE05945368558370CDDBE0C33827B9A480F9240071DC9652C01F5D8BF11FC0FAA0E35A3A14D23F3F6B93E0C29FE929D4879828DC279B00914765725435A489394F8080808080808080F9037220B9036E02F9036A018309CA3EB9010004000000000000000400000000000000000000000000000000000200000000000000000000000000000000000000000000000400000000000000000000040000000000000000000000090000000000000000000000040000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000100200000000100000000000000000000000010000080000000100000000000000000800000000000000000000000000000000000000000000000000010000000000000002000000000800000040000000000000000000000000000000000000100000008000000000000000200000F9025FF9015D94B20F0105F3598652A3BE569132F7B3F341106DDCF884A0B8ABFD5C33667C7440A4FC1153AE39A24833DBE44F7EB19CBE5CD5F2583E4940A000000000000000000000000024BBC063DEF30AE81AECC659B97A8B2562B2AFCDA00000000000000000000000000000000000000000000000000000000000000002A000000000000000000000000000000000000000000000000000000000000000BDB8C000000000000000000000000089A56FF41A4BE1360F780C5ABFBA8FD7ECED2C7A00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000F8B0A10E4700000000000000000000000000000E43C7A950406273B05066108EDC15CEA53E6289F8FD9424BBC063DEF30AE81AECC659B97A8B2562B2AFCDF884A0E0442D4E58B97FF2055E08DF9305389520A00AC06C83A83131EF3D0E1572068CA000000000000000000000000000000000000000000000000000000000000000BDA00000000000000000000000000000000000000000000000000000000000000002A00000000000000000000000000000000000000000000000000000000000000001B8600000000000000000000000000E43C7A950406273B05066108EDC15CEA53E62890000000000000000000000000E43C7A950406273B05066108EDC15CEA53E628900000000000000000000000000000000000000000000000000F8B0A10E470000 )
    • MptVerifier.validateMPT( proofBlob=0xF90501A035750C3B7428FA78E649E2EA633FCEF62692ECD9B4E5B84A0E182007933F811C04F904DCF851A069894FC614A0B2CD0EF65A3E4B2DCF42DB4288E2BDF0A1EAF62DF6244AD2392680808080808080A027E0E9070A15D192AA881244B0BC815B6A8DF959399374794AE81D5B0880DBA58080808080808080F9011180A058A17CE6066734DD4B063BDA402A38737C91D7ABBD1BEF665C1C50BD7C1D65BAA078633B54817911BA2FF6C08F0CF41E3366850E7CA041BF5894AC56EDD2EA4749A05D31EBDCC75D776E52404E8FB119D945A4917AFEC8DC11D46E4053AE4F6A597DA06E7A8F0D8AD48AE821362DB8867340A8BFB8B43130EE799E1CCC980EBBB5DC20A0E73D0457BBCE74FCA4C55151D4103136A4A91C9524E71B324D0F7A4DEE445099A0885CE1D84FBB85DFB53A513F9968DC0E0E0E6D5D68635AF5ECFC900B21547B02A0CE05945368558370CDDBE0C33827B9A480F9240071DC9652C01F5D8BF11FC0FAA0E35A3A14D23F3F6B93E0C29FE929D4879828DC279B00914765725435A489394F8080808080808080F9037220B9036E02F9036A018309CA3EB9010004000000000000000400000000000000000000000000000000000200000000000000000000000000000000000000000000000400000000000000000000040000000000000000000000090000000000000000000000040000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000100200000000100000000000000000000000010000080000000100000000000000000800000000000000000000000000000000000000000000000000010000000000000002000000000800000040000000000000000000000000000000000000100000008000000000000000200000F9025FF9015D94B20F0105F3598652A3BE569132F7B3F341106DDCF884A0B8ABFD5C33667C7440A4FC1153AE39A24833DBE44F7EB19CBE5CD5F2583E4940A000000000000000000000000024BBC063DEF30AE81AECC659B97A8B2562B2AFCDA00000000000000000000000000000000000000000000000000000000000000002A000000000000000000000000000000000000000000000000000000000000000BDB8C000000000000000000000000089A56FF41A4BE1360F780C5ABFBA8FD7ECED2C7A00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000F8B0A10E4700000000000000000000000000000E43C7A950406273B05066108EDC15CEA53E6289F8FD9424BBC063DEF30AE81AECC659B97A8B2562B2AFCDF884A0E0442D4E58B97FF2055E08DF9305389520A00AC06C83A83131EF3D0E1572068CA000000000000000000000000000000000000000000000000000000000000000BDA00000000000000000000000000000000000000000000000000000000000000002A00000000000000000000000000000000000000000000000000000000000000001B8600000000000000000000000000E43C7A950406273B05066108EDC15CEA53E62890000000000000000000000000E43C7A950406273B05066108EDC15CEA53E628900000000000000000000000000000000000000000000000000F8B0A10E470000 ) => ( receipt=[{name:receiptHash, type:bytes32, order:1, indexed:false, value:35750C3B7428FA78E649E2EA633FCEF62692ECD9B4E5B84A0E182007933F811C, valueString:35750C3B7428FA78E649E2EA633FCEF62692ECD9B4E5B84A0E182007933F811C}, {name:state, type:uint256, order:2, indexed:false, value:1, valueString:1}, {name:logs, type:bytes, order:3, indexed:false, value:0xF9015D94B20F0105F3598652A3BE569132F7B3F341106DDCF884A0B8ABFD5C33667C7440A4FC1153AE39A24833DBE44F7EB19CBE5CD5F2583E4940A000000000000000000000000024BBC063DEF30AE81AECC659B97A8B2562B2AFCDA00000000000000000000000000000000000000000000000000000000000000002A000000000000000000000000000000000000000000000000000000000000000BDB8C000000000000000000000000089A56FF41A4BE1360F780C5ABFBA8FD7ECED2C7A00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000F8B0A10E4700000000000000000000000000000E43C7A950406273B05066108EDC15CEA53E6289F8FD9424BBC063DEF30AE81AECC659B97A8B2562B2AFCDF884A0E0442D4E58B97FF2055E08DF9305389520A00AC06C83A83131EF3D0E1572068CA000000000000000000000000000000000000000000000000000000000000000BDA00000000000000000000000000000000000000000000000000000000000000002A00000000000000000000000000000000000000000000000000000000000000001B8600000000000000000000000000E43C7A950406273B05066108EDC15CEA53E62890000000000000000000000000E43C7A950406273B05066108EDC15CEA53E628900000000000000000000000000000000000000000000000000F8B0A10E470000, valueString:0xF9015D94B20F0105F3598652A3BE569132F7B3F341106DDCF884A0B8ABFD5C33667C7440A4FC1153AE39A24833DBE44F7EB19CBE5CD5F2583E4940A000000000000000000000000024BBC063DEF30AE81AECC659B97A8B2562B2AFCDA00000000000000000000000000000000000000000000000000000000000000002A000000000000000000000000000000000000000000000000000000000000000BDB8C000000000000000000000000089A56FF41A4BE1360F780C5ABFBA8FD7ECED2C7A00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000F8B0A10E4700000000000000000000000000000E43C7A950406273B05066108EDC15CEA53E6289F8FD9424BBC063DEF30AE81AECC659B97A8B2562B2AFCDF884A0E0442D4E58B97FF2055E08DF9305389520A00AC06C83A83131EF3D0E1572068CA000000000000000000000000000000000000000000000000000000000000000BDA00000000000000000000000000000000000000000000000000000000000000002A00000000000000000000000000000000000000000000000000000000000000001B8600000000000000000000000000E43C7A950406273B05066108EDC15CEA53E62890000000000000000000000000E43C7A950406273B05066108EDC15CEA53E628900000000000000000000000000000000000000000000000000F8B0A10E470000}] )
    • OptimisticBlockUpdater.checkBlock( _blockHash=CA8296B6423D72B83FDA09662F490577617A1A6CB93F12A01062F86D6393F639, _receiptHash=35750C3B7428FA78E649E2EA633FCEF62692ECD9B4E5B84A0E182007933F811C ) => ( True )
    • TransparentUpgradeableProxy.2de9952a( )
      • Bridge.zkReceive( srcChainId=7, srcAddress=0x24bbC063DeF30Ae81AECC659B97A8b2562b2AFCd, sequence=189, payload=0x000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000F8B0A10E4700000000000000000000000000000E43C7A950406273B05066108EDC15CEA53E6289 )
        • ETH 0.07 0x0e43c7a950406273b05066108edc15cea53e6289.CALL( )
          File 1 of 6: OptimizedTransparentUpgradeableProxy
          // Sources flattened with hardhat v2.17.2 https://hardhat.org
          
          // SPDX-License-Identifier: MIT
          
          // File @openzeppelin/contracts/interfaces/[email protected]
          
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
           * proxy whose upgrades are fully controlled by the current implementation.
           */
          interface IERC1822Proxiable {
              /**
               * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
               * address.
               *
               * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
               * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
               * function revert if invoked through a proxy.
               */
              function proxiableUUID() external view returns (bytes32);
          }
          
          
          // File @openzeppelin/contracts/interfaces/[email protected]
          
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.
           *
           * _Available since v4.8.3._
           */
          interface IERC1967 {
              /**
               * @dev Emitted when the implementation is upgraded.
               */
              event Upgraded(address indexed implementation);
          
              /**
               * @dev Emitted when the admin account has changed.
               */
              event AdminChanged(address previousAdmin, address newAdmin);
          
              /**
               * @dev Emitted when the beacon is changed.
               */
              event BeaconUpgraded(address indexed beacon);
          }
          
          
          // File @openzeppelin/contracts/proxy/beacon/[email protected]
          
          // Original license: 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);
          }
          
          
          // File @openzeppelin/contracts/utils/[email protected]
          
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
          
          pragma solidity ^0.8.1;
          
          /**
           * @dev Collection of functions related to the address type
           */
          library 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);
                  }
              }
          }
          
          
          // File @openzeppelin/contracts/utils/[email protected]
          
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol)
          // This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev Library for reading and writing primitive types to specific storage slots.
           *
           * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
           * This library helps with reading and writing to such slots without the need for inline assembly.
           *
           * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
           *
           * Example usage to set ERC1967 implementation slot:
           * ```solidity
           * contract ERC1967 {
           *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
           *
           *     function _getImplementation() internal view returns (address) {
           *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
           *     }
           *
           *     function _setImplementation(address newImplementation) internal {
           *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
           *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
           *     }
           * }
           * ```
           *
           * _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._
           * _Available since v4.9 for `string`, `bytes`._
           */
          library StorageSlot {
              struct AddressSlot {
                  address value;
              }
          
              struct BooleanSlot {
                  bool value;
              }
          
              struct Bytes32Slot {
                  bytes32 value;
              }
          
              struct Uint256Slot {
                  uint256 value;
              }
          
              struct StringSlot {
                  string value;
              }
          
              struct BytesSlot {
                  bytes value;
              }
          
              /**
               * @dev Returns an `AddressSlot` with member `value` located at `slot`.
               */
              function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
               */
              function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
               */
              function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
               */
              function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `StringSlot` with member `value` located at `slot`.
               */
              function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
               */
              function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := store.slot
                  }
              }
          
              /**
               * @dev Returns an `BytesSlot` with member `value` located at `slot`.
               */
              function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
          
              /**
               * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
               */
              function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := store.slot
                  }
              }
          }
          
          
          // File @openzeppelin/contracts/proxy/ERC1967/[email protected]
          
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)
          
          pragma solidity ^0.8.2;
          
          
          
          
          
          /**
           * @dev This abstract contract provides getters and event emitting update functions for
           * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
           *
           * _Available since v4.1._
           */
          abstract contract ERC1967Upgrade is IERC1967 {
              // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
              bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
          
              /**
               * @dev Storage slot with the address of the current implementation.
               * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
          
              /**
               * @dev Returns the current implementation address.
               */
              function _getImplementation() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
              }
          
              /**
               * @dev Stores a new address in the EIP1967 implementation slot.
               */
              function _setImplementation(address newImplementation) private {
                  require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                  StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
              }
          
              /**
               * @dev Perform implementation upgrade
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeTo(address newImplementation) internal {
                  _setImplementation(newImplementation);
                  emit Upgraded(newImplementation);
              }
          
              /**
               * @dev Perform implementation upgrade with additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
                  _upgradeTo(newImplementation);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(newImplementation, data);
                  }
              }
          
              /**
               * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {
                  // Upgrades from old implementations will perform a rollback test. This test requires the new
                  // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
                  // this special case will break upgrade paths from old UUPS implementation to new ones.
                  if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {
                      _setImplementation(newImplementation);
                  } else {
                      try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
                          require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
                      } catch {
                          revert("ERC1967Upgrade: new implementation is not UUPS");
                      }
                      _upgradeToAndCall(newImplementation, data, forceCall);
                  }
              }
          
              /**
               * @dev Storage slot with the admin of the contract.
               * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
          
              /**
               * @dev Returns the current admin.
               */
              function _getAdmin() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
              }
          
              /**
               * @dev Stores a new address in the EIP1967 admin slot.
               */
              function _setAdmin(address newAdmin) private {
                  require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                  StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
              }
          
              /**
               * @dev Changes the admin of the proxy.
               *
               * Emits an {AdminChanged} event.
               */
              function _changeAdmin(address newAdmin) internal {
                  emit AdminChanged(_getAdmin(), newAdmin);
                  _setAdmin(newAdmin);
              }
          
              /**
               * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
               * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
               */
              bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
          
              /**
               * @dev Returns the current beacon.
               */
              function _getBeacon() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
              }
          
              /**
               * @dev Stores a new beacon in the EIP1967 beacon slot.
               */
              function _setBeacon(address newBeacon) private {
                  require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract");
                  require(
                      Address.isContract(IBeacon(newBeacon).implementation()),
                      "ERC1967: beacon implementation is not a contract"
                  );
                  StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
              }
          
              /**
               * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
               * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
               *
               * Emits a {BeaconUpgraded} event.
               */
              function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
                  _setBeacon(newBeacon);
                  emit BeaconUpgraded(newBeacon);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                  }
              }
          }
          
          
          // File @openzeppelin/contracts/proxy/[email protected]
          
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.6.0) (proxy/Proxy.sol)
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
           * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
           * be specified by overriding the virtual {_implementation} function.
           *
           * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
           * different contract through the {_delegate} function.
           *
           * The success and return data of the delegated call will be returned back to the caller of the proxy.
           */
          abstract contract Proxy {
              /**
               * @dev Delegates the current call to `implementation`.
               *
               * This function does not return to its internal call site, it will return directly to the external caller.
               */
              function _delegate(address implementation) internal virtual {
                  assembly {
                      // Copy msg.data. We take full control of memory in this inline assembly
                      // block because it will not return to Solidity code. We overwrite the
                      // Solidity scratch pad at memory position 0.
                      calldatacopy(0, 0, calldatasize())
          
                      // Call the implementation.
                      // out and outsize are 0 because we don't know the size yet.
                      let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
          
                      // Copy the returned data.
                      returndatacopy(0, 0, returndatasize())
          
                      switch result
                      // delegatecall returns 0 on error.
                      case 0 {
                          revert(0, returndatasize())
                      }
                      default {
                          return(0, returndatasize())
                      }
                  }
              }
          
              /**
               * @dev This is a virtual function that should be overridden so it returns the address to which the fallback function
               * and {_fallback} should delegate.
               */
              function _implementation() internal view virtual returns (address);
          
              /**
               * @dev Delegates the current call to the address returned by `_implementation()`.
               *
               * This function does not return to its internal call site, it will return directly to the external caller.
               */
              function _fallback() internal virtual {
                  _beforeFallback();
                  _delegate(_implementation());
              }
          
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
               * function in the contract matches the call data.
               */
              fallback() external payable virtual {
                  _fallback();
              }
          
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
               * is empty.
               */
              receive() external payable virtual {
                  _fallback();
              }
          
              /**
               * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
               * call, or as part of the Solidity `fallback` or `receive` functions.
               *
               * If overridden should call `super._beforeFallback()`.
               */
              function _beforeFallback() internal virtual {}
          }
          
          
          // File @openzeppelin/contracts/proxy/ERC1967/[email protected]
          
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.7.0) (proxy/ERC1967/ERC1967Proxy.sol)
          
          pragma solidity ^0.8.0;
          
          
          /**
           * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
           * implementation address that can be changed. This address is stored in storage in the location specified by
           * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
           * implementation behind the proxy.
           */
          contract ERC1967Proxy is Proxy, ERC1967Upgrade {
              /**
               * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
               *
               * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
               * function call, and allows initializing the storage of the proxy like a Solidity constructor.
               */
              constructor(address _logic, bytes memory _data) payable {
                  _upgradeToAndCall(_logic, _data, false);
              }
          
              /**
               * @dev Returns the current implementation address.
               */
              function _implementation() internal view virtual override returns (address impl) {
                  return ERC1967Upgrade._getImplementation();
              }
          }
          
          
          // File @openzeppelin/contracts/proxy/transparent/[email protected]
          
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (proxy/transparent/TransparentUpgradeableProxy.sol)
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev Interface for {TransparentUpgradeableProxy}. In order to implement transparency, {TransparentUpgradeableProxy}
           * does not implement this interface directly, and some of its functions are implemented by an internal dispatch
           * mechanism. The compiler is unaware that these functions are implemented by {TransparentUpgradeableProxy} and will not
           * include them in the ABI so this interface must be used to interact with it.
           */
          interface ITransparentUpgradeableProxy is IERC1967 {
              function admin() external view returns (address);
          
              function implementation() external view returns (address);
          
              function changeAdmin(address) external;
          
              function upgradeTo(address) external;
          
              function upgradeToAndCall(address, bytes memory) external payable;
          }
          
          /**
           * @dev This contract implements a proxy that is upgradeable by an admin.
           *
           * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector
           * clashing], which can potentially be used in an attack, this contract uses the
           * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two
           * things that go hand in hand:
           *
           * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if
           * that call matches one of the admin functions exposed by the proxy itself.
           * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the
           * implementation. If the admin tries to call a function on the implementation it will fail with an error that says
           * "admin cannot fallback to proxy target".
           *
           * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing
           * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due
           * to sudden errors when trying to call a function from the proxy implementation.
           *
           * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,
           * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.
           *
           * NOTE: The real interface of this proxy is that defined in `ITransparentUpgradeableProxy`. This contract does not
           * inherit from that interface, and instead the admin functions are implicitly implemented using a custom dispatch
           * mechanism in `_fallback`. Consequently, the compiler will not produce an ABI for this contract. This is necessary to
           * fully implement transparency without decoding reverts caused by selector clashes between the proxy and the
           * implementation.
           *
           * WARNING: It is not recommended to extend this contract to add additional external functions. If you do so, the compiler
           * will not check that there are no selector conflicts, due to the note above. A selector clash between any new function
           * and the functions declared in {ITransparentUpgradeableProxy} will be resolved in favor of the new one. This could
           * render the admin operations inaccessible, which could prevent upgradeability. Transparency may also be compromised.
           */
          contract TransparentUpgradeableProxy is ERC1967Proxy {
              /**
               * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and
               * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.
               */
              constructor(address _logic, address admin_, bytes memory _data) payable ERC1967Proxy(_logic, _data) {
                  _changeAdmin(admin_);
              }
          
              /**
               * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
               *
               * CAUTION: This modifier is deprecated, as it could cause issues if the modified function has arguments, and the
               * implementation provides a function with the same selector.
               */
              modifier ifAdmin() {
                  if (msg.sender == _getAdmin()) {
                      _;
                  } else {
                      _fallback();
                  }
              }
          
              /**
               * @dev If caller is the admin process the call internally, otherwise transparently fallback to the proxy behavior
               */
              function _fallback() internal virtual override {
                  if (msg.sender == _getAdmin()) {
                      bytes memory ret;
                      bytes4 selector = msg.sig;
                      if (selector == ITransparentUpgradeableProxy.upgradeTo.selector) {
                          ret = _dispatchUpgradeTo();
                      } else if (selector == ITransparentUpgradeableProxy.upgradeToAndCall.selector) {
                          ret = _dispatchUpgradeToAndCall();
                      } else if (selector == ITransparentUpgradeableProxy.changeAdmin.selector) {
                          ret = _dispatchChangeAdmin();
                      } else if (selector == ITransparentUpgradeableProxy.admin.selector) {
                          ret = _dispatchAdmin();
                      } else if (selector == ITransparentUpgradeableProxy.implementation.selector) {
                          ret = _dispatchImplementation();
                      } else {
                          revert("TransparentUpgradeableProxy: admin cannot fallback to proxy target");
                      }
                      assembly {
                          return(add(ret, 0x20), mload(ret))
                      }
                  } else {
                      super._fallback();
                  }
              }
          
              /**
               * @dev Returns the current admin.
               *
               * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
               * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
               * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
               */
              function _dispatchAdmin() private returns (bytes memory) {
                  _requireZeroValue();
          
                  address admin = _getAdmin();
                  return abi.encode(admin);
              }
          
              /**
               * @dev Returns the current implementation.
               *
               * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
               * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
               * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
               */
              function _dispatchImplementation() private returns (bytes memory) {
                  _requireZeroValue();
          
                  address implementation = _implementation();
                  return abi.encode(implementation);
              }
          
              /**
               * @dev Changes the admin of the proxy.
               *
               * Emits an {AdminChanged} event.
               */
              function _dispatchChangeAdmin() private returns (bytes memory) {
                  _requireZeroValue();
          
                  address newAdmin = abi.decode(msg.data[4:], (address));
                  _changeAdmin(newAdmin);
          
                  return "";
              }
          
              /**
               * @dev Upgrade the implementation of the proxy.
               */
              function _dispatchUpgradeTo() private returns (bytes memory) {
                  _requireZeroValue();
          
                  address newImplementation = abi.decode(msg.data[4:], (address));
                  _upgradeToAndCall(newImplementation, bytes(""), false);
          
                  return "";
              }
          
              /**
               * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified
               * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the
               * proxied contract.
               */
              function _dispatchUpgradeToAndCall() private returns (bytes memory) {
                  (address newImplementation, bytes memory data) = abi.decode(msg.data[4:], (address, bytes));
                  _upgradeToAndCall(newImplementation, data, true);
          
                  return "";
              }
          
              /**
               * @dev Returns the current admin.
               *
               * CAUTION: This function is deprecated. Use {ERC1967Upgrade-_getAdmin} instead.
               */
              function _admin() internal view virtual returns (address) {
                  return _getAdmin();
              }
          
              /**
               * @dev To keep this contract fully transparent, all `ifAdmin` functions must be payable. This helper is here to
               * emulate some proxy functions being non-payable while still allowing value to pass through.
               */
              function _requireZeroValue() private {
                  require(msg.value == 0);
              }
          }
          
          
          // File contracts/OptimizedTransparentUpgradeableProxy.sol
          
          // Original license: SPDX_License_Identifier: MIT
          pragma solidity ^0.8.0;
          
          contract OptimizedTransparentUpgradeableProxy is TransparentUpgradeableProxy {
              constructor(
                  address _logic,
                  address _admin,
                  bytes memory _data
              ) TransparentUpgradeableProxy(_logic, _admin, _data) {}
          }

          File 2 of 6: TransparentUpgradeableProxy
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (proxy/transparent/TransparentUpgradeableProxy.sol)
          pragma solidity ^0.8.0;
          import "../ERC1967/ERC1967Proxy.sol";
          /**
           * @dev Interface for {TransparentUpgradeableProxy}. In order to implement transparency, {TransparentUpgradeableProxy}
           * does not implement this interface directly, and some of its functions are implemented by an internal dispatch
           * mechanism. The compiler is unaware that these functions are implemented by {TransparentUpgradeableProxy} and will not
           * include them in the ABI so this interface must be used to interact with it.
           */
          interface ITransparentUpgradeableProxy is IERC1967 {
              function admin() external view returns (address);
              function implementation() external view returns (address);
              function changeAdmin(address) external;
              function upgradeTo(address) external;
              function upgradeToAndCall(address, bytes memory) external payable;
          }
          /**
           * @dev This contract implements a proxy that is upgradeable by an admin.
           *
           * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector
           * clashing], which can potentially be used in an attack, this contract uses the
           * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two
           * things that go hand in hand:
           *
           * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if
           * that call matches one of the admin functions exposed by the proxy itself.
           * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the
           * implementation. If the admin tries to call a function on the implementation it will fail with an error that says
           * "admin cannot fallback to proxy target".
           *
           * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing
           * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due
           * to sudden errors when trying to call a function from the proxy implementation.
           *
           * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,
           * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.
           *
           * NOTE: The real interface of this proxy is that defined in `ITransparentUpgradeableProxy`. This contract does not
           * inherit from that interface, and instead the admin functions are implicitly implemented using a custom dispatch
           * mechanism in `_fallback`. Consequently, the compiler will not produce an ABI for this contract. This is necessary to
           * fully implement transparency without decoding reverts caused by selector clashes between the proxy and the
           * implementation.
           *
           * WARNING: It is not recommended to extend this contract to add additional external functions. If you do so, the compiler
           * will not check that there are no selector conflicts, due to the note above. A selector clash between any new function
           * and the functions declared in {ITransparentUpgradeableProxy} will be resolved in favor of the new one. This could
           * render the admin operations inaccessible, which could prevent upgradeability. Transparency may also be compromised.
           */
          contract TransparentUpgradeableProxy is ERC1967Proxy {
              /**
               * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and
               * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.
               */
              constructor(address _logic, address admin_, bytes memory _data) payable ERC1967Proxy(_logic, _data) {
                  _changeAdmin(admin_);
              }
              /**
               * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
               *
               * CAUTION: This modifier is deprecated, as it could cause issues if the modified function has arguments, and the
               * implementation provides a function with the same selector.
               */
              modifier ifAdmin() {
                  if (msg.sender == _getAdmin()) {
                      _;
                  } else {
                      _fallback();
                  }
              }
              /**
               * @dev If caller is the admin process the call internally, otherwise transparently fallback to the proxy behavior
               */
              function _fallback() internal virtual override {
                  if (msg.sender == _getAdmin()) {
                      bytes memory ret;
                      bytes4 selector = msg.sig;
                      if (selector == ITransparentUpgradeableProxy.upgradeTo.selector) {
                          ret = _dispatchUpgradeTo();
                      } else if (selector == ITransparentUpgradeableProxy.upgradeToAndCall.selector) {
                          ret = _dispatchUpgradeToAndCall();
                      } else if (selector == ITransparentUpgradeableProxy.changeAdmin.selector) {
                          ret = _dispatchChangeAdmin();
                      } else if (selector == ITransparentUpgradeableProxy.admin.selector) {
                          ret = _dispatchAdmin();
                      } else if (selector == ITransparentUpgradeableProxy.implementation.selector) {
                          ret = _dispatchImplementation();
                      } else {
                          revert("TransparentUpgradeableProxy: admin cannot fallback to proxy target");
                      }
                      assembly {
                          return(add(ret, 0x20), mload(ret))
                      }
                  } else {
                      super._fallback();
                  }
              }
              /**
               * @dev Returns the current admin.
               *
               * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
               * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
               * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
               */
              function _dispatchAdmin() private returns (bytes memory) {
                  _requireZeroValue();
                  address admin = _getAdmin();
                  return abi.encode(admin);
              }
              /**
               * @dev Returns the current implementation.
               *
               * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
               * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
               * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
               */
              function _dispatchImplementation() private returns (bytes memory) {
                  _requireZeroValue();
                  address implementation = _implementation();
                  return abi.encode(implementation);
              }
              /**
               * @dev Changes the admin of the proxy.
               *
               * Emits an {AdminChanged} event.
               */
              function _dispatchChangeAdmin() private returns (bytes memory) {
                  _requireZeroValue();
                  address newAdmin = abi.decode(msg.data[4:], (address));
                  _changeAdmin(newAdmin);
                  return "";
              }
              /**
               * @dev Upgrade the implementation of the proxy.
               */
              function _dispatchUpgradeTo() private returns (bytes memory) {
                  _requireZeroValue();
                  address newImplementation = abi.decode(msg.data[4:], (address));
                  _upgradeToAndCall(newImplementation, bytes(""), false);
                  return "";
              }
              /**
               * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified
               * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the
               * proxied contract.
               */
              function _dispatchUpgradeToAndCall() private returns (bytes memory) {
                  (address newImplementation, bytes memory data) = abi.decode(msg.data[4:], (address, bytes));
                  _upgradeToAndCall(newImplementation, data, true);
                  return "";
              }
              /**
               * @dev Returns the current admin.
               *
               * CAUTION: This function is deprecated. Use {ERC1967Upgrade-_getAdmin} instead.
               */
              function _admin() internal view virtual returns (address) {
                  return _getAdmin();
              }
              /**
               * @dev To keep this contract fully transparent, all `ifAdmin` functions must be payable. This helper is here to
               * emulate some proxy functions being non-payable while still allowing value to pass through.
               */
              function _requireZeroValue() private {
                  require(msg.value == 0);
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.7.0) (proxy/ERC1967/ERC1967Proxy.sol)
          pragma solidity ^0.8.0;
          import "../Proxy.sol";
          import "./ERC1967Upgrade.sol";
          /**
           * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
           * implementation address that can be changed. This address is stored in storage in the location specified by
           * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
           * implementation behind the proxy.
           */
          contract ERC1967Proxy is Proxy, ERC1967Upgrade {
              /**
               * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
               *
               * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
               * function call, and allows initializing the storage of the proxy like a Solidity constructor.
               */
              constructor(address _logic, bytes memory _data) payable {
                  _upgradeToAndCall(_logic, _data, false);
              }
              /**
               * @dev Returns the current implementation address.
               */
              function _implementation() internal view virtual override returns (address impl) {
                  return ERC1967Upgrade._getImplementation();
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.6.0) (proxy/Proxy.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
           * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
           * be specified by overriding the virtual {_implementation} function.
           *
           * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
           * different contract through the {_delegate} function.
           *
           * The success and return data of the delegated call will be returned back to the caller of the proxy.
           */
          abstract contract Proxy {
              /**
               * @dev Delegates the current call to `implementation`.
               *
               * This function does not return to its internal call site, it will return directly to the external caller.
               */
              function _delegate(address implementation) internal virtual {
                  assembly {
                      // Copy msg.data. We take full control of memory in this inline assembly
                      // block because it will not return to Solidity code. We overwrite the
                      // Solidity scratch pad at memory position 0.
                      calldatacopy(0, 0, calldatasize())
                      // Call the implementation.
                      // out and outsize are 0 because we don't know the size yet.
                      let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
                      // Copy the returned data.
                      returndatacopy(0, 0, returndatasize())
                      switch result
                      // delegatecall returns 0 on error.
                      case 0 {
                          revert(0, returndatasize())
                      }
                      default {
                          return(0, returndatasize())
                      }
                  }
              }
              /**
               * @dev This is a virtual function that should be overridden so it returns the address to which the fallback function
               * and {_fallback} should delegate.
               */
              function _implementation() internal view virtual returns (address);
              /**
               * @dev Delegates the current call to the address returned by `_implementation()`.
               *
               * This function does not return to its internal call site, it will return directly to the external caller.
               */
              function _fallback() internal virtual {
                  _beforeFallback();
                  _delegate(_implementation());
              }
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
               * function in the contract matches the call data.
               */
              fallback() external payable virtual {
                  _fallback();
              }
              /**
               * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
               * is empty.
               */
              receive() external payable virtual {
                  _fallback();
              }
              /**
               * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
               * call, or as part of the Solidity `fallback` or `receive` functions.
               *
               * If overridden should call `super._beforeFallback()`.
               */
              function _beforeFallback() internal virtual {}
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)
          pragma solidity ^0.8.2;
          import "../beacon/IBeacon.sol";
          import "../../interfaces/IERC1967.sol";
          import "../../interfaces/draft-IERC1822.sol";
          import "../../utils/Address.sol";
          import "../../utils/StorageSlot.sol";
          /**
           * @dev This abstract contract provides getters and event emitting update functions for
           * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
           *
           * _Available since v4.1._
           */
          abstract contract ERC1967Upgrade is IERC1967 {
              // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
              bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
              /**
               * @dev Storage slot with the address of the current implementation.
               * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
              /**
               * @dev Returns the current implementation address.
               */
              function _getImplementation() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
              }
              /**
               * @dev Stores a new address in the EIP1967 implementation slot.
               */
              function _setImplementation(address newImplementation) private {
                  require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                  StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
              }
              /**
               * @dev Perform implementation upgrade
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeTo(address newImplementation) internal {
                  _setImplementation(newImplementation);
                  emit Upgraded(newImplementation);
              }
              /**
               * @dev Perform implementation upgrade with additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
                  _upgradeTo(newImplementation);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(newImplementation, data);
                  }
              }
              /**
               * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
               *
               * Emits an {Upgraded} event.
               */
              function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {
                  // Upgrades from old implementations will perform a rollback test. This test requires the new
                  // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
                  // this special case will break upgrade paths from old UUPS implementation to new ones.
                  if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {
                      _setImplementation(newImplementation);
                  } else {
                      try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
                          require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
                      } catch {
                          revert("ERC1967Upgrade: new implementation is not UUPS");
                      }
                      _upgradeToAndCall(newImplementation, data, forceCall);
                  }
              }
              /**
               * @dev Storage slot with the admin of the contract.
               * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
               * validated in the constructor.
               */
              bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
              /**
               * @dev Returns the current admin.
               */
              function _getAdmin() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
              }
              /**
               * @dev Stores a new address in the EIP1967 admin slot.
               */
              function _setAdmin(address newAdmin) private {
                  require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                  StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
              }
              /**
               * @dev Changes the admin of the proxy.
               *
               * Emits an {AdminChanged} event.
               */
              function _changeAdmin(address newAdmin) internal {
                  emit AdminChanged(_getAdmin(), newAdmin);
                  _setAdmin(newAdmin);
              }
              /**
               * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
               * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
               */
              bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
              /**
               * @dev Returns the current beacon.
               */
              function _getBeacon() internal view returns (address) {
                  return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
              }
              /**
               * @dev Stores a new beacon in the EIP1967 beacon slot.
               */
              function _setBeacon(address newBeacon) private {
                  require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract");
                  require(
                      Address.isContract(IBeacon(newBeacon).implementation()),
                      "ERC1967: beacon implementation is not a contract"
                  );
                  StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
              }
              /**
               * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
               * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
               *
               * Emits a {BeaconUpgraded} event.
               */
              function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
                  _setBeacon(newBeacon);
                  emit BeaconUpgraded(newBeacon);
                  if (data.length > 0 || forceCall) {
                      Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev This is the interface that {BeaconProxy} expects of its beacon.
           */
          interface IBeacon {
              /**
               * @dev Must return an address that can be used as a delegate call target.
               *
               * {BeaconProxy} will check that this address is a contract.
               */
              function implementation() external view returns (address);
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.
           *
           * _Available since v4.8.3._
           */
          interface IERC1967 {
              /**
               * @dev Emitted when the implementation is upgraded.
               */
              event Upgraded(address indexed implementation);
              /**
               * @dev Emitted when the admin account has changed.
               */
              event AdminChanged(address previousAdmin, address newAdmin);
              /**
               * @dev Emitted when the beacon is changed.
               */
              event BeaconUpgraded(address indexed beacon);
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
           * proxy whose upgrades are fully controlled by the current implementation.
           */
          interface IERC1822Proxiable {
              /**
               * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
               * address.
               *
               * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
               * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
               * function revert if invoked through a proxy.
               */
              function proxiableUUID() external view returns (bytes32);
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (utils/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) (utils/StorageSlot.sol)
          // This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
          pragma solidity ^0.8.0;
          /**
           * @dev Library for reading and writing primitive types to specific storage slots.
           *
           * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
           * This library helps with reading and writing to such slots without the need for inline assembly.
           *
           * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
           *
           * Example usage to set ERC1967 implementation slot:
           * ```solidity
           * contract ERC1967 {
           *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
           *
           *     function _getImplementation() internal view returns (address) {
           *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
           *     }
           *
           *     function _setImplementation(address newImplementation) internal {
           *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
           *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
           *     }
           * }
           * ```
           *
           * _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._
           * _Available since v4.9 for `string`, `bytes`._
           */
          library StorageSlot {
              struct AddressSlot {
                  address value;
              }
              struct BooleanSlot {
                  bool value;
              }
              struct Bytes32Slot {
                  bytes32 value;
              }
              struct Uint256Slot {
                  uint256 value;
              }
              struct StringSlot {
                  string value;
              }
              struct BytesSlot {
                  bytes value;
              }
              /**
               * @dev Returns an `AddressSlot` with member `value` located at `slot`.
               */
              function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
               */
              function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
               */
              function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
               */
              function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `StringSlot` with member `value` located at `slot`.
               */
              function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
               */
              function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := store.slot
                  }
              }
              /**
               * @dev Returns an `BytesSlot` with member `value` located at `slot`.
               */
              function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := slot
                  }
              }
              /**
               * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
               */
              function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
                  /// @solidity memory-safe-assembly
                  assembly {
                      r.slot := store.slot
                  }
              }
          }
          

          File 3 of 6: ZKBridge
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)
          pragma solidity ^0.8.0;
          import "../utils/ContextUpgradeable.sol";
          import "../proxy/utils/Initializable.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 OwnableUpgradeable is Initializable, ContextUpgradeable {
              address private _owner;
              event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
              /**
               * @dev Initializes the contract setting the deployer as the initial owner.
               */
              function __Ownable_init() internal onlyInitializing {
                  __Ownable_init_unchained();
              }
              function __Ownable_init_unchained() internal onlyInitializing {
                  _transferOwnership(_msgSender());
              }
              /**
               * @dev Throws if called by any account other than the owner.
               */
              modifier onlyOwner() {
                  _checkOwner();
                  _;
              }
              /**
               * @dev Returns the address of the current owner.
               */
              function owner() public view virtual returns (address) {
                  return _owner;
              }
              /**
               * @dev Throws if the sender is not the owner.
               */
              function _checkOwner() internal view virtual {
                  require(owner() == _msgSender(), "Ownable: caller is not the owner");
              }
              /**
               * @dev Leaves the contract without owner. It will not be possible to call
               * `onlyOwner` functions. Can only be called by the current owner.
               *
               * NOTE: Renouncing ownership will leave the contract without an owner,
               * thereby disabling any functionality that is only available to the owner.
               */
              function renounceOwnership() public virtual onlyOwner {
                  _transferOwnership(address(0));
              }
              /**
               * @dev Transfers ownership of the contract to a new account (`newOwner`).
               * Can only be called by the current owner.
               */
              function transferOwnership(address newOwner) public virtual onlyOwner {
                  require(newOwner != address(0), "Ownable: new owner is the zero address");
                  _transferOwnership(newOwner);
              }
              /**
               * @dev Transfers ownership of the contract to a new account (`newOwner`).
               * Internal function without access restriction.
               */
              function _transferOwnership(address newOwner) internal virtual {
                  address oldOwner = _owner;
                  _owner = newOwner;
                  emit OwnershipTransferred(oldOwner, newOwner);
              }
              /**
               * @dev This empty reserved space is put in place to allow future versions to add new
               * variables without shifting down storage in the inheritance chain.
               * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
               */
              uint256[49] private __gap;
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)
          pragma solidity ^0.8.2;
          import "../../utils/AddressUpgradeable.sol";
          /**
           * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
           * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
           * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
           * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
           *
           * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
           * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
           * case an upgrade adds a module that needs to be initialized.
           *
           * For example:
           *
           * [.hljs-theme-light.nopadding]
           * ```solidity
           * contract MyToken is ERC20Upgradeable {
           *     function initialize() initializer public {
           *         __ERC20_init("MyToken", "MTK");
           *     }
           * }
           *
           * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
           *     function initializeV2() reinitializer(2) public {
           *         __ERC20Permit_init("MyToken");
           *     }
           * }
           * ```
           *
           * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
           * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
           *
           * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
           * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
           *
           * [CAUTION]
           * ====
           * Avoid leaving a contract uninitialized.
           *
           * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
           * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
           * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
           *
           * [.hljs-theme-light.nopadding]
           * ```
           * /// @custom:oz-upgrades-unsafe-allow constructor
           * constructor() {
           *     _disableInitializers();
           * }
           * ```
           * ====
           */
          abstract contract Initializable {
              /**
               * @dev Indicates that the contract has been initialized.
               * @custom:oz-retyped-from bool
               */
              uint8 private _initialized;
              /**
               * @dev Indicates that the contract is in the process of being initialized.
               */
              bool private _initializing;
              /**
               * @dev Triggered when the contract has been initialized or reinitialized.
               */
              event Initialized(uint8 version);
              /**
               * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
               * `onlyInitializing` functions can be used to initialize parent contracts.
               *
               * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
               * constructor.
               *
               * Emits an {Initialized} event.
               */
              modifier initializer() {
                  bool isTopLevelCall = !_initializing;
                  require(
                      (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
                      "Initializable: contract is already initialized"
                  );
                  _initialized = 1;
                  if (isTopLevelCall) {
                      _initializing = true;
                  }
                  _;
                  if (isTopLevelCall) {
                      _initializing = false;
                      emit Initialized(1);
                  }
              }
              /**
               * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
               * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
               * used to initialize parent contracts.
               *
               * A reinitializer may be used after the original initialization step. This is essential to configure modules that
               * are added through upgrades and that require initialization.
               *
               * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
               * cannot be nested. If one is invoked in the context of another, execution will revert.
               *
               * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
               * a contract, executing them in the right order is up to the developer or operator.
               *
               * WARNING: setting the version to 255 will prevent any future reinitialization.
               *
               * Emits an {Initialized} event.
               */
              modifier reinitializer(uint8 version) {
                  require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
                  _initialized = version;
                  _initializing = true;
                  _;
                  _initializing = false;
                  emit Initialized(version);
              }
              /**
               * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
               * {initializer} and {reinitializer} modifiers, directly or indirectly.
               */
              modifier onlyInitializing() {
                  require(_initializing, "Initializable: contract is not initializing");
                  _;
              }
              /**
               * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
               * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
               * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
               * through proxies.
               *
               * Emits an {Initialized} event the first time it is successfully executed.
               */
              function _disableInitializers() internal virtual {
                  require(!_initializing, "Initializable: contract is initializing");
                  if (_initialized != type(uint8).max) {
                      _initialized = type(uint8).max;
                      emit Initialized(type(uint8).max);
                  }
              }
              /**
               * @dev Returns the highest version that has been initialized. See {reinitializer}.
               */
              function _getInitializedVersion() internal view returns (uint8) {
                  return _initialized;
              }
              /**
               * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
               */
              function _isInitializing() internal view returns (bool) {
                  return _initializing;
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
          pragma solidity ^0.8.1;
          /**
           * @dev Collection of functions related to the address type
           */
          library AddressUpgradeable {
              /**
               * @dev Returns true if `account` is a contract.
               *
               * [IMPORTANT]
               * ====
               * It is unsafe to assume that an address for which this function returns
               * false is an externally-owned account (EOA) and not a contract.
               *
               * Among others, `isContract` will return false for the following
               * types of addresses:
               *
               *  - an externally-owned account
               *  - a contract in construction
               *  - an address where a contract will be created
               *  - an address where a contract lived, but was destroyed
               *
               * Furthermore, `isContract` will also return true if the target contract within
               * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
               * which only has an effect at the end of a transaction.
               * ====
               *
               * [IMPORTANT]
               * ====
               * You shouldn't rely on `isContract` to protect against flash loan attacks!
               *
               * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
               * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
               * constructor.
               * ====
               */
              function isContract(address account) internal view returns (bool) {
                  // This method relies on extcodesize/address.code.length, which returns 0
                  // for contracts in construction, since the code is only stored at the end
                  // of the constructor execution.
                  return account.code.length > 0;
              }
              /**
               * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
               * `recipient`, forwarding all available gas and reverting on errors.
               *
               * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
               * of certain opcodes, possibly making contracts go over the 2300 gas limit
               * imposed by `transfer`, making them unable to receive funds via
               * `transfer`. {sendValue} removes this limitation.
               *
               * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
               *
               * IMPORTANT: because control is transferred to `recipient`, care must be
               * taken to not create reentrancy vulnerabilities. Consider using
               * {ReentrancyGuard} or the
               * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
               */
              function sendValue(address payable recipient, uint256 amount) internal {
                  require(address(this).balance >= amount, "Address: insufficient balance");
                  (bool success, ) = recipient.call{value: amount}("");
                  require(success, "Address: unable to send value, recipient may have reverted");
              }
              /**
               * @dev Performs a Solidity function call using a low level `call`. A
               * plain `call` is an unsafe replacement for a function call: use this
               * function instead.
               *
               * If `target` reverts with a revert reason, it is bubbled up by this
               * function (like regular Solidity function calls).
               *
               * Returns the raw returned data. To convert to the expected return value,
               * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
               *
               * Requirements:
               *
               * - `target` must be a contract.
               * - calling `target` with `data` must not revert.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, "Address: low-level call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
               * `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but also transferring `value` wei to `target`.
               *
               * Requirements:
               *
               * - the calling contract must have an ETH balance of at least `value`.
               * - the called Solidity function must be `payable`.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
              }
              /**
               * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
               * with `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  require(address(this).balance >= value, "Address: insufficient balance for call");
                  (bool success, bytes memory returndata) = target.call{value: value}(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                  return functionStaticCall(target, data, "Address: low-level static call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal view returns (bytes memory) {
                  (bool success, bytes memory returndata) = target.staticcall(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionDelegateCall(target, data, "Address: low-level delegate call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  (bool success, bytes memory returndata) = target.delegatecall(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
               * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
               *
               * _Available since v4.8._
               */
              function verifyCallResultFromTarget(
                  address target,
                  bool success,
                  bytes memory returndata,
                  string memory errorMessage
              ) internal view returns (bytes memory) {
                  if (success) {
                      if (returndata.length == 0) {
                          // only check isContract if the call was successful and the return data is empty
                          // otherwise we already know that it was a contract
                          require(isContract(target), "Address: call to non-contract");
                      }
                      return returndata;
                  } else {
                      _revert(returndata, errorMessage);
                  }
              }
              /**
               * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
               * revert reason or using the provided one.
               *
               * _Available since v4.3._
               */
              function verifyCallResult(
                  bool success,
                  bytes memory returndata,
                  string memory errorMessage
              ) internal pure returns (bytes memory) {
                  if (success) {
                      return returndata;
                  } else {
                      _revert(returndata, errorMessage);
                  }
              }
              function _revert(bytes memory returndata, string memory errorMessage) private pure {
                  // Look for revert reason and bubble it up if present
                  if (returndata.length > 0) {
                      // The easiest way to bubble the revert reason is using memory via assembly
                      /// @solidity memory-safe-assembly
                      assembly {
                          let returndata_size := mload(returndata)
                          revert(add(32, returndata), returndata_size)
                      }
                  } else {
                      revert(errorMessage);
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
          pragma solidity ^0.8.0;
          import "../proxy/utils/Initializable.sol";
          /**
           * @dev Provides information about the current execution context, including the
           * sender of the transaction and its data. While these are generally available
           * via msg.sender and msg.data, they should not be accessed in such a direct
           * manner, since when dealing with meta-transactions the account sending and
           * paying for execution may not be the actual sender (as far as an application
           * is concerned).
           *
           * This contract is only required for intermediate, library-like contracts.
           */
          abstract contract ContextUpgradeable is Initializable {
              function __Context_init() internal onlyInitializing {
              }
              function __Context_init_unchained() internal onlyInitializing {
              }
              function _msgSender() internal view virtual returns (address) {
                  return msg.sender;
              }
              function _msgData() internal view virtual returns (bytes calldata) {
                  return msg.data;
              }
              /**
               * @dev This empty reserved space is put in place to allow future versions to add new
               * variables without shifting down storage in the inheritance chain.
               * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
               */
              uint256[50] private __gap;
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          interface IBlockUpdater {
              function checkBlock(bytes32 blockHash, bytes32 receiptsRoot) external view returns (bool);
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          interface IMptVerifier {
              struct Receipt {
                  bytes32 receiptHash;
                  uint256 state;
                  bytes logs;
              }
              function validateMPT(bytes memory proof) external view returns (Receipt memory receipt);
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          interface IZKBridge {
              event MessagePublished(
                  address indexed sender,
                  uint16 indexed dstChainId,
                  uint64 indexed sequence,
                  address dstAddress,
                  bytes payload
              );
              event ExecutedMessage(
                  address indexed sender,
                  uint16 indexed srcChainId,
                  uint64 indexed sequence,
                  address dstAddress,
                  bytes payload
              );
              function send(uint16 dstChainId, address dstAddress, bytes memory payload) external payable returns (uint64 nonce);
              function validateTransactionProof(
                  uint16 srcChainId,
                  bytes32 srcBlockHash,
                  uint256 logIndex,
                  bytes memory mptProof
              ) external;
              function estimateFee(uint16 dstChainId) external view returns (uint256 fee);
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          interface IZKBridgeReceiver {
              // @notice ZKBridge 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 sequence - the ordered message nonce
              // @param payload - the signed payload is the UA bytes has encoded to be sent
              function zkReceive(uint16 srcChainId, address srcAddress, uint64 sequence, bytes calldata payload) external;
          }
          // 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;
          library RLPReader {
              uint8 constant STRING_SHORT_START = 0x80;
              uint8 constant STRING_LONG_START = 0xb8;
              uint8 constant LIST_SHORT_START = 0xc0;
              uint8 constant LIST_LONG_START = 0xf8;
              uint8 constant WORD_SIZE = 32;
              struct RLPItem {
                  uint len;
                  uint memPtr;
              }
              struct Iterator {
                  RLPItem item; // Item that's being iterated over.
                  uint nextPtr; // Position of the next item in the list.
              }
              /*
               * @dev Returns the next element in the iteration. Reverts if it has not next element.
               * @param self The iterator.
               * @return The next element in the iteration.
               */
              function next(Iterator memory self) internal pure returns (RLPItem memory) {
                  require(hasNext(self));
                  uint ptr = self.nextPtr;
                  uint itemLength = _itemLength(ptr);
                  self.nextPtr = ptr + itemLength;
                  return RLPItem(itemLength, ptr);
              }
              /*
               * @dev Returns true if the iteration has more elements.
               * @param self The iterator.
               * @return true if the iteration has more elements.
               */
              function hasNext(Iterator memory self) internal pure returns (bool) {
                  RLPItem memory item = self.item;
                  return self.nextPtr < item.memPtr + item.len;
              }
              /*
               * @param item RLP encoded bytes
               */
              function toRlpItem(bytes memory item) internal pure returns (RLPItem memory) {
                  uint memPtr;
                  assembly {
                      memPtr := add(item, 0x20)
                  }
                  // offset the pointer if the first byte
                  uint8 byte0;
                  assembly {
                      byte0 := byte(0, mload(memPtr))
                  }
                  uint len = item.length;
                  if (len > 0 && byte0 < LIST_SHORT_START) {
                      assembly {
                          memPtr := add(memPtr, 0x01)
                      }
                      len -= 1;
                  }
                  return RLPItem(len, memPtr);
              }
              /*
               * @dev Create an iterator. Reverts if item is not a list.
               * @param self The RLP item.
               * @return An 'Iterator' over the item.
               */
              function iterator(RLPItem memory self) internal pure returns (Iterator memory) {
                  require(isList(self));
                  uint ptr = self.memPtr + _payloadOffset(self.memPtr);
                  return Iterator(self, ptr);
              }
              /*
               * @param the RLP item.
               */
              function rlpLen(RLPItem memory item) internal pure returns (uint) {
                  return item.len;
              }
              /*
               * @param the RLP item.
               * @return (memPtr, len) pair: location of the item's payload in memory.
               */
              function payloadLocation(RLPItem memory item) internal pure returns (uint, uint) {
                  uint offset = _payloadOffset(item.memPtr);
                  uint memPtr = item.memPtr + offset;
                  uint len = item.len - offset; // data length
                  return (memPtr, len);
              }
              /*
               * @param the RLP item.
               */
              function payloadLen(RLPItem memory item) internal pure returns (uint) {
                  (, uint len) = payloadLocation(item);
                  return len;
              }
              /*
               * @param the RLP item containing the encoded list.
               */
              function toList(RLPItem memory item) internal pure returns (RLPItem[] memory) {
                  require(isList(item));
                  uint items = numItems(item);
                  RLPItem[] memory result = new RLPItem[](items);
                  uint memPtr = item.memPtr + _payloadOffset(item.memPtr);
                  uint dataLen;
                  for (uint i = 0; i < items; i++) {
                      dataLen = _itemLength(memPtr);
                      result[i] = RLPItem(dataLen, memPtr);
                      memPtr = memPtr + dataLen;
                  }
                  return result;
              }
              // @return indicator whether encoded payload is a list. negate this function call for isData.
              function isList(RLPItem memory item) internal pure returns (bool) {
                  if (item.len == 0) return false;
                  uint8 byte0;
                  uint memPtr = item.memPtr;
                  assembly {
                      byte0 := byte(0, mload(memPtr))
                  }
                  if (byte0 < LIST_SHORT_START) return false;
                  return true;
              }
              /*
               * @dev A cheaper version of keccak256(toRlpBytes(item)) that avoids copying memory.
               * @return keccak256 hash of RLP encoded bytes.
               */
              function rlpBytesKeccak256(RLPItem memory item) internal pure returns (bytes32) {
                  uint256 ptr = item.memPtr;
                  uint256 len = item.len;
                  bytes32 result;
                  assembly {
                      result := keccak256(ptr, len)
                  }
                  return result;
              }
              /*
               * @dev A cheaper version of keccak256(toBytes(item)) that avoids copying memory.
               * @return keccak256 hash of the item payload.
               */
              function payloadKeccak256(RLPItem memory item) internal pure returns (bytes32) {
                  (uint memPtr, uint len) = payloadLocation(item);
                  bytes32 result;
                  assembly {
                      result := keccak256(memPtr, len)
                  }
                  return result;
              }
              /** RLPItem conversions into data types **/
              // @returns raw rlp encoding in bytes
              function toRlpBytes(RLPItem memory item) internal pure returns (bytes memory) {
                  bytes memory result = new bytes(item.len);
                  if (result.length == 0) return result;
                  uint ptr;
                  assembly {
                      ptr := add(0x20, result)
                  }
                  copy(item.memPtr, ptr, item.len);
                  return result;
              }
              // any non-zero byte except "0x80" is considered true
              function toBoolean(RLPItem memory item) internal pure returns (bool) {
                  require(item.len == 1);
                  uint result;
                  uint memPtr = item.memPtr;
                  assembly {
                      result := byte(0, mload(memPtr))
                  }
                  // SEE Github Issue #5.
                  // Summary: Most commonly used RLP libraries (i.e Geth) will encode
                  // "0" as "0x80" instead of as "0". We handle this edge case explicitly
                  // here.
                  if (result == 0 || result == STRING_SHORT_START) {
                      return false;
                  } else {
                      return true;
                  }
              }
              function toAddress(RLPItem memory item) internal pure returns (address) {
                  // 1 byte for the length prefix
                  require(item.len == 21);
                  return address(uint160(toUint(item)));
              }
              function toUint(RLPItem memory item) internal pure returns (uint) {
                  require(item.len > 0 && item.len <= 33);
                  (uint memPtr, uint len) = payloadLocation(item);
                  uint result;
                  assembly {
                      result := mload(memPtr)
                      // shfit to the correct location if neccesary
                      if lt(len, 32) {
                          result := div(result, exp(256, sub(32, len)))
                      }
                  }
                  return result;
              }
              // enforces 32 byte length
              function toUintStrict(RLPItem memory item) internal pure returns (uint) {
                  // one byte prefix
                  require(item.len == 33);
                  uint result;
                  uint memPtr = item.memPtr + 1;
                  assembly {
                      result := mload(memPtr)
                  }
                  return result;
              }
              function toBytes(RLPItem memory item) internal pure returns (bytes memory) {
                  require(item.len > 0);
                  (uint memPtr, uint len) = payloadLocation(item);
                  bytes memory result = new bytes(len);
                  uint destPtr;
                  assembly {
                      destPtr := add(0x20, result)
                  }
                  copy(memPtr, destPtr, len);
                  return result;
              }
              /*
               * Private Helpers
               */
              // @return number of payload items inside an encoded list.
              function numItems(RLPItem memory item) private pure returns (uint) {
                  if (item.len == 0) return 0;
                  uint count = 0;
                  uint currPtr = item.memPtr + _payloadOffset(item.memPtr);
                  uint endPtr = item.memPtr + item.len;
                  while (currPtr < endPtr) {
                      currPtr = currPtr + _itemLength(currPtr); // skip over an item
                      count++;
                  }
                  return count;
              }
              // @return entire rlp item byte length
              function _itemLength(uint memPtr) private pure returns (uint) {
                  uint itemLen;
                  uint byte0;
                  assembly {
                      byte0 := byte(0, mload(memPtr))
                  }
                  if (byte0 < STRING_SHORT_START) itemLen = 1;
                  else if (byte0 < STRING_LONG_START) itemLen = byte0 - STRING_SHORT_START + 1;
                  else if (byte0 < LIST_SHORT_START) {
                      assembly {
                          let byteLen := sub(byte0, 0xb7) // # of bytes the actual length is
                          memPtr := add(memPtr, 1) // skip over the first byte
                          /* 32 byte word size */
                          let dataLen := div(mload(memPtr), exp(256, sub(32, byteLen))) // right shifting to get the len
                          itemLen := add(dataLen, add(byteLen, 1))
                      }
                  } else if (byte0 < LIST_LONG_START) {
                      itemLen = byte0 - LIST_SHORT_START + 1;
                  } else {
                      assembly {
                          let byteLen := sub(byte0, 0xf7)
                          memPtr := add(memPtr, 1)
                          let dataLen := div(mload(memPtr), exp(256, sub(32, byteLen))) // right shifting to the correct length
                          itemLen := add(dataLen, add(byteLen, 1))
                      }
                  }
                  return itemLen;
              }
              // @return number of bytes until the data
              function _payloadOffset(uint memPtr) private pure returns (uint) {
                  uint byte0;
                  assembly {
                      byte0 := byte(0, mload(memPtr))
                  }
                  if (byte0 < STRING_SHORT_START) return 0;
                  else if (byte0 < STRING_LONG_START || (byte0 >= LIST_SHORT_START && byte0 < LIST_LONG_START)) return 1;
                  else if (byte0 < LIST_SHORT_START)
                      // being explicit
                      return byte0 - (STRING_LONG_START - 1) + 1;
                  else return byte0 - (LIST_LONG_START - 1) + 1;
              }
              /*
               * @param src Pointer to source
               * @param dest Pointer to destination
               * @param len Amount of memory to copy from the source
               */
              function copy(uint src, uint dest, uint len) private pure {
                  if (len == 0) return;
                  // copy as many word sizes as possible
                  for (; len >= WORD_SIZE; len -= WORD_SIZE) {
                      assembly {
                          mstore(dest, mload(src))
                      }
                      src += WORD_SIZE;
                      dest += WORD_SIZE;
                  }
                  if (len > 0) {
                      // left over bytes. Mask is used to remove unwanted bytes from the word
                      uint mask = 256 ** (WORD_SIZE - len) - 1;
                      assembly {
                          let srcpart := and(mload(src), not(mask)) // zero out src
                          let destpart := and(mload(dest), mask) // retrieve the bytes
                          mstore(dest, or(destpart, srcpart))
                      }
                  }
              }
              function toBytes32(RLPItem memory self) internal pure returns (bytes32 data) {
                  return bytes32(toUint(self));
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
          import "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
          import "./libraries/RLPReader.sol";
          import "./libraries/BytesLib.sol";
          import "./interfaces/IZKBridgeReceiver.sol";
          import "./interfaces/IZKBridge.sol";
          import "./interfaces/IMptVerifier.sol";
          import "./interfaces/IBlockUpdater.sol";
          contract ZKBridge is Initializable, OwnableUpgradeable, IZKBridge {
              using RLPReader for RLPReader.RLPItem;
              using RLPReader for bytes;
              using BytesLib for bytes;
              event SetFee(uint16 dstChainId, uint256 fee);
              event ClaimFee(address operator, uint256 amount);
              event SetTrustedRemoteAddress(uint16 chainId, address remoteAddress);
              event SetMptVerifier(uint16 chainId, address mptVerifier);
              event SetBlockUpdater(uint16 chainId, address lockUpdater);
              bytes32 public constant MESSAGE_TOPIC = 0xb8abfd5c33667c7440a4fc1153ae39a24833dbe44f7eb19cbe5cd5f2583e4940;
              uint16 public chainId;
              // chainId => mptVerifierAddress
              mapping(uint16 => IMptVerifier) public mptVerifiers;
              // chainId => blockUpdaterAddress
              mapping(uint16 => IBlockUpdater) public blockUpdaters;
              mapping(bytes32 => uint64) public targetNonce;
              // chainId => zkBridgeAddress
              mapping(uint16 => address) public trustedRemoteLookup;
              mapping(bytes32 => bool) public completedTransfers;
              mapping(uint16 => uint256) public fees;
              struct LogMessage {
                  uint16 dstChainId;
                  uint64 nonce;
                  address dstAddress;
                  address srcAddress;
                  address srcZkBridge;
                  bytes payload;
              }
              struct Payload {
                  uint16 srcChainId;
                  uint16 dstChainId;
                  address srcAddress;
                  address dstAddress;
                  uint64 nonce;
                  bytes uaPayload;
              }
              function initialize(uint16 _chainId) public initializer {
                  __Ownable_init();
                  chainId = _chainId;
              }
              function send(
                  uint16 _dstChainId,
                  address _dstAddress,
                  bytes memory _payload
              ) external payable returns (uint64 currentNonce) {
                  require(_dstChainId != chainId, "ZKBridge:Cannot send to same chain");
                  require(msg.value >= _estimateFee(_dstChainId), "ZKBridge:insufficient Fee");
                  currentNonce = _useNonce(msg.sender, _dstChainId, _dstAddress);
                  emit MessagePublished(msg.sender, _dstChainId, currentNonce, _dstAddress, _payload);
              }
              function validateTransactionProof(
                  uint16 _srcChainId,
                  bytes32 _srcBlockHash,
                  uint256 _logIndex,
                  bytes calldata _mptProof
              ) external {
                  IMptVerifier mptVerifier = mptVerifiers[_srcChainId];
                  IBlockUpdater blockUpdater = blockUpdaters[_srcChainId];
                  require(address(mptVerifier) != address(0), "ZKBridge:MptVerifier is not set");
                  require(address(blockUpdater) != address(0), "ZKBridge:Block Updater is not set");
                  IMptVerifier.Receipt memory receipt = mptVerifier.validateMPT(_mptProof);
                  require(receipt.state == 1, "ZKBridge:Source Chain Transaction Failure");
                  require(blockUpdater.checkBlock(_srcBlockHash, receipt.receiptHash), "ZKBridge:Block Header is not set");
                  LogMessage memory logMessage = _parseLog(receipt.logs, _logIndex);
                  require(
                      logMessage.srcZkBridge == trustedRemoteLookup[_srcChainId],
                      "ZKBridge:Destination chain is not a trusted sourcee"
                  );
                  require(logMessage.dstChainId == chainId, "ZKBridge:Invalid destination chain");
                  bytes32 hash = keccak256(
                      abi.encode(_srcChainId, logMessage.srcAddress, logMessage.dstAddress, logMessage.nonce)
                  );
                  require(!completedTransfers[hash], "ZKBridge:Message already executed.");
                  completedTransfers[hash] = true;
                  IZKBridgeReceiver(logMessage.dstAddress).zkReceive(
                      _srcChainId,
                      logMessage.srcAddress,
                      logMessage.nonce,
                      logMessage.payload
                  );
                  emit ExecutedMessage(
                      logMessage.srcAddress,
                      _srcChainId,
                      logMessage.nonce,
                      logMessage.dstAddress,
                      logMessage.payload
                  );
              }
              function _useNonce(
                  address _emitter,
                  uint16 _dstChainId,
                  address _dstAddress
              ) internal returns (uint64 currentNonce) {
                  bytes32 hash = keccak256(abi.encode(_emitter, _dstChainId, _dstAddress));
                  currentNonce = targetNonce[hash];
                  targetNonce[hash]++;
              }
              function _parseLog(bytes memory _logsByte, uint256 _logIndex) internal pure returns (LogMessage memory logMessage) {
                  RLPReader.RLPItem[] memory logs = _logsByte.toRlpItem().toList();
                  if (_logIndex != 0) {
                      require(logs.length > _logIndex + 2, "ZKBridge:Invalid proof");
                      logs = logs[_logIndex + 2].toRlpBytes().toRlpItem().toList();
                  }
                  RLPReader.RLPItem[] memory topicItem = logs[1].toRlpBytes().toRlpItem().toList();
                  bytes32 topic = bytes32(topicItem[0].toUint());
                  if (topic == MESSAGE_TOPIC) {
                      logMessage.srcZkBridge = logs[0].toAddress();
                      logMessage.srcAddress = abi.decode(topicItem[1].toBytes(), (address));
                      logMessage.dstChainId = uint16(topicItem[2].toUint());
                      logMessage.nonce = uint64(topicItem[3].toUint());
                      (logMessage.dstAddress, logMessage.payload) = abi.decode(logs[2].toBytes(), (address, bytes));
                  }
              }
              function _estimateFee(uint16 _dstChainId) internal view returns (uint256 bridgeFee) {
                  bridgeFee = fees[_dstChainId];
              }
              function estimateFee(uint16 _dstChainId) external view returns (uint256 bridgeFee) {
                  bridgeFee = _estimateFee(_dstChainId);
              }
              //----------------------------------------------------------------------------------
              // onlyOwner
              function setFee(uint16 _dstChainId, uint256 _fee) public onlyOwner {
                  fees[_dstChainId] = _fee;
                  emit SetFee(_dstChainId, _fee);
              }
              function setTrustedRemoteAddress(uint16 _remoteChainId, address _remoteAddress) external onlyOwner {
                  trustedRemoteLookup[_remoteChainId] = _remoteAddress;
                  emit SetTrustedRemoteAddress(_remoteChainId, _remoteAddress);
              }
              function setMptVerifier(uint16 _chainId, address _mptVerifier) external onlyOwner {
                  require(_mptVerifier != address(0), "ZKBridge:Zero address");
                  mptVerifiers[_chainId] = IMptVerifier(_mptVerifier);
                  emit SetMptVerifier(_chainId, _mptVerifier);
              }
              function setBlockUpdater(uint16 _chainId, address _blockUpdater) external onlyOwner {
                  require(_blockUpdater != address(0), "ZKBridge:Zero address");
                  blockUpdaters[_chainId] = IBlockUpdater(_blockUpdater);
                  emit SetBlockUpdater(_chainId, _blockUpdater);
              }
              function claimFees() external onlyOwner {
                  emit ClaimFee(msg.sender, address(this).balance);
                  payable(owner()).transfer(address(this).balance);
              }
              fallback() external payable {
                  revert("ZKBridge:unsupported");
              }
              receive() external payable {
                  revert("ZKBridge:the ZkBridge contract does not accept assets");
              }
          }
          

          File 4 of 6: MptVerifier
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          import "./RLPReader.sol";
          contract MptVerifier {
              using RLPReader for RLPReader.RLPItem;
              using RLPReader for bytes;
              struct Proof {
                  bytes32 receiptsHash;
                  bytes mptKey;
                  RLPReader.RLPItem[] stack;
              }
              struct Receipt {
                  bytes32 receiptHash;
                  uint256 state;
                  bytes logs;
              }
              function validateMPT(bytes memory proofBlob) external view returns (Receipt memory receipt){
                  Proof memory proof = decodeProofBlob(proofBlob);
                  bytes memory rlpTx = validateMPTProof(proof.receiptsHash, proof.mptKey, proof.stack);
                  require(rlpTx.length != 0, "invalid proof");
                  receipt = decodeReceipt(proof.receiptsHash, rlpTx);
              }
              /// @dev Validates a Merkle-Patricia-Trie proof.
              ///      If the proof proves the inclusion of some key-value pair in the
              ///      trie, the value is returned. Otherwise, i.e. if the proof proves
              ///      the exclusion of a key from the trie, an empty byte array is
              ///      returned.
              /// @param rootHash is the Keccak-256 hash of the root node of the MPT.
              /// @param mptKey is the key (consisting of nibbles) of the node whose
              ///        inclusion/exclusion we are proving.
              /// @param stack is the stack of MPT nodes (starting with the root) that
              ///        need to be traversed during verification.
              /// @return value whose inclusion is proved or an empty byte array for
              ///         a proof of exclusion
              function validateMPTProof(
                  bytes32 rootHash,
                  bytes memory mptKey,
                  RLPReader.RLPItem[] memory stack
              ) internal pure returns (bytes memory value) {
                  uint256 mptKeyOffset = 0;
                  bytes32 nodeHashHash;
                  bytes memory rlpNode;
                  RLPReader.RLPItem[] memory node;
                  RLPReader.RLPItem memory rlpValue;
                  if (stack.length == 0) {
                      // Root hash of empty Merkle-Patricia-Trie
                      return new bytes(0);
                  }
                  // Traverse stack of nodes starting at root.
                  for (uint256 i = 0; i < stack.length; i++) {
                      // We use the fact that an rlp encoded list consists of some
                      // encoding of its length plus the concatenation of its
                      // *rlp-encoded* items.
                      rlpNode = stack[i].toRlpBytes();
                      // The root node is hashed with Keccak-256 ...
                      if (i == 0 && rootHash != keccak256(rlpNode)) {
                          revert();
                      }
                      // ... whereas all other nodes are hashed with the MPT
                      // hash function.
                      if (i != 0 && nodeHashHash != mptHashHash(rlpNode)) {
                          revert();
                      }
                      // We verified that stack[i] has the correct hash, so we
                      // may safely decode it.
                      node = stack[i].toList();
                      if (node.length == 2) {
                          // Extension or Leaf node
                          bool isLeaf;
                          bytes memory nodeKey;
                          (isLeaf, nodeKey) = merklePatriciaCompactDecode(
                              node[0].toBytes()
                          );
                          uint256 prefixLength = sharedPrefixLength(
                              mptKeyOffset,
                              mptKey,
                              nodeKey
                          );
                          mptKeyOffset += prefixLength;
                          if (prefixLength < nodeKey.length) {
                              // Proof claims divergent extension or leaf. (Only
                              // relevant for proofs of exclusion.)
                              // An Extension/Leaf node is divergent iff it "skips" over
                              // the point at which a Branch node should have been had the
                              // excluded key been included in the trie.
                              // Example: Imagine a proof of exclusion for path [1, 4],
                              // where the current node is a Leaf node with
                              // path [1, 3, 3, 7]. For [1, 4] to be included, there
                              // should have been a Branch node at [1] with a child
                              // at 3 and a child at 4.
                              // Sanity check
                              if (i < stack.length - 1) {
                                  // divergent node must come last in proof
                                  revert();
                              }
                              return new bytes(0);
                          }
                          if (isLeaf) {
                              // Sanity check
                              if (i < stack.length - 1) {
                                  // leaf node must come last in proof
                                  revert();
                              }
                              if (mptKeyOffset < mptKey.length) {
                                  return new bytes(0);
                              }
                              rlpValue = node[1];
                              return rlpValue.toBytes();
                          } else {
                              // extension
                              // Sanity check
                              if (i == stack.length - 1) {
                                  // shouldn't be at last level
                                  revert();
                              }
                              if (!node[1].isList()) {
                                  // rlp(child) was at least 32 bytes. node[1] contains
                                  // Keccak256(rlp(child)).
                                  nodeHashHash = keccak256(node[1].toBytes());
                              } else {
                                  // rlp(child) was at less than 32 bytes. node[1] contains
                                  // rlp(child).
                                  nodeHashHash = keccak256(node[1].toRlpBytes());
                              }
                          }
                      } else if (node.length == 17) {
                          // Branch node
                          if (mptKeyOffset != mptKey.length) {
                              // we haven't consumed the entire path, so we need to look at a child
                              uint8 nibble = uint8(mptKey[mptKeyOffset]);
                              mptKeyOffset += 1;
                              if (nibble >= 16) {
                                  // each element of the path has to be a nibble
                                  revert();
                              }
                              if (isEmptyByteSequence(node[nibble])) {
                                  // Sanity
                                  if (i != stack.length - 1) {
                                      // leaf node should be at last level
                                      revert();
                                  }
                                  return new bytes(0);
                              } else if (!node[nibble].isList()) {
                                  nodeHashHash = keccak256(node[nibble].toBytes());
                              } else {
                                  nodeHashHash = keccak256(node[nibble].toRlpBytes());
                              }
                          } else {
                              // we have consumed the entire mptKey, so we need to look at what's contained in this node.
                              // Sanity
                              if (i != stack.length - 1) {
                                  // should be at last level
                                  revert();
                              }
                              return node[16].toBytes();
                          }
                      }
                  }
              }
              function isEmptyByteSequence(RLPReader.RLPItem memory item)
              internal
              pure
              returns (bool)
              {
                  if (item.len != 1) {
                      return false;
                  }
                  uint8 b;
                  uint256 memPtr = item.memPtr;
                  assembly {
                      b := byte(0, mload(memPtr))
                  }
                  return b == 0x80;
                  /* empty byte string */
              }
              function decodeReceipt(bytes32 receiptHash, bytes memory rlpSignedTx) internal pure returns (Receipt memory t){
                  if (rlpSignedTx[0] == bytes1(uint8(2))) {
                      rlpSignedTx = slice(rlpSignedTx, 1, rlpSignedTx.length - 1);
                  }
                  RLPReader.RLPItem[] memory fields = rlpSignedTx.toRlpItem().toList();
                  t = Receipt(
                      receiptHash,
                      fields[0].toUint(),
                      fields[3].toBytes()
                  );
              }
              function decodeNibbles(bytes memory compact, uint256 skipNibbles)
              internal
              pure
              returns (bytes memory nibbles)
              {
                  require(compact.length > 0);
                  uint256 length = compact.length * 2;
                  require(skipNibbles <= length);
                  length -= skipNibbles;
                  nibbles = new bytes(length);
                  uint256 nibblesLength = 0;
                  for (uint256 i = skipNibbles; i < skipNibbles + length; i += 1) {
                      if (i % 2 == 0) {
                          nibbles[nibblesLength] = bytes1(
                              (uint8(compact[i / 2]) >> 4) & 0xF
                          );
                      } else {
                          nibbles[nibblesLength] = bytes1(
                              (uint8(compact[i / 2]) >> 0) & 0xF
                          );
                      }
                      nibblesLength += 1;
                  }
                  assert(nibblesLength == nibbles.length);
              }
              function merklePatriciaCompactDecode(bytes memory compact)
              internal
              pure
              returns (bool isLeaf, bytes memory nibbles)
              {
                  require(compact.length > 0);
                  uint256 first_nibble = (uint8(compact[0]) >> 4) & 0xF;
                  uint256 skipNibbles;
                  if (first_nibble == 0) {
                      skipNibbles = 2;
                      isLeaf = false;
                  } else if (first_nibble == 1) {
                      skipNibbles = 1;
                      isLeaf = false;
                  } else if (first_nibble == 2) {
                      skipNibbles = 2;
                      isLeaf = true;
                  } else if (first_nibble == 3) {
                      skipNibbles = 1;
                      isLeaf = true;
                  } else {
                      // Not supposed to happen!
                      revert();
                  }
                  return (isLeaf, decodeNibbles(compact, skipNibbles));
              }
              function sharedPrefixLength(
                  uint256 xsOffset,
                  bytes memory xs,
                  bytes memory ys
              ) internal pure returns (uint256) {
                  uint256 i;
                  for (i = 0; i + xsOffset < xs.length && i < ys.length; i++) {
                      if (xs[i + xsOffset] != ys[i]) {
                          return i;
                      }
                  }
                  return i;
              }
              function decodeProofBlob(bytes memory proofBlob)
              internal
              pure
              returns (Proof memory proof)
              {
                  RLPReader.RLPItem[] memory proofFields = proofBlob.toRlpItem().toList();
                  proof = Proof(
                      proofFields[0].toBytes32(),
                      decodeNibbles(proofFields[1].toRlpBytes(), 0),
                      proofFields[2].toList()
                  );
              }
              /// @dev Computes the hash of the Merkle-Patricia-Trie hash of the input.
              ///      Merkle-Patricia-Tries use a weird "hash function" that outputs
              ///      *variable-length* hashes: If the input is shorter than 32 bytes,
              ///      the MPT hash is the input. Otherwise, the MPT hash is the
              ///      Keccak-256 hash of the input.
              ///      The easiest way to compare variable-length byte sequences is
              ///      to compare their Keccak-256 hashes.
              /// @param input The byte sequence to be hashed.
              /// @return Keccak-256(MPT-hash(input))
              function mptHashHash(bytes memory input) internal pure returns (bytes32) {
                  if (input.length < 32) {
                      return keccak256(input);
                  } else {
                      return
                      keccak256(abi.encodePacked(keccak256(abi.encodePacked(input))));
                  }
              }
              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;
              }
          }
          // SPDX-License-Identifier: Apache-2.0
          pragma solidity ^0.8.0;
          library RLPReader {
              uint8 constant STRING_SHORT_START = 0x80;
              uint8 constant STRING_LONG_START  = 0xb8;
              uint8 constant LIST_SHORT_START   = 0xc0;
              uint8 constant LIST_LONG_START    = 0xf8;
              uint8 constant WORD_SIZE = 32;
              struct RLPItem {
                  uint len;
                  uint memPtr;
              }
              struct Iterator {
                  RLPItem item;   // Item that's being iterated over.
                  uint nextPtr;   // Position of the next item in the list.
              }
              /*
              * @dev Returns the next element in the iteration. Reverts if it has not next element.
              * @param self The iterator.
              * @return The next element in the iteration.
              */
              function next(Iterator memory self) internal pure returns (RLPItem memory) {
                  require(hasNext(self));
                  uint ptr = self.nextPtr;
                  uint itemLength = _itemLength(ptr);
                  self.nextPtr = ptr + itemLength;
                  return RLPItem(itemLength, ptr);
              }
              /*
              * @dev Returns true if the iteration has more elements.
              * @param self The iterator.
              * @return true if the iteration has more elements.
              */
              function hasNext(Iterator memory self) internal pure returns (bool) {
                  RLPItem memory item = self.item;
                  return self.nextPtr < item.memPtr + item.len;
              }
              /*
              * @param item RLP encoded bytes
              */
              function toRlpItem(bytes memory item) internal pure returns (RLPItem memory) {
                  uint memPtr;
                  assembly {
                      memPtr := add(item, 0x20)
                  }
                  return RLPItem(item.length, memPtr);
              }
              /*
              * @dev Create an iterator. Reverts if item is not a list.
              * @param self The RLP item.
              * @return An 'Iterator' over the item.
              */
              function iterator(RLPItem memory self) internal pure returns (Iterator memory) {
                  require(isList(self));
                  uint ptr = self.memPtr + _payloadOffset(self.memPtr);
                  return Iterator(self, ptr);
              }
              /*
              * @param the RLP item.
              */
              function rlpLen(RLPItem memory item) internal pure returns (uint) {
                  return item.len;
              }
              /*
               * @param the RLP item.
               * @return (memPtr, len) pair: location of the item's payload in memory.
               */
              function payloadLocation(RLPItem memory item) internal pure returns (uint, uint) {
                  uint offset = _payloadOffset(item.memPtr);
                  uint memPtr = item.memPtr + offset;
                  uint len = item.len - offset; // data length
                  return (memPtr, len);
              }
              /*
              * @param the RLP item.
              */
              function payloadLen(RLPItem memory item) internal pure returns (uint) {
                  (, uint len) = payloadLocation(item);
                  return len;
              }
              /*
              * @param the RLP item containing the encoded list.
              */
              function toList(RLPItem memory item) internal pure returns (RLPItem[] memory) {
                  require(isList(item));
                  uint items = numItems(item);
                  RLPItem[] memory result = new RLPItem[](items);
                  uint memPtr = item.memPtr + _payloadOffset(item.memPtr);
                  uint dataLen;
                  for (uint i = 0; i < items; i++) {
                      dataLen = _itemLength(memPtr);
                      result[i] = RLPItem(dataLen, memPtr);
                      memPtr = memPtr + dataLen;
                  }
                  return result;
              }
              // @return indicator whether encoded payload is a list. negate this function call for isData.
              function isList(RLPItem memory item) internal pure returns (bool) {
                  if (item.len == 0) return false;
                  uint8 byte0;
                  uint memPtr = item.memPtr;
                  assembly {
                      byte0 := byte(0, mload(memPtr))
                  }
                  if (byte0 < LIST_SHORT_START)
                      return false;
                  return true;
              }
              /*
               * @dev A cheaper version of keccak256(toRlpBytes(item)) that avoids copying memory.
               * @return keccak256 hash of RLP encoded bytes.
               */
              function rlpBytesKeccak256(RLPItem memory item) internal pure returns (bytes32) {
                  uint256 ptr = item.memPtr;
                  uint256 len = item.len;
                  bytes32 result;
                  assembly {
                      result := keccak256(ptr, len)
                  }
                  return result;
              }
              /*
               * @dev A cheaper version of keccak256(toBytes(item)) that avoids copying memory.
               * @return keccak256 hash of the item payload.
               */
              function payloadKeccak256(RLPItem memory item) internal pure returns (bytes32) {
                  (uint memPtr, uint len) = payloadLocation(item);
                  bytes32 result;
                  assembly {
                      result := keccak256(memPtr, len)
                  }
                  return result;
              }
              /** RLPItem conversions into data types **/
              // @returns raw rlp encoding in bytes
              function toRlpBytes(RLPItem memory item) internal pure returns (bytes memory) {
                  bytes memory result = new bytes(item.len);
                  if (result.length == 0) return result;
                  uint ptr;
                  assembly {
                      ptr := add(0x20, result)
                  }
                  copy(item.memPtr, ptr, item.len);
                  return result;
              }
              // any non-zero byte except "0x80" is considered true
              function toBoolean(RLPItem memory item) internal pure returns (bool) {
                  require(item.len == 1);
                  uint result;
                  uint memPtr = item.memPtr;
                  assembly {
                      result := byte(0, mload(memPtr))
                  }
                  // SEE Github Issue #5.
                  // Summary: Most commonly used RLP libraries (i.e Geth) will encode
                  // "0" as "0x80" instead of as "0". We handle this edge case explicitly
                  // here.
                  if (result == 0 || result == STRING_SHORT_START) {
                      return false;
                  } else {
                      return true;
                  }
              }
              function toAddress(RLPItem memory item) internal pure returns (address) {
                  // 1 byte for the length prefix
                  require(item.len == 21);
                  return address(uint160(toUint(item)));
              }
              function toUint(RLPItem memory item) internal pure returns (uint) {
                  require(item.len > 0 && item.len <= 33);
                  (uint memPtr, uint len) = payloadLocation(item);
                  uint result;
                  assembly {
                      result := mload(memPtr)
                  // shfit to the correct location if neccesary
                      if lt(len, 32) {
                          result := div(result, exp(256, sub(32, len)))
                      }
                  }
                  return result;
              }
              // enforces 32 byte length
              function toUintStrict(RLPItem memory item) internal pure returns (uint) {
                  // one byte prefix
                  require(item.len == 33);
                  uint result;
                  uint memPtr = item.memPtr + 1;
                  assembly {
                      result := mload(memPtr)
                  }
                  return result;
              }
              function toBytes(RLPItem memory item) internal pure returns (bytes memory) {
                  require(item.len > 0);
                  (uint memPtr, uint len) = payloadLocation(item);
                  bytes memory result = new bytes(len);
                  uint destPtr;
                  assembly {
                      destPtr := add(0x20, result)
                  }
                  copy(memPtr, destPtr, len);
                  return result;
              }
              /*
              * Private Helpers
              */
              // @return number of payload items inside an encoded list.
              function numItems(RLPItem memory item) private pure returns (uint) {
                  if (item.len == 0) return 0;
                  uint count = 0;
                  uint currPtr = item.memPtr + _payloadOffset(item.memPtr);
                  uint endPtr = item.memPtr + item.len;
                  while (currPtr < endPtr) {
                      currPtr = currPtr + _itemLength(currPtr); // skip over an item
                      count++;
                  }
                  return count;
              }
              // @return entire rlp item byte length
              function _itemLength(uint memPtr) private pure returns (uint) {
                  uint itemLen;
                  uint byte0;
                  assembly {
                      byte0 := byte(0, mload(memPtr))
                  }
                  if (byte0 < STRING_SHORT_START)
                      itemLen = 1;
                  else if (byte0 < STRING_LONG_START)
                      itemLen = byte0 - STRING_SHORT_START + 1;
                  else if (byte0 < LIST_SHORT_START) {
                      assembly {
                          let byteLen := sub(byte0, 0xb7) // # of bytes the actual length is
                          memPtr := add(memPtr, 1) // skip over the first byte
                      /* 32 byte word size */
                          let dataLen := div(mload(memPtr), exp(256, sub(32, byteLen))) // right shifting to get the len
                          itemLen := add(dataLen, add(byteLen, 1))
                      }
                  }
                  else if (byte0 < LIST_LONG_START) {
                      itemLen = byte0 - LIST_SHORT_START + 1;
                  }
                  else {
                      assembly {
                          let byteLen := sub(byte0, 0xf7)
                          memPtr := add(memPtr, 1)
                          let dataLen := div(mload(memPtr), exp(256, sub(32, byteLen))) // right shifting to the correct length
                          itemLen := add(dataLen, add(byteLen, 1))
                      }
                  }
                  return itemLen;
              }
              // @return number of bytes until the data
              function _payloadOffset(uint memPtr) private pure returns (uint) {
                  uint byte0;
                  assembly {
                      byte0 := byte(0, mload(memPtr))
                  }
                  if (byte0 < STRING_SHORT_START)
                      return 0;
                  else if (byte0 < STRING_LONG_START || (byte0 >= LIST_SHORT_START && byte0 < LIST_LONG_START))
                      return 1;
                  else if (byte0 < LIST_SHORT_START)  // being explicit
                      return byte0 - (STRING_LONG_START - 1) + 1;
                  else
                      return byte0 - (LIST_LONG_START - 1) + 1;
              }
              /*
              * @param src Pointer to source
              * @param dest Pointer to destination
              * @param len Amount of memory to copy from the source
              */
              function copy(uint src, uint dest, uint len) private pure {
                  if (len == 0) return;
                  // copy as many word sizes as possible
                  for (; len >= WORD_SIZE; len -= WORD_SIZE) {
                      assembly {
                          mstore(dest, mload(src))
                      }
                      src += WORD_SIZE;
                      dest += WORD_SIZE;
                  }
                  if (len > 0) {
                      // left over bytes. Mask is used to remove unwanted bytes from the word
                      uint mask = 256 ** (WORD_SIZE - len) - 1;
                      assembly {
                          let srcpart := and(mload(src), not(mask)) // zero out src
                          let destpart := and(mload(dest), mask) // retrieve the bytes
                          mstore(dest, or(destpart, srcpart))
                      }
                  }
              }
              function toBytes32(RLPItem memory self) internal pure returns (bytes32 data) {
                  return bytes32(toUint(self));
              }
          }
          

          File 5 of 6: OptimisticBlockUpdater
          // Sources flattened with hardhat v2.19.0 https://hardhat.org
          
          // SPDX-License-Identifier: MIT
          
          // File @openzeppelin/contracts/utils/[email protected]
          
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev Provides information about the current execution context, including the
           * sender of the transaction and its data. While these are generally available
           * via msg.sender and msg.data, they should not be accessed in such a direct
           * manner, since when dealing with meta-transactions the account sending and
           * paying for execution may not be the actual sender (as far as an application
           * is concerned).
           *
           * This contract is only required for intermediate, library-like contracts.
           */
          abstract contract Context {
              function _msgSender() internal view virtual returns (address) {
                  return msg.sender;
              }
          
              function _msgData() internal view virtual returns (bytes calldata) {
                  return msg.data;
              }
          }
          
          
          // File @openzeppelin/contracts/access/[email protected]
          
          // Original license: SPDX_License_Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)
          
          pragma solidity ^0.8.0;
          
          /**
           * @dev Contract module which provides a basic access control mechanism, where
           * there is an account (an owner) that can be granted exclusive access to
           * specific functions.
           *
           * By default, the owner account will be the one that deploys the contract. This
           * can later be changed with {transferOwnership}.
           *
           * This module is used through inheritance. It will make available the modifier
           * `onlyOwner`, which can be applied to your functions to restrict their use to
           * the owner.
           */
          abstract contract 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);
              }
          }
          
          
          // File contracts/interface/IMixtureBlockUpdater.sol
          
          // Original license: SPDX_License_Identifier: MIT
          pragma solidity ^0.8.0;
          
          interface IMixtureBlockUpdater {
              event ImportBlock(uint256 identifier, bytes32 blockHash, bytes32 receiptHash);
          
              function importBlock(uint256 blockNumber,bytes32 _blockHash,bytes32 _receiptsRoot,uint256 blockConfirmation) external;
          
              function checkBlock(bytes32 _blockHash, bytes32 _receiptsRoot) external view returns (bool);
          
              function checkBlockConfirmation(bytes32 _blockHash, bytes32 _receiptsRoot) external view returns (bool, uint256);
          }
          
          
          // File contracts/block/optimistic/OptimisticBlockUpdater.sol
          
          // Original license: SPDX_License_Identifier: MIT
          
          pragma solidity ^0.8.14;
          contract OptimisticBlockUpdater is IMixtureBlockUpdater, Ownable {
          
              address public blockRouter;
          
              IMixtureBlockUpdater public oldBlockUpdater;
          
              // blockHash=>receiptsRoot =>BlockConfirmation
              mapping(bytes32 => mapping(bytes32 => uint256)) public blockInfos;
          
              modifier onlyBlockRouter() {
                  require(msg.sender == blockRouter, "caller is not the block router");
                  _;
              }
          
              constructor(address _blockRouter) {
                  blockRouter = _blockRouter;
              }
          
              function importBlock(uint256 blockNumber, bytes32 _blockHash, bytes32 _receiptsRoot, uint256 _blockConfirmation) external onlyBlockRouter {
                  (bool exist,uint256 blockConfirmation) = _checkBlock(_blockHash, _receiptsRoot);
                  require(_blockConfirmation > 0, "invalid blockConfirmation");
                  if (exist && _blockConfirmation <= blockConfirmation) {
                      return;
                  }
                  blockInfos[_blockHash][_receiptsRoot] = _blockConfirmation;
                  emit ImportBlock(blockNumber, _blockHash, _receiptsRoot);
              }
          
          
              function checkBlock(bytes32 _blockHash, bytes32 _receiptHash) external view returns (bool) {
                  (bool exist,) = _checkBlock(_blockHash, _receiptHash);
                  return exist;
              }
          
              function checkBlockConfirmation(bytes32 _blockHash, bytes32 _receiptHash) external view returns (bool, uint256) {
                  return _checkBlock(_blockHash, _receiptHash);
              }
          
              function _checkBlock(bytes32 _blockHash, bytes32 _receiptHash) internal view returns (bool, uint256) {
                  uint256 blockConfirmation = blockInfos[_blockHash][_receiptHash];
                  if (blockConfirmation > 0) {
                      return (true, blockConfirmation);
                  }
                  if (address(oldBlockUpdater) != address(0)) {
                      return oldBlockUpdater.checkBlockConfirmation(_blockHash, _receiptHash);
                  }
                  return (false, 0);
              }
          
              //----------------------------------------------------------------------------------
              // onlyOwner
              function setBlockRouter(address _blockRouter) external onlyOwner {
                  require(_blockRouter != address(0), "Zero address");
                  blockRouter = _blockRouter;
              }
          
              function setOldBlockUpdater(address _oldBlockUpdater) external onlyOwner {
                  oldBlockUpdater = IMixtureBlockUpdater(_oldBlockUpdater);
              }
          
          }

          File 6 of 6: Bridge
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          import {Initializable} from "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
          import {ReentrancyGuardUpgradeable} from "@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol";
          import {IERC20, SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
          import {Address} from "@openzeppelin/contracts/utils/Address.sol";
          import "./interfaces/IZKBridgeReceiver.sol";
          import "./interfaces/IZKBridgeEndpoint.sol";
          import "./interfaces/IL1Bridge.sol";
          import {Pool} from "./Pool.sol";
          contract Bridge is IZKBridgeReceiver, Initializable, ReentrancyGuardUpgradeable, Pool {
              using SafeERC20 for IERC20;
              IZKBridgeEndpoint public immutable zkBridgeEndpoint;
              IL1Bridge public immutable l1Bridge;
              // chainId -> bridge address, mapping of token bridge contracts on other chains
              mapping(uint16 => address) public bridgeLookup;
              // For two-step bridge management
              bool public pendingBridge;
              uint16 public pendingDstChainId;
              address public pendingBridgeAddress;
              event TransferToken(
                  uint64 indexed sequence,
                  uint16 indexed dstChainId,
                  uint256 indexed poolId,
                  address sender,
                  address recipient,
                  uint256 amount
              );
              event ReceiveToken(
                  uint64 indexed sequence, uint16 indexed srcChainId, uint256 indexed poolId, address recipient, uint256 amount
              );
              event NewPendingBridge(uint16 chainId, address bridge);
              event NewBridge(uint16 chainId, address bridge);
              /// @dev l1Bridge_ could be address(0) when Mux functions are not needed
              constructor(IZKBridgeEndpoint zkBridgeEndpoint_, IL1Bridge l1Bridge_, uint256 NATIVE_TOKEN_POOL_ID_)
                  Pool(NATIVE_TOKEN_POOL_ID_)
              {
                  require(address(zkBridgeEndpoint_) != address(0), "Bridge: zkBridgeEndpoint is the zero address");
                  zkBridgeEndpoint = zkBridgeEndpoint_;
                  l1Bridge = l1Bridge_;
              }
              function initialize() external initializer {
                  __ReentrancyGuard_init();
                  __Admin_init();
              }
              function estimateFee(uint256 poolId, uint16 dstChainId, uint256 amount) public view returns (uint256) {
                  _checkDstChain(poolId, dstChainId);
                  uint256 uaFee = getFee(poolId, dstChainId, amount);
                  uint256 zkBridgeFee = zkBridgeEndpoint.estimateFee(dstChainId);
                  return uaFee + zkBridgeFee;
              }
              function _transfer(uint16 dstChainId, uint256 poolId, uint256 amount, address recipient, uint256 fee)
                  internal
                  returns (uint256)
              {
                  address dstBridge = bridgeLookup[dstChainId];
                  require(dstBridge != address(0), "Bridge: dstChainId does not exist");
                  uint256 uaFee = getFee(poolId, dstChainId, amount);
                  uint256 zkBridgeFee = zkBridgeEndpoint.estimateFee(dstChainId);
                  require(fee >= uaFee + zkBridgeFee, "Bridge: Insufficient Fee");
                  uint256 amountSD = _deposit(poolId, dstChainId, amount);
                  bytes memory payload = abi.encode(poolId, amountSD, recipient);
                  uint64 sequence = zkBridgeEndpoint.send{value: zkBridgeFee}(dstChainId, dstBridge, payload);
                  emit TransferToken(sequence, dstChainId, poolId, msg.sender, recipient, amountSD);
                  // Returns the actual amount of fees used
                  return uaFee + zkBridgeFee;
              }
              /// @notice The main function for sending native token through bridge
              function transferETH(uint16 dstChainId, uint256 amount, address recipient) external payable nonReentrant {
                  require(msg.value >= amount, "Bridge: Insufficient ETH");
                  _transfer(dstChainId, NATIVE_TOKEN_POOL_ID, amount, recipient, msg.value - amount);
              }
              /// @notice The main function for sending ERC20 tokens through bridge
              function transferToken(uint16 dstChainId, uint256 poolId, uint256 amount, address recipient)
                  external
                  payable
                  nonReentrant
              {
                  require(poolId != NATIVE_TOKEN_POOL_ID, "Bridge: Can't transfer token using native token pool ID");
                  IERC20(_poolInfo[poolId].token).safeTransferFrom(msg.sender, address(this), amount);
                  _transfer(dstChainId, poolId, amount, recipient, msg.value);
              }
              /// @notice The main function for receiving tokens. Should only be called by zkBridge
              function zkReceive(uint16 srcChainId, address srcAddress, uint64 sequence, bytes calldata payload)
                  external
                  nonReentrant
              {
                  require(msg.sender == address(zkBridgeEndpoint), "Bridge: Not from zkBridgeEndpoint");
                  require(srcAddress != address(0) && srcAddress == bridgeLookup[srcChainId], "Bridge: Invalid emitter");
                  (uint256 poolId, uint256 amountSD, address recipient) = abi.decode(payload, (uint256, uint256, address));
                  uint256 amount = _withdraw(poolId, srcChainId, amountSD);
                  if (poolId == NATIVE_TOKEN_POOL_ID) {
                      Address.sendValue(payable(recipient), amount);
                  } else {
                      IERC20(_poolInfo[poolId].token).safeTransfer(recipient, amount);
                  }
                  emit ReceiveToken(sequence, srcChainId, poolId, recipient, amountSD);
              }
              /// @notice Sending native token through bridge, fallback to l1bridge when limits are triggered
              function transferETHMux(uint16 dstChainId, uint256 amount, address recipient) external payable nonReentrant {
                  require(address(l1Bridge) != address(0), "Bridge: l1Bridge not available");
                  uint256 refundAmount;
                  if (
                      _poolInfo[NATIVE_TOKEN_POOL_ID].balance + amount <= _poolInfo[NATIVE_TOKEN_POOL_ID].maxLiquidity
                          && amount <= _dstChains[NATIVE_TOKEN_POOL_ID][dstChainId].maxTransferLimit
                  ) {
                      require(msg.value >= amount, "Bridge: Insufficient ETH");
                      uint256 fee = _transfer(dstChainId, NATIVE_TOKEN_POOL_ID, amount, recipient, msg.value - amount);
                      refundAmount = msg.value - amount - fee;
                  } else {
                      uint256 fee = l1Bridge.fees(dstChainId);
                      require(msg.value >= amount + fee, "Bridge: Insufficient ETH");
                      l1Bridge.transferETH{value: amount + fee}(dstChainId, amount, recipient);
                      refundAmount = msg.value - amount - fee;
                  }
                  if (refundAmount > 0) {
                      Address.sendValue(payable(msg.sender), refundAmount);
                  }
              }
              /// @notice Sending ERC20 tokens through bridge, fallback to l1bridge when limits are triggered
              function transferTokenMux(uint16 dstChainId, uint256 poolId, uint256 amount, address recipient)
                  external
                  payable
                  nonReentrant
              {
                  require(address(l1Bridge) != address(0), "Bridge: l1Bridge not available");
                  require(poolId != NATIVE_TOKEN_POOL_ID, "Bridge: Can't transfer token using native token pool ID");
                  address token = _poolInfo[poolId].token;
                  require(token != address(0), "Bridge: pool not found");
                  IERC20(token).safeTransferFrom(msg.sender, address(this), amount);
                  uint256 refundAmount;
                  if (
                      _poolInfo[poolId].balance + amount <= _poolInfo[poolId].maxLiquidity
                          && amount <= _dstChains[poolId][dstChainId].maxTransferLimit
                  ) {
                      uint256 fee = _transfer(dstChainId, poolId, amount, recipient, msg.value);
                      refundAmount = msg.value - fee;
                  } else {
                      uint256 fee = l1Bridge.fees(dstChainId);
                      require(msg.value >= fee, "Bridge: Insufficient fee");
                      IERC20(token).safeApprove(address(l1Bridge), amount);
                      l1Bridge.transferERC20{value: fee}(dstChainId, token, amount, recipient);
                      IERC20(token).safeApprove(address(l1Bridge), 0);
                      refundAmount = msg.value - fee;
                  }
                  if (refundAmount > 0) {
                      Address.sendValue(payable(msg.sender), refundAmount);
                  }
              }
              function estimateFeeMux(uint256 poolId, uint16 dstChainId, uint256 amount) external view returns (uint256) {
                  require(address(l1Bridge) != address(0), "Bridge: l1Bridge not available");
                  uint256 fee = estimateFee(poolId, dstChainId, amount);
                  uint256 l1Fee = l1Bridge.fees(dstChainId);
                  return fee > l1Fee ? fee : l1Fee;
              }
              /// @notice adding a new dstChain bridge address
              /// @param bridge could be address(0) when deleting a bridge
              function setBridge(uint16 dstChainId, address bridge) external onlyBridgeManager nonReentrant {
                  if (bridgeManager != bridgeReviewer) {
                      // Two-step bridge management needed
                      pendingDstChainId = dstChainId;
                      pendingBridgeAddress = bridge;
                      pendingBridge = true;
                      emit NewPendingBridge(dstChainId, bridge);
                  } else {
                      // bridgeManager is the same as bridgeReviewer, two-step bridge management not needed
                      bridgeLookup[dstChainId] = bridge;
                      if (pendingBridge) {
                          pendingBridge = false;
                      }
                      emit NewBridge(dstChainId, bridge);
                  }
              }
              /// @notice approve a new dstChain bridge address
              /// @dev The dstChainId and bridge params are required to prevent front-running attacks
              function approveSetBridge(uint16 dstChainId, address bridge) external onlyBridgeReviewer nonReentrant {
                  require(pendingBridge, "Bridge: no pending bridge");
                  require(
                      dstChainId == pendingDstChainId && bridge == pendingBridgeAddress,
                      "Bridge: dstChainId or bridge does not match"
                  );
                  bridgeLookup[dstChainId] = bridge;
                  pendingBridge = false;
                  emit NewBridge(dstChainId, bridge);
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)
          pragma solidity ^0.8.2;
          import "../../utils/AddressUpgradeable.sol";
          /**
           * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
           * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
           * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
           * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
           *
           * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
           * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
           * case an upgrade adds a module that needs to be initialized.
           *
           * For example:
           *
           * [.hljs-theme-light.nopadding]
           * ```solidity
           * contract MyToken is ERC20Upgradeable {
           *     function initialize() initializer public {
           *         __ERC20_init("MyToken", "MTK");
           *     }
           * }
           *
           * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
           *     function initializeV2() reinitializer(2) public {
           *         __ERC20Permit_init("MyToken");
           *     }
           * }
           * ```
           *
           * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
           * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
           *
           * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
           * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
           *
           * [CAUTION]
           * ====
           * Avoid leaving a contract uninitialized.
           *
           * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
           * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
           * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
           *
           * [.hljs-theme-light.nopadding]
           * ```
           * /// @custom:oz-upgrades-unsafe-allow constructor
           * constructor() {
           *     _disableInitializers();
           * }
           * ```
           * ====
           */
          abstract contract Initializable {
              /**
               * @dev Indicates that the contract has been initialized.
               * @custom:oz-retyped-from bool
               */
              uint8 private _initialized;
              /**
               * @dev Indicates that the contract is in the process of being initialized.
               */
              bool private _initializing;
              /**
               * @dev Triggered when the contract has been initialized or reinitialized.
               */
              event Initialized(uint8 version);
              /**
               * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
               * `onlyInitializing` functions can be used to initialize parent contracts.
               *
               * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
               * constructor.
               *
               * Emits an {Initialized} event.
               */
              modifier initializer() {
                  bool isTopLevelCall = !_initializing;
                  require(
                      (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
                      "Initializable: contract is already initialized"
                  );
                  _initialized = 1;
                  if (isTopLevelCall) {
                      _initializing = true;
                  }
                  _;
                  if (isTopLevelCall) {
                      _initializing = false;
                      emit Initialized(1);
                  }
              }
              /**
               * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
               * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
               * used to initialize parent contracts.
               *
               * A reinitializer may be used after the original initialization step. This is essential to configure modules that
               * are added through upgrades and that require initialization.
               *
               * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
               * cannot be nested. If one is invoked in the context of another, execution will revert.
               *
               * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
               * a contract, executing them in the right order is up to the developer or operator.
               *
               * WARNING: setting the version to 255 will prevent any future reinitialization.
               *
               * Emits an {Initialized} event.
               */
              modifier reinitializer(uint8 version) {
                  require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
                  _initialized = version;
                  _initializing = true;
                  _;
                  _initializing = false;
                  emit Initialized(version);
              }
              /**
               * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
               * {initializer} and {reinitializer} modifiers, directly or indirectly.
               */
              modifier onlyInitializing() {
                  require(_initializing, "Initializable: contract is not initializing");
                  _;
              }
              /**
               * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
               * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
               * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
               * through proxies.
               *
               * Emits an {Initialized} event the first time it is successfully executed.
               */
              function _disableInitializers() internal virtual {
                  require(!_initializing, "Initializable: contract is initializing");
                  if (_initialized != type(uint8).max) {
                      _initialized = type(uint8).max;
                      emit Initialized(type(uint8).max);
                  }
              }
              /**
               * @dev Returns the highest version that has been initialized. See {reinitializer}.
               */
              function _getInitializedVersion() internal view returns (uint8) {
                  return _initialized;
              }
              /**
               * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
               */
              function _isInitializing() internal view returns (bool) {
                  return _initializing;
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)
          pragma solidity ^0.8.0;
          import "../proxy/utils/Initializable.sol";
          /**
           * @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 ReentrancyGuardUpgradeable is Initializable {
              // 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;
              function __ReentrancyGuard_init() internal onlyInitializing {
                  __ReentrancyGuard_init_unchained();
              }
              function __ReentrancyGuard_init_unchained() internal onlyInitializing {
                  _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;
              }
              /**
               * @dev This empty reserved space is put in place to allow future versions to add new
               * variables without shifting down storage in the inheritance chain.
               * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
               */
              uint256[49] private __gap;
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.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
          pragma solidity ^0.8.0;
          interface IZKBridgeReceiver {
              // @notice ZKBridge 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 sequence - the ordered message nonce
              // @param payload - the signed payload is the UA bytes has encoded to be sent
              function zkReceive(uint16 srcChainId, address srcAddress, uint64 sequence, bytes calldata payload) external;
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          interface IZKBridgeEndpoint {
              function send(uint16 dstChainId, address dstAddress, bytes memory payload) external payable returns (uint64);
              function estimateFee(uint16 dstChainId) external view returns (uint256 fee);
              function chainId() external view returns (uint16);
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          interface IL1Bridge {
              function transferETH(uint16 dstChainId_, uint256 amount_, address recipient_) external payable;
              function transferETHFromVault(uint16 dstChainId_, address recipient_) external payable;
              function transferERC20(uint16 dstChainId_, address l1Token_, uint256 amount_, address recipient_)
                  external
                  payable;
              function transferERC20FromVault(uint16 dstChainId_, address l1Token_, uint256 amount_, address recipient_)
                  external;
              function fees(uint16 dstChainId_) external view returns (uint256);
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          import {ReentrancyGuardUpgradeable} from "@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol";
          import {IERC20, SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
          import {Address} from "@openzeppelin/contracts/utils/Address.sol";
          import {Admin} from "./Admin.sol";
          abstract contract Pool is ReentrancyGuardUpgradeable, Admin {
              using SafeERC20 for IERC20;
              struct DstChainInfo {
                  // Whether dstChain is enabled for this pool
                  bool enabled;
                  // Static fee when sending tokens to dstChain
                  uint128 staticFee;
                  // Numerator of dynamic fee, a fee proportionate to the transfer amount
                  // Currently only supports native token pools
                  uint64 dynamicFeeNum;
                  // Limit of a single transfer
                  uint256 maxTransferLimit;
              }
              uint256 public constant DYNAMIC_FEE_DEN = 1000000000; // denominator of dynamic fee
              struct PoolInfo {
                  // Whether this pool is enabled
                  bool enabled;
                  // Should be (local decimals - shared decimals)
                  // e.g. If local decimals is 18 and shared decimals is 6, this number should be 12
                  // Local decimals is the decimals of the underlying ERC20 token
                  // Shared decimals is the common decimals across all chains
                  uint8 convertRateDecimals;
                  // ERC20 token address. Should be address(0) for native token pool
                  address token;
                  // Token balance of this pool
                  // This should be tracked via a variable because this contract also hold fees
                  // Also, an attacker may force transfer tokens to this contract to reach maxLiquidity
                  uint256 balance;
                  // The liquidity of this pool when the remote pool is exhausted
                  // Only works when there are two chains
                  // When there are >= 3 chains, this does not work and should be set to type(uint256).max
                  uint256 maxLiquidity;
              }
              // poolId -> dstChainId -> DstChainInfo
              mapping(uint256 => mapping(uint16 => DstChainInfo)) internal _dstChains;
              // Native token pool ID
              uint256 public immutable NATIVE_TOKEN_POOL_ID;
              // poolId -> PoolInfo
              // poolId needs to be the same across different chains for the same token
              mapping(uint256 => PoolInfo) internal _poolInfo;
              event AddLiquidity(uint256 indexed poolId, uint256 amount);
              event RemoveLiquidity(uint256 indexed poolId, uint256 amount);
              event DstChainStatusChanged(uint256 indexed poolId, uint16 indexed dstChainId, bool indexed enabled);
              event NewMaxTransferLimit(uint256 indexed poolId, uint16 indexed dstChainId, uint256 maxTransferLimit);
              event NewMaxLiquidity(uint256 indexed poolId, uint256 maxLiquidity);
              event NewFee(uint256 indexed poolId, uint16 indexed dstChainId, uint256 staticFee, uint256 dynamicFeeNum);
              event ClaimedFees(address to, uint256 amount);
              constructor(uint256 NATIVE_TOKEN_POOL_ID_) {
                  NATIVE_TOKEN_POOL_ID = NATIVE_TOKEN_POOL_ID_;
              }
              function poolInfo(uint256 poolId) public view returns (PoolInfo memory) {
                  return _poolInfo[poolId];
              }
              function dstChains(uint256 poolId, uint16 dstChainId) public view returns (DstChainInfo memory) {
                  return _dstChains[poolId][dstChainId];
              }
              function convertRate(uint256 poolId) public view returns (uint256) {
                  return 10 ** _poolInfo[poolId].convertRateDecimals;
              }
              /// @dev ensure amount is a multiple of convertRate
              function _checkConvertRate(uint256 poolId, uint256 amount) internal view {
                  require(amount % convertRate(poolId) == 0, "Pool: amount is not a multiple of convert rate");
              }
              function _checkPool(uint256 poolId) internal view {
                  require(_poolInfo[poolId].enabled, "Pool: pool ID not enabled");
              }
              function _checkDstChain(uint256 poolId, uint16 dstChainId) internal view {
                  _checkPool(poolId);
                  require(_dstChains[poolId][dstChainId].enabled, "Pool: pool ID or dst chain ID not enabled");
              }
              function getFee(uint256 poolId, uint16 dstChainId, uint256 amount) public view returns (uint256) {
                  return amount * _dstChains[poolId][dstChainId].dynamicFeeNum / DYNAMIC_FEE_DEN
                      + _dstChains[poolId][dstChainId].staticFee;
              }
              /// @notice The main function for adding liquidity of ERC20 tokens
              function addLiquidity(uint256 poolId, uint256 amount) public onlyPoolManager nonReentrant {
                  _checkPool(poolId);
                  _checkConvertRate(poolId, amount);
                  IERC20(_poolInfo[poolId].token).safeTransferFrom(msg.sender, address(this), amount);
                  _poolInfo[poolId].balance += amount;
                  emit AddLiquidity(poolId, amount);
              }
              /// @notice The main function for adding liquidity of native token
              function addLiquidityETH() public payable onlyPoolManager nonReentrant {
                  uint256 poolId = NATIVE_TOKEN_POOL_ID;
                  _checkPool(poolId);
                  _checkConvertRate(poolId, msg.value);
                  _poolInfo[poolId].balance += msg.value;
                  emit AddLiquidity(poolId, msg.value);
              }
              /// @notice The main function for adding liquidity of ERC20 tokens without permission
              /// @dev When there are >= 3 chains, maxLiquidity is not enforced so everyone can add liquidity without any problem
              function addLiquidityPublic(uint256 poolId, uint256 amount) external nonReentrant {
                  _checkPool(poolId);
                  require(
                      _poolInfo[poolId].maxLiquidity == type(uint256).max,
                      "Pool: addLiquidityPublic only work when maxLiquidity is not limited"
                  );
                  _checkConvertRate(poolId, amount);
                  IERC20(_poolInfo[poolId].token).safeTransferFrom(msg.sender, address(this), amount);
                  _poolInfo[poolId].balance += amount;
                  emit AddLiquidity(poolId, amount);
              }
              /// @notice The main function for adding liquidity of native token without permission
              /// @dev When there are >= 3 chains, maxLiquidity is not enforced so everyone can add liquidity without any problem
              function addLiquidityETHPublic() external payable nonReentrant {
                  uint256 poolId = NATIVE_TOKEN_POOL_ID;
                  _checkPool(poolId);
                  require(
                      _poolInfo[poolId].maxLiquidity == type(uint256).max,
                      "Pool: addLiquidityPublic only work when maxLiquidity is not limited"
                  );
                  _checkConvertRate(poolId, msg.value);
                  _poolInfo[poolId].balance += msg.value;
                  emit AddLiquidity(poolId, msg.value);
              }
              /// @notice The main function for removing liquidity
              function removeLiquidity(uint256 poolId, uint256 amount) external onlyPoolManager nonReentrant {
                  _checkPool(poolId);
                  _checkConvertRate(poolId, amount);
                  require(amount <= _poolInfo[poolId].balance);
                  if (poolId == NATIVE_TOKEN_POOL_ID) {
                      Address.sendValue(payable(msg.sender), amount);
                  } else {
                      IERC20(_poolInfo[poolId].token).safeTransfer(msg.sender, amount);
                  }
                  _poolInfo[poolId].balance -= amount;
                  emit RemoveLiquidity(poolId, amount);
              }
              /// @notice Enable or disable a dstChain for a pool
              function setDstChain(uint256 poolId, uint16 dstChainId, bool enabled) external onlyPoolManager nonReentrant {
                  _checkPool(poolId);
                  require(_dstChains[poolId][dstChainId].enabled != enabled, "Pool: dst chain already enabled/disabled");
                  _dstChains[poolId][dstChainId].enabled = enabled;
                  emit DstChainStatusChanged(poolId, dstChainId, enabled);
              }
              /// @notice Set maxLiquidity. See the comments of PoolInfo.maxLiquidity
              function setMaxLiquidity(uint256 poolId, uint256 maxLiquidity) public onlyPoolManager nonReentrant {
                  _checkPool(poolId);
                  _poolInfo[poolId].maxLiquidity = maxLiquidity;
                  emit NewMaxLiquidity(poolId, maxLiquidity);
              }
              /// @notice Adding liquidity and setting maxLiquidity in a single tx
              /// If you add liquidity first and then set maxLiquidity, the maxLiquidity may be reached between the two transactions, making the bridge unusable.
              /// If you raise maxLiquidity first and then add liquidity, a large number of users may use it between the two transactions, resulting in insufficient liquidity.
              /// Therefore, this function is provided to ensure atomicity.
              function addLiquidityAndSetMaxLiquidity(uint256 poolId, uint256 amount, uint256 maxLiquidity) external {
                  addLiquidity(poolId, amount);
                  setMaxLiquidity(poolId, maxLiquidity);
              }
              function addLiquidityETHAndSetMaxLiquidity(uint256 maxLiquidity) external payable {
                  addLiquidityETH();
                  setMaxLiquidity(NATIVE_TOKEN_POOL_ID, maxLiquidity);
              }
              function setMaxTransferLimit(uint256 poolId, uint16 dstChainId, uint256 maxTransferLimit)
                  external
                  onlyPoolManager
                  nonReentrant
              {
                  _checkDstChain(poolId, dstChainId);
                  _dstChains[poolId][dstChainId].maxTransferLimit = maxTransferLimit;
                  emit NewMaxTransferLimit(poolId, dstChainId, maxTransferLimit);
              }
              function setFee(uint256 poolId, uint16 dstChainId, uint256 staticFee, uint256 dynamicFeeNum)
                  external
                  onlyPoolManager
                  nonReentrant
              {
                  _checkDstChain(poolId, dstChainId);
                  _dstChains[poolId][dstChainId].staticFee = uint128(staticFee);
                  _dstChains[poolId][dstChainId].dynamicFeeNum = uint64(dynamicFeeNum);
                  emit NewFee(poolId, dstChainId, staticFee, dynamicFeeNum);
              }
              function _deposit(uint256 poolId, uint16 dstChainId, uint256 amount) internal returns (uint256) {
                  _checkDstChain(poolId, dstChainId);
                  _checkConvertRate(poolId, amount);
                  require(
                      _poolInfo[poolId].balance + amount <= _poolInfo[poolId].maxLiquidity,
                      "Pool: Insufficient liquidity on the target chain"
                  );
                  require(
                      amount <= _dstChains[poolId][dstChainId].maxTransferLimit,
                      "Pool: Exceeding the maximum limit of a single transfer"
                  );
                  _poolInfo[poolId].balance += amount;
                  return amount / convertRate(poolId);
              }
              function _withdraw(uint256 poolId, uint16 srcChainId, uint256 amountSD) internal returns (uint256) {
                  _checkDstChain(poolId, srcChainId);
                  uint256 amount = amountSD * convertRate(poolId);
                  require(amount <= _poolInfo[poolId].balance, "Pool: Liquidity shortage");
                  _poolInfo[poolId].balance -= amount;
                  return amount;
              }
              function accumulatedFees() public view returns (uint256) {
                  return address(this).balance - _poolInfo[NATIVE_TOKEN_POOL_ID].balance;
              }
              function claimFees() external onlyPoolManager nonReentrant {
                  uint256 fee = accumulatedFees();
                  Address.sendValue(payable(msg.sender), fee);
                  emit ClaimedFees(msg.sender, fee);
              }
              /// @notice Create a new pool
              /// @param poolId is the new pool ID. It should be NATIVE_TOKEN_POOL_ID for native token and other values for ERC20 tokens
              /// poolId needs to be the same across different chains for the same token
              /// @param token ERC20 token address. Should be address(0) for native token pool
              /// @param convertRateDecimals Should be (local decimals - shared decimals). See the comments of PoolInfo.convertRateDecimals
              function createPool(uint256 poolId, address token, uint8 convertRateDecimals)
                  external
                  onlyBridgeManager
                  nonReentrant
              {
                  require(!_poolInfo[poolId].enabled, "Pool: pool already created");
                  if (poolId == NATIVE_TOKEN_POOL_ID) {
                      require(token == address(0), "Pool: native token pool should not have token address");
                  } else {
                      require(token != address(0), "Pool: token address should not be zero");
                  }
                  _poolInfo[poolId].enabled = true;
                  _poolInfo[poolId].convertRateDecimals = convertRateDecimals;
                  _poolInfo[poolId].token = token;
                  _poolInfo[poolId].maxLiquidity = type(uint256).max;
              }
              /**
               * @dev This empty reserved space is put in place to allow future versions to add new
               * variables without shifting down storage in the inheritance chain.
               * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
               */
              uint256[48] private __gap;
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
          pragma solidity ^0.8.1;
          /**
           * @dev Collection of functions related to the address type
           */
          library AddressUpgradeable {
              /**
               * @dev Returns true if `account` is a contract.
               *
               * [IMPORTANT]
               * ====
               * It is unsafe to assume that an address for which this function returns
               * false is an externally-owned account (EOA) and not a contract.
               *
               * Among others, `isContract` will return false for the following
               * types of addresses:
               *
               *  - an externally-owned account
               *  - a contract in construction
               *  - an address where a contract will be created
               *  - an address where a contract lived, but was destroyed
               *
               * Furthermore, `isContract` will also return true if the target contract within
               * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
               * which only has an effect at the end of a transaction.
               * ====
               *
               * [IMPORTANT]
               * ====
               * You shouldn't rely on `isContract` to protect against flash loan attacks!
               *
               * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
               * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
               * constructor.
               * ====
               */
              function isContract(address account) internal view returns (bool) {
                  // This method relies on extcodesize/address.code.length, which returns 0
                  // for contracts in construction, since the code is only stored at the end
                  // of the constructor execution.
                  return account.code.length > 0;
              }
              /**
               * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
               * `recipient`, forwarding all available gas and reverting on errors.
               *
               * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
               * of certain opcodes, possibly making contracts go over the 2300 gas limit
               * imposed by `transfer`, making them unable to receive funds via
               * `transfer`. {sendValue} removes this limitation.
               *
               * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
               *
               * IMPORTANT: because control is transferred to `recipient`, care must be
               * taken to not create reentrancy vulnerabilities. Consider using
               * {ReentrancyGuard} or the
               * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
               */
              function sendValue(address payable recipient, uint256 amount) internal {
                  require(address(this).balance >= amount, "Address: insufficient balance");
                  (bool success, ) = recipient.call{value: amount}("");
                  require(success, "Address: unable to send value, recipient may have reverted");
              }
              /**
               * @dev Performs a Solidity function call using a low level `call`. A
               * plain `call` is an unsafe replacement for a function call: use this
               * function instead.
               *
               * If `target` reverts with a revert reason, it is bubbled up by this
               * function (like regular Solidity function calls).
               *
               * Returns the raw returned data. To convert to the expected return value,
               * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
               *
               * Requirements:
               *
               * - `target` must be a contract.
               * - calling `target` with `data` must not revert.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, "Address: low-level call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
               * `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but also transferring `value` wei to `target`.
               *
               * Requirements:
               *
               * - the calling contract must have an ETH balance of at least `value`.
               * - the called Solidity function must be `payable`.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
              }
              /**
               * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
               * with `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  require(address(this).balance >= value, "Address: insufficient balance for call");
                  (bool success, bytes memory returndata) = target.call{value: value}(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                  return functionStaticCall(target, data, "Address: low-level static call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal view returns (bytes memory) {
                  (bool success, bytes memory returndata) = target.staticcall(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionDelegateCall(target, data, "Address: low-level delegate call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  (bool success, bytes memory returndata) = target.delegatecall(data);
                  return verifyCallResultFromTarget(target, success, returndata, errorMessage);
              }
              /**
               * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
               * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
               *
               * _Available since v4.8._
               */
              function verifyCallResultFromTarget(
                  address target,
                  bool success,
                  bytes memory returndata,
                  string memory errorMessage
              ) internal view returns (bytes memory) {
                  if (success) {
                      if (returndata.length == 0) {
                          // only check isContract if the call was successful and the return data is empty
                          // otherwise we already know that it was a contract
                          require(isContract(target), "Address: call to non-contract");
                      }
                      return returndata;
                  } else {
                      _revert(returndata, errorMessage);
                  }
              }
              /**
               * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
               * revert reason or using the provided one.
               *
               * _Available since v4.3._
               */
              function verifyCallResult(
                  bool success,
                  bytes memory returndata,
                  string memory errorMessage
              ) internal pure returns (bytes memory) {
                  if (success) {
                      return returndata;
                  } else {
                      _revert(returndata, errorMessage);
                  }
              }
              function _revert(bytes memory returndata, string memory errorMessage) private pure {
                  // Look for revert reason and bubble it up if present
                  if (returndata.length > 0) {
                      // The easiest way to bubble the revert reason is using memory via assembly
                      /// @solidity memory-safe-assembly
                      assembly {
                          let returndata_size := mload(returndata)
                          revert(add(32, returndata), returndata_size)
                      }
                  } else {
                      revert(errorMessage);
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.9.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.0) (token/ERC20/extensions/IERC20Permit.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
           * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
           *
           * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
           * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
           * need to send a transaction, and thus is not required to hold Ether at all.
           */
          interface 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].
               */
              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
          pragma solidity ^0.8.0;
          import {Initializable} from "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
          abstract contract Admin is Initializable {
              address public poolManager;
              address public bridgeManager;
              address public bridgeReviewer; // When bridgeReviewer == bridgeManager, the reviewing step will be skipped.
              // Two-step ownership management design, similar to Ownable2Step in OpenZeppelin Contracts.
              address public pendingPoolManager;
              address public pendingBridgeManager;
              address public pendingBridgeReviewer;
              event PoolManagerTransferStarted(address indexed previousOwner, address indexed newOwner);
              event PoolManagerTransferred(address indexed previousOwner, address indexed newOwner);
              event BridgeManagerTransferStarted(address indexed previousOwner, address indexed newOwner);
              event BridgeManagerTransferred(address indexed previousOwner, address indexed newOwner);
              event BridgeReviewerTransferStarted(address indexed previousOwner, address indexed newOwner);
              event BridgeReviewerTransferred(address indexed previousOwner, address indexed newOwner);
              function __Admin_init() internal onlyInitializing {
                  poolManager = msg.sender;
                  bridgeManager = msg.sender;
                  bridgeReviewer = msg.sender;
              }
              modifier onlyPoolManager() {
                  require(msg.sender == poolManager, "Admin: caller is not poolManager");
                  _;
              }
              modifier onlyBridgeManager() {
                  require(msg.sender == bridgeManager, "Admin: caller is not bridgeManager");
                  _;
              }
              modifier onlyBridgeReviewer() {
                  require(msg.sender == bridgeReviewer, "Admin: caller is not bridgeReviewer");
                  _;
              }
              function transferPoolManager(address newOwner) external onlyPoolManager {
                  pendingPoolManager = newOwner;
                  emit PoolManagerTransferStarted(msg.sender, newOwner);
              }
              function acceptPoolManager() external {
                  require(msg.sender == pendingPoolManager, "Admin: caller is not the new owner");
                  delete pendingPoolManager;
                  address oldOwner = poolManager;
                  poolManager = msg.sender;
                  emit PoolManagerTransferred(oldOwner, msg.sender);
              }
              function transferBridgeManager(address newOwner) external onlyBridgeManager {
                  pendingBridgeManager = newOwner;
                  emit BridgeManagerTransferStarted(msg.sender, newOwner);
              }
              function acceptBridgeManager() external {
                  require(msg.sender == pendingBridgeManager, "Admin: caller is not the new owner");
                  delete pendingBridgeManager;
                  address oldOwner = bridgeManager;
                  bridgeManager = msg.sender;
                  emit BridgeManagerTransferred(oldOwner, msg.sender);
              }
              function transferBridgeReviewer(address newOwner) external onlyBridgeReviewer {
                  pendingBridgeReviewer = newOwner;
                  emit BridgeReviewerTransferStarted(msg.sender, newOwner);
              }
              function acceptBridgeReviewer() external {
                  require(msg.sender == pendingBridgeReviewer, "Admin: caller is not the new owner");
                  delete pendingBridgeReviewer;
                  address oldOwner = bridgeReviewer;
                  bridgeReviewer = msg.sender;
                  emit BridgeReviewerTransferred(oldOwner, msg.sender);
              }
              /**
               * @dev This empty reserved space is put in place to allow future versions to add new
               * variables without shifting down storage in the inheritance chain.
               * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
               */
              uint256[44] private __gap;
          }